Referência de métricas

Lista completa das métricas expostas pelo endpoint Prometheus do Managed Postgres

Esta página lista todas as métricas expostas pelo endpoint Prometheus do Managed Postgres. Para configuração e autenticação, consulte a página endpoint Prometheus.

​

Rótulos comuns

Toda métrica inclui os seguintes rótulos:

Rótulo	Descrição
clickhouse_org	ID da organização
postgres_service	ID do serviço Postgres
postgres_service_name	Nome do serviço Postgres

Algumas métricas adicionam um rótulo para a dimensão por que são segmentadas (por exemplo, mode nas métricas de CPU, state nas conexões, database no tamanho do banco de dados). Esses rótulos são listados junto de cada métrica.

​

Métrica de informação

PostgresServiceInfo é uma métrica gauge que sempre tem valor 1 e traz o status e a versão atuais do serviço em seus rótulos. Use-a para associar o status a outras métricas ou para criar um alerta quando um serviço sair do estado running.

Métrica	Tipo	Rótulos extras	Descrição
PostgresServiceInfo	gauge	postgres_status, postgres_version	Uma série por serviço; o valor é sempre 1.

postgres_status informa o estado atual do ciclo de vida do serviço (por exemplo, running, creating, stopped). postgres_version informa a versão principal do Postgres (por exemplo, 17, 18).

​

Capacidade

Limites estáticos provisionados para o serviço. Eles só mudam quando o serviço é redimensionado.

Métrica	Tipo	Unidade	Descrição
PostgresServer_CPUCores	gauge	cores	Núcleos de CPU alocados para o serviço.
PostgresServer_MemoryLimitBytes	gauge	bytes	Memória alocada para o serviço.
PostgresServer_StorageLimitBytes	gauge	bytes	Armazenamento alocado para o serviço.

​

Utilização de recursos

Métrica	Tipo	Rótulos extras	Descrição
PostgresServer_CPUSeconds_Total	counter	mode	Tempo de CPU consumido, discriminado por modo: user, system, iowait, softirq, steal, irq, nice, idle.
PostgresServer_MemoryUsedPercent	gauge		Memória em uso, como porcentagem de PostgresServer_MemoryLimitBytes.
PostgresServer_MemoryCachePercent	gauge		Memória usada por cache e buffers, como porcentagem da memória total.
PostgresServer_FilesystemUsedPercent	gauge		Espaço do sistema de arquivos usado, como porcentagem do armazenamento total.

Para calcular o uso de CPU em porcentagem, obtenha a taxa de PostgresServer_CPUSeconds_Total nos modos relevantes e divida por PostgresServer_CPUCores.

​

E/S de disco e rede

Métrica	Tipo	Unidade	Descrição
PostgresServer_DiskReads_Total	counter	ops	Operações de leitura em disco concluídas.
PostgresServer_DiskWrites_Total	counter	ops	Operações de gravação em disco concluídas.
PostgresServer_NetworkReceiveBytes_Total	counter	bytes	Bytes recebidos via rede.
PostgresServer_NetworkTransmitBytes_Total	counter	bytes	Bytes transmitidos via rede.

​

Atividade do banco de dados

Contadores cumulativos desde a inicialização do serviço. Use rate() ou irate() para convertê-los em valores por segundo.

Métrica	Tipo	Descrição
PostgresServer_TuplesFetched_Total	counter	Linhas recuperadas por consultas.
PostgresServer_TuplesInserted_Total	counter	Linhas inseridas.
PostgresServer_TuplesUpdated_Total	counter	Linhas atualizadas.
PostgresServer_TuplesDeleted_Total	counter	Linhas excluídas.
PostgresServer_TransactionsCommitted_Total	counter	Transações confirmadas.
PostgresServer_TransactionsRolledBack_Total	counter	Transações desfeitas.
PostgresServer_Deadlocks_Total	counter	Deadlocks detectados.

​

Conexões, cache e tamanho do banco de dados

Metric	Tipo	Rótulos extras	Descrição
PostgresServer_ActiveConnections	gauge	state	Conexões por estado (por exemplo, active, idle).
PostgresServer_CacheHitRatio	gauge		Taxa de acerto do cache de buffer: blocos atendidos pelo cache em relação ao total de blocos acessados, em porcentagem.
PostgresServer_DatabaseSizeBytes	gauge	database	Tamanho em disco de cada banco de dados, em bytes. Inclui o banco de dados padrão postgres e quaisquer bancos de dados criados pelo usuário.

​

Páginas relacionadas

• endpoint Prometheus — configuração, autenticação e scraping
• Dashboard — gráficos integrados do console em nuvem
• Guia de OpenAPI — criação de chave de API e consulta dos IDs da organização e do serviço