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_include 和 metrics_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 进程状态字段参考表
| Statecode | Statename | 描述 |
|---|---|---|
| 0 | STOPPED | 进程由于停止请求而被停止,或者从未启动过。 |
| 10 | STARTING | 进程由于启动请求正在启动。 |
| 20 | RUNNING | 进程正在运行。 |
| 30 | BACKOFF | 进程进入 STARTING 状态,但随后退出过快,未能进入 RUNNING 状态。 |
| 40 | STOPPING | 进程由于停止请求正在停止。 |
| 100 | EXITED | 进程已从 RUNNING 状态退出(预期或非预期)。 |
| 200 | FATAL | 进程未能成功启动。 |
| 1000 | UNKNOWN | 进程处于未知状态(supervisord 编程错误)。 |
Supervisor 实例状态字段参考
| Statecode | Statename | 描述 |
|---|---|---|
| 2 | FATAL | Supervisor 遇到严重错误。 |
| 1 | RUNNING | Supervisor 正常工作。 |
| 0 | RESTARTING | Supervisor 正在重启。 |
| -1 | SHUTDOWN | Supervisor 正在关闭。 |
示例输出
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此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。