Esta página se ha traducido con Cloud Translation API.
Switch to English

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 los gráficos de Cloud Monitoring y en las políticas de alertas.

Existen dos hijos de métricas basadas en registros:

  • Métricas basadas en registros definidas por el sistema y proporcionadas por Cloud Logging para que la usen todos los proyectos de Google Cloud.
  • Métricas basadas en registros definidas por el usuario y creadas para que realices un seguimiento de los elementos de tu proyecto de Google Cloud que te interesen. 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 solo se aplican a un único 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.

Comenzar

A fin de verificar que tienes los permisos correctos para usar métricas basadas en registros en un proyecto de Cloud, consulta Control de acceso en esta página.

Si es la primera vez que usas Cloud Monitoring, consulta la sección Cloud Monitoring en esta página.

Visualiza las 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.

A fin de ver una lista de métricas basadas en registros de 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 usuario que muestra las listas de métricas basadas en registros.

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

Ambas áreas contienen un resumen en forma de tabla de las métricas. Cada fila de la tabla tiene un menú  que presenta las siguientes opciones:

Las listas de métricas basadas en registros que muestran el menú ampliado.

  • Ver en el Explorador de métricas (View in Metrics Explorer) te permite ver los datos de una métrica basada en registros del sistema con solo abrir 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 (Create alert from metric) te permite crear políticas de alertas relacionadas con tu 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. A fin de 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 definido por el usuario

El panel Métricas definidas por el usuario de la interfaz de métricas basadas en registros tiene diferentes funciones que te ayudan a administrar las métricas definidas por el usuario en el 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.

  • Los modelosFiltrar métricas te permite filtrar la lista de métricas según búsqueda de texto o métrica.Nombre :Descripción yFiltro (Filter) :

Las listas de métricas basadas en registros que muestran las opciones de filtro.

  • En la tabla de métricas definidas por el usuario se incluyen columnas de Consumo del mes anterior y Uso (este mes, hasta la fecha). Estas métricas de uso son útiles, por ejemplo, si deseas determinar qué métricas transfieren la mayor cantidad de datos o estimar tus facturas.

  • Puedes editar o borrar las métricas con las opciones Editar métrica y Borrar métrica del menú en el final de una fila de la tabla.

Además, si haces clic en cualquiera de los nombres de columna, podrás ordenar datos en orden ascendente o descendente. En la parte inferior de la tabla, también puedes seleccionar la cantidad de filas que deseas mostrar.

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

Las métricas basadas en registros se calculan a partir de los registros incluidos y los excluidos.

Los datos para una métrica basada en registros provienen de entradas de registro recibidas una vez que se creó una métrica. Una métrica no se propaga de forma retroactiva con los datos de las entradas de registro que ya están en Logging.

El registro 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 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 y definidas por el usuario pueden ser de contador o de métricas 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:

  • Contar las entradas de registro que contienen un mensaje de error específico
  • Para contar la cantidad de veces que cada usuario invoca una operación, busca mensajes de registro que coincidan con este patrón:

    ... user [USERNAME] called  [OPERATION] ...
    

    Mediante la extracción de [USERNAME] yOPERA y usarlas como valores para dosetiquetas , puedes preguntar: "¿Cuántas vecessally llamar aUPDATE la operación", “¿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, ve a Crea 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 en una serie temporal y cómo se visualizan, consulta Gráfico de métricas de distribución.

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

Etiquetas

Las métricas basadas en registros pueden tener etiquetas, lo que permite recopilar varias series temporales de 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 etiquetas.

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

Métricas basadas en registros definidas por el usuario

Un usuario 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 las métricas definidas por el usuario mediante Cloud Console, consulta Crea métricas de contadores y Crea métricas de distribución. las rutas "a GCP".

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. 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: 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 Crea gráficos y alertas.

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

  • Sistema: logging.googleapis.com/<var>SYSTEM_METRIC_NAME</var>
  • Definido por el usuario: logging.googleapis.com/user/<var>...</var>

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

Configuración

Para configurar un lugar de trabajo de Cloud Monitoring para tu proyecto, haz lo siguiente:
  1. En Cloud Console, selecciona tu proyecto de Google Cloud.
    Ir a Cloud Console
  2. En el panel de navegación, selecciona Monitoring.

    Si nunca usaste Cloud Monitoring, entonces, en tu primer acceso a Monitoring en Google Cloud Console, se crea un lugar de trabajo de forma automática y tu proyecto se asocia con ese lugar de trabajo. De lo contrario, si el proyecto no está asociado con un lugar de trabajo, aparecerá un diálogo y podrás crear uno o agregar tu proyecto a un lugar de trabajo existente. Te recomendamos que crees un lugar de trabajo. Después de realizar la selección, haz clic en Agregar.

Control de acceso

A fin de ver las métricas basadas en registros de tu proyecto de Cloud, verifica que tengas la función y los permisos correctos.

Las funciones y los permisos de la administración de identidades y accesos rigen el acceso a los datos de Google Cloud. A continuación, se incluye un resumen de las funciones y los permisos comunes que un miembro del proyecto de Google Cloud necesita para acceder a las métricas basadas en registros:

  • Escritor de configuración de registros/Logging (roles/logging.configWriter) te permite enumerar, crear, obtener, actualizar y borrar métricas basadas en registros.

  • Visor de registros/Logging (roles/logging.viewer) te permite ver las métricas existentes. También puedes agregar los permisos logging.logMetrics.get y logging.logMetrics.list a una función personalizada.

  • Visualizador de Monitoring (roles/monitoring.viewer) te permite leer las series temporales que contiene la métrica basada en registros. También puedes agregar el permiso monitoring.timeSeries.list a una función personalizada.

  • Administrador de registros (roles/logging.admin ),Editor de proyecto (roles/editor ) yPropietario del proyecto (roles/owner ) son funciones de alto nivel que contienen el permiso para crear métricas basadas en registros (logging.logMetrics.create de Google).

Para obtener más información sobre los permisos y funciones, consulta la guía de control de acceso.

Soluciona problemas

Si tienes problemas cuando usas métricas basadas en registros, consulta Solución de problemas.