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 criteri di avviso.

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

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

Prima di iniziare

Prima di poter creare regole di allarme, devi eseguire il deployment di un punto di monitoraggio.

Allarmi in AppNeta

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

Ad esempio, se la latenza supera 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 notificare il tuo team.

Per ulteriori informazioni sugli avvisi, consulta Panoramica degli avvisi o Avvisi - Best practice nella documentazione di AppNeta.

Creare 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 Criteri 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.

Una volta attivato 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 impostare i criteri di avviso.

Per ulteriori informazioni sulla creazione di regole di allarme, consulta Regole di allarme nella documentazione di AppNeta.

Visualizza i log in 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 valori per logName:

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

Per saperne di più, consulta Creare e salvare 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 di 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

  • Nome log: networkmanagement.googleapis.com/insights_alarm
  • Attivato: generato quando vengono soddisfatte le condizioni di una regola di allarme.
  • Etichette risorsa: descrive la risorsa monitorata associata al log. Sono inclusi:
    • type: il tipo di risorsa, può essere uno dei seguenti:
      • networkmanagement.googleapis.com/NetworkMonitoringProvider
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
    • labels - Coppie chiave-valore che identificano l'istanza di 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 log allarmi

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

Campo Tipo Descrizione
alarm_id string L'identificatore univoco dell'allarme in AppNeta.
alarm_type enum Il tipo di allarme. È supportato il tipo QUALITY_OF_SERVICE.
state enum Lo stato dell'allarme. Può essere RAISED, UPDATED (i dettagli dell'allarme sono stati aggiornati in AppNeta ma non ancora risolti) o CLEARED.
alarm_severity enum La gravità dell'allarme. Può essere CRITICAL, MAJOR, MINOR o WARNING.
rule string Il nome della regola di avviso che ha attivato l'avviso.
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.
raised_time timestamp L'ora in cui è stato attivato l'allarme.
cleared_time timestamp L'ora in cui l'allarme è stato disattivato. Questo campo sarà vuoto se il log dell'allarme ha lo stato RAISED o UPDATED.
provider_link string Un link ipertestuale all'allarme nell'interfaccia utente di AppNeta.
item oggetto L'entità associata all'allarme. Per maggiori dettagli, consulta Strutture comuni degli elementi.

Log eventi

  • Nome 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 degli eventi forniscono informazioni sugli eventi attivati.

Campi del log eventi

Il jsonPayload di un log eventi contiene i seguenti campi.

Campo Tipo Descrizione
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 o QOS_CHANGE.
item oggetto L'entità associata all'evento. Per maggiori dettagli, consulta Strutture comuni degli elementi.
event_detail oggetto Dettagli specifici per il tipo di evento. Può essere route_change_event, mtu_change_event o qos_change_event. Verrà restituito un oggetto vuoto per gli eventi che non hanno ulteriori dettagli.

Strutture comuni degli articoli

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

NetworkPathItem

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

WebPathItem

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

MonitoringPointItem

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

MonitoringPointHost

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