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

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

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

Las métricas basadas en registros derivan datos de métricas del contenido de las entradas de registro. Por ejemplo, puedes usar una métrica basada en registros para contar la cantidad de entradas de registro que contienen un mensaje en particular o para extraer información de latencia registrada en las entradas de registro. Puedes usar métricas basadas en registros en los gráficos de Cloud Monitoring y las políticas de alertas.

Fuentes de métricas basadas en registros

Puedes usar las métricas definidas por Cloud Logging para recopilar información de uso general y definir tu propia métrica basada en registros a fin de capturar información específica de tu aplicación o empresa.

Las métricas basadas en registros se aplican solo dentro de un único proyecto de Google Cloud. No puedes crear métricas basadas en registros para otros recursos de Google Cloud, como organizaciones o cuentas de facturación de Cloud.

Métricas definidas por el sistema

Logging proporciona un conjunto de métricas para los valores de uso, como la cantidad de entradas de registro transferidas en tu proyecto o la cantidad de bytes que exportaste. Para obtener una lista completa de las métricas definidas por el sistema, consulta Métricas de Google Cloud: registro.

Logging calcula las métricas basadas en registros definidas por el sistema solo a partir de registros transferidos por Logging. Si un registro se excluyó de forma explícita de Logging, no se incluye en estas métricas.

Métricas definidas por el usuario

Puedes crear métricas basadas en registros definidas por el usuario a fin de hacer un seguimiento de otras métricas importantes para tu proyecto. Por ejemplo, puedes crear una métrica basada en registros para contar la cantidad de entradas de registro que coinciden con un filtro determinado.

De forma predeterminada, 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 puedan aplicarse al proyecto de Cloud.

Vista previa: También puedes crear métricas basadas en registros definidas por el usuario para un depósito de registro específico en un proyecto de Cloud. Las métricas basadas en registros a nivel de bucket se calculan a partir de todos los registros destinados al bucket, sin importar su origen. Para obtener más información, consulta Métricas basadas en registros en depósitos de registros.

Tipos de datos para las métricas basadas en registros

Las métricas basadas en registros pueden extraer datos de los registros para crear métricas de los siguientes tipos:

  • Contador: Estas métricas cuentan la cantidad de entradas de registro que coinciden con un filtro especificado dentro de un período específico. Usa contadores cuando quieras realizar un seguimiento de la cantidad de veces que aparece un valor o una string en los registros.
  • Distribución: Estas métricas también cuentan valores, pero recopilan los recuentos en rangos de valores (depósitos de histogramas). Usa distribuciones cuando quieras extraer valores como las latencias.
  • Booleano: Estas métricas capturan si una entrada de registro coincide o no con un filtro especificado.

Las métricas basadas en registros definidas por el usuario pueden ser del tipo de contador 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. Las características de los contadores y las distribuciones se describen con más detalle en las secciones posteriores.

Los datos de una métrica basada en registros definidos por el usuario provienen solo de las entradas de registro recibidas después de crear la métrica. Una métrica no se propaga de forma retroactiva con datos de entradas de registro que ya están en Logging.

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

Logging acumula información para una métrica basada en registros cada vez que recibe una entrada de registro que coincida. 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) recibida desde el dato anterior.

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 Gráficos de 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, lo que permite 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.

Gráficos y alertas en Cloud Monitoring

Puedes usar métricas basadas en registros, ya sean las definidas por el sistema o por el usuario, en Cloud Monitoring para 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:

  • 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 basadas en registros definidas por el usuario incluyen la string user.

Visibilidad de los permisos de las métricas de Monitoring

Cloud Monitoring transfiere las métricas basadas en registros, y el alcance de las métricas determina la visibilidad de los datos de las métricas en un proyecto de Cloud. Un alcance de métricas es una lista de proyectos que supervisa el proyecto que aloja el alcance de las métricas. El proyecto de hosting se denomina proyecto de permisos.

De forma predeterminada, cada proyecto aloja un permiso de métricas que se incluye solo a sí mismo, por lo que un proyecto es de alcance para sí mismo. Por lo tanto, tus métricas, incluidas las basadas en registros, solo son visibles para tu proyecto de Cloud.

También puedes crear un alcance de métricas de varios proyectos para el proyecto de permisos. Con un alcance de métricas de varios proyectos, el proyecto de permisos puede ver las métricas de todos los proyectos en el alcance de las métricas. Lo que es visible para los proyectos individuales en un alcance de métricas de varios proyectos está determinado por el alcance de las métricas que aloja cada uno de esos proyectos. El hecho de que dos proyectos estén en un permiso de métricas de varios proyectos no significa que cada proyecto tenga acceso a la métrica o los datos de configuración en el otro proyecto.

Un solo proyecto también puede aparecer en varios alcances de métricas. Las métricas de dicho proyecto son visibles para los proyectos de alcance de cada uno de esos alcances de métricas.

Las métricas, incluidas las métricas basadas en registros, se definen dentro de un proyecto específico. Cuando ese proyecto aparece en varios alcances de métricas, las métricas son visibles para proyectos distintos del que están definidos.

Para obtener más información sobre los permisos de las métricas, incluidos los alcances de las métricas de varios proyectos y sobre el alcance de los proyectos, consulta los siguientes vínculos:

Precios

Todas 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.

Cuota

Para obtener información sobre las cuotas y los límites asociados con las métricas basadas en registros definidas por el usuario, consulta Cuotas y límites.

Soluciona problemas

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