Configura il logging

Questa pagina fornisce informazioni su come Cloud Network Insights si integra con AppNeta per la generazione di allarmi e su come questi allarmi vengono inviati a Google Cloud per l'analisi, la visualizzazione e la creazione di policy di avviso.

Le attività di logging e avviso sono suddivise tra Google Cloud e AppNeta. Il logging di Cloud Network Insights monitora quando le metriche raccolte dai punti di monitoraggio violano le soglie configurate con le regole di allarme in AppNeta.

Crea allarmi e regole di allarme in AppNeta per generare log di allarme. I log degli allarmi e i log eventi vengono quindi esportati in Cloud Logging. Puoi quindi utilizzare le policy di avviso per inviare avvisi e notifiche quando si verifica un incidente di rete.

Prima di iniziare

Devi eseguire il deployment di un punto di monitoraggio prima di poter creare regole di allarme.

Allarmi in AppNeta

Gli allarmi e le regole di allarme vengono creati in AppNeta. Gli allarmi ti informano quando si verifica un problema nella rete. Se una metrica che monitori, ad esempio la latenza, supera una soglia impostata entro un intervallo specifico, si verifica una violazione della regola di allarme. Puoi scegliere di attivare un allarme dopo una singola violazione o dopo più violazioni in un intervallo impostato.

Ad esempio, se la latenza supera i 160 ms due volte in 3 minuti, puoi impostare l'allarme in modo che attivi un avviso. Questo allarme viene inviato a Google Cloud come log. Una volta che il log arriva in Cloud Logging, puoi inviare un avviso e informare il tuo team.

Per ulteriori informazioni sugli allarmi, consulta la sezione Panoramica degli allarmi o Allarmi - Best practice nella documentazione di AppNeta.

Crea regole di allarme in AppNeta

Crea regole di allarme che definiscono le soglie di rendimento.

  1. Apri la console Google Cloud e vai a Network Intelligence > Cloud Network Insights > Policy di avviso.

    Vai a Policy di avviso

  2. Fai clic su Crea regole di allarme per aprire la pagina Modifica regola di allarme in AppNeta.

  3. Definisci regole che specificano metriche, soglie, strategie di violazione e gravità. Puoi utilizzare o personalizzare le regole predefinite.

Dopo l'attivazione di un allarme, il log dell'allarme viene inviato a Cloud Logging. Dopo l'invio del log a Google Cloud, puoi andare a Cloud Network Insights e configurare le policy di avviso.

Per saperne di più sulla creazione di regole di allarme, consulta Regole di allarme nella documentazione di AppNeta.

Visualizza i log quando connesso Google Cloud

Cloud Network Insights esporta log dettagliati in Cloud Logging per aiutarti ad analizzare e risolvere i problemi relativi alle prestazioni di rete e agli eventi significativi. Puoi accedere a questi log utilizzando Esplora log.

  1. Nella console Google Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Crea query per ricevere avvisi su informazioni pertinenti.

I log di Cloud Network Insights utilizzano uno dei seguenti ID log:

  • Log degli allarmi: networkmanagement.googleapis.com/insights_alarm
  • Log eventi: networkmanagement.googleapis.com/insights_event

Per saperne di più, consulta Crea e salva query utilizzando il linguaggio di query di Logging.

Prezzi

Tutti i log di Cloud Network Insights vengono scritti in Cloud Logging. Non è previsto un addebito separato da Cloud Network Insights per questo servizio. Tuttavia, questi log possono comportare costi di archiviazione aggiuntivi a seconda delle dimensioni dei log scritti e archiviati.

Per informazioni sui prezzi di Cloud Logging, consulta Prezzi di Google Cloud Observability: Cloud Logging.

Dettagli log

Sebbene i dettagli specifici per ogni tipo di log siano contenuti nel campo jsonPayload, diversi altri campi LogEntry standard sono fondamentali per eseguire query e comprendere i log.

