Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Crea reglas de alertas

En esta página, se describe el proceso para crear reglas de alertas basadas en registros y métricas de los entornos aislados de Google Distributed Cloud (GDC) para facilitar la supervisión proactiva y una respuesta ante incidentes más rápida.

GDC te permite definir reglas de alertas basadas en las métricas o los registros de tu proyecto. Estas reglas activan alertas automáticamente cuando se cumplen condiciones específicas. Los siguientes son los tipos de reglas de alertas que puedes definir:

Reglas basadas en métricas: Activan alertas basadas en datos numéricos recopilados de tus aplicaciones o infraestructura. Por ejemplo, puedes crear una regla para activar una alerta si el uso de CPU supera el 80%. Crea reglas basadas en métricas con la consola de GDC o una definición de recurso personalizado MonitoringRule.
Reglas basadas en registros: Activan alertas basadas en el análisis de datos de registro. Estas alertas te permiten identificar eventos o patrones específicos en tus registros y responder a ellos, como mensajes de error o actividades inusuales. Crea reglas basadas en registros con la consola de GDC o una definición de recurso personalizado LoggingRule.

Las reglas basadas en métricas y en registros se basan en una expresión de lenguaje de consulta para definir la condición que activa una alerta. Esta expresión filtra y analiza los datos entrantes, y evalúa si se cumplen los criterios definidos.

La primera vez que se cumple una condición, la alerta pasa al estado pendiente. Si las condiciones son verdaderas durante el período de duración que definas, la alerta pasa al estado abierto. En ese momento, el sistema envía la alerta.

Para proporcionar más contexto y facilitar la administración eficiente de alertas, puedes agregar etiquetas y anotaciones a tus reglas de alertas:

Etiquetas: Son pares clave-valor que categorizan e identifican alertas. Usa etiquetas para obtener información como la siguiente:
- Nivel de gravedad (error, crítico, advertencia)
- Código de alerta
- Nombre del recurso
Anotaciones: Proporcionan información adicional no identificable para enriquecer la alerta. Las anotaciones pueden incluir la siguiente información:
- Mensajes de error detallados
- Expresiones relevantes
- Vínculos a manuales de operaciones o guías de solución de problemas

Antes de comenzar

Para administrar reglas basadas en métricas o basadas en registros, debes tener los permisos necesarios.

### Solicita roles de IAM de la organización para reglas basadas en métricas

Comunícate con tu administrador de IAM de la organización para solicitar los siguientes roles:

Creador de MonitoringRule PA (monitoringrule-pa-creator): Crea recursos personalizados MonitoringRule.
Editor de MonitoringRule PA (monitoringrule-pa-editor): Edita o modifica recursos personalizados MonitoringRule.
Visualizador de MonitoringRule PA (monitoringrule-pa-viewer): Visualiza recursos personalizados MonitoringRule.

Solicita roles de IAM del proyecto para reglas basadas en métricas

Comunícate con tu administrador de IAM del proyecto para solicitar los siguientes roles:

Editor de MonitoringRule (monitoringrule-editor): Edita o modifica recursos personalizados MonitoringRule en el espacio de nombres del proyecto.
Visualizador de MonitoringRule (monitoringrule-viewer): Visualiza recursos personalizados MonitoringRule en el espacio de nombres del proyecto.

Solicita roles de IAM de la organización para reglas basadas en registros

Comunícate con tu administrador de IAM de la organización para solicitar los siguientes roles:

Creador de LoggingRule PA (loggingrule-pa-creator): Crea recursos personalizados LoggingRule.
Editor de LoggingRule PA (loggingrule-pa-editor): Edita o modifica recursos personalizados LoggingRule.
Visualizador de LoggingRule PA (loggingrule-pa-viewer): Visualiza recursos personalizados LoggingRule.

Solicita roles de IAM del proyecto para reglas basadas en registros

Comunícate con tu administrador de IAM del proyecto para solicitar los siguientes roles:

Editor de LoggingRule (loggingrule-editor): Edita o modifica recursos personalizados LoggingRule en el espacio de nombres del proyecto.
Visualizador de LoggingRule (loggingrule-viewer): Visualiza recursos personalizados LoggingRule en el espacio de nombres del proyecto.

Define reglas de alertas

