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

​
Mô tả

Probe snmp_check poll giá trị OID từ thiết bị hỗ trợ SNMP. Hỗ trợ SNMPv2c (community string) và SNMPv3 (username + auth/privacy). Credential được resolve qua secret reference — không bao giờ log. Build tag vms_heavy.

​
Config fields

FieldTypeBắt buộcDefaultMô tả
typestringCó—Phải là "snmp_check"
hoststringCó—SNMP target host/IP
portintKhông161SNMP port
versionstringCó—"v2c" hoặc "v3"
communitySecretRefstringKhông"public" (v2c)Secret ref cho community string (v2c). Để trống = "public"
usernameSecretRefstringv3: Có—Secret ref cho SNMPv3 username
authProtocolstringKhông—Auth protocol: "md5", "sha", "sha224", "sha256", "sha384", "sha512"
authPasswordSecretRefstringKhi có authProtocol—Secret ref cho auth passphrase
privacyProtocolstringKhông—Privacy protocol: "des", "aes", "aes192", "aes256"
privPasswordSecretRefstringKhi có privacyProtocol—Secret ref cho privacy passphrase
oidsstring[]Có—Danh sách OID cần GET. Ít nhất 1 OID

​
Secret resolution

Secret ref được resolve qua environment variable tại thời điểm khởi tạo probe. Nếu ref được cấu hình nhưng env var tương ứng không set → probe bị skip (lỗi khi khởi tạo) thay vì chạy với credential rỗng.

​
SNMPv3 security levels

authProtocolprivacyProtocolSecurity level
(trống)(trống)NoAuthNoPriv
có giá trị(trống)AuthNoPriv
có giá trịcó giá trịAuthPriv

​
Metrics

MetricTypeLabelsMô tả
vms.snmp.statusstatus—up hoặc down
vms.snmp.valuegaugeoidGiá trị numeric của OID. OID non-numeric bị skip

​
Ví dụ config

SNMPv2c: 
{
  "type": "snmp_check",
  "host": "10.0.0.20",
  "port": 161,
  "version": "v2c",
  "communitySecretRef": "SNMP_COMMUNITY_CORE",
  "oids": ["1.3.6.1.2.1.1.3.0", "1.3.6.1.2.1.2.2.1.10.1"]
}
SNMPv3 AuthPriv: 
{
  "type": "snmp_check",
  "host": "10.0.0.30",
  "version": "v3",
  "usernameSecretRef": "SNMP_V3_USER",
  "authProtocol": "sha256",
  "authPasswordSecretRef": "SNMP_V3_AUTH_PASS",
  "privacyProtocol": "aes256",
  "privPasswordSecretRef": "SNMP_V3_PRIV_PASS",
  "oids": ["1.3.6.1.2.1.1.3.0"]
}

​
Lưu ý

  • Connect fail hoặc timeout → status down, severity warning. Không phải lỗi agent.
  • Chỉ giá trị numeric được emit thành metric gauge. OID trả octet string, IP address, v.v. bị skip.
  • Timeout mặc định 5 giây, bị clamp bởi probe timeout từ scheduler nếu nhỏ hơn.
  • Build tag vms_heavy — không có trong package agent mặc định.