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
      }
    ]
  }
}

15 TSDB 어드민 API

이는 고급 사용자를 위한 데이터베이스 기능을 제공하는 API입니다. 이 API는 --web.enable-admin-api가 세팅되지 않으면 활성화되지 않습니다.

15.1 스냅샷

스냅샷은 모든 현재 데이터의 스냅샷을 TSDB의 데이터 디렉토리 아래의 snapshots/<datetime>-<rand>에 생성하고 해당 디렉토리를 응답으로 반환합니다. 선택적으로 헤드 블록에만 존재하고 아직 디스크에 압축되지 않은 데이터 스냅샷은 건너뜁니다.

POST /api/v1/admin/tsdb/snapshot
PUT /api/v1/admin/tsdb/snapshot

URL 쿼리 파라미터:

• skip_head=<bool>: 헤드 블록에 있는 데이터를 건너뜁니다. 선택적.

$ curl -XPOST http://localhost:9090/api/v1/admin/tsdb/snapshot
{
  "status": "success",
  "data": {
    "name": "20171210T211224Z-2be650b6d019eb54"
  }
}

이제 스냅샷은 <data-dir>/snapshots/20171210T211224Z-2be650b6d019eb54에 있습니다.

18 참고

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