ClickHouse Managed Postgres 메트릭 참고

이 페이지에는 ClickHouse Managed Postgres Prometheus 엔드포인트에서 노출되는 모든 메트릭이 나열되어 있습니다. 설정 및 인증에 대해서는 Prometheus 엔드포인트 페이지를 참조하십시오.

공통 레이블

모든 메트릭에는 다음 레이블이 포함됩니다.

일부 메트릭에는 구분 기준이 되는 차원에 대한 레이블이 추가로 포함됩니다(예: CPU 메트릭의 mode, 연결의 state, 데이터베이스 크기의 database). 이러한 레이블은 각 메트릭과 함께 나열됩니다.

PostgresServiceInfo는 값이 항상 1인 게이지로, 레이블에 서비스의 현재 상태와 버전이 포함됩니다. 이를 사용해 다른 메트릭에 상태를 조인하거나, 서비스가 running 상태를 벗어날 때 알림을 설정할 수 있습니다.

메트릭	유형	추가 레이블	설명
`PostgresServiceInfo`	gauge	`postgres_status`, `postgres_version`	서비스마다 하나의 series가 있으며 값은 항상 `1`입니다.

postgres_status는 서비스의 현재 수명 주기 상태를 나타냅니다 (예: running, creating, stopped). postgres_version은 Postgres의 메이저 버전(예: 17, 18)을 나타냅니다.

서비스에 프로비저닝된 정적 한도입니다. 이 값은 서비스 크기를 조정할 때만 변경됩니다.

메트릭	유형	단위	설명
`PostgresServer_CPUCores`	gauge	cores	서비스에 할당된 CPU 코어 수입니다.
`PostgresServer_MemoryLimitBytes`	gauge	bytes	서비스에 할당된 메모리입니다.
`PostgresServer_StorageLimitBytes`	gauge	bytes	서비스에 할당된 스토리지입니다.

메트릭	유형	추가 레이블	설명
`PostgresServer_CPUSeconds_Total`	counter	`mode`	사용된 CPU 시간이며, 모드별로 구분됩니다: `user`, `system`, `iowait`, `softirq`, `steal`, `irq`, `nice`, `idle`.
`PostgresServer_MemoryUsedPercent`	gauge		사용 중인 메모리로, `PostgresServer_MemoryLimitBytes` 대비 백분율입니다.
`PostgresServer_MemoryCachePercent`	gauge		캐시와 버퍼가 사용하는 메모리로, 전체 메모리 대비 백분율입니다.
`PostgresServer_FilesystemUsedPercent`	gauge		사용된 파일 시스템 공간으로, 전체 스토리지 대비 백분율입니다.

CPU 사용률을 백분율로 계산하려면, 확인하려는 모드에 대한 PostgresServer_CPUSeconds_Total의 rate를 구한 다음 PostgresServer_CPUCores로 나누십시오.

메트릭	유형	단위	설명
`PostgresServer_DiskReads_Total`	counter	ops	완료된 디스크 읽기 작업 수
`PostgresServer_DiskWrites_Total`	counter	ops	완료된 디스크 쓰기 작업 수
`PostgresServer_NetworkReceiveBytes_Total`	counter	bytes	네트워크를 통해 수신한 바이트 수
`PostgresServer_NetworkTransmitBytes_Total`	counter	bytes	네트워크를 통해 전송한 바이트 수

서비스 시작 이후 누적된 카운터입니다. rate() 또는 irate()를 사용해 초당 값으로 변환합니다.

메트릭	유형	설명
`PostgresServer_TuplesFetched_Total`	counter	쿼리가 가져온 행 수입니다.
`PostgresServer_TuplesInserted_Total`	counter	삽입된 행 수입니다.
`PostgresServer_TuplesUpdated_Total`	counter	업데이트된 행 수입니다.
`PostgresServer_TuplesDeleted_Total`	counter	삭제된 행 수입니다.
`PostgresServer_TransactionsCommitted_Total`	counter	커밋된 트랜잭션 수입니다.
`PostgresServer_TransactionsRolledBack_Total`	counter	롤백된 트랜잭션 수입니다.
`PostgresServer_Deadlocks_Total`	counter	감지된 데드락 수입니다.

메트릭	유형	추가 레이블	설명
`PostgresServer_ActiveConnections`	gauge	`state`	상태별 연결 수입니다(예: `active`, `idle`).
`PostgresServer_CacheHitRatio`	gauge		버퍼 캐시 적중률입니다. 전체 접근 블록 수 대비 캐시에서 제공된 블록 수의 비율을 백분율로 나타냅니다.
`PostgresServer_DatabaseSizeBytes`	gauge	`database`	각 데이터베이스의 디스크 크기(바이트)입니다. `postgres` 기본 데이터베이스와 사용자가 생성한 모든 데이터베이스를 포함합니다.