Os tipos de métricas seguem a definição dos tipos de métricas do Prometheus. Uma métrica de informações do Prometheus é um tipo especial de métrica de medidor do Prometheus, que sempre tem um valor de 1 e vários rótulos com informações importantes sobre o recurso personalizado do operador do AlloyDB Omni no Kubernetes correspondente.
Rótulos de metadados de definição de recurso personalizada (CRD)
Todas as métricas de recursos personalizados têm os seguintes rótulos que marcam o grupo, a versão e o tipo
do CRD. Para mais informações, consulte
Conceitos da API Kubernetes.
As definições e os nomes dos rótulos estão listados na tabela a seguir:
Key
Descrição
Valor de exemplo
customresource_group
O grupo do CRD.
alloydbomni.dbadmin.goog
customresource_version
A versão do CRD.
v1
customresource_kind
O tipo do CRD.
DBCluster
Métricas do DBCluster
As métricas do DBCluster são expostas nos manifestos de recursos DBCluster. Todos os nomes de métricas de DBCluster começam com alloydb_omni_dbcluster_. Todas as métricas de DBCluster têm os seguintes rótulos:
Key
Valor
namespace
O namespace a que o DBCluster pertence.
dbcluster
O nome do recurso personalizado DBCluster.
Os rótulos na tabela a seguir terão um valor vazio e serão considerados equivalentes a rótulos que não existem por nomes e rótulos de métricas do Prometheus se o campo relevante não estiver presente no manifesto do DBCluster.
Nome da métrica
Descrição
Rótulo
Unidade
Tipo
alloydb_omni_dbcluster_ha_ready
A prontidão de alta disponibilidade (HA) do `DBCluster`: 1 se ha-ready, caso contrário, 0.
reason: o motivo pelo qual este DBCluster está
(não) pronto para alta disponibilidade.
1
Medidor
alloydb_omni_dbcluster_primary_ready
A prontidão do nó principal DBCluster:
1 se estiver pronto, caso contrário, 0.
reason: o motivo pelo qual o nó principal deste DBCluster está (não) pronto.
1
Medidor
alloydb_omni_dbcluster_status_info
O status atual do DBCluster.
phase: a fase do DBCluster.
database_version: a versão atual em execução da
imagem do AlloyDB Omni. Por exemplo, 15.7.0.
controlplane_agents_version: a versão
atual em execução da imagem dos agentes do plano de controle, por exemplo, 1.3.0.
read_write_endpoint: o endpoint de leitura/gravação do
DBCluster.
read_only_endpoint: o endpoint somente leitura do
DBCluster.
primary_phase: a fase do nó principal DBCluster.
haready_status: status da condição HAReady, True ou False.
haready_reason: o motivo da condição
HAReady.
1
Informações
alloydb_omni_dbcluster_spec_info
Configuração DBCluster no campo spec
do manifesto do DBCluster.
num_standbys:o número de nós em espera configurados.
database_version: a versão da imagem do AlloyDB Omni
configurada, por exemplo, 15.7.0.
controlplane_agents_version: a versão da imagem dos agentes do plano de controle configurada, por exemplo, 1.3.0.
is_deleted: indica se este
DBCluster está marcado para exclusão, definido como true ou
false.
allow_external_incoming_traffic: indica se
este DBCluster está configurado para permitir tráfego de fora do
cluster do Kubernetes, true ou false.
1
Informações
alloydb_omni_dbcluster_spec_num_standbys
O número de standbys definidos na especificação DBCluster.
N/A
1
Medidor
alloydb_omni_dbcluster_critical_incident_info
Entradas de incidentes críticos na seção status.criticalIncidents do manifesto DBCluster.
create_time: o momento em que o incidente crítico ocorreu.
O horário em que o incidente crítico ocorreu, expresso no formato tempo de época do Unix.
message: a mensagem de erro do incidente crítico.
code: o código de erro do incidente crítico.
s
Medidor
Métricas de failover
As métricas de failover são métricas expostas do manifesto de recursos Failover. Todos os nomes de métricas de failover começam com alloydb_omni_failover_. Todas as métricas de failover têm os seguintes rótulos:
Key
Valor
namespace
O namespace a que o Failover pertence.
failover
O nome do recurso personalizado Failover.
dbcluster
O nome do recurso personalizado DBCluster a que o failover se destina.
Esse valor é igual ao campo spec.dbclusterRef do
Failover.
Os rótulos na tabela a seguir terão um valor vazio e serão considerados equivalentes a rótulos que não existem com base em Nomes e rótulos de métricas do Prometheus se o campo relevante não estiver presente no manifesto de failover.
end_time: o momento em que o Failover
foi concluído.
new_primary: o nome do nó principal após a conclusão do
Failover.
old_primary: o nome do nó principal antes do início do
Failover
phase: a fase do Failover.
state: o estado do Failover.
1
Informações
Métricas do PgBouncer
As métricas do PgBouncer são expostas dos manifestos de recursos doPgBouncer. Todos os nomes de métricas do PgBouncer começam com alloydb_omni_pgbouncer_. Todas as métricas do PGBouncer têm os seguintes rótulos:
Key
Valor
namespace
O namespace a que o PgBouncer pertence.
pgbouncer
O nome do recurso personalizado PgBouncer.
dbcluster
O nome do recurso personalizado do DBCluster que este
PgBouncer segmenta. Esse valor é igual ao campo
spec.dbclusterRef do
PgBouncer.
Os rótulos na tabela a seguir terão um valor vazio e serão considerados equivalentes a rótulos que não existem com base em Nomes e rótulos de métricas do Prometheus se o campo relevante não estiver presente no manifesto do PgBouncer.
Nome da métrica
Descrição
Rótulo
Unidade
Tipo
alloydb_omni_pgbouncer_status_info
O status atual do PgBouncer.
endpoint: o endpoint exposto por este PgBouncer. Você
se conecta a esse endpoint para executar consultas no DBCluster que esse
PgBouncer tem como destino.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis page details the custom resource (CR) metrics exposed by the AlloyDB Omni Kubernetes operator, formatted for use with Prometheus and kube-state-metrics.\u003c/p\u003e\n"],["\u003cp\u003eCustom resource metrics provide insights into the group, version, and kind of the Custom Resource Definition (CRD) through specific labels like \u003ccode\u003ecustomresource_group\u003c/code\u003e, \u003ccode\u003ecustomresource_version\u003c/code\u003e, and \u003ccode\u003ecustomresource_kind\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDBCluster metrics, prefixed with \u003ccode\u003ealloydb_omni_dbcluster_\u003c/code\u003e, reveal the status and configuration of DBCluster resources, including HA readiness, primary node readiness, and details about critical incidents.\u003c/p\u003e\n"],["\u003cp\u003eFailover metrics, starting with \u003ccode\u003ealloydb_omni_failover_\u003c/code\u003e, track the start and end times of failover events, along with the status of the failover process, including the new and old primary nodes.\u003c/p\u003e\n"],["\u003cp\u003ePgBouncer metrics, denoted by \u003ccode\u003ealloydb_omni_pgbouncer_\u003c/code\u003e, provide the current status of PgBouncer instances, such as its endpoint and phase, allowing users to monitor database connection pooling.\u003c/p\u003e\n"]]],[],null,["# Custom resource metrics for the AlloyDB Omni Kubernetes operator\n\nSelect a documentation version: 16.3.0keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [16.8.0](/alloydb/omni/16.8.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [16.3.0](/alloydb/omni/16.3.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.12.0](/alloydb/omni/15.12.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.7.1](/alloydb/omni/15.7.1/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.7.0](/alloydb/omni/15.7.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n\n\u003cbr /\u003e\n\nThis page describes the custom resource (CR) metrics for the AlloyDB Omni Kubernetes operator. The AlloyDB Omni Kubernetes operator exposes metrics constructed from custom resource manifests in a [Prometheus](https://prometheus.io/) format using [kube-state-metrics](https://kubernetes.io/docs/concepts/cluster-administration/kube-state-metrics/).\n\n\u003cbr /\u003e\n\n| **Note:** These metrics are only available on AlloyDB Omni Kubernetes operator version 1.3.0 and later.\n\nMetric types follow the definition of Prometheus metrics types. A Prometheus\nInfo metric is a special kind of Prometheus Gauge metric, which always has a\nvalue of 1 and has multiple labels carrying important information about the\ncorresponding AlloyDB Omni Kubernetes operator Custom Resource.\n\nTo learn how to enable custom resource metrics, see [Monitor AlloyDB Omni Kubernetes operator custom resources](/alloydb/omni/16.3.0/docs/monitor-kubernetes-operator-custom-resources).\n\nCustom Resource Definition (CRD) metadata labels\n------------------------------------------------\n\nAll custom resource metrics have the following labels that mark the group, version, and kind\nof the CRD. For more information, see\n[Kubernetes API concepts](https://kubernetes.io/docs/reference/using-api/api-concepts/).\nLabel definitions and naming are listed in the following table:\n\nDBCluster metrics\n-----------------\n\nDBCluster metrics are exposed from `DBCluster` resource manifests. All\nDBCluster metric names start with `alloydb_omni_dbcluster_`. All DBCluster\nmetrics have the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist per\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the DBCluster manifest.\n\nFailover metrics\n----------------\n\nFailover metrics are metrics exposed from the `Failover` resource manifest. All\nfailover metric names start with `alloydb_omni_failover_`. All Failover metrics\nhave the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist based on\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the Failover manifest.\n\nPgBouncer metrics\n-----------------\n\nPgBouncer metrics are metrics that are exposed from`PgBouncer` resource\nmanifests. All PgBouncer metric names start with `alloydb_omni_pgbouncer_`. All\nPgBouncer metrics have the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist based on\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the PgBouncer manifest..\n\nWhat's next\n-----------\n\n- [Monitor AlloyDB Omni Kubernetes operator custom resources](/alloydb/omni/16.3.0/docs/monitor-kubernetes-operator-custom-resources)."]]
