SNMP 和 Cortex 集成

输入和输出集成概述

SNMP 插件允许您从 SNMP（简单网络管理协议）代理收集各种指标。 它在如何检索数据方面提供了灵活性，无论是收集单个指标还是整个表。

此插件使 Telegraf 能够使用 Prometheus 远程写入协议将指标发送到 Cortex，从而可以无缝地摄取到 Cortex 的可扩展、多租户时间序列存储中。

集成详情

SNMP

此插件使用轮询从 SNMP 代理收集指标，支持检索单个 OID 和完整的 SNMP 表。 它可以配置为处理多个 SNMP 版本、身份验证和其他功能。

Cortex

借助 Telegraf 的 HTTP 输出插件和 prometheusremotewrite 数据格式，您可以将指标直接发送到 Cortex，Cortex 是 Prometheus 的水平可扩展长期存储后端。 Cortex 支持多租户，并接受使用 Prometheus protobuf 格式的远程写入请求。 通过使用 Telegraf 作为收集代理，并使用 Remote Write 作为传输机制，组织可以将可观测性扩展到 Prometheus 本身不支持的来源（例如 Windows 主机、支持 SNMP 的设备或自定义应用程序指标），同时利用 Cortex 的高可用性和长期保留功能。

配置

SNMP

[[inputs.snmp]]
  agents = ["udp://127.0.0.1:161"]

  [[inputs.snmp.field]]
    oid = "RFC1213-MIB::sysUpTime.0"
    name = "sysUptime"
    conversion = "float(2)"

  [[inputs.snmp.field]]
    oid = "RFC1213-MIB::sysName.0"
    name = "sysName"
    is_tag = true

  [[inputs.snmp.table]]
    oid = "IF-MIB::ifTable"
    name = "interface"
    inherit_tags = ["sysName"]

    [[inputs.snmp.table.field]]
      oid = "IF-MIB::ifDescr"
      name = "ifDescr"
      is_tag = true

Cortex

[[outputs.http]]
  ## Cortex Remote Write endpoint
  url = "http://cortex.example.com/api/v1/push"

  ## Use POST to send data
  method = "POST"

  ## Send metrics using Prometheus remote write format
  data_format = "prometheusremotewrite"

  ## Optional HTTP headers for authentication
  # [outputs.http.headers]
  #   X-Scope-OrgID = "your-tenant-id"
  #   Authorization = "Bearer YOUR_API_TOKEN"

  ## Optional TLS configuration
  # tls_ca = "/path/to/ca.pem"
  # tls_cert = "/path/to/cert.pem"
  # tls_key = "/path/to/key.pem"
  # insecure_skip_verify = false

  ## Request timeout
  timeout = "10s"

输入和输出集成示例

SNMP

1. 基本 SNMP 配置：使用典型的 SNMP 社区字符串设置从本地 SNMP 代理收集指标。 此设置非常适合本地设备性能监控。
2. 高级 SNMPv3 设置：使用 SNMPv3 通过身份验证和加密安全地收集指标，以增强安全性。 建议在生产环境中使用此配置。
3. 收集接口指标：配置插件以从设备的 SNMP 表中收集接口指标。 利用字段捕获用于流量分析的特定数据点。
4. 连接两个 SNMP 表：通过使用转换字段，连接来自两个 SNMP 表的数据，以全面了解相关的性能指标。

Cortex

1. 统一的多租户监控：使用 Telegraf 从不同的团队或环境收集指标，并使用单独的 X-Scope-OrgID 标头将其推送到 Cortex。 这实现了每个租户的隔离数据摄取和查询，非常适合托管服务和平台团队。

2. 将 Prometheus 覆盖范围扩展到边缘设备：在边缘或物联网设备上部署 Telegraf 以收集系统指标，并将它们发送到集中的 Cortex 集群。 即使对于没有本地 Prometheus 抓取器的环境，这种方法也能确保一致的可观测性。

3. 具有联合租户的全球服务可观测性：通过配置 Telegraf 代理将数据推送到区域 Cortex 集群（每个集群都标有租户标识符）来聚合来自全球基础设施的指标。 Cortex 处理跨区域的重复数据删除和集中访问。

4. 自定义应用程序遥测管道：通过 Telegraf 的 exec 或 http 输入插件收集特定于应用程序的遥测数据，并将其转发到 Cortex。 这使 DevOps 团队能够以可扩展、查询高效的格式监控特定于应用程序的 KPI，同时保持指标按租户或服务进行逻辑分组。

反馈

感谢您成为我们社区的一份子！ 如果您有任何一般性反馈或在这些页面上发现任何错误，我们欢迎并鼓励您提出意见。 请在 InfluxDB 社区 Slack 中提交您的反馈。