Log degli allarmi

  • ID log: networkmanagement.googleapis.com/insights_alarm
  • Attivato: generato quando vengono soddisfatte le condizioni di una regola di allarme.
  • Etichette delle risorse: descrive la risorsa monitorata associata al log. In questa pagina puoi:
    • type: il tipo di risorsa, che può essere uno dei seguenti:
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
      • networkmanagement.googleapis.com/WebPath
    • labels: coppie chiave-valore che identificano l'istanza della risorsa specifica, ad esempio resource_container (ID progetto), location, network_monitoring_provider_id e path_id o monitoring_point_id.
  • Campi JSON chiave: i log degli allarmi forniscono informazioni sugli allarmi attivati.
  • Mappatura della gravità: la gravità viene registrata in modo diverso tra AppNeta e Google Cloud.
    Gravità AppNeta Gravità dei log di Google Cloud
    Critico CRITICO
    Alta ERRORE
    Bassa AVVISO
    Avviso NOTIFICA

Campi del log degli allarmi

Il campo jsonPayload di un log degli allarmi contiene i seguenti campi.

Campo Tipo Descrizione
alarm_id string L'identificatore univoco dell'allarme in AppNeta.
alarm_severity enum La gravità dell'allarme. Può essere CRITICAL, MAJOR, MINOR o WARNING.
alarm_type enum Il tipo di allarme. Il tipo QUALITY_OF_SERVICE è supportato.
cleared_reason string Il motivo per cui l'allarme è stato cancellato. Generato solo quando state = "CLEARED" (omesso o null in caso contrario). I valori di stringa comuni includono alarm-rule-no-longer-violated, stale, rule-deleted e duplicate.
cleared_time timestamp L'ora in cui l'allarme è stato cancellato. Questo campo sarà vuoto se il log degli allarmi ha lo stato RAISED o UPDATED.
description string Una descrizione dell'allarme leggibile da una persona.
first_violation_time timestamp L'ora in cui la condizione di allarme è stata violata per la prima volta.
item oggetto L'entità associata alla sveglia. Per maggiori dettagli, consulta Strutture degli elementi comuni.
noise_conditions array di stringhe Identifica le condizioni filtro del rumore che hanno attivato questo allarme per la coppia di regola ed elemento specificata. Gli allarmi vengono valutati in base a una soglia di frequenza di 24 ore e a una finestra di burst a breve termine.

Può contenere uno o entrambi i seguenti valori:

  • frequent-detection: attivato quando le occorrenze di allarme sullo stesso elemento raggiungono la soglia di 24 ore (valore predefinito: 5 allarmi).
  • burst-detection: attivato quando si verificano più allarmi entro la finestra temporale configurata (valore predefinito: più di 1 allarme ogni 60 minuti).

Restituisce un array vuoto o viene omesso del tutto se l'allarme non è considerato rumoroso.

provider_link string Un link ipertestuale all'allarme nella UI di AppNeta.
raised_time timestamp L'ora in cui è stato attivato l'allarme.
receiveTimestamp string L'ora in cui è stata creata la sveglia in Google Cloud.
rule string Il nome della regola di allarme che ha attivato l'allarme.
state enum Lo stato dell'allarme. Può essere RAISED, UPDATED (i dettagli dell'allarme sono stati aggiornati in AppNeta, ma non ancora cancellati) o CLEARED.
timestamp string L'ora in cui è stato creato l'allarme in AppNeta.

Log eventi

  • ID log: networkmanagement.googleapis.com/insights_event
  • Trigger: generato quando si verifica una modifica strutturale (ad esempio Route Change, MTU Change o Monitoring Point Offline).
  • Gravità: sempre INFO.
  • Campi JSON chiave: i log eventi forniscono informazioni sugli eventi attivati.

Campi del log eventi

Il jsonPayload di un log eventi contiene i seguenti campi.

