Prometheus 문서/쿼리/HTTP API 편집하기

==개요==
;HTTP API

==포맷 개요==
==표현식 쿼리==
===인스턴트 쿼리===
===범위 쿼리===
==쿼리 표현식 포맷팅==
==메타데이터 쿼리하기==
===레이블 매처로 시리즈 찾기===
===레이블 이름 얻기===
===레이블 값 쿼리하기===
==이그젬플러 쿼리==
==표현식 쿼리 결과 포맷==
===범위 벡터===
===인스턴트 벡터===
===스칼라===
===문자열===
===네이티브 히스토그램===
==타겟==
==규칙==
==경보==
==타겟 메타데이터 쿼리하기==
==메트릭 메타데이터 쿼리하기==
==경보매니저==
==상태==
===설정===
===플래그===
===런타임 정보===
===빌드 정보===
===TSDB 통계===
다음 엔드포인트는 Prometheus TSDB에 대한 다양한 카디널리티 통계를 반환합니다.

<syntaxhighlight lang='text'>
GET /api/v1/status/tsdb
</syntaxhighlight>

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

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

<syntaxhighlight lang='console'>
$ 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
      }
    ]
  }
}
</syntaxhighlight>

===WAL 리플레이 통계===
==TSDB 어드민 API==
이는 고급 사용자를 위한 데이터베이스 기능을 제공하는 API입니다. 이 API는 <code>--web.enable-admin-api</code>가 세팅되지 않으면 활성화되지 않습니다.

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

<syntaxhighlight lang='text'>
POST /api/v1/admin/tsdb/snapshot
PUT /api/v1/admin/tsdb/snapshot
</syntaxhighlight>

URL 쿼리 파라미터:
* <code>skip_head=<bool></code>: 헤드 블록에 있는 데이터를 건너뜁니다. 선택적.

<syntaxhighlight lang='console'>
$ curl -XPOST http://localhost:9090/api/v1/admin/tsdb/snapshot
{
  "status": "success",
  "data": {
    "name": "20171210T211224Z-2be650b6d019eb54"
  }
}
</syntaxhighlight>

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

===시리즈 삭제===
===툼스톤 청소===

==원격 쓰기 수신기==
==OTLP 수신기==
==참고==
* https://prometheus.io/docs/prometheus/latest/querying/api/

[[분류: Prometheus 문서]]
[[분류: Prometheus API]]