Visualizzazione dei log e delle metriche

Il router Cloud invia le informazioni di logging a Cloud Logging e le metriche di monitoraggio a Cloud Monitoring. Questa pagina mostra come accedere a entrambi i tipi di informazioni.

Log

Il router Cloud invia le informazioni di logging a Cloud Logging, che registra i seguenti eventi:

  • Eventi del router correlati al router Cloud
  • Eventi BGP relativi a una configurazione e a una sessione BGP
  • Eventi di routing relativi agli annunci di route tra i due peer BGP
  • Eventi relativi alle quote di routing correlate alle quote di prefissi unici del router Cloud

Visualizza i log

Console

  1. Nella console Google Cloud , vai alla pagina Router Cloud.

    Vai a Router Cloud

  2. Seleziona un router Cloud dall'elenco dei router Cloud.

  3. Nella colonna Log, fai clic su Visualizza.

    I log del router Cloud hanno i seguenti formati:

    • Eventi di router, BGP e annuncio di route: log (compute.googleapis.com/router_events) associati alla risorsa monitorata gce_router:

      [Event Type]: [Log Text]

    • Eventi quota di route: log JSON (router.googleapis.com/route_quota_events) associati alla risorsa monitorata gce_network_region. Per informazioni dettagliate sulla struttura del payload, vedi Log degli eventi delle quote di route.

  4. Per creare query in Esplora log, vedi Crea query in Esplora log.

Log informativo

La tabella seguente elenca gli eventi registrati nel log Logging Info.

Evento Descrizione
Evento router Attività del router attivata
Attività del router disattivata
Evento BGP Configurazione aggiunta correttamente per i peer: LIST_OF_PEERS
Il peering BGP con PEER è stato stabilito x secondi fa
Il peering BGP con PEER non è andato a buon fine per il motivo MESSAGE, dove MESSAGE fornisce una spiegazione come HOLD_TIMER_EXPIRED o LINK_DOWN.
Per saperne di più su LINK_DOWN, consulta Il messaggio LINK_DOWN viene visualizzato nel router Cloud Router.
ID router BGP impostato su BGP_ROUTER_ID
Evento route Prefisso pubblicitario ai peer: PREFIX
Ritiro del prefisso dai peer: PREFIX
Prefisso PREFIX Hop successivi LIST_OF_NEXTHOPS ricevuti dal router Cloud
Prefisso PREFIX hop successivi LIST_OF_NEXTHOPS eliminati dal router Cloud

Eventi di logging comuni

Per visualizzare gli eventi di logging comuni per router Cloud elencati nella tabella seguente, utilizza i passaggi per visualizzare i log. Specifica uno dei filtri avanzati elencati nella tabella. Modifica il periodo di tempo per la ricerca di Logging in base alle esigenze.

Descrizione evento Filtro avanzato di logging
Migrazione o riavvio di un processo del router Cloud resource.type="gce_router"
"task activated"
Aggiungere le route apprese resource.type="gce_router"
"received by cloud router"
Rimozione delle route apprese resource.type="gce_router"
"deleted from cloud router"
Esportare le route annunciate resource.type="gce_router"
("Route Event" AND "Advertising prefix")
Il peering BGP è stato stabilito resource.type="gce_router"
("BGP peering" AND "came up")
Il peering BGP è stato stabilito con l'autenticazione MD5 resource.type="gce_router"
("BGP peering" AND "came up" AND "MD5 authentication enabled")
Il peering BGP non è attivo resource.type="gce_router"
("BGP peering" AND "went down")
Il peering BGP non è più attivo perché il link non è più attivo sul router di peering Google resource.type="gce_router"
("BGP peering" AND "went down" AND "LINK_DOWN")
Una sessione BGP è stata chiusa a causa di un numero eccessivo di route ricevute resource.type="gce_router"
("NOTIFICATION 6/1")
severity="CRITICAL"
È stata superata una quota di prefissi di route dinamiche del router Cloud resource.type="gce_network_region"
("No more routes" AND "can be programmed")
severity="ERROR"
Un percorso è stato eliminato a causa di un problema di quota resource.type="gce_network_region"
severity="ERROR"
jsonPayload.affectedResource.routes.nextHopIpAddresses="PEER_IP_ADDRESS"
Una sessione BFD in attesa del peer resource.type="gce_router"
("BFD Event" AND "bfd enabled, state [Init, NoDiagnostic]")
È stata avviata una sessione BFD resource.type="gce_router"
("BFD Event" AND "to [Up, NoDiagnostic]")
Una sessione BFD non è più attiva (timer di ricezione scaduto) resource.type="gce_router"
("BFD Event" AND "to [Down, ControlDetectionTimeExpired]")
Una sessione BFD non è attiva (lo stato del peer è Down o AdminDown) resource.type="gce_router"
("BFD Event" AND "to [Down, NeighborSessionDown]")
Una sessione BFD è disabilitata localmente resource.type="gce_router"
("BFD Event" AND "bfd disabled")

