Prometheus 문서/쿼리/HTTP API

1 개요

HTTP API

14 상태

14.5 TSDB 통계

다음 엔드포인트는 Prometheus TSDB에 대한 다양한 카디널리티 통계를 반환합니다.

GET /api/v1/status/tsdb

URL 쿼리 파라미터: - limit=<number>: 반환된 항목 수를 각 통계 세트에 대해 지정된 수로 제한합니다. 기본적으로 10개의 항목이 반환됩니다.

data 쿼리 결과 섹션은 다음으로 구성됩니다.

• headStats: TSDB의 헤드 블록에 대한 다음 데이터를 제공합니다.
• numSeries: 시리즈 수입니다.
• ChunkCount : 청크의 개수입니다.
• minTime: 현재 최소 타임스탬프(밀리초)입니다.
• maxTime: 현재 최대 타임스탬프(밀리초)입니다.
• seriesCountByMetricName: 지표 이름 및 해당 계열 수 목록을 제공합니다.
• labelValueCountByLabelName: 레이블 이름과 해당 값 개수 목록을 제공합니다.
• memoryInBytesByLabelName: 바이트 단위로 사용되는 레이블 이름 및 메모리 목록을 제공합니다. 메모리 사용량은 지정된 레이블 이름에 대한 모든 값의 길이를 더하여 계산됩니다.
• seriesCountByLabelPair""": 레이블 값 쌍 및 해당 계열 수 목록을 제공합니다.

$ curl http://localhost:9090/api/v1/status/tsdb
{
  "status": "success",
  "data": {
    "headStats": {
      "numSeries": 508,
      "chunkCount": 937,
      "minTime": 1591516800000,
      "maxTime": 1598896800143,
    },
    "seriesCountByMetricName": [
      {
        "name": "net_conntrack_dialer_conn_failed_total",
        "value": 20
      },
      {
        "name": "prometheus_http_request_duration_seconds_bucket",
        "value": 20
      }
    ],
    "labelValueCountByLabelName": [
      {
        "name": "__name__",
        "value": 211
      },
      {
        "name": "event",
        "value": 3
      }
    ],
    "memoryInBytesByLabelName": [
      {
        "name": "__name__",
        "value": 8266
      },
      {
        "name": "instance",
        "value": 28
      }
    ],
    "seriesCountByLabelValuePair": [
      {
        "name": "job=prometheus",
        "value": 425
      },
      {
        "name": "instance=localhost:9090",
        "value": 425
      }
    ]
  }
}

18 참고

• https://prometheus.io/docs/prometheus/latest/querying/api/