Configura el registro

En esta página, se proporciona información sobre cómo Cloud Network Insights se integra con AppNeta para generar alarmas y cómo estas alarmas se envían a Google Cloud para su análisis, visualización y creación de políticas de alertas.

Las tareas de registro y alerta se dividen entre Google Cloud y AppNeta. El registro de Cloud Network Insights realiza un seguimiento de cuándo las métricas recopiladas por los puntos de supervisión incumplen los umbrales que configuras con las reglas de alarma en AppNeta.

Crea alarmas y reglas de alarma en AppNeta para generar registros de alarma. Luego, los registros de alarmas y de eventos se exportan a Cloud Logging. Luego, puedes usar políticas de alertas para enviar alertas y notificaciones cuando ocurra un incidente de red.

Antes de comenzar

Debes implementar un punto de supervisión antes de poder crear reglas de alarma.

Alarmas en AppNeta

Las alarmas y las reglas de alarma se crean en AppNeta. Las alarmas te informan cuando hay un problema en tu red. Si una métrica que supervisas, como la latencia, supera un umbral establecido dentro de un intervalo específico, se considera un incumplimiento de la regla de alarma. Puedes elegir activar una alarma después de un solo incumplimiento o después de varios incumplimientos durante un intervalo establecido.

Por ejemplo, si la latencia supera los 160 ms dos veces en 3 minutos, puedes configurar la alarma para que active una advertencia. Esta alarma se envía a Google Cloud como un registro. Una vez que el registro llega a Cloud Logging, puedes enviar una alerta sobre él y notificar a tu equipo.

Para obtener más información sobre las alarmas, consulta Alarms Overview o Alarms – Best Practices en la documentación de AppNeta.

Crea reglas de alarma en AppNeta

Crea reglas de alarma que definan los umbrales de rendimiento.

  1. Abre la consola de Google Cloud y navega a Inteligencia de la red > Cloud Network Insights > Políticas de alertas.

    Ir a Políticas de alertas

  2. Haz clic en Create Alarm Rules para abrir la página Alarm Rule Edit en AppNeta.

  3. Define reglas que especifican métricas, umbrales, estrategias de incumplimiento y gravedad. Puedes usar o personalizar las reglas predeterminadas.

Una vez que se activa una alarma, el registro de alarma se envía a Cloud Logging. Después de que se envíe el registro a Google Cloud, puedes navegar a Cloud Network Insights y configurar tus políticas de alertas.

Para obtener más información sobre cómo crear reglas de alarma, consulta Alarm Rules en la documentación de AppNeta.

Visualiza los registros en Google Cloud

Cloud Network Insights exporta registros detallados a Cloud Logging para ayudarte a analizar y solucionar problemas relacionados con el rendimiento de la red y los eventos importantes. Puedes acceder a estos registros con el Explorador de registros.

  1. En la consola de Google Cloud , accede a la página Explorador de registros.

    Ve al Explorador de registros

  2. Crea consultas para generar alertas sobre la información pertinente.

Los registros de Cloud Network Insights usan uno de los siguientes valores para logName:

  • Registros de alarma: networkmanagement.googleapis.com/insights_alarm
  • Registros de eventos: networkmanagement.googleapis.com/insights_event

Para obtener más información, consulta Compila y guarda consultas con el lenguaje de consulta de Logging.

Precios

Todos los registros de Cloud Network Insights se escriben en Cloud Logging. Este servicio no se cobra por separado de Cloud Network Insights. Sin embargo, estos registros pueden generar costos de almacenamiento adicionales según el tamaño de los registros que se escriben y almacenan.

Para obtener información sobre los precios de Cloud Logging, consulta Precios de Google Cloud Observability: Cloud Logging.

Detalles de registro

Si bien los detalles específicos de cada tipo de registro se encuentran dentro del campo jsonPayload, varios otros campos estándar de LogEntry son fundamentales para consultar y comprender los registros.

Registros de alarmas

  • Nombre del registro: networkmanagement.googleapis.com/insights_alarm
  • Activada: Se genera cuando se cumplen las condiciones de una regla de alarma.
  • Etiquetas de recursos: Describen el recurso supervisado asociado al registro. Esto incluye lo siguiente:
    • type: Es el tipo de recurso y puede ser uno de los siguientes:
      • networkmanagement.googleapis.com/NetworkMonitoringProvider
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
    • labels: Pares clave-valor que identifican la instancia de recurso específica, como resource_container (ID del proyecto), location, network_monitoring_provider_id y path_id o monitoring_point_id.
  • Campos JSON clave: Los registros de alarma proporcionan información sobre las alarmas activadas.
  • Asignación de gravedad: La gravedad se registra de manera diferente entre AppNeta y Google Cloud.
    Gravedad de AppNeta Gravedad de los registros de Google Cloud
    Crítico CRÍTICO
    Grave (Major) ERROR
    Menor ADVERTENCIA
    Advertencia AVISO

Campos del registro de alarmas

El jsonPayload de un registro de alarma contiene los siguientes campos.

