文档文档

Supervisor 输入插件

此插件使用 XML-RPC API 收集有关在 supervisord 下运行的进程的信息。

此插件需要 supervisor v3.3.2+。

引入版本: Telegraf v1.24.0 标签: applications 操作系统支持: all

全局配置选项

插件支持其他全局和插件配置设置,用于修改指标、标签和字段,创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md

配置

# Gathers information about processes that running under supervisor using XML-RPC API
[[inputs.supervisor]]
  ## Url of supervisor's XML-RPC endpoint if basic auth enabled in supervisor http server,
  ## than you have to add credentials to url (ex. http://login:pass@localhost:9001/RPC2)
  # url="https://:9001/RPC2"
  ## With settings below you can manage gathering additional information about processes
  ## If both of them empty, then all additional information will be collected.
  ## Currently supported supported additional metrics are: pid, rc
  # metrics_include = []
  # metrics_exclude = ["pid", "rc"]

Supervisor 配置

此插件需要在 supervisor 中启用 HTTP 服务器。建议在 HTTP 服务器上启用基本身份验证。使用基本身份验证时,请确保在插件的 url 设置中包含用户名和密码。以下是 supervisor 配置中与默认插件配置配合使用的 inet_http_server 部分示例。

[inet_http_server]
port = 127.0.0.1:9001
username = user
password = pass

可选指标

您可以通过在配置文件中设置 metrics_includemetrics_exclude 参数来控制收集 supervisor 的某些指标(进程 PID 和退出码)。

服务器标签

服务器标签用于标识指标源服务器。您可以选择使用 supervisor 的 http 端点的 host:port 对作为默认值,或者使用 supervisor 的标识字符串,该字符串在 supervisor 的配置文件中设置。

Metrics

  • supervisor_processes

    • 标签
      • source (supervisor 实例的主机名或 IP 地址)
      • port (supervisor HTTP 服务器的端口号)
      • id (Supervisor 的标识字符串)
      • name (进程名称)
      • group (进程组)
    • 字段
      • state (整数,参见参考)
      • uptime (整数,秒)
      • pid (整数,可选)
      • exitCode (整数,可选)
  • supervisor_instance

    • 标签
      • source (supervisor 实例的主机名或 IP 地址)
      • port (supervisor HTTP 服务器的端口号)
      • id (Supervisor 的标识字符串)
    • 字段
      • state (整数,参见参考)

Supervisor 进程状态字段参考表

StatecodeStatename描述
0STOPPED进程由于停止请求而被停止,或者从未启动过。
10STARTING进程由于启动请求正在启动。
20RUNNING进程正在运行。
30BACKOFF进程进入 STARTING 状态,但随后退出过快,未能进入 RUNNING 状态。
40STOPPING进程由于停止请求正在停止。
100EXITED进程已从 RUNNING 状态退出(预期或非预期)。
200FATAL进程未能成功启动。
1000UNKNOWN进程处于未知状态(supervisord 编程错误)。

Supervisor 实例状态字段参考

StatecodeStatename描述
2FATALSupervisor 遇到严重错误。
1RUNNINGSupervisor 正常工作。
0RESTARTINGSupervisor 正在重启。
-1SHUTDOWNSupervisor 正在关闭。

示例输出

supervisor_processes,group=ExampleGroup,id=supervisor,port=9001,process=ExampleProcess,source=localhost state=20i,uptime=75958i 1659786637000000000
supervisor_instance,id=supervisor,port=9001,source=localhost state=1i 1659786637000000000

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2