Prometheus Metrics 的响应格式是一种文本格式,称为“纯文本格式(Plain Text Format)”,也被称为“指标格式(Metric Format)”。该格式使用 ASCII 字符表示度量指标数据,并包含以下三个部分:
- 注释行:以 # 开头的注释行,用于描述度量指标的信息和上下文。
- 类型声明行:以 #TYPE 开头的声明行,用于声明每个度量指标的类型(例如计数器、测量值等)。
- 指标行:度量指标数据按照每行一个指标进行排列。
以下是一个示例 Prometheus Metrics 响应:
# HELP http_requests_total The total number of HTTP requests.
# TYPE http_requests_total counter
http_requests_total{method="GET",handler="/api/v1/status"} 213
http_requests_total{method="POST",handler="/api/v1/users"} 78
http_requests_total{method="DELETE",handler="/api/v1/users/123"} 5
在此示例中,第一行是注释行,描述了 http_requests_total
度量指标的信息。第二行是类型声明行,它将 http_requests_total
标记为计数器类型。后续三个行包含实际的度量值数据,每个度量值由其对应的标签和值组成。