Prometheus 协议

暴露指标

备注

如果您正在使用 ClickHouse Cloud，您可以使用 Prometheus 集成 将指标暴露给 Prometheus。

ClickHouse 可以暴露其自身的指标以供 Prometheus 抓取：

设置：

名称	默认	描述
port	none	用于提供暴露指标协议的端口。
endpoint	/metrics	Prometheus 服务器抓取指标的 HTTP 端点。以 / 开头。与 <handlers> 部分不应同时使用。
url / headers / method	none	用于根据请求查找匹配处理程序的过滤器。类似于 <http_handlers> 部分中同名字段的功能。
metrics	true	从 system.metrics 表中暴露指标。
asynchronous_metrics	true	从 system.asynchronous_metrics 表中暴露当前指标值。
events	true	从 system.events 表中暴露指标。
errors	true	暴露自上次服务器重启以来按错误代码发生的错误数量。这些信息也可以从 system.errors 中获取。

检查（将 127.0.0.1 替换为您的 ClickHouse 服务器的 IP 地址或主机名）：

远程写入协议

ClickHouse 支持 remote-write 协议。 数据通过此协议接收并写入一个 TimeSeries 表（该表应预先创建）。

设置：

名称	默认	描述
port	none	用于提供 remote-write 协议的端口。
url / headers / method	none	用于根据请求查找匹配处理程序的过滤器。类似于 <http_handlers> 部分中同名字段的功能。
table	none	用于写入通过 remote-write 协议接收的数据的 TimeSeries 表的名称。此名称可以选择性地包含数据库的名称。
database	none	表示在 table 设置中指定的表位置的数据库名称（如果它未在 table 设置中指定）。

远程读取协议

ClickHouse 支持 remote-read 协议。 数据从 TimeSeries 表中读取，并通过此协议发送。

设置：

名称	默认	描述
port	none	用于提供 remote-read 协议的端口。
url / headers / method	none	用于根据请求查找匹配处理程序的过滤器。类似于 <http_handlers> 部分中同名字段的功能。
table	none	用于通过 remote-read 协议发送数据的 TimeSeries 表的名称。此名称可以选择性地包含数据库的名称。
database	none	表示在 table 设置中指定的表位置的数据库名称（如果它未在 table 设置中指定）。

多协议配置

可以在一个地方同时指定多个协议：