Campo Tipo Descripción
alarm_id cadena Es el identificador único de la alarma en AppNeta.
alarm_severity enum Es la gravedad de la alarma. Puede ser CRITICAL, MAJOR, MINOR o WARNING.
alarm_type enum Es el tipo de alarma. Se admite el tipo QUALITY_OF_SERVICE.
cleared_time timestamp Es la fecha y hora en que se borró la alarma. Este campo estará vacío si el registro de alarma tiene el estado RAISED o UPDATED.
description cadena Es una descripción de la alarma legible por humanos.
first_violation_time timestamp Es la fecha y hora en que se incumplió la condición de alarma por primera vez.
item objeto Es la entidad asociada con la alarma. Consulta Estructuras de elementos comunes para obtener más detalles.
provider_link cadena Es un hipervínculo a la alarma en la IU de AppNeta.
raised_time timestamp Es la fecha y hora en que se activó la alarma.
receiveTimestamp cadena Es la fecha y hora en que se creó la alarma en Google Cloud.
rule cadena Es el nombre de la regla de alarma que activó la alarma.
state enum Es el estado de la alarma. Puede ser RAISED, UPDATED (los detalles de la alarma se actualizaron en AppNeta, pero aún no se borraron) o CLEARED.
timestamp cadena Es la fecha y hora en que se creó la alarma en AppNeta.

Registros de eventos

  • Nombre del registro: networkmanagement.googleapis.com/insights_event
  • Trigger: Se genera cuando ocurre un cambio estructural (por ejemplo, Route Change, MTU Change o Monitoring Point Offline).
  • Severity: Siempre es INFO.
  • Campos clave de JSON: Los registros de eventos proporcionan información sobre los eventos activados.

Campos del registro de eventos

El objeto jsonPayload de un registro de eventos contiene los siguientes campos.

Campo Tipo Descripción
event_detail objeto Son los detalles específicos del tipo de evento. Puede ser route_change_event, mtu_change_event, o qos_change_event. Se devolverá un objeto vacío para los eventos que no tengan más detalles.
event_id cadena Es el identificador único de este evento.
event_type enum El tipo de evento Puede ser MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE o QOS_CHANGE.
item objeto Es la entidad asociada al evento. Consulta Estructuras de elementos comunes para obtener más detalles.
receiveTimestamp cadena Es la fecha y hora en que se creó el evento en Google Cloud.
timestamp cadena Es la fecha y hora en que se creó el evento en AppNeta.

Estructuras de elementos comunes

El campo item dentro del jsonPayload de los registros de alarma y de evento contiene detalles sobre la entidad asociada. La estructura depende del tipo de elemento.

NetworkPathItem

Campo Tipo Descripción
destination cadena Es la dirección IP o el nombre de host de destino.
destination_monitoring_point MonitoringPointItem Son los detalles del MonitoringPointItem de destino (solo para rutas de MonitoringPoint a MonitoringPoint).
display_name cadena Es el nombre visible definido por el usuario de la ruta de red.
monitoring_policy_display_name cadena Es el nombre visible de la política de supervisión.
monitoring_policy_id cadena Es el ID de la política de supervisión.
network_protocol cadena Protocolo de red utilizado, como TCP, UDP o ICMP.
provider_tags Array de objetos Son las etiquetas definidas en AppNeta para la ruta.
source_monitoring_point MonitoringPointItem Son los detalles del objeto MonitoringPointItem de origen.

WebPathItem

Campo Tipo Descripción
destination cadena Es la URL de destino.
display_name cadena Es el nombre visible definido por el usuario de la ruta web.
monitoring_policy_display_name cadena Es el nombre visible de la política de supervisión.
monitoring_policy_id cadena Es el ID de la política de supervisión.
provider_tags array Son las etiquetas definidas en el proveedor para la ruta de acceso.
source_monitoring_point objeto Son los detalles del objeto MonitoringPoint de la fuente.

MonitoringPointItem

Campo Tipo Descripción
display_name cadena Es el nombre visible definido por el usuario del punto de supervisión.
host objeto Son los detalles del host del punto de supervisión.
id cadena Es el identificador único del punto de supervisión.
provider_tags array Son las etiquetas definidas en el proveedor para el punto de supervisión.

MonitoringPointHost

Campo Tipo Descripción
cloud_instance_id cadena Es el ID de la instancia del proveedor de servicios en la nube.
cloud_project_id cadena ID del proyecto Google Cloud
cloud_provider cadena Proveedor de servicios en la nube, como GCP, AWS o AZURE.
cloud_region cadena Región de la nube del extremo, por ejemplo, us-central1.
cloud_virtual_network_ids Es un array de cadenas. Son los IDs de Cloud Virtual Network visibles para el usuario.
cloud_zone cadena Es la zona de Cloud del extremo, por ejemplo, us-central1-a.
labels mapa Son las etiquetas definidas por el usuario que se configuraron en la instancia de VM.
os cadena Es el sistema operativo del host del punto de supervisión.