Descripción general de las métricas basadas en registros

En esta página, se proporciona una descripción general conceptual de las métricas basadas en registros.

Las métricas basadas en registros se basan en el contenido de las entradas de registro. Por ejemplo, pueden registrar la cantidad de entradas de registro que contienen mensajes particulares o pueden extraer información sobre la latencia informada en entradas de registro. Puedes usar métricas basadas en registros en gráficos de Cloud Monitoring y políticas de alertas.

Existen dos tipos de métricas basadas en registros:

  • Métricas basadas en registros definidas por el sistema que proporciona Cloud Logging para que las usen todos los proyectos de Google Cloud.

    Las métricas basadas en registros definidas por el sistema se calculan solo a partir de registros que Logging haya transferido. Si un registro se excluyó explícitamente de la transferencia mediante Logging, no se incluye en estas métricas.

  • Métricas basadas en registros definidas por el usuario, creadas por ti a fin de realizar un seguimiento de las cosas en tu proyecto de Google Cloud que te interesan. Por ejemplo, puedes crear una métrica basada en registros para contar la cantidad de entradas de registro que coinciden con un filtro determinado.

    Las métricas basadas en registros definidas por el usuario se calculan a partir de todos los registros que recibe la API de Logging para el proyecto de Cloud, sin importar los filtros de inclusión o los filtros de exclusión que se puedan aplicar al proyecto.

Las métricas basadas en registros se aplican solo a un proyecto de Google Cloud. No puedes crearlos para buckets de Logging ni para otros recursos de Google Cloud, como organizaciones o cuentas de Facturación de Cloud.

Antes de comenzar

Para usar métricas basadas en registros, debes tener un proyecto de Cloud con la facturación habilitada:

  1. En Google Cloud Console, ve a la página del selector de proyectos.

    Ir al selector de proyectos

  2. Para comenzar a crear un proyecto de Google Cloud, haz clic en Crear proyecto.

  3. Ponle un nombre al proyecto. Toma nota de tu ID del proyecto generado.

  4. Edita los otros campos según sea necesario.

  5. Para crear el proyecto, haz clic en Crear.

Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

A fin de verificar si tienes los permisos correctos para usar métricas basadas en registros del proyecto de Cloud, consulta Control de acceso con métricas basadas en registros de IAM.

Visualiza tus métricas basadas en registros.

La página Métricas basadas en registros de Google Cloud Console te permite crear una métrica basada en registros y contiene listas de todas las métricas basadas en registros para el proyecto de Cloud.

A fin de ver una lista de métricas basadas en registros para tu proyecto de Google Cloud, haz lo siguiente:

  1. Ve a la página Métricas basadas en registros de Console:

    Ir a Métricas basadas en registros

  2. Selecciona un proyecto de Cloud existente. Aparecerán las listas de métricas basadas en registros en tu proyecto de Cloud.

La interfaz de métricas basadas en registros se divide en dos paneles de tipo de métrica: Métricas del sistema y Métricas definidas por el usuario.

Cada panel contiene un resumen de la tabla de las métricas. La fila de cada métrica tiene un menú que presenta las siguientes opciones:

  • Ver en el Explorador de métricas te permite ver los datos de una métrica basada en registros del sistema cuando abres el Explorador de métricas en Cloud Monitoring.

    Puedes usar el Explorador de métricas a fin de especificar una métrica de destino para una política de alertas. El gráfico junto a la región de Destino te brinda comentarios visuales sobre los datos capturados por la métrica de destino.

  • Crear alerta a partir de métricas te permite crear una política de alertas basada en la métrica basada en registros.

    Cuando seleccionas esta opción, se abre la consola de Cloud Monitoring, en la que puedes crear, editar y administrar las políticas de alertas. Si quieres obtener detalles sobre cómo crear políticas de alertas para tus métricas basadas en registros, consulta Crea una política de alertas.

Panel de métricas definidas por el usuario

El panel Métricas definidas por el usuario de la interfaz de métricas basadas en registros tiene varias funciones que te ayudan a administrar las métricas definidas por el usuario en tu proyecto de Cloud:

  • En la tabla de métricas definidas por el usuario, se incluyen columnas de Nombre (Name), Descripción (Description), Tipo (Type) y Filtro (Filter). Estas se especifican cuando creas la métrica.

  • El panel Filtrar métricas definidas por el usuario te permite filtrar tu lista de métricas por búsqueda de texto o métrica Nombre, Descripción y Filtro.

  • En la tabla de métricas definidas por el usuario se incluyen columnas de Uso del mes anterior y Uso en lo que va del mes (MTD). Estos datos de uso son útiles, por ejemplo, si deseas determinar qué métricas transfieren la mayor cantidad de datos o quieres estimar tus facturas.

Hacer clic en cualquiera de los nombres de columna te permite ordenar los datos de forma ascendente o descendente.

El menú para cada métrica del panel de métricas definidas por el usuario contiene funciones adicionales que permiten administrar las métricas:

Opciones del menú ampliado del panel de métricas basadas en registros definidas por el usuario.

  • Ver los detalles de la métrica: Muestra el Nombre, Tipo, Descripción, Filtro, Unidades y Etiquetas, si están definidas.
  • Editar métrica: Te permite editar ciertos campos para la métrica.
  • Inhabilitar métrica: Te permite detener el cálculo de la métrica. Puedes volver a habilitar una métrica inhabilitada desde el mismo menú.
  • Borrar métrica: Te permite borrar la métrica.
  • Ver registros de la métrica: Te lleva al Explorador de registros y propaga el filtro de la métrica en el Compilador de consultas y ejecuta la consulta.