Instrada il log eventi della quota

router Cloud scrive gli eventi di quota di route in Cloud Logging in router.googleapis.com/route_quota_events tramite la risorsa monitorata gce_network_region. Questi log ti aiutano a monitorare l'utilizzo del prefisso di route rispetto alle quote e a identificare eventuali route eliminate.

Gli eventi relativi alla quota di route vengono registrati ai seguenti livelli di gravità:

  • WARNING: L'utilizzo delle route si avvicina al limite di quota (l'utilizzo raggiunge o supera il 75% del limite regionale o globale).
  • ERROR: l'utilizzo della route raggiunge o supera il 100% del limite. Le route in eccesso non possono essere programmate e vengono eliminate. Se i percorsi vengono eliminati a causa dell'esaurimento della quota, la voce di log include dettagli sui percorsi eliminati nel campo jsonPayload.affectedResource.routes.

Campi evento quota percorso

Le voci di log della quota di route contengono un payload JSON strutturato (jsonPayload) con i seguenti campi:

Campo Descrizione
eventTime Il timestamp in cui si è verificato l'evento relativo alla quota.
routeQuotaEvent.helperMessage Un messaggio che descrive lo stato della quota, ad esempio, un avviso quando l'utilizzo di una quota di prefisso univoco del router Cloud si sta avvicinando o ha superato il limite.
routeQuotaEvent.regionalRouteCount L'utilizzo della quota prefissi di route dinamiche del router Cloud univoci dalla propria regione per regione per rete VPC. L'utilizzo rappresenta il numero di prefissi di route unici, elaborati dal control plane di routing dinamico in una determinata regione di una rete VPC, ricevuti da tutte le sessioni BGP del router Cloud nella stessa regione e rete.
routeQuotaEvent.regionalRouteLimit Il limite della quota prefissi di route dinamiche di router Cloud univoche della propria regione per regione per rete VPC. Il limite rappresenta il numero massimo di prefissi di route univoci che possono essere elaborati dal control plane delle route dinamiche in una determinata regione di una rete VPC, ricevuti da tutte le sessioni BGP di router Cloud nella stessa regione e rete.
routeQuotaEvent.globalRouteCount L'utilizzo della quota prefissi di route dinamiche del router Cloud univoche di altre regioni per regione per rete VPC. L'utilizzo rappresenta il numero di prefissi di route unici, elaborati dal control plane di routing dinamico in una determinata regione di una rete VPC, ricevuti da tutte le sessioni BGP del router Cloud in altre regioni della stessa rete.
routeQuotaEvent.globalRouteLimit Il limite della quota prefissi di route dinamiche router Cloud univoche di altre regioni per regione per rete VPC. Il limite rappresenta il numero massimo di prefissi di route univoci che possono essere elaborati dal control plane delle route dinamiche in una determinata regione di una rete VPC, ricevuti da tutte le sessioni BGP di router Cloud in altre regioni della stessa rete.
affectedResource.routes[] Una voce contenente gli attributi per i prefissi eliminati che non hanno comportato la creazione di route dinamiche quando l'utilizzo della quota di prefissi univoci del router Cloud supera il limite (presente negli eventi di gravità ERROR). Ogni voce include i seguenti attributi:
  • ipPrefix: il prefisso (destinazione) in formato CIDR.
  • nextHopIpAddresses: gli indirizzi IP BGP delle sessioni BGP del router Cloud che hanno appreso il prefisso.
  • medValue: l'attributo MED.
  • srcRouterIds: gli ID dei router Cloud che gestiscono le sessioni BGP.

Metriche

Router Cloud pubblica le metriche in Cloud Monitoring. Per un elenco delle metriche pubblicate per router Cloud, consulta Monitorare le metriche per Cloud Router.

Tutte le metriche del router Cloud coprono il traffico IPv4 e IPv6.

Visualizzare le metriche utilizzando l'API

Puoi accedere a queste metriche utilizzando l'API Cloud Monitoring. Per saperne di più, consulta Lettura dei dati delle metriche.

Visualizzare le metriche utilizzando le dashboard di Monitoring

Puoi anche creare una dashboard personalizzata in Cloud Monitoring per analizzare queste metriche. Per saperne di più, consulta Gestire le dashboard personalizzate.

Per creare una dashboard personalizzata:

