Se usó la API de Cloud Translation para traducir esta página.
Switch to English

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.