---
title: "Transport Ping 调度配置"
date: 2026-01-02
lastmod: 2026-01-02
description: "transport.ping_schedule 配置项用于定义传输层连接的内部 ping 间隔。"
tags: ["Transport", "Ping", "心跳检测", "连接管理"]
summary: "配置项作用 #  transport.ping_schedule 配置项用于定义传输层连接的内部 ping 间隔时间。
配置项属性 #   配置路径: transport.ping_schedule 数据类型: TimeValue（时间值） 默认值: -1（禁用） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置建议 #  默认配置 #  transport: ping_schedule: -1 # 禁用，默认值 生产环境推荐 #  transport: ping_schedule: 30s  # 每30秒发送一次ping 低延迟网络 #  transport: ping_schedule: 15s  # 每15秒发送一次ping 高延迟或跨数据中心网络 #  transport: ping_schedule: 60s  # 每60秒发送一次ping 注意事项 #    非动态更新: 需要重启节点生效。
  默认禁用: 默认值为 -1，表示禁用此功能。"
---


## 配置项作用

`transport.ping_schedule` 配置项用于定义**传输层连接的内部 ping 间隔时间**。

## 配置项属性

- **配置路径**: `transport.ping_schedule`
- **数据类型**: `TimeValue`（时间值）
- **默认值**: `-1`（禁用）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## 配置建议

## 默认配置

```yaml
transport:
  ping_schedule: -1  # 禁用，默认值
```

## 生产环境推荐

```yaml
transport:
  ping_schedule: 30s  # 每30秒发送一次ping
```

## 低延迟网络

```yaml
transport:
  ping_schedule: 15s  # 每15秒发送一次ping
```

## 高延迟或跨数据中心网络

```yaml
transport:
  ping_schedule: 60s  # 每60秒发送一次ping
```

## 注意事项

1. **非动态更新**: 需要重启节点生效。

2. **默认禁用**: 默认值为 -1，表示禁用此功能。

3. **功能说明**:
   - 当设置为正时间值时，Easysearch 会定期发送 ping 消息来维持连接
   - 用于检测无响应的节点
   - 有助于及早发现网络问题或节点故障

4. **生产环境建议**: 应该在生产环境中启用，以便更好地进行故障检测。

5. **网络环境考虑**:
   - 低延迟网络：可使用 `15s` 或 `20s`
   - 一般环境：推荐使用 `30s`
   - 高延迟或跨数据中心网络：可使用 `60s` 或更长

6. **与故障检测配合**: 此配置与集群的故障检测机制配合工作，确保节点间连接的健康状态。