Console

  1. Nella console Google Cloud , vai alla pagina Monitoring.

    Vai a Monitoring

  2. Seleziona Dashboard, quindi nella pagina Panoramica delle dashboard, fai clic su Crea dashboard.

  3. (Facoltativo) Aggiorna il titolo della dashboard con un nome descrittivo.

  4. Nella raccolta di grafici, seleziona il grafico che vuoi aggiungere. Ad esempio, per aggiungere un grafico a linee alla dashboard, fai clic o trascina la voce dalla Libreria di grafici all'area del grafico.

  5. In Titolo grafico, modifica il titolo del grafico o utilizza il titolo suggerito.

  6. In Quali dati vuoi visualizzare?, segui questi passaggi:

    1. In Tipo di risorsa, fai clic sul campo Digita per filtrare e inserisci Cloud Router.
    2. In Metrica, aggiungi una metrica di router Cloud.

  7. Utilizza i controlli Filtro per limitare la visualizzazione solo a determinati router o sessioni.

  8. Per aggiungere un'altra metrica, fai clic su Aggiungi un'altra metrica.

Alcune metriche sono per Cloud Router e altre per una sessione BGP su un determinato router Cloud. Le metriche del router Cloud vengono visualizzate come router-name, mentre le metriche della sessione BGP vengono visualizzate come router-name(bgp-name).

Metriche di monitoraggio per router Cloud

Le stringhe "tipo di metrica" in questa tabella devono essere precedute dal prefisso router.googleapis.com/. Questo prefisso è stato omesso dalle voci della tabella. Quando esegui una query su un'etichetta, utilizza il prefisso metric.labels.; ad esempio, metric.labels.LABEL="VALUE".

