Configurar métricas de contadores

Console

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

1. En la consola de Google Cloud, ve a la página Métricas basadas en registros.

   Ir a Métricas basadas en registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

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

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

4. Configura los siguientes campos en la sección Detalles:

   • Nombre de la métrica de registro: Elige un nombre que sea único entre las métricas basadas en registros en tu proyecto de Google Cloud. Se aplican algunas restricciones de denominación. Para obtener más detalles, consulta Solución de problemas.
   • Descripción: ingresa una descripción para la métrica.
   • Unidades: deja este campo en blanco o inserta el número 1.

5. Define tu filtro de métricas en la sección Selección de filtro.

   1. Usa el menú Seleccionar proyecto o bucket de registros para elegir si la métrica cuenta las entradas de registro de tu proyecto de Google Cloud o solo las entradas de registro de un bucket de registros específico.

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

   3. Para ver qué entradas de registro coinciden con el filtro, haz clic en Obtener vista previa de los registros.

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

7. Haz clic en Crear métrica a fin de crear la métrica.

gcloud

Puedes crear una métrica basada en registros sin etiquetas personalizadas con el siguiente comando:

gcloud logging metrics create METRIC_NAME \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  [--bucket-name="BUCKET_NAME"]

Por ejemplo, el siguiente comando crea una métrica basada en registros a nivel del proyecto llamada error_count.

gcloud logging metrics create error_count \
     --description "Errors in syslog." \
     --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR"

Para crear una métrica basada en registros de bucket, proporciona la marca --bucket_name:

gcloud logging metrics create error_count \
    --description "Errors in syslog." \
    --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR" \
    --bucket-name projects/my-project/locations/global/buckets/my-test-bucket

Para obtener instrucciones sobre cómo crear etiquetas, consulta Configura etiquetas en métricas basadas en registros.

API

Para crear una métrica de contador, usa el método projects.metrics.create de la API de Logging. Si usas el panel del Explorador de APIs en la página de referencia, prepara los argumentos de la siguiente manera:

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

   • Para una métrica basada en registros centrada en el proyecto, especifica el proyecto:

   projects/PROJECT_ID
   

   • Para una métrica basada en registros de permisos de bucket, especifica el bucket:

   projects/PROJECT_ID/locations/LOCATION/bucket/BUCKET_ID
   

2. Establece el cuerpo de la solicitud como un objeto LogMetric. A continuación, se muestra un objeto de muestra para una métrica de contador:

   {
     name:        "my-metric"
     description: "This is my metric."
     filter:      "resource.type=gce_instance AND log_id(\"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 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.

• Para las métricas de contador, los campos valueExtractor y bucketOptions de LogMetric 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 para obtener una introducción a las etiquetas y los detalles sobre cómo crearlas en la API.

Para obtener más detalles, consulta el tipo LogMetric.

Console

1. En la consola de Google Cloud, ve a la página Métricas basadas en registros.

   Ir a Métricas basadas en registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. 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 Google Cloud:

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

gcloud

Para enumerar las métricas basadas en registros definidas por el usuario en tu proyecto de Google 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 Google 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 Google Cloud CLI.

API

Mostrar métricas

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

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

Recupera definiciones de métricas

Para 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 serie temporal en una métrica basada en registros, usa projects.timeseries.list en la API de Cloud Monitoring. Para obtener detalles sobre los datos de series temporales, consulta Lee series temporales.

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

logging.googleapis.com/user/METRIC_ID

Console

1. En la consola de Google Cloud, ve a la página Métricas basadas en registros.

   Ir a Métricas basadas en registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. Haz clic en Editar métrica en el menú more_vert de 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.

gcloud

Usa Google Cloud CLI para cambiar la descripción, la consulta de filtro y el bucket de una métrica de contador. Puedes actualizar uno o todos los campos a la vez.

gcloud logging update METRIC_NAME \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  --bucket-name=BUCKET_NAME

Si cambias el bucket asociado con una métrica centrada en el bucket, los datos de métricas recopilados antes del cambio ya no reflejarán la configuración actual. No se quitan los datos de métricas recopilados para el bucket anterior.

Para actualizar las métricas de distribución o cualquier otro campo de métrica de contador, excepto METRIC_NAME, crea un archivo que contenga la especificación revisada de tu LogMetric en formato JSON o YAML. Luego, llama al comando update con el campo --config-from-file para actualizar la métrica y reemplaza FILENAME por el nombre de tu archivo JSON o YAML:

gcloud logging update METRIC_NAME --config-from-file FILENAME

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

gcloud logging metrics update --help

API

Para editar una métrica basada en registros, usa el método projects.metrics.update en la API. Configura 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 sea igual a la métrica existente excepto por los cambios y adiciones que desees hacer.

Console

1. En la consola de Google Cloud, ve a la página Métricas basadas en registros.

   Ir a Métricas basadas en registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

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ú more_vert de la métrica basada en registros que deseas borrar.

gcloud

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

gcloud logging metrics delete METRIC_NAME

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

gcloud logging metrics delete --help

API

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