Campo Tipo Descrizione
event_detail oggetto Dettagli specifici del tipo di evento. Può essere route_change_event, mtu_change_event, qos_change_event o forwarding_loss_clear_event. Per gli eventi che non hanno ulteriori dettagli, verrà restituito un oggetto vuoto. Per maggiori dettagli, consulta Campi dei dettagli degli eventi.
event_id string L'identificatore univoco di questo evento.
event_type enum Il tipo di evento. Può essere MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE, QOS_CHANGE o FORWARDING_LOSS_CLEAR.
item oggetto L'entità associata all'evento. Per maggiori dettagli, consulta Strutture degli elementi comuni.
receiveTimestamp string L'ora in cui l'evento è stato creato in Google Cloud.
timestamp string L'ora in cui l'evento è stato creato in AppNeta.

Campi dei dettagli dell'evento

L'oggetto event_detail contiene dettagli specifici del tipo di evento. A seconda di event_type, contiene uno dei seguenti oggetti nidificati:

Per gli eventi senza ulteriori dettagli viene restituito un oggetto vuoto.

Evento di modifica della MTU (mtu_change_event)

Questo oggetto acquisisce i dettagli ogni volta che viene modificata la dimensione della MTU.

Campo Tipo Descrizione
new_mtu int32 La MTU appena misurata.
previous_mtu int32 L'MTU precedente, se presente (omesso all'avvio).
mtu_exceeded oggetto hop Hop contenente i dettagli (ad esempio l'indirizzo IP) del nodo che segnala l'errore "pacchetto troppo grande". Per maggiori dettagli, consulta la sezione Hop.

Evento di modifica QoS (qos_change_event)

Questo oggetto segnala la rimappatura QoS su tutti i percorsi rilevati.

Campo Tipo Descrizione
configured_qos int32 La QoS configurata nelle impostazioni del job.
remapped_qos int32 QoS alterata rilevata sul percorso.
ip_address string L'indirizzo IP dell'hop in cui è stata rilevata la modifica della QoS, se noto.

Evento di cancellazione della perdita di inoltro (forwarding_loss_clear_event)

Questo oggetto segnala che la perdita di pacchetti prolungata che inizia in un hop di rete specifico (perdita di forwarding) è stata risolta e che il forwarding normale è stato ripristinato. Questo evento acquisisce il momento in cui riprende il normale inoltro e il timestamp iniziale del sospetto. L'insorgenza della perdita di forwarding viene monitorata utilizzando gli avvisi di AppNeta.

Campo Tipo Descrizione
protocol string Il protocollo di monitoraggio (ad esempio TCP, UDP e ICMP).
first_hop oggetto hop Il primo hop in cui è iniziata la perdita di inoltro. Per maggiori dettagli, consulta Hop.
initial_loss_suspected_time timestamp L'ora in cui è stata inizialmente sospettata la perdita di inoltro.

Evento di modifica del percorso (route_change_event)

L'oggetto acquisisce le differenze nel numero di hop o nella sequenza di indirizzi IP noti tra traceroute consecutivi.

Campo Tipo Descrizione
previous_route_change_time timestamp Il timestamp del traceroute che ha rilevato per la prima volta la route precedente.
protocol string Il protocollo utilizzato per il traceroute (ad esempio TCP, UDP e ICMP).
hop_count int32 Il numero totale di hop nella route.
target_ip string L'indirizzo IP di destinazione del traceroute.
route_changes array di oggetti Un array di tutte le modifiche rilevate. Ogni oggetto contiene una stringa route_change_type e un oggetto details. Consulta i dettagli delle modifiche al percorso.

Dettagli della modifica della route

L'oggetto details all'interno dell'array route_changes dipende da route_change_type:

  • incomplete_route o complete_route
    • terminal_hop (oggetto hop): l'ultimo hop raggiunto correttamente (o l'hop finale se completo).
    • terminal_network (oggetto di rete): le informazioni di rete per l'hop del terminale.
  • route_loop
    • first_hop (oggetto hop): il primo hop nel loop di route rilevato.
    • last_hop (oggetto hop): l'ultimo hop nel loop di route rilevato.
    • loop_span (int32): il numero di hop coinvolti nel loop.
  • target_ip_change
    • previous_target_ip (stringa): l'indirizzo IP di destinazione osservato nel traceroute precedente.
    • new_target_ip (stringa): l'indirizzo IP di destinazione corrente.
  • sequence_change
    • last_common_hop (oggetto hop): l'ultimo hop comune tra i traceroute precedente e corrente.
    • previous_next_hop (oggetto hop): il dispositivo hop successivo precedente nella sequenza.
    • new_next_hop (oggetto hop): il nuovo dispositivo hop successivo nella sequenza.
    • previous_hop_count (int32): numero totale di hop nel traceroute precedente.
    • hop_count (int32): numero totale di hop nel traceroute corrente.
  • network_change
    • previous_asns (array di int32): sequenza di reti ASN per il percorso.
    • new_asns (array di int32): la nuova sequenza di reti ASN per il percorso.
  • isp_change
    • previous_isp (oggetto di rete): l'ISP osservato nel traceroute precedente.
    • new_isp (oggetto di rete): l'ISP corrente osservato.