Tipo di metrica Fase di lancio (livelli della gerarchia delle risorse)
Nome visualizzato
Tipo, Tipo, Unità
Risorse monitorate		 Descrizione
Etichette
best_received_routes_count GA  (progetto)
Conteggio delle route ricevute
GAUGE, INT64, 1
gce_router 		Numero attuale di percorsi migliori ricevuti dal router. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
bfd/control/receive_intervals GA  (project)
Intervalli di ricezione dei pacchetti di controllo BFD
GAUGE, INT64, ms
gce_router 		Intervalli di ricezione dei pacchetti di controllo BFD. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bfd/control/received_packets_count GA  (progetto)
Pacchetti di controllo ricevuti
DELTA, INT64, 1
gce_router 		Numero di pacchetti di controllo ricevuti da questa sessione BFD. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bfd/control/rejected_packets_count GA  (progetto)
Pacchetti di controllo rifiutati
DELTA, INT64, 1
gce_router 		Numero di pacchetti di controllo rifiutati da questa sessione BFD. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bfd/control/transmit_intervals GA  (project)
BFD control packets transmit intervals
GAUGE, INT64, ms
gce_router 		Intervalli di trasmissione dei pacchetti di controllo BFD. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bfd/control/transmitted_packets_count GA  (project)
Pacchetti di controllo trasmessi
DELTA, INT64, 1
gce_router 		Numero di pacchetti di controllo trasmessi da questa sessione BFD. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bfd/session_flap_events_count GA  (progetto)
Flap della sessione BFD
DELTA, INT64, 1
gce_router 		Numero di ogni evento di flapping BFD di questa sessione BFD. Un evento di flapping della sessione si riferisce alla transizione dallo stato Up. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
event_type: Il motivo del flap BFD, ad esempio "AdminDown" o "ControlDetectionTimeExpired".
bfd/session_up GA  (progetto)
Stato sessione BFD
GAUGE, INT64, 1
gce_router 		Indicatore per la creazione della sessione BFD riuscita. 1 indica che la sessione è attiva. 0 indica che la sessione non è attiva. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
peer_ip: L'IP peer della sessione BFD.
bgp/received_routes_count GA  (progetto)
Conteggio delle route BGP ricevute
GAUGE, INT64, 1
gce_router 		Numero attuale di route ricevute in una sessione BGP. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
bgp_peer_name: Il nome della sessione BGP.
bgp/sent_routes_count GA  (progetto)
Conteggio delle route inviate BGP
GAUGE, INT64, 1
gce_router 		Numero attuale di route inviate in una sessione BGP. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
bgp_peer_name: Il nome della sessione BGP.
bgp/session_up GA  (project)
Stato sessione BGP
GAUGE, INT64, 1
gce_router 		Indicatore per la creazione riuscita della sessione BGP. 1 indica che la sessione è attiva. 0 indica che la sessione non è attiva. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
bgp_peer_name: Il nome della sessione BGP.
bgp_sessions_down_count GA  (project)
Conteggio sessioni BGP non attive
GAUGE, INT64, 1
gce_router 		Numero di sessioni BGP sul router non attive. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
bgp_sessions_up_count GA  (project)
Conteggio sessioni BGP attive
GAUGE, INT64, 1
gce_router 		Numero di sessioni BGP sul router attive. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
dynamic_routes/learned_routes/any_dropped_unique_destinations BETA  (progetto)
Qualsiasi destinazione unica eliminata
GAUGE, BOOL, 1
gce_network_region 		Una metrica booleana che indica se sono state eliminate destinazioni univoche in una regione di rete a causa del superamento della quota. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 60 secondi.
routing_mode: Modalità di routing della route, una tra ["global" - appresa da regioni remote; "regional" - appresa da regioni locali].
dynamic_routes/learned_routes/dropped_unique_destinations BETA  (progetto)
Destinazioni uniche abbandonate
GAUGE, INT64, 1
gce_network_region 		Il numero di destinazioni univoche eliminate in una regione di rete a causa del superamento della quota. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 60 secondi.
routing_mode: Modalità di routing della route, una tra ["global" - appresa da regioni remote; "regional" - appresa da regioni locali].
dynamic_routes/learned_routes/unique_destinations_limit BETA  (progetto)
Limite di destinazioni uniche
GAUGE, INT64, 1
gce_network_region 		Il numero massimo di destinazioni univoche consentite dalla quota di route per questa regione di rete. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 60 secondi.
routing_mode: Modalità di routing della route, una tra ["global" - appresa da regioni remote; "regional" - appresa da regioni locali].
dynamic_routes/learned_routes/used_unique_destinations BETA  (progetto)
Destinazioni uniche utilizzate
GAUGE, INT64, 1
gce_network_region 		Numero di destinazioni univoche utilizzate dalle route apprese per questa regione di rete. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 60 secondi.
routing_mode: Modalità di routing della route, una tra ["global" - appresa da regioni remote; "regional" - appresa da regioni locali].
nat/allocated_ports GA  (progetto)
Porte allocate
GAUGE, INT64, {port}
nat_gateway 		Numero di porte allocate a tutte le VM dal gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
nat_ip: IP NAT delle porte.
nat/closed_connections_count GA  (project)
Conteggio delle connessioni chiuse
DELTA, INT64, {connection}
nat_gateway 		Conteggio delle connessioni chiuse tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/dropped_received_packets_count GA  (progetto)
Conteggio pacchetti ricevuti eliminati
DELTA, INT64, {packet}
nat_gateway 		Conteggio dei pacchetti ricevuti eliminati dal gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/dropped_sent_packets_count GA  (progetto)
Conteggio pacchetti inviati eliminati
DELTA, INT64, {packet}
nat_gateway 		Conteggio dei pacchetti inviati eliminati dal gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
reason: Il motivo della perdita del pacchetto. I valori possibili sono OUT_OF_RESOURCES, ENDPOINT_INDEPENDENCE_CONFLICT.
nat/nat_allocation_failed GA  (project)
NAT allocation failed
GAUGE, BOOL, 
nat_gateway 		Indica se si è verificato un errore nell'allocazione degli IP NAT a una VM nel gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
nat/new_connections_count GA  (progetto)
Conteggio nuove connessioni
DELTA, INT64, {connection}
nat_gateway 		Conteggio delle nuove connessioni create tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/open_connections GA  (progetto)
Connessioni aperte
GAUGE, INT64, {connection}
nat_gateway 		Numero di connessioni attualmente aperte sul gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/port_usage GA  (progetto)
Utilizzo porta
GAUGE, INT64, {port}
nat_gateway 		Numero massimo di connessioni dalla VM a un singolo endpoint internet (IP:porta). Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/received_bytes_count GA  (progetto)
Conteggio byte ricevuti
DELTA, INT64, By
nat_gateway 		Conteggio dei byte ricevuti (destinazione -> VM) tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/received_packets_count GA  (progetto)
Conteggio pacchetti ricevuti
DELTA, INT64, {packet}
nat_gateway 		Conteggio dei pacchetti ricevuti (destinazione -> VM) tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/sent_bytes_count GA  (progetto)
Conteggio byte inviati
DELTA, INT64, By
nat_gateway 		Conteggio dei byte inviati (VM -> destinazione) tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
nat/sent_packets_count GA  (progetto)
Conteggio pacchetti inviati
DELTA, INT64, {packet}
nat_gateway 		Conteggio dei pacchetti inviati (VM -> destinazione) tramite il gateway NAT. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 225 secondi.
ip_protocol: Il protocollo della connessione. Può essere TCP, UDP o ICMP.
router_up GA  (progetto)
Attività del router attive
GAUGE, INT64, 1
gce_router 		Numero di attività software del router in esecuzione. Un valore maggiore o uguale a 1 indica che il router è attivo, anche se non tutte le attività software sono in esecuzione. Confronta il numero restituito con il numero previsto di attività software per il router. Un valore pari a 0 indica che il router non è attivo. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
sent_routes_count GA  (progetto)
Conteggio delle route inviate
GAUGE, INT64, 1
gce_router 		Numero attuale di route inviate dal router. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.

Tabella generata il giorno 08/10/2026 alle 15:22:12 UTC.

Passaggi successivi