Para diagnosticar y resolver problemas con tus métricas basadas en registros en Cloud Logging, como datos faltantes, recuentos retrasados o alertas de falsos positivos, usa la guía de solución de problemas de esta página.
El contenido de esta página solo se aplica a los datos de métricas derivados de tus registros. No se aplica a los datos de métricas que escriben directamente los servicios de Google Cloud o tus aplicaciones.
No se pueden ver ni crear métricas
Las métricas basadas en registros se aplican solo a un proyecto de Google Cloud o a un bucket de Logging dentro de un proyecto de Google Cloud . No puedes crear métricas basadas en registros para otros recursos de Google Cloud, como cuentas de facturación u organizaciones. Las métricas basadas en registros se calculan solo para los registros del proyecto o bucket de Google Cloud en el que se reciben.
Para crear métricas basadas en registros, necesitas los permisos de Identity and Access Management correctos. Para obtener más detalles, consulta Control de acceso con IAM: Métricas basadas en registros.
Faltan datos de registros en la métrica
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Existen diferentes razones por las cuales podrían faltar datos en métricas basadas en registros:
Es posible que las entradas de registro nuevas no coincidan con el filtro de tu métrica. Una métrica basada en registros obtiene datos de las entradas de registro coincidentes que se reciben después de que se crea la métrica. Logging no reabastece la métrica a partir de entradas de registro anteriores.
Es posible que las entradas de registro nuevas no contengan el campo correcto, o los datos podrían no estar en el formato correcto para que tu métrica de distribución la extraiga. Controla que los nombres de tu campo y las expresiones regulares sean las correctas.
Es posible que el conteo de métricas esté retrasado. Aunque las entradas de registro contables aparecen en el Explorador de registros, puede tardar hasta 10 minutos en actualizar las métricas basadas en registros en Cloud Monitoring.
Es posible que las entradas de registro que se muestran se cuenten tarde o que no se cuenten en absoluto, ya que tienen marcas de tiempo demasiado antiguas o futuras. Si Cloud Logging recibe una entrada de registro con más de 24 horas de antigüedad o 10 minutos en el futuro, esta no se contará en la métrica basada en registros.
La cantidad de entradas que llegan tarde se registra en la métrica basada en registros
logging.googleapis.com/logs_based_metrics_error_count.Ejemplo: Una entrada de registro que coincide con una métrica basada en registros llega tarde. Tiene un
timestampde las 2:30 p.m. del 20 de febrero de 2020 y unreceivedTimestampde las 2:45 p.m. del 21 de febrero de 2020. Esta entrada no se contará en la métrica basada en registros.La métrica basada en registros se creó después de la llegada de las entradas de registro que la métrica podría contar. Las métricas basadas en registros evalúan las entradas de registro a medida que se almacenan en buckets de registros. Estas métricas no evalúan las entradas de registro almacenadas en Logging.
La métrica basada en registros tiene brechas en los datos. Se esperan algunas brechas de datos, ya que los sistemas que procesan los datos de las métricas basadas en registros no garantizan la persistencia de cada dato de métrica. Cuando se producen brechas, suelen ser poco frecuentes y de corta duración. Sin embargo, si tienes una política de alertas que supervisa una métrica basada en registros, las brechas en los datos pueden causar una notificación falsa. La configuración que usas en tu política de alertas puede reducir esta posibilidad.
Ejemplo: Se escribe una entrada de registro de "latido" cada cinco minutos, y una métrica basada en registros cuenta la cantidad de entradas de registro de "latido". Una política de alertas suma los recuentos en un intervalo de cinco minutos y te notifica cuando el total es menor que uno. Cuando a la serie temporal le falta un dato, la política de alertas inserta un valor sintético, que es un duplicado de la muestra más reciente y es más probable que sea cero, y, luego, evalúa la condición. Por lo tanto, incluso un solo dato faltante podría dar como resultado que el valor sumado sea cero, lo que hace que esta política de alertas envíe una notificación.
Para reducir el riesgo de una notificación falsa, configura la política de modo que cuente varias entradas de registro de "latido", no solo una.
El tipo de recurso es "undefined" en Cloud Monitoring
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Algunos tipos de recursos supervisados de Cloud Logging no se asignan directamente a los tipos de recursos supervisados de Cloud Monitoring. Por ejemplo, cuando creas por primera vez una política de alertas o un gráfico a partir de una métrica basada en registros, es posible que veas que el tipo de recurso es "sin definir".
El tipo de recurso supervisado se asigna a global o a un tipo de recurso supervisado diferente en Cloud Monitoring. Consulta las
Asignaciones para recursos solo de Logging
para determinar qué tipo de recurso supervisado debes elegir.
Las etiquetas de una notificación no se resuelven
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Crea una métrica basada en registros y, luego, una política de alertas para
supervisar esa métrica.
En el campo de documentación de tu política de alertas, haz referencia a las
etiquetas extraídas con una variable del formato
${log.extracted_label.KEY}, en el que KEY es el nombre que le diste
a la etiqueta extraída. La etiqueta no se resuelve en la notificación.
Para solucionar este problema, realiza una de las siguientes acciones:
Quita el contenido de la etiqueta extraída de la documentación. Las políticas de alertas que supervisan las métricas basadas en registros no pueden extraer datos de las entradas de registro.
Crea una alerta basada en registros. Estas políticas de alertas pueden extraer datos de la entrada de registro que hace que se active la política de alertas.
No se crean alertas o son falsos positivos
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Podrías recibir alertas de falsos positivos o situaciones en las que Monitoring no crea alertas a partir de métricas basadas en registros porque el período de alineación de la política de alertas es demasiado corto. Es posible que encuentres falsos positivos en las siguientes situaciones:
- Cuando una política de alertas usa la lógica menor que.
- Cuando una política de alertas se basa en una condición de percentil para una métrica de distribución.
- Cuando hay una brecha en los datos de la métrica.
Las alertas de falsos positivos pueden ocurrir porque las entradas de registro se pueden enviar a
Logging tarde. Por ejemplo, los campos de registro timestamp y
receiveTimestamp pueden tener una diferencia de minutos en algunos casos. Además, cuando
Logging almacena registros en buckets de registros, hay un retraso inherente
entre el momento en que se generan las entradas de registro y el momento en que Logging
las recibe. Esto significa que es posible que Logging no tenga el recuento total
de una entrada de registro en particular hasta un momento posterior a la generación de las entradas
de registro. Por este motivo, una política de alertas que use la lógica menor que
o que se base en una condición de percentil para una métrica de distribución puede producir una
alerta de falso positivo: aún no se tuvieron en cuenta todas las entradas de registro.
Sin embargo, las métricas basadas en registros tienen coherencia eventual, ya que una entrada de registro que
coincide con una métrica basada en registros se puede enviar a Logging con un
timestamp que es significativamente más antiguo o más nuevo que el
receiveTimestamp del registro.
Esto significa que la métrica basada en registros puede recibir entradas de registro con marcas de tiempo más antiguas después de que Logging ya haya recibido entradas de registro existentes con la misma marca de tiempo. Por lo tanto, se debe actualizar el valor de la métrica.
Para que las notificaciones sigan siendo precisas incluso para los datos puntuales, te recomendamos que configures el período de alineación de la condición para que sea lo suficientemente grande como para contar varias entradas de registro que coincidan con tu filtro y para tener en cuenta el retraso de transferencia, que puede ser de hasta 10 minutos.
Por ejemplo, si una métrica basada en registros cuenta las entradas de registro de "latido" que se esperan cada 7 minutos, establece el período de alineación en, al menos, 24 minutos. Este valor tiene en cuenta la demora de transferencia y dos muestras.
Si usas la consola de Google Cloud , usa el menú Ventana móvil para establecer el período de alineación.
Si usas la API, utiliza el campo
aggregations.alignmentPeriodde la condición para establecer el período de alineación.
La métrica basada en registros tiene demasiadas series temporales
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
La cantidad de series temporales en una métrica depende de la cantidad de combinaciones diferentes en los valores de etiquetas. La cantidad de series temporales se denomina cardinalidad de la métrica. La cantidad máxima de series temporales para una métrica es de 30,000.
Debido a que generas una serie temporal para cada combinación de valores de etiqueta, si tienes una o más etiquetas con una gran cantidad de valores, no es difícil superar las 30,000 series temporales. Evita las métricas de cardinalidad alta.
A medida que la cardinalidad de una métrica aumenta, esta podría acelerarse y causar que algunos datos no se escriban en ella. Los gráficos en los que se muestra la métrica pueden tardar en cargarse debido a la gran cantidad de series temporales que el gráfico tiene que procesar. También puedes incurrir en costos por las llamadas a la API para consultar datos de series temporales. Revisa las secciones de Cloud Monitoring de la página Precios de Google Cloud Observability.
Debido a un límite de 1,000,000 de series temporales activas por
recurso supervisado, el sistema podría limitar los datos de tus métricas, incluso cuando tenga
menos de 30,000 series temporales activas. Para las métricas basadas en registros a nivel de proyecto, el recurso se define por el recurso en la entrada de registro. Para las
métricas basadas en registros con alcance de bucket,
el recurso es logging_bucket.
Para evitar crear métricas de alta cardinalidad, haz lo siguiente:
Verifica que tus campos de etiquetas y las expresiones regulares del extractor coincidan con valores que tienen una cardinalidad limitada.
Por ejemplo, no almacenes tamaños, recuentos ni duraciones en las etiquetas. Tampoco almacenes campos como URLs, direcciones IP o IDs únicos, ya que todos estos pueden generar una gran cantidad de series temporales.
Evita extraer mensajes de texto que pueden cambiar, sin límites, como valores de etiquetas.
Evita extraer valores numéricos con cardinalidad ilimitada.
Solo extrae valores de etiquetas de cardinalidad conocida, por ejemplo, códigos de estado con un conjunto de valores conocidos.
Estas dos métricas basadas en registros del sistema pueden ayudarte a medir el efecto de agregar o quitar etiquetas en la cardinalidad de tu métrica:
logging.googleapis.com/metric_throttledlogging.googleapis.com/time_series_countlogging.googleapis.com/metric_label_throttledlogging.googleapis.com/metric_label_cardinality
Cuando inspeccionas estas métricas, puedes filtrar aún más los resultados mediante el nombre de la métrica. Para obtener más detalles, consulta Selecciona métricas: filtrado.
El nombre de la métrica no es válido
Cuando crees una métrica de contador o distribución, elige un nombre de métrica que sea único entre las métricas basadas en registros de tu proyecto de Google Cloud .
Las strings de nombres de métricas no deben exceder los 100 caracteres y pueden incluir solamente los que se muestran a continuación:
A-Za-z0-9Los caracteres especiales
_-.,+!*',()%\/.El carácter de barra diagonal
/denota una relación jerárquica de las partes dentro del nombre de la métrica y no se puede usar como primer carácter del nombre.
Los valores de las métricas basadas en registros no son correctos
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Observas que los valores informados para una métrica basada en registros a veces son diferentes de la cantidad de entradas de registro que informa el Explorador de registros.
Para minimizar la discrepancia, haz lo siguiente:
Asegúrate de que las aplicaciones no envíen entradas de registro duplicadas. Las entradas de registro se consideran duplicadas cuando tienen los mismos valores de
timestampyinsertId. El Explorador de registros suprime automáticamente las entradas de registro duplicadas. Sin embargo, las métricas basadas en registros cuentan cada entrada de registro que coincide con el filtro de la métrica.Asegúrate de que se envíe una entrada de registro a Cloud Logging cuando la marca de tiempo sea inferior a 24 horas en el pasado o inferior a 10 minutos en el futuro. Las métricas basadas en registros no cuentan las entradas de registro cuyas marcas de tiempo no se encuentran dentro de estos límites.
No puedes eliminar la posibilidad de que haya registros duplicados. Si se produce un error interno durante el control de una entrada de registro, Cloud Logging invoca un proceso de reintento. El proceso de reintento puede causar una entrada de registro duplicada. Cuando existen entradas de registro duplicadas, el valor de una métrica basada en registros puede ser demasiado grande, ya que estas métricas cuentan cada entrada de registro que coincide con el filtro de la métrica.
Los valores de la etiqueta están truncados
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Los valores de las etiquetas definidas por el usuario no deben exceder los 1,024 bytes.
No se puede borrar una métrica basada en registros personalizada
Esta entrada solo se aplica a los datos de métricas que Google Cloud Observability deriva de tus datos de registro (métricas basadas en registros). No se aplica a los datos de métricas que escriben los servicios de Google Cloud o tus aplicaciones.
Intentas borrar una métrica personalizada basada en registros con la consola de Google Cloud .
La solicitud de eliminación falla y el diálogo de eliminación muestra
el mensaje de error There is an unknown error while executing this operation.
Para resolver este problema, realiza las siguientes acciones:
Actualiza la página Métricas basadas en registros en la consola de Google Cloud . Es posible que se muestre el mensaje de error debido a un problema de sincronización interno.
Identifica y borra las políticas de alertas que supervisan la métrica basada en registros. Después de verificar que la métrica basada en registros no esté supervisada por una política de alertas, borra la métrica basada en registros. No se pueden borrar las métricas basadas en registros que supervisa una política de alertas.