> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 이 테이블에는 즉시 계산하여 Prometheus 포맷으로 내보낼 수 있는 차원형 메트릭이 포함되어 있습니다. 항상 최신 상태가 유지됩니다.

# system.dimensional_metrics

<Info>
  **ClickHouse Cloud에서 쿼리하기**

  이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
</Info>

## 설명

이 테이블(table)에는 즉시 계산하여 Prometheus 포맷으로 내보낼 수 있는 차원형 메트릭이 포함되어 있습니다. 이 테이블은 항상 최신 상태입니다.

## 메트릭 설명

### merge\_failures

시작 후 지금까지 실패한 모든 머지의 수입니다.

### startup\_scripts\_failure\_reason

오류 유형별로 시작 스크립트 실패를 나타냅니다. 시작 스크립트가 실패하면 값이 1로 설정되며, 오류 이름으로 레이블이 지정됩니다.

### merge\_tree\_parts

파트 상태, 파트 유형, 프로젝션 파트 여부를 레이블로 구분한 MergeTree 데이터 파트 수입니다.

### `filesystem_cache_evictions_total`

파일 시스템 캐시에서 축출된 파일 세그먼트 수로, 캐시 이름별로 레이블이 지정됩니다. 기본적으로 비활성화되어 있으며, `expose_prometheus_eviction_metrics`를 사용해 활성화할 수 있습니다.

### `filesystem_cache_evicted_bytes_total`

파일 시스템 캐시에서 축출된 파일 세그먼트의 총 바이트 수이며, 캐시 이름별로 레이블이 지정됩니다. 기본적으로 비활성화되어 있으며 `expose_prometheus_eviction_metrics`로 활성화할 수 있습니다.

### `filesystem_cache_evictions_by_user_total`

파일 시스템 캐시에서 축출된 파일 세그먼트 수를 나타내는 메트릭으로, 캐시 이름과 사용자 ID별로 레이블이 지정됩니다. 기본적으로 비활성화되어 있으며, `expose_prometheus_eviction_metrics` 및 `expose_prometheus_eviction_metrics_per_user`를 사용해 활성화할 수 있습니다.

### `filesystem_cache_evicted_bytes_by_user_total`

파일 시스템 캐시에서 축출된 파일 세그먼트의 총 바이트 수로, 캐시 이름과 사용자 ID를 레이블로 구분합니다. 기본적으로 비활성화되어 있으므로 `expose_prometheus_eviction_metrics` 및 `expose_prometheus_eviction_metrics_per_user`를 사용해 활성화하십시오.

### `object_storage_queue_failures_total`

데이터베이스, 테이블, 처리 단계(`read`, `set_processing`, `insert`, `commit`), 오류 코드별 `ObjectStorageQueue`(`S3Queue`/`AzureQueue`) 실패 횟수입니다.

### `object_storage_queue_permanently_failed_files_total`

재시도 횟수를 모두 소진했거나 재시도가 비활성화되어 영구적으로 포기된 `ObjectStorageQueue` (`S3Queue`/`AzureQueue`) 파일 수입니다. 데이터베이스와 테이블별로 레이블이 지정되며, 각각의 파일에 포함된 데이터는 더 이상 처리되지 않습니다.

### `object_storage_queue_newest_seen_object_timestamp_seconds`

`ObjectStorageQueue`(`S3Queue`/`AzureQueue`) 테이블에서 현재까지 확인된 가장 최신 객체의 마지막 수정 시각을 나타내는 Unix timestamp입니다. 데이터베이스와 테이블별로 레이블이 지정됩니다.

### `object_storage_queue_newest_committed_object_timestamp_seconds`

데이터베이스와 테이블을 레이블로 지정한 `ObjectStorageQueue`(`S3Queue`/`AzureQueue`) 테이블에서 지금까지 완전히 처리된 가장 최신 객체의 마지막 수정 시각을 나타내는 Unix timestamp입니다.

## 컬럼

* `metric` ([String](/ko/reference/data-types/string)) — 메트릭 이름입니다.
* `value` ([Float64](/ko/reference/data-types/float)) — 메트릭 값입니다.
* `description` ([String](/ko/reference/data-types/string)) — 메트릭 설명입니다.
* `labels` ([Map(String, String)](/ko/reference/data-types/map)) — 메트릭 레이블입니다.

**별칭:**

* `name` — `metric`의 별칭입니다.

## 예시

다음과 같은 쿼리를 사용하면 모든 차원형 메트릭을 Prometheus 포맷으로 내보낼 수 있습니다.

```sql theme={null}
SELECT
  metric AS name,
  toFloat64(value) AS value,
  description AS help,
  labels,
  'gauge' AS type
FROM system.dimensional_metrics
FORMAT Prometheus
```

## 관련 항목

* [system.asynchronous\_metrics](/ko/reference/system-tables/asynchronous_metrics) — 주기적으로 계산된 메트릭을 포함합니다.
* [system.events](/ko/reference/system-tables/events) — 발생한 여러 이벤트를 포함합니다.
* [system.metric\_log](/ko/reference/system-tables/metric_log) — `system.metrics` 및 `system.events` 테이블의 메트릭 값 이력을 포함합니다.
* [모니터링](/ko/guides/oss/deployment-and-scaling/monitoring/monitoring) — ClickHouse 모니터링의 기본 개념을 설명합니다.