> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

# system.dimensional_metrics

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

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

<div id="description">
  ## 설명
</div>

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

<div id="columns">
  ## 컬럼
</div>

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

<div id="example">
  ## 예시
</div>

다음과 같은 쿼리를 사용하면 모든 차원형 메트릭을 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
```

<div id="metric_descriptions">
  ## 메트릭 설명
</div>

<div id="merge_failures">
  ### merge\_failures
</div>

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

<div id="startup_scripts_failure_reason">
  ### startup\_scripts\_failure\_reason
</div>

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

<div id="merge_tree_parts">
  ### merge\_tree\_parts
</div>

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

<div id="filesystem-cache-evictions-total">
  ### `filesystem_cache_evictions_total`
</div>

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

<div id="filesystem-cache-evicted-bytes-total">
  ### `filesystem_cache_evicted_bytes_total`
</div>

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

<div id="filesystem-cache-evictions-by-user-total">
  ### `filesystem_cache_evictions_by_user_total`
</div>

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

<div id="filesystem-cache-evicted-bytes-by-user-total">
  ### `filesystem_cache_evicted_bytes_by_user_total`
</div>

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

<div id="see-also">
  ## 관련 항목
</div>

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