Crear métricas de contadores

En esta página, se explica cómo crear métricas de contador basadas en registros mediante Cloud Console, la API de Logging y la herramienta de línea de comandos de gcloud.

Para obtener una vista general de las métrica basadas en registros, dirígete a la Descripción general de las métricas basadas en registros.

Crea una métrica de contador

Cuando creas un filtro para las entradas de registro que deseas contar en tu métrica, puedes usar expresiones regulares.

Console

Sigue estos pasos para crear una métrica de contador en Cloud Console, en tu proyecto de Google Cloud:

  1. Ve a la página Logging > Métricas basadas en registros:

    Ir a Métricas basadas en registros

  2. Haz clic en Crear métrica. Aparecerá el panel Crear métrica de registros.

  3. Para Tipo de métrica, selecciona Contador.

  4. Establece los siguientes campos en la sección Detalles (Details):

    • Nombre de la métrica de registro: elige un nombre que sea único entre las métricas basadas en registros en tu proyecto de Cloud. Se aplican algunas restricciones de denominación. consulta Solución de problemas para obtener más información.
    • Descripción: ingresa una descripción para la métrica.
    • Unidades: Deja este campo en blanco o inserta el número 1.
  5. Defina su filtro de métricas en la sección Filtrar selección.

    Crea un filtro que recopile solo las entradas de registro que deseas registrar en tu métrica con el lenguaje de consulta de registro. También puedes usar expresiones regulares para crear tus filtros de métricas.

    Haz clic en Obtener vista previa de los registros para abrir un panel que muestre las entradas de registro que coinciden con tu filtro.

  6. (Opcional) Agrega una etiqueta en la sección Etiquetas. Para obtener instrucciones sobre cómo crear etiquetas, consulta Crea una etiqueta.

  7. Haz clic en Crear métrica para crear la métrica.

Línea de comandos

La herramienta de línea de comandos de gcloud admite métricas de contador basadas en registros sin etiquetas. A continuación, se muestra el comando para crear métricas basadas en registros:

gcloud logging metrics create [METRIC_NAME] [METRIC_DESCRIPTION] [FILTER]

Por ejemplo, el siguiente comando crea una métrica de contador basada en registros llamada error_count.

gcloud logging metrics create error_count \
    --description "Errors in syslog." \
    --log-filter "resource.type=gce_instance AND logName:logs/syslog AND severity>=ERROR"

Elige un nombre de métrica que sea único entre las métricas basadas en registros en tu proyecto de Cloud. Se aplican algunas restricciones de denominación; para obtener más detalles consulta Solución de problemas.

API

Para crear una métrica de contador, usa el método projects.metrics.create de la API de Logging. Puedes probar el método en el Explorador de API. Prepara los argumentos del método de la siguiente manera:

  1. Establece el campo Superior en el proyecto en el que se creará la métrica:

    projects/[PROJECT_ID]
    
  2. Establece el cuerpo de la solicitud como un objeto LogMetric. A continuación, se muestra un ejemplo del objeto:

    {
      name:        "my-metric"
      description: "This is my metric."
      filter:      "resource.type=gce_instance AND logName:\"logs/syslog\"",
      metricDescriptor: {
          labels: [
            {
              key: "my-label",
              valueType: STRING,
              description: "This is my label.",
            }
          ]
      },
      labelExtractors: {
        "my-label":
          "REGEXP_EXTRACT(jsonPayload.someField, \"before ([0-9]+) after\")",
        ...
      },
    }
    

Notas:

  • Elige un nombre de métrica que es único entre las métricas basadas en registros en tu proyecto. Se aplican algunas restricciones de denominación; para obtener más detalles consulta Solución de problemas.

  • Para las métricas de contador, los campos LogMetric valueExtractor y bucketOptions no cumplen ningún propósito y se omiten.

  • Si la métrica no tiene etiquetas, puedes omitir los campos metricDescriptor y labelExtractors. Si tu métrica tiene etiquetas, consulta Etiquetas de métricas basadas en registros a fin de obtener una introducción a las etiquetas y los detalles sobre cómo crearlas en la API.

A fin de obtener más detalles, consulta el tipo LogMetric.

Latencia de métrica nueva

Tu nueva métrica aparece en la lista de métricas del visor de registros y en los menús relevantes de Monitoring de inmediato. Los datos suelen estar disponibles en menos de un minuto.

Inspecciona métricas de contador

A fin de crear una lista de las métricas basadas en registros definidas por el usuario en tu proyecto de Google Cloud o para inspeccionar una métrica particular en tu proyecto de Cloud, haz lo siguiente:

Console

Dirígete a la página Métricas basadas en registros:

Ir a Métricas basadas en registros

En el panel Métricas definidas por el usuario, verás las métricas basadas en registros definidas por el usuario en el proyecto actual de Cloud:

