Chuyển đến nội dung chính

​
Mô tả

Probe ping kiểm tra host có reachable không bằng ICMP echo (unprivileged datagram socket). Nếu ICMP không khả dụng (thiếu CAP_NET_RAW hoặc net.ipv4.ping_group_range không bao gồm user chạy agent), probe tự động fallback sang TCP connect.

​
Config fields

FieldTypeBắt buộcDefaultMô tả
typestringCó—Phải là "ping"
hoststringCó—Host hoặc IP cần ping
countintKhông3Số lần ping (1–10). Giá trị > 10 bị clamp về 10
methodstringKhông"" (auto)"icmp": chỉ dùng ICMP. "tcp_fallback": chỉ dùng TCP. Để trống: thử ICMP trước, fallback TCP nếu thất bại
fallbackPortintKhông443TCP port dùng khi fallback (1–65535)

​
Metrics

MetricTypeUnitLabelsMô tả
vms.ping.statusstatus—methodup hoặc down
vms.ping.latency_msgaugemsmethodLatency trung bình
vms.agent.permission_missinggauge—capability=CAP_NET_RAWEmit khi ICMP bị chặn và probe chạy bằng TCP fallback
Label method có giá trị "icmp" hoặc "tcp_fallback".

​
Ví dụ config

{
  "type": "ping",
  "host": "10.0.0.10",
  "count": 3,
  "fallbackPort": 443
}
Bắt buộc TCP fallback (bỏ qua ICMP): 
{
  "type": "ping",
  "host": "10.0.0.10",
  "method": "tcp_fallback",
  "fallbackPort": 80
}

​
Lưu ý

  • ICMP unavailable được detect 1 lần khi khởi tạo, không probe lại mỗi lần chạy.
  • Khi ICMP bị chặn, probe log warning 1 lần và emit vms.agent.permission_missing{capability=CAP_NET_RAW} mỗi lần chạy để gap hiển thị trên dashboard.
  • Để bật ICMP native trên Linux: cấp CAP_NET_RAW cho binary hoặc mở rộng net.ipv4.ping_group_range.