配置用于指标的 HTTP 端点
编辑配置用于指标的 HTTP 端点
编辑此功能为技术预览版，未来版本中可能会更改或删除。Elastic 将努力修复任何问题，但技术预览版中的功能不受官方 GA 功能的支持 SLA 约束。
Filebeat 可以通过 HTTP 端点公开内部指标。这些指标有助于监控 Beat 的内部状态。出于安全原因，默认情况下禁用该端点，因为您可能希望避免公开此信息。
HTTP 端点具有以下配置设置
-
http.enabled - （可选）启用 HTTP 端点。默认为
false。 -
http.host - （可选）绑定到此主机名、IP 地址、Unix 套接字（unix:///var/run/filebeat.sock）或 Windows 命名管道（npipe:///filebeat）。建议仅使用 localhost。默认为
localhost -
http.port - （可选）HTTP 端点将绑定到的端口。默认为
5066。 -
http.named_pipe.user - （可选）用于创建命名管道的用户，仅在 Windows 上有效，默认为当前用户。
-
http.named_pipe.security_descriptor - （可选）以 SDDL 格式定义的 Windows 安全描述符字符串。默认为当前用户的读写权限。
-
http.pprof.enabled - （可选）启用提供 HTTP 服务时的
/debug/pprof/端点。建议仅在 localhost 上启用此项，因为这些端点可能会泄漏数据。默认为false。 -
http.pprof.block_profile_rate - （可选）
block_profile_rate控制在/debug/pprof/block中提供的阻塞配置文件中报告的 goroutine 阻塞事件的比例。分析器旨在对每个阻塞纳秒花费的平均阻塞事件进行采样。要在配置文件中包含每个阻塞事件，请传递 rate = 1。要完全关闭分析，请传递 rate ⇐ 0。默认为 0。 -
http.pprof.mem_profile_rate - （可选）
mem_profile_rate控制在/debug/pprof/heap中提供的内存配置文件中记录和报告的内存分配比例。分析器旨在对每个分配的mem_profile_rate字节的平均分配进行采样。要在配置文件中包含每个分配的块，请将mem_profile_rate设置为 1。要完全关闭分析，请将mem_profile_rate设置为 0。默认为 524288。 -
http.pprof.mutex_profile_rate - （可选）
mutex_profile_rate控制在/debug/pprof/mutex中提供的互斥锁配置文件中报告的互斥锁争用事件的比例。平均报告 1/rate 事件。要完全关闭分析，请传递 rate 0。默认值为 0。
这是您可以访问的路径列表。要获得漂亮的 JSON 输出，请将 ?pretty 附加到 URL。
您可以使用 cURL 命令和 --unix-socket 标志查询 Unix 套接字。
curl -XGET --unix-socket '/var/run/{beatname_lc}.sock' 'http:/stats/?pretty'
信息
编辑/ 提供来自 Filebeat 的基本信息。示例
curl -XGET 'localhost:5066/?pretty'
{
"beat": "filebeat",
"hostname": "example.lan",
"name": "example.lan",
"uuid": "34f6c6e1-45a8-4b12-9125-11b3e6e89866",
"version": "8.17.0"
}
统计
编辑/stats 报告内部指标。示例
curl -XGET 'localhost:5066/stats?pretty'
{
"beat": {
"cpu": {
"system": {
"ticks": 1710,
"time": {
"ms": 1712
}
},
"total": {
"ticks": 3420,
"time": {
"ms": 3424
},
"value": 3420
},
"user": {
"ticks": 1710,
"time": {
"ms": 1712
}
}
},
"info": {
"ephemeral_id": "ab4287c4-d907-4d9d-b074-d8c3cec4a577",
"uptime": {
"ms": 195547
}
},
"memstats": {
"gc_next": 17855152,
"memory_alloc": 9433384,
"memory_total": 492478864,
"rss": 50405376
},
"runtime": {
"goroutines": 22
}
},
"libbeat": {
"config": {
"module": {
"running": 0,
"starts": 0,
"stops": 0
},
"scans": 1,
"reloads": 1
},
"output": {
"events": {
"acked": 0,
"active": 0,
"batches": 0,
"dropped": 0,
"duplicates": 0,
"failed": 0,
"total": 0
},
"read": {
"bytes": 0,
"errors": 0
},
"type": "elasticsearch",
"write": {
"bytes": 0,
"errors": 0
}
},
"pipeline": {
"clients": 6,
"events": {
"active": 716,
"dropped": 0,
"failed": 0,
"filtered": 0,
"published": 716,
"retry": 278,
"total": 716
},
"queue": {
"acked": 0
}
}
},
"system": {
"cpu": {
"cores": 4
},
"load": {
"1": 2.22,
"15": 1.8,
"5": 1.74,
"norm": {
"1": 0.555,
"15": 0.45,
"5": 0.435
}
}
}
}
实际输出可能包含更多特定于 Filebeat 的指标
输入
编辑/inputs/ 返回与输入实例相关的指标。它返回一个对象列表，其中每个对象包含输入实例的指标。每个对象将至少包含一个 input 字段，用于标识输入类型（例如 aws-s3），以及一个 id 字段，它是输入实例的唯一标识符。
请求可以选择指定 type 查询参数，以请求特定类型的输入的指标。并且可以包含 pretty 以使返回的 JSON 格式化美观。
curl 'https://127.0.0.1:5066/inputs/' curl 'https://127.0.0.1:5066/inputs/?pretty' curl 'https://127.0.0.1:5066/inputs/?type=aws-s3&pretty'