Puedes definir reglas de alertas en el espacio de nombres de tu proyecto con la consola de GDC (opción preferida) o las APIs de Monitoring y Logging para aplicar recursos personalizados.

Selecciona uno de los siguientes métodos para definir reglas de alertas basadas en métricas o registros:

Console

Crea reglas de alertas en grupos de reglas desde la consola de GDC:

En la consola de GDC, selecciona un proyecto.
En el menú de navegación, selecciona Operaciones > Alertas.
Haz clic en la pestaña Política de alertas.
Haz clic en Crear grupo de reglas.
Elige el tipo de regla de alerta:
- Selecciona Métricas para las reglas de alertas basadas en métricas.
- Selecciona Registros para las reglas de alertas basadas en registros.
Configura el grupo de reglas de alertas:
- En el campo Nombre del grupo de reglas de alertas, ingresa un nombre para el grupo de reglas.
- En el campo Intervalo de evaluación de reglas, ingresa la cantidad de segundos para cada intervalo.
- En el campo Límite, ingresa la cantidad máxima de alertas.
  
  Nota: Ingresa 0 para alertas ilimitadas.
En la sección Reglas de alertas, haz clic en Agregar regla.
En la ventana Crear regla de alerta, ingresa los siguientes detalles:
- Un nombre para la regla de alerta
- Una expresión para la regla de alerta (usa LogQL para reglas basadas en registros y PromQL para reglas basadas en métricas).
  
  Nota: Esta expresión debe evaluarse como una instrucción verdadera o falsa, que determina si la alerta debe pasar a un estado pendiente o no.
- La duración en segundos antes de que una alerta pase de pendiente a abierta.
  
  Nota: Si estableces la duración en un valor de 0, el sistema envía la alerta inmediatamente después de que se cumpla la condición.
- El nivel de gravedad, como Error o Advertencia.
- Un nombre corto para identificar el recurso relacionado
- Un código de alerta para identificar la alerta
- Una URL de manual de operaciones o información para solucionar problemas
- Un mensaje o una descripción de la alerta
- Opcional: Agrega Etiquetas y Anotaciones como pares clave-valor.
Haz clic en Guardar para crear la regla.
Haz clic en Crear para crear el grupo de reglas.

El grupo de reglas aparece en la lista Grupo de reglas de alertas. Puedes agrupar más reglas de alertas en este grupo de reglas.

API

Crea reglas de alertas desde las APIs de Monitoring o Logging:

Define un recurso personalizado MonitoringRule (reglas basadas en métricas) o LoggingRule (reglas basadas en registros) en un archivo YAML.

La especificación de recursos completa muestra un ejemplo para reglas basadas en métricas y en registros.

Reemplaza los siguientes valores en el archivo YAML según tus necesidades:

Campo	Descripción
`namespace`	El espacio de nombres del proyecto
`name`	El nombre de la configuración de la regla de alerta
`source`	La fuente de registro de la regla de alerta Las opciones válidas son `operational` y `audit`. Solo se aplica a los recursos `LoggingRule`.
`interval`	La duración del intervalo de evaluación de reglas en segundos
`limit`	Opcional. La cantidad máxima de alertas Ingresa `0` para alertas ilimitadas.
`alertRules`	Las definiciones para crear reglas de alertas
`alertRules.alert`	El nombre de la alerta
`alertRules.expr`	Una expresión LogQL para reglas basadas en registros o una expresión PromQL para reglas basadas en métricas La expresión debe evaluarse como un valor verdadero o falso para determinar si la alerta pasa a un estado pendiente.
`alertRules.for`	Opcional. La duración en segundos antes de que una alerta pase de pendiente a abierta. El valor predeterminado es `0` segundos (activación inmediata).
`alertRules.labels`	Pares clave-valor para categorizar e identificar la alerta Requiere las siguientes etiquetas: `severity`, `code`, y `resource`.
`alertRules.annotations`	Opcional. Metadatos no identificables para la alerta como pares clave-valor

Guarda el archivo YAML.
Aplica la configuración de recursos al servidor de la API de Management dentro del mismo espacio de nombres que tus reglas de alertas basadas en métricas o en registros:
```
kubectl --kubeconfig KUBECONFIG_PATH apply -f ALERT_RULE_NAME.yaml
```
Reemplaza lo siguiente:
- KUBECONFIG_PATH: Es la ruta al archivo kubeconfig para el servidor de la API de Management.
- ALERT_RULE_NAME: Es el nombre del archivo de definición MonitoringRule o LoggingRule.

