Crear métricas de contadores

En esta página, se explica cómo crear métricas basadas en registros del tipo de contador con GCP Console, la API de Stackdriver Logging y el SDK de Cloud (el comando gcloud logging).

Crea una métrica de contador

Consola de Logging

Sigue estos pasos a fin de crear una métrica de contador basada en registros en GCP Console:

  1. Haz clic en Stackdriver Logging > Métricas basadas en registros (Métricas basadas en registros) en la lista de navegación del lado izquierdo en GCP Console o haz clic en el siguiente botón:

    Ir a Métricas basadas en registros

  2. Usa el menú desplegable en la parte superior de la página para seleccionar un proyecto.

  3. Haz clic en Create Metric (Crear métrica) en la parte superior de la página. Verás el Metric Editor (Editor de métricas) del lado derecho de la página y el panel del visor que muestra tus registros en el lado izquierdo:

    Crea una métrica de contador

  4. En el panel del visor, crea un filtro que muestre solo las entradas de registro que deseas contar en tu métrica.

    El filtro básico está disponible en los menús desplegables sobre las entradas del registro. De manera alternativa, puedes acceder a la interfaz del filtro avanzado si haces clic en el menú desplegable del lado derecho de la barra de búsqueda y seleccionas Convert to advanced filter (Convertir en filtro avanzado).

    A fin de obtener más información, consulta el Visor de registros.

  5. En el panel de Metric Editor, establece los siguientes campos:

    • Name (Nombre): Elige un nombre que sea único entre las métricas basadas en registros de tu proyecto. Se aplican algunas restricciones de denominación; para obtener más detalles consulta la sección Solución de problemas.
    • Description (Descripción): Describe la métrica.
    • Labels (Etiquetas): Este campo es opcional; si quieres agregar etiquetas, haz clic en Add item (Agregar elemento) para cada etiqueta. A fin de obtener detalles sobre la definición de etiquetas, consulta Etiquetas de métricas basadas en registros.
    • Units (Unidades): En métricas de contadores, deja este blanco o inserta el número 1.
    • Type (Tipo): Contador.
  6. Haz clic en Create Metric a fin de crear la métrica.

API de Logging

A fin de crear una métrica de contador, usa el método projects.metrics.create de la API de Stackdriver 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 parent (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 la sección Solución de problemas.

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

  • Si tu 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 detalles sobre cómo crearlas en la API.

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

SDK de Cloud

El comando de acceso de gcloud del SDK de Cloud es compatible con las métricas sin etiquetas basadas en registros del tipo de contador. 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 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 la sección Solución de problemas.

Latencia de métrica nueva

Tu métrica nueva aparece de inmediato en la lista de métricas del Visor de registros y en los menús relevantes de Stackdriver Monitoring. Los datos deberían 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 de tu proyecto de GCP o inspeccionar una métrica particular en tu proyecto, haz lo siguiente:

Consola de Logging

Haz clic en el siguiente botón para dirigirte a la página Métricas basadas en registros, que muestra una lista de todas las métricas basadas en registros en el proyecto actual:

Ir a Métricas basadas en registros

A fin de ver los datos en una métrica basada en registros, selecciona View in Metrics Explorer (Ver en el explorador de métricas) en el menú ampliado del lado derecho de la lista de métricas.

API de Logging

Enumera las métricas

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

  • parent: el nombre del recurso del proyecto: projects/[PROJECT_ID].
  • pageSize: la cantidad máxima de resultados.
  • pageToken: obtiene la próxima página de resultados. Consulta 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

A fin de leer los datos de serie temporal de una métrica basada en registros, usa projects.timeseries.list en la API de Stackdriver Monitoring. Para obtener más detalles, consulta Lee series temporales. A continuación, se presenta la información que necesitas para las métricas basadas en registros:

  • El tipo de métrica es logging.googleapis.com/user/[METRIC_ID].

SDK de Cloud

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

gcloud logging metrics list

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

gcloud logging metrics describe [METRIC_NAME]

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

gcloud logging metrics --help

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

Actualiza métricas de contador

Puedes actualizar una métrica basada en registros a fin de cambiar la descripción, los filtros y los 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 o sus etiquetas. Tampoco puedes borrar las etiquetas existentes en una métrica basada en registros.

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

Consola de Logging

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

    Ir a Métricas basadas en registros

  2. Haz clic en Edit metric (Editar métrica) en el menú a la derecha de la métrica basada en registros que deseas editar.

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

  4. Haz clic en Done.

API de Logging

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

  • metricName: 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.

SDK de Cloud

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

Para actualizar una métrica basada en registros, usa el siguiente comando. 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

Borra métricas de contadores

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

Consola de Logging

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

    Ir a Métricas basadas en registros

  2. Selecciona las métricas que deseas borrar y haz clic en Delete (Borrar) en la parte superior de la página.

    De manera alternativa, haz clic en Delete metric (Borrar métrica) en el menú a la derecha de la métrica basada en registros que deseas borrar.

API de Logging

Usa el método projects.metrics.delete en la API.

SDK de Cloud

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

gcloud logging metrics delete [METRIC_NAME]

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

gcloud logging metrics delete --help

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Logging
Si necesitas ayuda, visita nuestra página de asistencia.