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, proporcionadas por 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 los registros que Logging transfirió. Si un registro se excluyó de forma explícita de la transferencia por Logging, no se incluye en estas métricas.

  • Métricas basadas en registros definidas por el usuario, creadas por ti para hacer un seguimiento de los elementos de tu proyecto de Google Cloud que te interesan en particular. Por ejemplo, puedes crear una métrica basada en registros para contar el número 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, independientemente de cualquierfiltros de inclusión ofiltros de exclusión que se pueda aplicar al proyecto de Cloud.

Las métricas basadas en registros se aplican solo a un proyecto de Google Cloud. No puedes crearlos para depósitos 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. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

Si deseas verificar que tienes los permisos correctos a fin de usar métricas basadas en registros para el 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 en Google Cloud Console te permite crear una métrica basada en registros y contiene listas de todas las métricas basadas en registros de tu proyecto de Cloud.

Si deseas ver una lista de las métricas basadas en registros de tu proyecto de Google Cloud, haz lo siguiente:

  1. Dirígete 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. 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 si 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 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). 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:

Las 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 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 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 la serie temporal de una métrica basada 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 de tipos de contador o métrica 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 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 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 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 crea un conjunto de métricas basadas en registros definidas por el usuario en un proyecto de Google Cloud. 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.

Si deseas obtener información para 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 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.

Soluciona problemas

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