Convenciones de nombres

El nombre del recurso para un tipo de métrica consta de una string con tres subestructuras principales:

  • Un identificador para un proyecto específico
  • Un marcador que indica que la string representa un descriptor de métrica
  • El tipo de métrica

Los nombres de recursos para los tipos de métricas siguen este patrón:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

La substring METRIC_TYPE es un identificador que representa el tipo de métrica. Está disponible en diferentes formatos, como los siguientes:

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

En el descriptor de métrica, el campo name almacena el nombre del recurso del tipo de métrica y el campo type almacena la substring METRIC_TYPE.

En la siguiente tabla, se muestra cómo analizar las substrings METRIC_TYPE contenidas en un nombre de recurso:

Estructuras posibles Descripción
SERVICE 1.googleapis.com/PATH 2 Métricas de productos y servicios de Google Cloud. Para obtener una lista completa de estas métricas, consulta Métricas de Google Cloud.
agent.googleapis.com/SERVICE 1/PATH 2 Métricas de los agentes de Monitoring y Logging que se ejecutan en instancias de VM en Google Cloud o AWS. Para obtener una lista completa de estas métricas, consulta Métricas del agente.
kubernetes.io/anthos/PATH 2 Métricas de Anthos, un servicio de Google Cloud que te permite ejecutar clústeres de Kubernetes locales y en la nube. Para obtener una lista completa de estas métricas, consulta Métricas de Anthos.
aws.googleapis.com/SERVICE 1/PATH 2 Métricas de Amazon Web Services. Para obtener una lista completa de estas métricas, consulta Métricas de AWS.
istio.io/PATH 2 Métricas de Istio para Google Cloud Para obtener una lista completa de estas métricas, consulta Métricas de Istio.
kubernetes.io/PATH 2 Métricas de Google Kubernetes Engine Para obtener una lista completa de estas métricas, consulta Métricas de Kubernetes.
knative.dev/PATH 2 Métricas de Knative. Para obtener una lista completa de estas métricas, consulta Métricas de Knative.
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2
Métricas personalizadas de terceros, como Prometheus. Esta herramienta de supervisión de código abierto a menudo se usa con Kubernetes. Para obtener más información sobre estas métricas, consulta Métricas externas. Puedes usar estos tipos de métricas solo en los proyectos que los definen.
custom.googleapis.com/PATH 2 Métricas personalizadas definidas por el usuario. Puedes usar estos tipos de métricas solo en los proyectos en los que los defines.
logging.googleapis.com/PATH 2 Métricas basadas en registros de Cloud Logging. Puedes usar métricas predefinidas o puedes crear métricas personalizadas. Las métricas personalizadas solo se pueden usar en proyectos en los que tú las definas.

1 SERVICE identifica un producto de Google Cloud, como compute para Compute Engine.
2 PATH identifica la métrica dentro del producto, como instance/cpu/utilization.

Nombra tipos de métricas y etiquetas

Si creas tipos de métricas personalizadas, debes cumplir con las siguientes reglas para asignar nombres a tus tipos de métricas y etiquetas. Cuando se define un tipo de métrica, las etiquetas se especifican como pares clave-valor del tipo LabelDescriptor. La clave actúa como el nombre de la etiqueta.

  • Tipos de métricas
    • Puedes usar letras mayúsculas y minúsculas (A-Z, a-z), dígitos (0-9) y guiones bajos (_) en la string.
    • Solo puedes usar puntos (.) en la parte del dominio de la string, por ejemplo, custom.googleapis.com.
    • Puedes usar barras diagonales (/) para separar los elementos de la ruta.
    • Puedes iniciar cada elemento de la ruta con una letra o un dígito.
    • La longitud máxima de una string de tipo de métrica es de 200 caracteres.
  • Claves de etiquetas
    • Puedes usar letras minúsculas (a-z), dígitos (0-9), guiones bajos (_) y guiones (-) en una clave de etiqueta.
    • Puedes iniciar claves de etiqueta con una letra.
    • La longitud máxima de una clave de etiqueta es de 100 caracteres.
    • Cada clave debe ser única dentro del tipo de métrica. No puedes tener más de 10 etiquetas por tipo de métrica.