Esta página foi traduzida pela API Cloud Translation.
Switch to English

Convenções de nomeação

O nome do recurso de um tipo de métrica consiste em uma string com três subestruturas principais:

  • Um identificador para um projeto específico
  • Um marcador que indica que a string representa um descritor de métrica
  • O tipo de métrica

Os nomes de recursos para tipos de métricas seguem este padrão:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

A substring METRIC_TYPE é um identificador que representa o tipo de métrica. Ele apresenta diversos formatos, como, por exemplo:

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/antho/APIServiceOpenAPIAggregationControllerQueue1_adds

No descritor de métrica, o campo name armazena o nome do recurso do tipo de métrica, e o campo type armazena a substring METRIC_TYPE.

A tabela a seguir mostra como analisar as substrings METRIC_TYPE contidas em um nome de recurso:

Possíveis estruturas Descrição
SERVICE 1.googleapis.com/PATH 2 Métricas de produtos e serviços do Google Cloud. Para uma lista completa dessas métricas, consulte métricas do Google Cloud.
agent.googleapis.com/SERVICE 1/PATH 2 Métricas dos agentes do Monitoring e do Logging em execução em instâncias de VM no Google Cloud ou na AWS. Para uma lista completa dessas métricas, consulte Métricas do agente.
kubernetes.io/anthos/PATH 2 Métricas do Anthos, um serviço do Google Cloud que permite executar clusters do Kubernetes no local e na nuvem. Para uma lista completa dessas métricas, consulte Métricas do Anthos.
aws.googleapis.com/SERVICE 1/PATH 2 Métricas do Amazon Web Services Para uma lista completa dessas métricas, consulte Métricas do AWS.
istio.io/PATH 2 Métricas do Istio para o Google Cloud. Para uma lista completa dessas métricas, consulte Métricas do Istio.
kubernetes.io/PATH 2 Métricas do Google Kubernetes Engine. Para uma lista completa dessas métricas, consulte Métricas do Kubernetes.
knative.dev/PATH 2 Métricas do Knative. Para uma lista completa dessas métricas, consulte Métricas do Knative.
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2
Métricas personalizadas de terceiros, como Prometheus. Essa ferramenta de monitoramento de código aberto é frequentemente usada com o Kubernetes. Para mais informações sobre essas métricas, consulte Métricas externas. É possível usar esses tipos de métricas somente nos projetos que os definem.
custom.googleapis.com/PATH 2 Métricas personalizadas definidas pelo usuário. Só é possível usar esses tipos de métricas nos projetos em que são definidos.
logging.googleapis.com/PATH 2 Métricas com base em registros do Cloud Logging. É possível usar métricas predefinidas ou criar métricas personalizadas. As métricas personalizadas só podem ser usadas em projetos em que você as define.

1 SERVICE identifica um produto do Google Cloud, como compute para o Compute Engine.
2 PATH identifica a métrica no produto, como instance/cpu/utilization.

Como nomear tipos e rótulos de métricas

Se você estiver criando tipos de métricas personalizadas, siga as regras a seguir para nomear os tipos e rótulos de métricas. Ao definir um tipo de métrica, os rótulos são especificados como pares de chave-valor do tipo LabelDescriptor. A chave atua como o nome do rótulo.

  • Tipos de métricas
    • É possível usar letras maiúsculas e minúsculas (A-Z, a-z), dígitos (0-9) e sublinhados (_) na string.
    • É possível usar pontos (.) apenas na parte do domínio da string, por exemplo, custom.googleapis.com.
    • É possível usar barras (/) para separar os elementos do caminho.
    • É possível iniciar cada elemento do caminho com uma letra ou um dígito.
    • O tamanho máximo de uma string do tipo métrica é 200 caracteres.
  • Chaves de marcadores
    • É possível usar letras minúsculas (a-z), dígitos (0-9), sublinhados (_) e traços (-) em uma chave de rótulo.
    • É possível começar a marcar as teclas com uma letra.
    • O tamanho máximo de uma chave de rótulo é 100 caracteres.
    • Cada chave precisa ser exclusiva no tipo de métrica. É possível ter no máximo 10 rótulos por tipo de métrica.