Especificación de recursos completa

En esta sección, se incluyen las plantillas YAML que puedes usar para crear reglas de alertas basadas en métricas y en registros mediante la aplicación de recursos personalizados. Si creas alertas desde la consola de GDC, puedes omitir esta sección.

Define reglas de alertas en los siguientes recursos personalizados:

MonitoringRule: Reglas basadas en métricas
LoggingRule: Reglas basadas en registros

MonitoringRule

En el siguiente archivo YAML, se muestra una plantilla para el recurso personalizado MonitoringRule. Para obtener más información, consulta la documentación de referencia de la API.

# Configures either an alert or a target record for precomputation.
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringRule
metadata:
  # Choose a namespace that matches the project namespace.
  # The alert or record is produced in the same namespace.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_RULE_NAME
spec:
  # Rule evaluation interval.
  interval: 60s

  # Configure the limit for the number of alerts.
  # A value of '0' means no limit.
  # Optional.
  # Default value: '0'
  limit: 0

  # Configure metric-based alert rules.
  alertRules:
    # Define an alert name.
  - alert: my-metric-based-alert

    # Define the PromQL expression to evaluate for this rule.
    expr: rate({service_name="bob-service"} [1m])

    # The duration in seconds before an alert transitions from pending to open.
    # Optional.
    # Default value: '0s'
    for: 0s

    # Define labels to add or overwrite.
    # Map of key-value pairs.
    # Required labels:
    #     severity: [error, critical, warning, info]
    #     code:
    #     resource: component/service/hardware related to the alert
    # Additional labels are optional.
    labels:
      severity: error
      code: 202
      resource: AIS
      another-label: another-value

    # Define annotations to add.
    # Map of key-value pairs.
    # Optional.
    # Recommended annotations:
    #     message: value of the Message field in the user interface.
    #     expression: value of the Rule field in the user interface.
    #     runbookurl: URL of the Actions to take field in the user interface.
    annotations:
      message: my-alert-message

Reemplaza lo siguiente:

PROJECT_NAMESPACE: Es el espacio de nombres de tu proyecto.
MONITORING_RULE_NAME: Es el nombre del archivo de definición MonitoringRule.

LoggingRule

En el siguiente archivo YAML, se muestra una plantilla para el recurso personalizado LoggingRule. Para obtener más información, consulta la documentación de referencia de la API.

# Configures either an alert or a target record for precomputation.
apiVersion: logging.gdc.goog/v1
kind: LoggingRule
metadata:
  # Choose a namespace that matches the project namespace.
  # The alert or record is produced in the same namespace.
  namespace: PROJECT_NAMESPACE
  name: LOGGING_RULE_NAME
spec:
  # Choose the log source to base alerts on (operational or audit logs).
  # Optional.
  # Valid options: 'operational' and 'audit'
  # Default value: 'operational'
  source: operational

  # Rule evaluation interval.
  interval: 60s

  # Configure the limit for the number of alerts.
  # A value of '0' means no limit.
  # Optional.
  # Default value: '0'
  limit: 0

  # Configure log-based alert rules.
  alertRules:
    # Define an alert name.
  - alert: my-log-based-alert

    # Define the LogQL expression to evaluate for this rule.
    expr: rate({service_name="bob-service"} [1m])

    # The duration in seconds before an alert transitions from pending to open.
    # Optional.
    # Default value: '0s'
    for: 0s

    # Define labels to add or overwrite.
    # Map of key-value pairs.
    # Required labels:
    #     severity: [error, critical, warning, info]
    #     code:
    #     resource: component/service/hardware related to the alert
    # Additional labels are optional.
    labels:
      severity: warning
      code: 202
      resource: AIS
      another-label: another-value

    # Define annotations to add.
    # Map of key-value pairs.
    # Optional.
    # Recommended annotations:
    #     message: value of the Message field in the user interface.
    #     expression: value of the Rule field in the user interface.
    #     runbookurl: URL of the Actions to take field in the user interface.
    annotations:
      message: my-alert-message