> ## 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` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

## 描述

此表包含可即时计算并以 Prometheus 格式导出的维度指标，且会始终保持最新状态。

## 指标说明

### merge\_failures

自启动以来所有失败 merge 的数量。

### startup\_scripts\_failure\_reason

按错误类型指示启动脚本失败情况。当启动脚本失败时，该值设为 1，并带有错误名称标记。

### merge\_tree\_parts

MergeTree 数据分区片段的数量，按分区片段状态、分区片段类型以及是否为投影分区片段区分。

### `filesystem_cache_evictions_total`

从文件系统缓存中逐出的 File 段数量，按缓存名称标记。默认禁用；可通过 `expose_prometheus_eviction_metrics` 启用。

### `filesystem_cache_evicted_bytes_total`

从文件系统缓存中被逐出的 File 段总字节数，按缓存名称加标签。默认禁用；可通过 `expose_prometheus_eviction_metrics` 启用。

### `filesystem_cache_evictions_by_user_total`

从文件系统缓存中逐出的 File 段数量，按缓存名称和用户 ID 标记。默认禁用；可通过 `expose_prometheus_eviction_metrics` 和 `expose_prometheus_eviction_metrics_per_user` 启用。

### `filesystem_cache_evicted_bytes_by_user_total`

从文件系统缓存中淘汰的 File 段总字节数，按缓存名称和用户 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 时间戳，按数据库和表标记。

### `object_storage_queue_newest_committed_object_timestamp_seconds`

截至目前由 `ObjectStorageQueue` (`S3Queue`/`AzureQueue`) 表完全处理的最新对象的最后修改时间的 Unix 时间戳，按数据库和表标记。

## 列

* `metric` ([String](/zh/reference/data-types/string)) — 指标名称。
* `value` ([Float64](/zh/reference/data-types/float)) — 指标值。
* `description` ([String](/zh/reference/data-types/string)) — 指标说明。
* `labels` ([Map(String, String)](/zh/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](/zh/reference/system-tables/asynchronous_metrics) — 包含定期计算的指标。
* [system.events](/zh/reference/system-tables/events) — 包含已发生的一系列事件。
* [system.metric\_log](/zh/reference/system-tables/metric_log) — 包含来自表 `system.metrics` 和 `system.events` 的指标值历史记录。
* [监控](/zh/guides/oss/deployment-and-scaling/monitoring/monitoring) — ClickHouse 监控的基本概念。