A fin de ver los datos en una métrica basada en registros, haz clic en el menú en la fila de la métrica y selecciona Ver en el Explorador de métricas.

Línea de comandos

A fin de realizar una lista de las métricas basadas en registros definidas por el usuario en tu proyecto de Cloud, usa el siguiente comando:

gcloud logging metrics list

Para mostrar una métrica basada en registros definida por el usuario en tu proyecto de Cloud, usa el siguiente comando:

gcloud logging metrics describe [METRIC_NAME]

Para obtener ayuda, usa el siguiente comando:

gcloud logging metrics --help

No puedes leer los datos de series temporales de una métrica desde el SDK de Cloud.

API

Enumera las métricas

Para enumerar las métricas basadas en registros definidas por el usuario en un proyecto de Cloud, usa el método de API projects.metrics.list. Completa los parámetros del método de la siguiente manera:

  • parent: es el nombre del recurso del proyecto de Cloud: projects/[PROJECT_ID].
  • pageSize: la cantidad máxima de resultados.
  • pageToken: obtiene la próxima página de resultados. Para obtener más información sobre el uso de tokens de página, consulta la página projects.metrics.list.

Recupera definiciones de métricas

A fin de recuperar una sola métrica basada en registros definida por el usuario, usa el método de la API projects.metrics.get. Completa los parámetros del método de la siguiente manera:

  • metricName: el nombre del recurso de la métrica:

    projects/[PROJECT_ID]/metrics/[METRIC_ID]
    

Lee datos de métricas

Para leer los datos de series temporales en una métrica basada en registros, usa projects.timeseries.list en la API de Cloud Monitoring. Para obtener más detalles sobre los datos de series temporales, consulta Lee las series temporales.

A fin de leer una sola métrica basada en registros definida por el usuario, completa los parámetros del método con este tipo de métrica y este identificador:

logging.googleapis.com/user/[METRIC_ID]

Actualiza métricas de contador

Puedes editar una métrica basada en registros definida por el usuario para cambiar su descripción, filtro y nombres de los campos a los que se hace referencia en la métrica. Puedes agregar etiquetas nuevas a la métrica y cambiar las expresiones regulares usadas a fin de extraer valores para la métrica y sus etiquetas.

No puedes cambiar los nombres o tipos de las métricas basadas en registros definidas por el usuario o sus etiquetas, y no puedes borrar las etiquetas existentes en una métrica basada en registros.

A fin de editar una métrica basada en registros, haz lo siguiente:

Console

  1. Dirígete a la página Métricas basadas en registros:

    Ir a Métricas basadas en registros

  2. Haz clic en Editar métrica en el menú para la métrica basada en registros que deseas modificar.

  3. Cambia los elementos permitidos en la métrica.

  4. Haz clic en Actualizar métrica.

Línea de comandos

Solo puedes cambiar la descripción y la consulta de una métrica existente con el SDK de Cloud.

Usa el siguiente comando para actualizar una métrica basada en registros. Puedes especificar cualquiera de las dos marcas, o ambas:

gcloud logging metrics update [METRIC_NAME] --description=[DESCRIPTION] --log-filter=[FILTER]

Para obtener más detalles, usa el siguiente comando:

gcloud logging metrics update --help

API

A fin de editar una métrica basada en registros, usa el método projects.metrics.update en la API. Configure los campos de la siguiente manera:

  • metricName: es el nombre completo del recurso de la métrica:

    projects/[PROJECT_ID]/metrics/[METRIC_ID]
    

    Por ejemplo:

    projects/my-gcp-project/metrics/my-error-metric
    
  • En el cuerpo de la solicitud, incluye un objeto LogMetric que es igual a la métrica existente excepto por los cambios y adiciones que deseas hacer.

Borra métricas de contador

A fin de borrar una métrica basada en registros definida por el usuario, haz lo siguiente:

Console

  1. Dirígete a la página Métricas basadas en registros:

    Ir a Métricas basadas en registros

  2. Selecciona la métrica que deseas borrar y haz clic en Borrar.

    De manera alternativa, haz clic en Borrar métrica en el menú de la métrica basada en registros que deseas borrar.

Línea de comandos

Usa el siguiente comando para borrar una métrica basada en registros definida por el usuario en el proyecto actual de Cloud:

gcloud logging metrics delete [METRIC_NAME]

Para obtener más detalles, usa el siguiente comando:

gcloud logging metrics delete --help

API

A fin de borrar una métrica basada en registros definida por el usuario, usa el método projects.metrics.delete en la API.

Además, en la página Métrica basada en registros de Google Cloud Console, el panel Métricas definidas por el usuario de la interfaz de métricas basadas en registros proporciona más funciones. para ayudarte a administrar las métricas definidas por el usuario en tu proyecto de Cloud. Consulta el panel de métricas definidas por el usuario para obtener más información.