Configurar a geração de registros

Nesta página, você encontra informações sobre como o Cloud Network Insights se integra ao AppNeta para geração de alarmes e como esses alarmes são enviados ao Google Cloud para análise, visualização e criação de políticas de alerta.

As tarefas de geração de registros e alertas são divididas entre Google Cloud e AppNeta. O registro do Cloud Network Insights rastreia quando as métricas coletadas pelos pontos de monitoramento violam os limites configurados com regras de alarme no AppNeta.

Crie alarmes e regras de alarme no AppNeta para gerar registros de alarme. Os registros de alarmes e eventos são exportados para o Cloud Logging. Em seguida, use políticas de alertas para enviar alertas e notificações quando ocorrer um incidente de rede.

Antes de começar

É necessário implantar um ponto de monitoramento antes de criar regras de alarme.

Alarmes no AppNeta

Os alarmes e as regras de alarme são criados no AppNeta. Os alarmes avisam quando há um problema na sua rede. Se uma métrica que você acompanha, como a latência, exceder um limite definido em um intervalo específico, isso é uma violação da regra de alarme. Você pode acionar um alarme após uma única violação ou após várias violações em um intervalo definido.

Por exemplo, se a latência exceder 160 ms duas vezes em três minutos, você poderá definir o alarme para acionar um aviso. Esse alarme é enviado para Google Cloud como um registro. Quando o registro chegar ao Cloud Logging, você poderá enviar um alerta e notificar sua equipe.

Para mais informações sobre alarmes, consulte Visão geral dos alarmes ou Alarmes – Práticas recomendadas na documentação do AppNeta.

Criar regras de alarme no AppNeta

Crie regras de alarme que definam limites de performance.

  1. Abra o console do Google Cloud e acesse Network Intelligence > Cloud Network Insights > Políticas de alerta.

    Acessar as políticas de alertas

  2. Clique em Criar regras de alarme para abrir a página Editar regra de alarme no AppNeta.

  3. Defina regras especificando métricas, limites, estratégias de violação e gravidade. Você pode usar ou personalizar as regras padrão.

Quando um alarme é acionado, o registro dele é enviado para o Cloud Logging. Depois que o registro for enviado para Google Cloud, navegue até o Cloud Network Insights e defina suas políticas de alerta.

Para mais informações sobre como criar regras de alarme, consulte Regras de alarme na documentação do AppNeta.

Ver registros em Google Cloud

O Cloud Network Insights exporta registros detalhados para o Cloud Logging para ajudar você a analisar e resolver problemas de desempenho da rede e eventos significativos. É possível acessar esses registros usando a Análise de registros.

  1. No console do Google Cloud , acesse a página Análise de registros.

    Acessar a Análise de registros

  2. Crie consultas para alertar sobre informações relevantes.

Os registros do Cloud Network Insights usam um dos seguintes para logName:

  • Registros de alarmes: networkmanagement.googleapis.com/insights_alarm
  • Logs de eventos - networkmanagement.googleapis.com/insights_event

Para mais informações, consulte Criar e salvar consultas usando a linguagem de consulta do Logging.

Preços

Todos os registros do Cloud Network Insights são gravados no Cloud Logging. Não há cobrança separada do Cloud Network Insights por esse serviço. No entanto, esses registros podem resultar em custos adicionais de armazenamento, dependendo do tamanho dos registros gravados e armazenados.

Para informações sobre os preços do Cloud Logging, consulte Preços do Google Cloud Observability: Cloud Logging.

Detalhes do registro

Embora os detalhes específicos de cada tipo de registro estejam contidos no campo jsonPayload, vários outros campos padrão de LogEntry são cruciais para consultar e entender os registros.

Registros de alarmes

  • Nome do registro: networkmanagement.googleapis.com/insights_alarm
  • Acionado: gerado quando as condições de uma regra de alarme são atendidas.
  • Rótulos de recursos: descreve o recurso monitorado associado ao registro. Isso inclui o seguinte:
    • type: o tipo de recurso, que pode ser um dos seguintes:
      • networkmanagement.googleapis.com/NetworkMonitoringProvider
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
    • labels: pares de chave-valor que identificam a instância de recurso específica, como resource_container (ID do projeto), location, network_monitoring_provider_id e path_id ou monitoring_point_id.
  • Campos JSON de chave: os registros de alarmes fornecem informações sobre alarmes acionados.
  • Mapeamento de gravidade: a gravidade é registrada de maneira diferente entre o AppNeta e o Google Cloud.
    Gravidade do AppNeta Gravidade do registro do Google Cloud
    Crítico CRITICAL
    Grave ERRO
    Leve AVISO
    Aviso AVISO