Descripción general de los tipos de métricas basadas en registros

Las métricas basadas en registros del sistema se calculan solo a partir de los registros incluidos. Las métricas basadas en registros definidas por el usuario se calculan a partir de los registros incluidos y excluidos.

Los datos de una métrica basada en registros provienen de entradas de registro recibidas después de que se crea una métrica. Una métrica no se propaga de forma retroactiva con datos de entradas de registro que ya están en Logging.

Logging acumula información para una métrica basada en registros cada vez que recibe una entrada de registro coincidente. Logging escribe 1 dato nuevo por minuto en la serie temporal de la métrica, lo que permite que los datos estén disponibles para Cloud Monitoring.

Cada dato de una serie temporal de métricas basadas en registros representa solo la información adicional (el delta) recibido desde el dato anterior.

Las métricas basadas en registros definidas por el usuario pueden ser del tipo de métrica de contador o distribución. La mayoría de las métricas basadas en registros definidas por el sistema son contadores, pero algunas son del tipo booleano.

En las siguientes secciones se describen las características de las métricas de tipo contador y distribución.

Métricas de contador

Las métricas de contador cuentan la cantidad de entradas de registro que coinciden con un filtro determinado. Por ejemplo, puedes hacer lo siguiente:

  • Cuenta las entradas de registro que contienen un mensaje de error específico.
  • Hacer un recuento de las veces que cada usuario invoca una operación mediante la búsqueda de mensajes de registro que coincidan con este patrón:

    ... user USERNAME called OPERATION ...

    Si extraes USERNAME y OPERATION a fin de usarlos como valores para dos etiquetas, más adelante puedes preguntar “¿Cuántas veces llamó sally a la operación update?”, “¿Cuántas personas llamaron a la operación read?”, “¿Cuántas veces george llamó a una operación?”, y así sucesivamente.

Para obtener más información, consulta Configura métricas de contadores.

Métricas de distribución

Las métricas de distribución acumulan datos numéricos de entradas de registro que coinciden con un filtro. Las métricas contienen una serie temporal de objetos de distribución, cada uno de los cuales contiene lo siguiente:

  • Un conteo de la cantidad de valores en la distribución
  • La media de los valores
  • La suma de las desviaciones al cuadrado: Suma i=1..n(x i–media)2
  • Un conjunto de bucket s de histogramas con el conteo de valores en cada bucket. Puedes utilizar el diseño predeterminado del bucket o elegir uno propio

Un uso común para las métricas de distribución es para hacer un seguimiento de las latencias. A medida que se reciben las entradas de registro, se extrae un valor de latencia de algún lugar en la entrada de registro y se lo agrega a la distribución. En intervalos periódicos, la distribución acumulada se escribe en Cloud Monitoring.

Para obtener información sobre las distribuciones, incluido su formato dentro de una serie temporal y cómo se visualizan, consulta Crea gráficos de las métricas de distribución.

Para obtener información sobre cómo crear métricas basadas en registros de distribución, consulta Configura métricas de distribución.

Etiquetas

Las métricas basadas en registros pueden tener etiquetas, que permiten recopilar varias series temporales para la métrica. Los valores de las etiquetas se extraen de los campos en las entradas de registro que coinciden. Los registros de Logging separan series temporales para cada combinación de valores de etiqueta.

Las métricas basadas en registros del sistema tienen etiquetas predefinidas. Puedes definir las etiquetas de las métricas definidas por el usuario. Para obtener más información, consulta Etiquetas de métricas basadas en registros.

Métricas basadas en registros definidas por el usuario

Un usuario de un proyecto de Google Cloud crea métricas basadas en registros definidas por el usuario. Estas métricas cuentan la cantidad de entradas de registro que coinciden con un filtro determinado o registran valores particulares dentro de las entradas de registro coincidentes.

Para obtener información sobre cómo crear y administrar tus métricas definidas por el usuario mediante la consola, consulta Configura métricas de contador y Configura métricas de distribución.

Métricas basadas en registros del sistema

Logging proporciona un conjunto de métricas que incluye contadores. Las métricas del contador registran la cantidad de eventos de registro que ocurrieron dentro de un período específico. Estas métricas tienen etiquetas que registran los recuentos según el nombre del registro y el nivel de gravedad.

Para obtener una lista de estas métricas, consulta Métricas de Google Cloud: registros.

Cloud Monitoring

En Cloud Monitoring, puedes usar métricas basadas en registros, ya sean las definidas por el sistema o por el usuario, a fin de crear gráficos y políticas de alertas. Para obtener más información, consulta Configura gráficos y alertas.

En Cloud Monitoring, las métricas basadas en registros usan los siguientes patrones de nombres:

  • Sistema: logging.googleapis.com/SYSTEM_METRIC_NAME
  • Definido por el usuario: logging.googleapis.com/user/USER_METRIC_NAME

Ten en cuenta que las métricas definidas por el usuario incluyen la string user.

Precios

Las métricas basadas en registros definidas por el usuario son una clase de métricas personalizadas de Cloud Monitoring y se cobran.

Para obtener información sobre los precios, consulta Precios de Cloud Logging: métricas basadas en registros.

Solución de problemas

Si tienes problemas cuando usas métricas basadas en registros, consulta Soluciona problemas de métricas basadas en registros.