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, las métricas pueden registrar la cantidad de entradas de registro que contienen mensajes específicos o pueden extraer información sobre la latencia informada en entradas de registro. Puedes usar métricas basadas en registros en los gráficos de Cloud Monitoring y las políticas de alertas.

Existen dos tipos de métricas basadas en registros:

Las métricas basadas en registros se aplican solo a un proyecto de Google Cloud. No puedes crearlos para depósitos de registros 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.

Comprueba que la facturación esté habilitada en tu proyecto.

Descubre cómo puedes habilitar la facturación

A fin de verificar que tienes los permisos correctos a fin de usar métricas basadas en registros para el proyecto de Cloud, consulta Guía de control de acceso: Métricas basadas en registros.

Visualiza tus métricas basadas en registros

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

Si deseas ver una lista de las 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 en Cloud 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 de 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. Cada fila de la 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 si abres el Explorador de métricas en Cloud Monitoring.

    Puedes usar el Explorador de métricas con el 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 las métricas basadas 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 las 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 ayudarán 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). 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 hasta la fecha (MTD). Estos datos de uso son útiles, por ejemplo, si quieres determinar qué métricas transfieren la mayor cantidad de datos o estimar tus facturas.

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

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

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

  • Ver detalles de métricas: Muestra el Nombre, Tipo, Descripción y Filtro{ de la métrica /1}, Unidades y Etiquetas, si están definidas.
  • Editar métrica: Te permite editar ciertos campos para la métrica.
  • Inhabilitar métrica: te permite evitar que se calcule 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 para métrica: Te lleva al Explorador de registros y propaga el filtro de métrica en el Compilador de consultas y ejecuta la consulta.

Descripción general de 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 para una métrica basada en registros provienen de entradas de registro recibidas después de crear 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 un dato nuevo en la serie temporal de la métrica a una velocidad de 1 dato por minuto, lo que hace que los datos estén disponibles para Cloud Monitoring.

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

Las métricas basadas en registros definidas por el usuario pueden ser de tipos de contadores o de 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 contadores cuentan la cantidad de entradas de registros 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.
  • Cuenta la cantidad de veces que cada usuario invoca una operación. Para ello, busca mensajes de registro que coincidan con este patrón:

    ... user USERNAME called OPERATION ...

    Si extraes USERNAME y OPERATION, y los usas como valores para dos etiquetas, más adelante podrás preguntar: "¿Cuántas veces llamó sally al 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 Representa métricas de distribución.

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

Etiquetas

Las métricas basadas en registros pueden tener etiquetas, que permiten que se recopilen varias series temporales para la métrica. Los valores de las etiquetas se extraen de los campos en las entradas de registro coincidentes. 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 crea un proyecto de Google Cloud con 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 específicos dentro de las entradas de registro coincidentes.

Para obtener información sobre cómo crear y administrar las métricas definidas por el usuario mediante Cloud Console, consulta Configura métricas de contadores 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 de contador registran la cantidad de eventos de registro que ocurrieron dentro de un período específico. Las métricas tienen etiquetas que registran los recuentos por nombre de registro y nivel de gravedad.

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

Cloud Monitoring

En Cloud Monitoring, se pueden 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.

Soluciona problemas

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