Campos de registro de alarmes

O jsonPayload de um registro de alarme contém os seguintes campos.

Campo Tipo Descrição
alarm_id string O identificador exclusivo do alerta no AppNeta.
alarm_severity enum A gravidade do alarme. Pode ser CRITICAL, MAJOR, MINOR ou WARNING.
alarm_type enum O tipo do alarme. O tipo QUALITY_OF_SERVICE é compatível.
cleared_time timestamp O horário em que o alerta foi removido. Esse campo vai ficar vazio se o registro de alarme tiver o estado RAISED ou UPDATED.
description string Uma descrição legível do alarme.
first_violation_time timestamp O horário em que a condição do alerta foi violada pela primeira vez.
item objeto A entidade associada ao alarme. Consulte Estruturas de itens comuns para mais detalhes.
provider_link string Um hiperlink para o alarme na interface do AppNeta.
raised_time timestamp O horário em que o alarme foi gerado.
receiveTimestamp string A hora em que o alarme foi criado no Google Cloud.
rule string O nome da regra de alerta que acionou o alerta.
state enum O estado do alarme. Pode ser RAISED, UPDATED (os detalhes do alarme foram atualizados no AppNeta, mas ainda não foram limpos) ou CLEARED.
timestamp string A hora em que o alarme foi criado no AppNeta.

Logs de eventos

  • Nome do registro: networkmanagement.googleapis.com/insights_event
  • Gatilho: gerado quando ocorre uma mudança estrutural (por exemplo, Route Change, MTU Change ou Monitoring Point Offline).
  • Gravidade: sempre INFO.
  • Campos JSON principais: os registros de eventos fornecem informações sobre eventos acionados.

Campos de log de eventos

O jsonPayload de um log de eventos contém os seguintes campos.

Campo Tipo Descrição
event_detail objeto Detalhes específicos do tipo de evento. Os valores podem ser route_change_event, mtu_change_event ou qos_change_event. Um objeto vazio será retornado para eventos sem mais detalhes.
event_id string O identificador exclusivo do evento.
event_type enum O tipo de evento. Pode ser MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE ou QOS_CHANGE.
item objeto A entidade associada ao evento. Consulte Estruturas de itens comuns para mais detalhes.
receiveTimestamp string O horário em que o evento foi criado em Google Cloud.
timestamp string O horário em que o evento foi criado no AppNeta.

Estruturas comuns de itens

O campo "item" no jsonPayload dos registros de alarmes e eventos contém detalhes sobre a entidade associada. A estrutura depende do tipo de item.

NetworkPathItem

Campo Tipo Descrição
destination string O endereço IP ou nome do host de destino.
destination_monitoring_point MonitoringPointItem Detalhes do MonitoringPointItem de destino (somente para caminhos de MonitoringPoint para MonitoringPoint).
display_name string O nome de exibição definido pelo usuário do caminho de rede.
monitoring_policy_display_name string O nome de exibição da política de monitoramento.
monitoring_policy_id string O ID da política de monitoramento.
network_protocol string O protocolo de rede usado, como TCP, UDP ou ICMP.
provider_tags matriz de objetos Tags definidas no AppNeta para o caminho.
source_monitoring_point MonitoringPointItem Detalhes do MonitoringPointItem de origem.

WebPathItem

Campo Tipo Descrição
destination string O URL de destino.
display_name string O nome de exibição definido pelo usuário do caminho da Web.
monitoring_policy_display_name string O nome de exibição da política de monitoramento.
monitoring_policy_id string O ID da política de monitoramento.
provider_tags matriz Tags definidas no provedor para o caminho.
source_monitoring_point objeto Detalhes do MonitoringPoint de origem.

MonitoringPointItem

Campo Tipo Descrição
display_name string O nome de exibição do ponto de monitoramento definido pelo usuário.
host objeto Detalhes do host do ponto de monitoramento.
id string O identificador exclusivo do ponto de monitoramento.
provider_tags matriz Tags definidas no provedor para o ponto de monitoramento.

MonitoringPointHost

Campo Tipo Descrição
cloud_instance_id string O ID da instância do provedor de nuvem.
cloud_project_id string O ID do projeto Google Cloud .
cloud_provider string Provedor de nuvem, como GCP, AWS ou AZURE.
cloud_region string A região da nuvem do endpoint, por exemplo, us-central1.
cloud_virtual_network_ids matriz de strings IDs de rede virtual do Cloud visíveis para o usuário.
cloud_zone string A zona de nuvem do endpoint, por exemplo, us-central1-a.
labels mapa Rótulos definidos pelo usuário configurados na instância da VM.
os string O sistema operacional do host do ponto de monitoramento.