Referência de métricas do Managed Postgres

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