En este documento, se describe cómo puedes usar Cloud Monitoring para observar tendencias en tus registros y para notificarte cuando ocurran las condiciones que describes Para proporcionarle a Cloud Monitoring datos de tus registros, Logging admite las siguientes funciones:
Puedes generar métricas personalizadas a partir de tus entradas de registro. Estas métricas son llamada métricas basadas en registros. También puedes crear alertas basadas en métricas políticas para notificarte cuando una métrica basada en registros cumple con una condición. Para obtener más información, consulta Visualiza los datos de las entradas de registro con métricas basadas en registros.
Puedes usar políticas de alertas para supervisar, casi en tiempo real, cuando aparece un mensaje en tus entradas de registro. Estas políticas de alertas se denominan políticas de alertas basadas en registros. Para obtener más información, consulta Supervisa entradas de registro individuales en busca de mensajes.
Puedes escribir una consulta en SQL en el Análisis de registros y crear una política de alertas que supervisa los resultados de la consulta. Estas políticas de alertas se denominan políticas de alertas basadas en SQL. Para obtener más información, consulta Supervisa los resultados de la consulta en SQL.
Las políticas de alertas basadas en SQL están en versión preliminar pública.
En el resto de este documento, se describen las diferencias entre estas tres políticas de alertas y se proporciona información sobre la autorización, los costos y los límites.
Visualiza los datos de las entradas de registro con métricas basadas en registros
Cuando desees supervisar eventos recurrentes en tus registros a lo largo del tiempo, usa métricas basadas en registros. Las métricas basadas en registros generan datos numéricos de tus registros. Las métricas basadas en registros son adecuadas si deseas llevar a cabo alguna de las siguientes acciones:
- Cuenta los casos de un mensaje, como una advertencia o un error, en los registros y recibe una notificación cuando la cantidad de casos supera un umbral.
- Observar las tendencias en tus datos, como los valores de latencia en tus registros, y recibir una notificación si los valores cambian de una manera inaceptable.
- Crear gráficos para mostrar los datos numéricos extraídos de tus registros.
Debido a que las métricas basadas en registros generan datos numéricos de tus registros, puedes usar estas métricas en las políticas de alertas y mostrarlas en gráficos. Si deseas obtener información para crear políticas y gráficos de alertas para métricas basadas en registros, consulta Configura notificaciones para métricas basadas en registros.
Cloud Monitoring proporciona un conjunto de métricas predefinidas basadas en registros, y puedes definir las tuyas. Para ver una lista de las métricas basadas en registros definidas por el sistema, haz clic en el siguiente botón add_circle:
Métricas basadas en registros definidas por el usuario
Puedes crear métricas basadas en registros para extraer datos numéricos de tus de datos. Las métricas basadas en registros definidas por el usuario calculan valores a partir de registros incluidos y excluidos.
De forma predeterminada, las métricas basadas en registros definidas por el usuario recopilan datos de todos los registros que recibe el Router de registros en tu proyecto de Google Cloud, pero puedes definir métricas basadas en registros que recopilen datos de registros enrutados a un bucket de registros específico.
- Si deseas obtener información para definir y usar métricas basadas en registros a nivel del proyecto, consulta Usa métricas basadas en registros.
- Para obtener información sobre cómo definir y usar métricas basadas en registros a nivel de bucket, consulta Métricas basadas en registros en buckets de registros.
Si defines tus propias métricas basadas en registros, es posible que se generen cargos. Para obtener más información sobre los costos asociados con la transferencia de métricas, consulta Métricas cobrables.
Supervisa las entradas de registro individuales en busca de mensajes
Cuando desees recibir notificaciones cada vez que ocurra un mensaje específico en una entrada de registro, usa políticas de alertas basadas en registros. Políticas de alertas basadas en registros son útiles para detectar eventos relacionados con la seguridad en entradas de registro de la siguiente manera:
- Quieres recibir una notificación cuando aparezca un evento en un registro de auditoría. por ejemplo, un usuario humano accede a la llave de seguridad de una cuenta de servicio.
- Tu aplicación escribe mensajes de implementación en los registros y deseas recibir una notificación cuando se registra un cambio de implementación.
Las políticas de alertas basadas en registros son útiles para los eventos que esperas importantes y escasas. No quieres conocer una tendencia o un patrón, sino que ocurrió algo.
Para obtener información sobre cómo crear políticas de alertas basadas en registros, consulta Configura políticas de alertas basadas en registros.
Puedes configurar una política de alertas basada en métricas para simular una política política de alertas. Para ello, define una métrica basada en registros y usa la métrica en una política de alertas basada en métricas con un umbral de uno. Las políticas de alertas basadas en registros te brindan ese comportamiento sin la necesidad de crear una métrica basada en registros y configurar una política de alertas basada en métricas.
Supervisa los resultados de las consultas de SQL
Puedes configurar políticas de alertas que usen las estadísticas de registros para ejecutar consultas SQL en los datos de entrada de registro. Estos tipos de políticas de alertas son eficaces cuando deseas recibir notificaciones basados en patrones que las políticas de alertas basadas en registros no pueden evaluar como patrones complejos en entradas de registro o agregaciones de datos de registro. Para obtener más información, consulta Supervisa los resultados de tus consultas de SQL con una política de alertas.
Comparación de opciones de alertas
En esta sección, se comparan las políticas de alertas creadas en métricas basadas en registros, las políticas de alertas basadas en registros y las políticas de alertas basadas en SQL.
Tabla de resumen
En la siguiente tabla, se resumen las técnicas de alerta y se proporcionan vínculos a información adicional:
| Políticas de alertas basadas en métricas | Políticas de alertas basadas en registros | Políticas de alertas basadas en SQL | Más información |
|---|---|---|---|
| Basado en métricas derivadas de entradas de registro | Según cadenas en entradas de registro individuales | Basado en tablas devueltas por consultas en SQL sobre entradas de registro | Métricas basadas en registros Alertas basadas en registros Alertas basadas en SQL |
| Se usan para notificarte tendencias en el tiempo | Se usa para notificarte cuando aparece un mensaje específico en un registro | Se usa para notificarte sobre un patrón en una ventana de entradas de registro | Métricas basadas en registros Alertas basadas en registros Alertas basadas en SQL |
Cálculo a partir de
|
Coincidir solo con los registros incluidos | Se calcula a partir de las entradas de registro en una ventana deslizante. | Registros disponibles Alertas basadas en SQL |
| Opera con métricas de todos los proyectos en el permiso de métricas de la proyecto de permisos | Operar solo en registros en el proyecto de permisos | Opera en todos los registros legibles de cualquier proyecto de Google Cloud. | Alertas en múltiples proyectos |
| El incidente se crea cuando el valor de una métrica cumple una condición durante un período específico | Se crea un incidente cada vez que una entrada de registro específica coincide con un filtro. | El incidente se crea cuando la tabla de resultados de la consulta cumple una condición. | Incidentes y notificaciones |
| Creadas y administradas en Monitoring | Se crea en Logging. administrada en Monitoring |
Se crea en el Análisis de registros. administrada en Monitoring | Cómo crear y administrar políticas de alertas Alertas basadas en SQL |
| Visto en Monitoring | Visto en Monitoring | Visto en Monitoring | Cómo ver las políticas de alertas |
| Puede usar cualquier canal de notificaciones compatible con Monitoring | Puede usar cualquier canal de notificaciones compatible con Monitoring | Puede usar cualquier canal de notificaciones compatible con Monitoring | Canales de notificaciones |
Registros disponibles
Las métricas basadas en registros definidas por el usuario se calculan a partir de todos los registros recibidos la API de Logging para el proyecto de Google Cloud, sin importar filtros de inclusión o filtros de exclusión que podrían aplicarse el proyecto de Google Cloud. Si creas una política de alertas basada en una métrica basada en registros que define el usuario, la política supervisa los datos de todos los registros.
Las métricas basadas en registros definidas por el sistema se calculan solo a partir de registros que se almacenaron en buckets de registros en proyecto de Google Cloud. Si un registro se excluyó explícitamente excluido, no se incluye en estas métricas. Si creas una política de alertas basada en una métrica basada en registros que define el sistema, la política solo supervisará los datos de los registros incluidos.
Las políticas de alertas basadas en registros solo funcionan en registros incluidos que se originan en un proyecto. No puedes usar políticas de alertas basadas en registros para recibir notificaciones sobre mensajes en registros excluidos o registros de otros recursos, como carpetas o organizaciones.
Las métricas basadas en registros y las políticas de alertas basadas en registros operan en el permiso del proyecto de Google Cloud, no en buckets individuales.
Las políticas de alertas basadas en SQL consultan vistas de registros en buckets de registros. Estos buckets de registros deben actualizarse para usar el Análisis de registros y, luego, vincularse a un conjunto de datos de BigQuery. Para obtener más información sobre las políticas de alertas basadas en SQL, consulta Supervisa los resultados de tu consulta en SQL con una política de alertas.
Alertas en múltiples proyectos
Puedes supervisar las métricas de varios proyectos mediante la configuración de un permiso de métrica. Un permiso de métricas enumera todos los proyectos y cuentas que supervisa. Un proyecto de permisos aloja el permiso de métricas. El proyecto de permisos almacena las políticas de alertas y otras opciones de configuración que creas para el permiso de las métricas. El proyecto de permisos para un permiso de métricas es el proyecto que selecciona el selector de proyectos de la consola de Google Cloud.
Las políticas de alertas basadas en métricas basadas en registros, como las políticas de alertas basadas en otras métricas, funcionan en todos los proyectos dentro del permiso de las métricas del proyecto de permisos.
Las políticas de alertas basadas en registros y las políticas de alertas basadas en SQL no operan en permisos de métricas. Los registros de los proyectos no forman parte de un permiso de métricas. Una política de alertas basada en registros solo evalúa los registros que se originan en el proyecto actual o que se dirigen a él. Una política de alertas basada en SQL consulta una vista de registro en un bucket de registro.
Para obtener más información sobre los permisos de las métricas, incluidos los permisos de métricas de varios proyectos, y sobre los proyectos de permisos, consulta lo siguiente:
Las políticas de alertas basadas en SQL pueden consultar vistas de registro de cualquier bucket de registros
en cualquier proyecto de Google Cloud, siempre y cuando se cumplan los permisos read correspondientes
se otorgó en el conjunto de datos vinculado de BigQuery.
Incidentes y notificaciones
Cuando se cumple la condición de una política de alertas, abre un incidente y envía notificaciones a los canales de notificación de la política de alertas. Para ver los detalles del incidente, haz clic en Ver incidente. en el mensaje de notificación o navega directamente a la Página Incidentes en Monitoring.
Incidentes para las políticas de alertas basadas en métricas
Las políticas de alertas basadas en métricas basadas en registros crean incidentes y notificaciones, como todas las demás políticas de alertas basadas en métricas en Monitoring, como se describe en Comportamiento de alertas. Si deseas obtener más información sobre la administración de incidentes para las políticas de alertas basadas en métricas, consulta Incidentes para políticas de alertas basadas en métricas.
Incidentes para políticas de alertas basadas en registros
Las políticas de alertas basadas en registros no son políticas de alertas basadas en métricas. Cuando una entrada de registro cumple con la condición de una política de alertas basada en registros, Monitoring crea incidentes y notificaciones de la siguiente manera:
La primera vez que Cloud Logging escribe una entrada de registro que coincide con tu consulta de alerta en un bucket de registro, se crea un incidente y se envía una notificación. Si se escribe otra entrada de registro que coincida, entonces, se genera un incidente nuevo. solo si se cerró el incidente anterior. Sin embargo, un incidente cerrado puede tardar hasta tres minutos en borrarse definitivamente. Cuando se recibe una entrada de registro que coincida en los tres minutos posteriores al cierre de un incidente, el sistema puede reabrirlo en lugar de crear un incidente nuevo.
Cuando creas una política de alertas basada en registros, puedes especificar el tiempo mínimo entre notificaciones. Por ejemplo, puedes seleccionar 10 minutos como tiempo entre notificaciones. Si la condición de tu la política de alertas basada en registros se cumple dos veces en ese período, recibirás solo una notificación.
La frecuencia máxima de notificaciones para las políticas de alertas basadas en registros es 1 notificación cada 5 minutos para cada política de alertas basada en registros. Sin embargo, si la consulta de tu política de alertas basada en registros extrae valores de etiqueta entonces, cada combinación de los valores extraídos representa su propia línea de tiempo de notificaciones. Por ejemplo, supongamos que un usuario la política de alertas extrae los valores de una etiqueta. Supongamos que la etiqueta puede tener dos valores. Con esta configuración, podrías recibir dos notificaciones, una para cada valor de etiqueta, en los mismos 5 minutos.
Existe un límite de 20 notificaciones por día para cada política de alertas basada en registros. Si llegas a este límite, la notificación incluirá un mensaje que indica que alcanzaste el límite establecido para ese día.
Los incidentes se cierran automáticamente después de 7 días a menos que configures un período más corto o cierres los incidentes de forma manual.
Si deseas obtener más información para administrar incidentes para políticas de alertas basadas en registros, consulta Administra incidentes para políticas de alertas basadas en registros.
Incidentes para políticas de alertas basadas en SQL
Para políticas de alertas basadas en SQL, Cloud Monitoring crea un incidente la primera vez que el resultado de si la consulta en SQL cumple con la condición especificada en la política. Cada la política de alertas tiene un solo incidente abierto. Mientras el incidente esté abierto, Si la condición se vuelve a cumplir, Monitoring no crea más incidentes o enviar notificaciones adicionales. Monitoring cierra los incidentes basados en SQL después de siete días, a menos que configures un período más corto para cerrar el incidente por tu cuenta.
Si necesitas más información sobre la administración de incidentes para las políticas de alertas basadas en SQL, consulta Administra incidentes para las políticas de alertas basadas en SQL.
Crea y administra políticas de alertas
Puedes crear, modificar y borrar políticas de alertas en función de las métricas basadas en registros en Cloud Monitoring, como cualquier otra política de alertas basada en métricas. Para obtener más información, consulta Administra políticas.
Puedes crear políticas de alertas basadas en registros mediante el Explorador de registros o la API de Cloud Monitoring. Modificas y borras políticas de alertas basadas en registros en Monitoring o con la API de Cloud Monitoring. Para obtener más información, consulta Administra políticas de alertas basadas en registros.
Puedes crear políticas de alertas basadas en SQL con Análisis de registros o la API de Cloud Monitoring. Modificas y borras las alertas basadas en SQL. políticas en Monitoring o mediante con la API de Cloud Monitoring. Para obtener más información, consulta Supervisa los resultados de tus consultas de SQL con una política de alertas.
Visualiza las políticas de alertas
La página Políticas de Monitoring muestra todos los políticas de alertas en tu proyecto de Google Cloud. Esta lista incluye políticas que usan métricas basadas en registros y políticas de alertas basadas en registros.
-
En la consola de Google Cloud, ve a la página notifications Alertas.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona Ver todas las políticas.
Las políticas de alertas basadas en registros aparecen en la lista con el valor Logs en la columna Tipo. Las políticas de alertas basadas en métricas, incluidas las basadas en registros, aparecen en la lista con el valor Metrics en la columna Tipo.
Las políticas de alertas basadas en SQL aparecen en la lista con el valor SQL en la columna Tipos.
En la siguiente captura de pantalla, se muestra un extracto de una lista de políticas:
Canales de notificaciones
Puedes enviar notificaciones desde cualquier tipo de política de alertas a cualquiera de los canales de notificación compatibles con Monitoring. Tú debes configurar estos canales antes de que puedas usarlos en las políticas de alertas.
Para obtener más información, consulta Administra los canales de notificaciones.
Requisitos de autorización
El uso de métricas basadas en registros o políticas de alertas basadas en registros requiere autorización para Cloud Logging y Cloud Monitoring.
Para las métricas basadas en registros que define el usuario, consulta Permisos de métricas basadas en registros.
Para las políticas de alertas basadas en registros, consulta Permisos de las políticas de alertas basadas en registros.
Para políticas de alertas basadas en SQL, consulta Permisos para políticas de alertas basadas en SQL.
Costos y límites
Si defines tus propias métricas basadas en registros, se aplicará lo siguiente:
- Existen límites para la cantidad y la estructura de las métricas basadas en registros definidas por el usuario. Para obtener más información sobre estos límites, consulta límites de métricas basadas en registros.
- Es posible que se generen cargos por las métricas basadas en registros que define el usuario. Para obtener más información sobre los costos asociados con la transferencia de métricas, consulta Métricas cobrables.
- Las políticas de alertas basadas en SQL se ejecutan en una reserva de BigQuery en tu proyecto de Google Cloud. Es posible que se te cobre por tener Reserva de BigQuery. Para obtener más información sobre los costos asociados con las reservas de BigQuery, consulta Precios de BigQuery.
No hay cargos asociados con el uso de políticas de alertas basadas en métricas basadas en registros.
Se aplican los siguientes límites de Monitoring relacionados con las políticas de alertas:
| Categoría | Valor | Tipo de política1 |
|---|---|---|
| Políticas de alertas (suma del registro y la métrica) por alcance de métricas 2 | 500 | Métrica, registro |
| Condiciones por política de alertas basada en métricas | 6 | Métrica |
| Condiciones por política de alertas basada en SQL (versión preliminar pública) | 1 | SQL |
| Período máximo que una condición de ausencia de métricas evalúa3 |
1 día | Métrica |
| Período máximo que una condición de umbral de métrica evalúa3 |
23 horas y 30 minutos | Métrica |
| Es la longitud máxima del filtro que se usa en una condición de umbral de métrica. |
2,048 caracteres Unicode | Métrica |
| Cantidad máxima de series temporales que supervisa una condición de previsión |
64 | Métrica |
| Ventana de previsión mínima | 1 hora (3,600 segundos) | Métrica |
| Período máximo de previsión | 2.5 días (216,000 segundos) | Métrica |
| Canales de notificaciones por política de alertas | 16 | Métrica, registro |
| Frecuencia máxima de notificaciones4 | 1 notificación cada 5 minutos de cada política de alertas basada en registros | Registro |
| Cantidad máxima de notificaciones | 20 notificaciones al día para cada política de alertas basada en registros | Registro |
| Cantidad máxima de incidentes abiertos simultáneamente por política de alertas |
1,000 | Métrica |
| Período después del cual se cierra automáticamente un incidente sin datos nuevos |
7 días | Métrica |
| Duración máxima de un incidente si no se cierra de forma manual | 7 días | Registro |
| Retención de incidentes cerrados | 13 meses | No aplicable |
| Retención de incidentes abiertos | Indefinido | No aplicable |
| Canales de notificaciones por alcance de métricas | 4,000 | No aplicable |
| Cantidad máxima de políticas de alertas por posposición | 16 | Métrica, registro |
| Retención de una alerta pospuesta | 13 meses | No aplicable |
2Apigee y Apigee Hybrid están profundamente integrados en Cloud Monitoring. El límite de alertas para todos los niveles de suscripción de Apigee (Standard, Enterprise y Enterprise Plus) es el mismo que para Cloud Monitoring: 500 por alcance de métrica.
3El período máximo que una condición evalúa es la suma del período de alineación y los valores del período de duración. Por ejemplo, si el período de alineación se establece en 15 horas y el período de duración se establece en 15 horas, se requieren 30 horas de datos para evaluar la condición.
4Si la consulta de tu política de alertas basada en registros extrae valores de etiqueta, cada combinación de valores extraídos representa su propio cronograma de notificaciones. Por ejemplo, supongamos que una política de alertas basada en registros extrae los valores de una etiqueta. Supongamos que la etiqueta puede tener dos valores. Con esta configuración, podrías recibir dos notificaciones, una para cada valor de etiqueta, en la misma 5 minutos.