Oggetti secondari comuni

Gli oggetti hop e di rete vengono restituiti per più campi.

Hop

Gli oggetti hop descrivono un hop di rete specifico.

Campo Tipo Descrizione
hop_number int32 Il numero di hop nel traceroute.
ip_address string L'indirizzo IP dell'hop.
hostname string Il nome host risolto per l'indirizzo IP dell'hop.

Rete

Un oggetto di rete descrive la rete in cui si è verificata un'azione.

Campo Tipo Descrizione
asn int32 Il numero di sistema autonomo (ASN) della rete.
display_name string Il nome della rete (ad esempio il nome dell'ISP o dell'organizzazione).

Strutture degli elementi comuni

Il campo item all'interno di jsonPayload dei log di allarmi e dei log eventi contiene dettagli sull'entità associata. La struttura dipende dal tipo di articolo.

NetworkPathItem

Campo Tipo Descrizione
destination string L'indirizzo IP o il nome host di destinazione.
destination_monitoring_point MonitoringPointItem Dettagli del MonitoringPointItem di destinazione (solo per i percorsi da MonitoringPoint a MonitoringPoint).
display_name string Il nome visualizzato definito dall'utente del percorso di rete.
monitoring_policy_display_name string Il nome visualizzato della policy di monitoraggio.
monitoring_policy_id string L'ID della policy di monitoraggio.
network_protocol string Il protocollo di rete utilizzato, ad esempio TCP, UDP o ICMP.
provider_tags array di oggetti Tag definiti in AppNeta per il percorso.
source_monitoring_point MonitoringPointItem Dettagli del MonitoringPointItem di origine.

WebPathItem

Campo Tipo Descrizione
destination string L'URL di destinazione.
display_name string Il nome visualizzato definito dall'utente del percorso web.
monitoring_policy_display_name string Il nome visualizzato della policy di monitoraggio.
monitoring_policy_id string L'ID della policy di monitoraggio.
provider_tags matrice Tag definiti nel provider per il percorso.
source_monitoring_point oggetto Dettagli del MonitoringPoint di origine.

MonitoringPointItem

Campo Tipo Descrizione
display_name string Il nome visualizzato definito dall'utente del punto di monitoraggio.
host oggetto Dettagli dell'host del punto di monitoraggio.
id string L'identificatore univoco del punto di monitoraggio.
provider_tags matrice Tag definiti nel provider per il punto di monitoraggio.

MonitoringPointHost

Campo Tipo Descrizione
cloud_instance_id string L'ID istanza del cloud provider.
cloud_project_id string L'ID progetto Google Cloud .
cloud_provider string Cloud provider come GCP, AWS o AZURE.
cloud_region string La regione cloud dell'endpoint, ad esempio us-central1.
cloud_virtual_network_ids array di stringhe ID Cloud Virtual Network visibili all'utente.
cloud_zone string La zona cloud dell'endpoint, ad esempio us-central1-a.
labels mappa Etichette definite dall'utente configurate nell'istanza VM.
os string Il sistema operativo dell'host del punto di monitoraggio.