> ## 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.

> Esta tabela contém métricas dimensionais que podem ser calculadas instantaneamente e exportadas no formato Prometheus. Ela está sempre atualizada.

# system.dimensional_metrics

<Info>
  **Consultas no ClickHouse Cloud**

  Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função `clusterAllReplicas`. Consulte [aqui](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
</Info>

## Descrição

Esta tabela contém métricas dimensionais que podem ser calculadas instantaneamente e exportadas em formato Prometheus. Ela está sempre atualizada.

## Descrição das métricas

### merge\_failures

Número total de merges com falha desde a inicialização.

### startup\_scripts\_failure\_reason

Indica falhas em scripts de inicialização por tipo de erro. É definida como 1 quando um script de inicialização falha, com o nome do erro como rótulo.

### merge\_tree\_parts

Número de partes de dados do MergeTree, identificadas pelo estado da parte, pelo tipo da parte e por serem ou não partes de projeção.

### `filesystem_cache_evictions_total`

Número de segmentos de arquivo removidos de um cache do sistema de arquivos, identificado pelo nome do cache. Desativado por padrão; habilite com `expose_prometheus_eviction_metrics`.

### `filesystem_cache_evicted_bytes_total`

Total de bytes de segmentos de arquivo removidos de um cache do sistema de arquivos, identificado pelo nome do cache. Desativada por padrão; habilite com `expose_prometheus_eviction_metrics`.

### `filesystem_cache_evictions_by_user_total`

Número de segmentos de arquivo removidos de um cache do sistema de arquivos, identificados pelo nome do cache e pelo ID do usuário. Desativado por padrão; habilite com `expose_prometheus_eviction_metrics` e `expose_prometheus_eviction_metrics_per_user`.

### `filesystem_cache_evicted_bytes_by_user_total`

Total de bytes de segmentos de arquivo removidos de um cache do sistema de arquivos, identificados pelo nome do cache e pelo ID do usuário. Desativado por padrão; habilite com `expose_prometheus_eviction_metrics` e `expose_prometheus_eviction_metrics_per_user`.

### `object_storage_queue_failures_total`

Número de falhas de `ObjectStorageQueue` (`S3Queue`/`AzureQueue`), identificado por database, table, estágio de processamento (`read`, `set_processing`, `insert`, `commit`) e código de erro.

### `object_storage_queue_permanently_failed_files_total`

Número de arquivos do `ObjectStorageQueue` (`S3Queue`/`AzureQueue`) abandonados permanentemente após esgotarem as tentativas (ou quando as tentativas estão desabilitadas), identificados por banco de dados e tabela. Cada um representa um arquivo cujos dados nunca serão processados.

### `object_storage_queue_newest_seen_object_timestamp_seconds`

Timestamp Unix da última modificação do objeto mais recente visto até o momento por uma tabela `ObjectStorageQueue` (`S3Queue`/`AzureQueue`), identificado por banco de dados e tabela.

### `object_storage_queue_newest_committed_object_timestamp_seconds`

Timestamp Unix da última modificação do objeto mais recente totalmente processado até o momento por uma tabela `ObjectStorageQueue` (`S3Queue`/`AzureQueue`), identificado por banco de dados e tabela.

## Colunas

* `metric` ([String](/pt-BR/reference/data-types/string)) — Nome da métrica.
* `value` ([Float64](/pt-BR/reference/data-types/float)) — Valor da métrica.
* `description` ([String](/pt-BR/reference/data-types/string)) — Descrição da métrica.
* `labels` ([Map(String, String)](/pt-BR/reference/data-types/map)) — Labels da métrica.

**Aliases:**

* `name` — Alias de `metric`.

## Exemplo

Você pode usar uma consulta como esta para exportar todas as métricas dimensionais no formato 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
```

## Veja também

* [system.asynchronous\_metrics](/pt-BR/reference/system-tables/asynchronous_metrics) — Contém métricas calculadas periodicamente.
* [system.events](/pt-BR/reference/system-tables/events) — Contém diversos eventos que ocorreram.
* [system.metric\_log](/pt-BR/reference/system-tables/metric_log) — Contém um histórico dos valores das métricas das tabelas `system.metrics` e `system.events`.
* [Monitoramento](/pt-BR/guides/oss/deployment-and-scaling/monitoring/monitoring) — Conceitos básicos de monitoramento no ClickHouse.