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 métricos de las entradas de registro que que se originan en tu proyecto de Google Cloud o que se enrutan a tu proyecto de Google Cloud. Por ejemplo, puedes usar una métrica basada en registros para contar el número de entradas de registro que contienen un mensaje en particular o y extraer la información de latencia registrada en entradas de registro. Puedes usar métricas basadas en registros en los gráficos y las alertas de Cloud Monitoring y políticas de seguridad.
Fuentes de métricas basadas en registros
Puedes usar las métricas que define Cloud Logging para recopilar datos de uso general información y puedes definir tu propia métrica basada en registros para capturar información específicas de tu aplicación o negocio.
Las métricas basadas en registros se pueden aplicar a un solo proyecto de Google Cloud o a un registro bucket. No puedes crear métricas basadas en registros para otros recursos de Google Cloud, como Organizaciones o cuentas de Facturación de Cloud
Para obtener información sobre las diferencias entre las métricas basadas en registros basadas en proyectos y métricas basadas en registros basadas en bucket, consulta Métricas basadas en registros con alcance de bucket.
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 almacenadas en buckets de registros 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.
Métricas definidas por el usuario
Puedes crear métricas basadas en registros definidas por el usuario para realizar un seguimiento de otras métricas que son importantes para tu proyecto. Para Por ejemplo, puedes crear una métrica basada en registros para contar la cantidad de registros entradas 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 recibidos por la API de Logging para el proyecto de Google Cloud, independientemente de los filtros de inclusión o filtros de exclusión que podrían aplicarse proyecto de Google Cloud.
También puedes crear métricas basadas en registros definidas por el usuario para un bucket de registros específico en un proyecto de Google Cloud. Con alcance de bucket las métricas basadas en registros se calculan a partir de todos los registros destinados al bucket, más allá de su origen. Para obtener más información, consulta Métricas basadas en registros en buckets de registros.
Tipos de datos para métricas basadas en registros
Las métricas basadas en registros pueden extraer datos de los registros para crear métricas del los siguientes tipos:
- Contador: estas métricas cuentan el número de entradas de registro que coinciden con un filtro especificado en un período específico. Usa contadores cuando quieras mantener realizar un seguimiento del número de veces que un valor o una cadena aparecen en tus registros.
- Distribución: Estas métricas también cuentan valores, pero recopilan los se cuentan en rangos de valores (buckets de histogramas). Usa distribuciones cuando queremos extraer valores como latencias.
- Booleano: estas métricas capturan si una entrada de registro coincide o no con un filtro.
Las métricas basadas en registros definidas por el usuario pueden ser de contador o de distribución de tipos de datos. La mayoría de las métricas basadas en registros definidas por el sistema son contadores, el tipo booleano. Las características de los contadores y distribuciones son se describe con más detalle en secciones posteriores.
Los datos de una métrica basada en registros definida por el usuario provienen solo de entradas de registro recibido después de que se crea la métrica. Una métrica no es retroactivamente completados con datos de entradas de registro que ya están en Logging.
Las métricas basadas en registros del sistema se calculan solo a partir de los registros incluidos. Definido por el usuario las métricas basadas en registros se calculan a partir de los registros incluidos y excluidos.
Logging acumula información para una métrica basada en registros cada vez 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 el 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ó
sallya la operaciónupdate?”, “¿Cuántas personas llamaron a la operaciónread?”, “¿Cuántas vecesgeorgellamó 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 distribuciones, incluido su formato dentro de una serie temporal y cómo se visualizan, ve Crea gráficos de las métricas de distribución.
Para obtener información sobre la creación de métricas basadas en registros de distribución, consulta Configura métricas de distribución.
Tipos de recursos
Recomendamos que las métricas basadas en registros especifiquen un solo tipo de recurso. Esta especificación garantiza que los datos de series temporales generados para tu la métrica basada en registros coincide con el modelo de datos que espera Cloud Monitoring. También simplifica el proceso de creación de gráficos y políticas de alertas, ya que no hay ambigüedad sobre qué datos de series temporales se representan o se supervisan.
Considera una métrica basada en registros con el siguiente filtro:
severity>="ERROR"
resource.type="gce_instance"
Cloud Monitoring reconoce que estos datos son para una Compute Engine instancia de VM. Por lo tanto, cuando creas un gráfico para una instancia de VM, basada en registros aparece como una opción en los menús. Cuando crear un gráfico para un tipo de recurso diferente, tu y la métrica basada en registros no aparece como opción.
Si creas una métrica basada en registros sin especificar un tipo de recurso, entonces Monitoring muestra tu métrica basada en registros como una opción para varios tipos de recursos, aun cuando no cuentes las entradas de esos recursos.
Etiquetas
Las métricas basadas en registros pueden tener etiquetas, que permiten varias series temporales que se recopilarán 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.
Todas las métricas basadas en registros proporcionan una etiqueta log predeterminada.
Esta etiqueta contiene el valor de la porción LOG_ID de la
El campo logName en la entrada de registro, por ejemplo,
cloudresourcemanager.googleapis.com%2Factivity
Las métricas basadas en registros del sistema tienen parámetros etiquetas que no se pueden cambiar. Sin embargo, puedes personalizar las etiquetas para métricas definidas por el usuario. Por ejemplo, puedes usar etiquetas en la métrica basada en registros para registrar la carpeta organización en la que se originó una entrada de registro, a pesar de que bucket las métricas basadas en registros no se pueden crear para organizaciones o carpetas. Para ver más para obtener más información, consulta Etiquetas de métricas basadas en registros.
Gráficos y políticas de alertas en Cloud Monitoring
Puedes usar métricas basadas en registros por el sistema y definidas por el usuario Cloud Monitoring para crear gráficos y políticas de alertas. Para ver más consulta Crea listas y gráficos de métricas basadas en registros y Alerta sobre métricas basadas en registros.
En Cloud Monitoring, las métricas basadas en registros usan los siguientes patrones de nomenclatura:
- 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 para los permisos de métricas de Monitoring
Cloud Monitoring transfiere métricas basadas en registros, y la visibilidad de datos de métricas a un proyecto de Google Cloud se determina mediante un permiso de métricas. Un permiso de métricas es una lista de proyectos que supervisa el proyecto que aloja el permiso de métricas; el proyecto host se llama 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 un proyecto de permisos para sí mismo. Por lo tanto, tus métricas, incluidas las basadas en registros, solo son visibles para tu proyecto de Google Cloud.
También puedes crear un permiso de métricas multiproyecto para el proyecto de permisos. Con un permiso de métricas multiproyecto, el proyecto de permisos puede ver las métricas de todos los proyectos en el permiso de métricas. ¿Qué es visible para los proyectos individuales de una el permiso de métricas de varios proyectos está determinado por el permiso de métricas. alojados en cada uno de esos proyectos. El hecho de que dos proyectos están en un el permiso de métricas de varios proyectos no significa que cada proyecto tenga acceso a los datos de métricas o configuración en el otro proyecto.
Un solo proyecto también puede aparecer en varios permisos de métricas. Las métricas de ese proyecto son visibles para los proyectos de permisos de cada uno de esos permisos de métricas.
Las métricas, incluidas las basadas en registros, se definen dentro de un proyecto específico. Cuando ese proyecto aparece en varios permisos de métricas, las métricas son visibles para otros proyectos que no sean aquel en el que se encuentran definido. Para saber cómo los permisos de métricas y los bucket basados en interactúan, consulta Proyectos y permisos de métricas.
Para obtener más información sobre los permisos de métricas, incluidos los permisos de métricas y los proyectos de permisos, consulta lo siguiente:
Precios
Todas las métricas basadas en registros definidas por el usuario son una clase de las métricas personalizadas de Cloud Monitoring y son cobrables. Para obtener información sobre 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 para las métricas basadas en registros, 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.