Afficher les journaux et les métriques

Cloud Router envoie des informations de journalisation à Cloud Logging et des métriques de surveillance à Cloud Monitoring. Cette page vous explique comment accéder à ces deux types d'informations.

Journaux

Cloud Router envoie des informations de journalisation à Cloud Logging, qui consigne les événements suivants :

  • Événements de routeur liés à votre Cloud Router
  • Les événements BGP liés à une configuration et à une session BGP
  • Les événements de routage liés aux annonces de routage entre les deux pairs BGP
  • Événements de quota de routes liés aux quotas de préfixes uniques Cloud Router

Afficher les journaux

Console

  1. Dans la console Google Cloud , accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Sélectionnez un Cloud Router dans la liste des Cloud Routers.

  3. Dans la colonne Journaux, cliquez sur Afficher.

    Les journaux Cloud Router ont les formats suivants :

    • Événements de routeur, BGP et d'annonce de route : journaux (compute.googleapis.com/router_events) associés à la ressource surveillée gce_router :

      [Event Type]: [Log Text]

    • Événements de quota de route : journaux JSON (router.googleapis.com/route_quota_events) associés à la ressource surveillée gce_network_region. Pour en savoir plus sur la structure de la charge utile, consultez Journal des événements de quota de routes.

  4. Pour créer des requêtes dans l'explorateur de journaux, consultez la page Créer des requêtes dans l'explorateur de journaux.

Journal d'informations

Le tableau suivant répertorie les événements enregistrés dans le journal d'informations de Logging.

Événement Description
Événement de routeur Tâche de routeur activée.
Tâche de routeur désactivée.
Événement BGP La configuration des pairs a bien été ajoutée : LIST_OF_PEERS.
L'appairage BGP avec PEER a eu lieu il y a x secondes.
L'appairage BGP avec PEER a été interrompu pour la raison MESSAGE, où MESSAGE fournit une explication telle que HOLD_TIMER_EXPIRED ou LINK_DOWN.
Pour en savoir plus sur LINK_DOWN, consultez la section Le message LINK_DOWN s'affiche dans les journaux Cloud Router.
ID de routeur BGP défini sur BGP_ROUTER_ID.
Événement de routage Annonce du préfixe aux pairs : PREFIX.
Retrait du préfixe des pairs : PREFIX.
Préfixe PREFIX pour les sauts suivants LIST_OF_NEXTHOPS reçu par Cloud Router.
Préfixe PREFIX pour les sauts suivants LIST_OF_NEXTHOPS supprimé de Cloud Router.

Événements de journalisation courants

Pour afficher les événements de journalisation courants de Cloud Router répertoriés dans le tableau suivant, suivez la procédure d'affichage des journaux. Spécifiez l'un des filtres avancés répertoriés dans le tableau. Ajustez la période de recherche au sein de la journalisation le cas échéant.

Description de l'événement Filtre avancé Logging
Migrer ou redémarrer un processus Cloud Router. resource.type="gce_router"
"task activated"
Ajouter des routes apprises. resource.type="gce_router"
"received by cloud router"
Supprimer des routes apprises. resource.type="gce_router"
"deleted from cloud router"
Exporter les routes annoncées. resource.type="gce_router"
("Route Event" AND "Advertising prefix")
L'appairage BGP a été effectué. resource.type="gce_router"
("BGP peering" AND "came up")
L'appairage BGP a été conçu avec l'authentification MD5. resource.type="gce_router"
("BGP peering" AND "came up" AND "MD5 authentication enabled")
L'appairage BGP a été interrompu. resource.type="gce_router"
("BGP peering" AND "went down")
L'appairage BGP a été interrompu, car le lien a été interrompu sur le routeur périphérique d'appairage de Google. resource.type="gce_router"
("BGP peering" AND "went down" AND "LINK_DOWN")
Une session BGP a été arrêtée en raison d'un nombre excessif de routes reçues. resource.type="gce_router"
("NOTIFICATION 6/1")
severity="CRITICAL"
Un quota de préfixe de route dynamique Cloud Router a été dépassé resource.type="gce_network_region"
("No more routes" AND "can be programmed")
severity="ERROR"
Une route a été supprimée en raison d'un problème de quota resource.type="gce_network_region"
severity="ERROR"
jsonPayload.affectedResource.routes.nextHopIpAddresses="PEER_IP_ADDRESS"
Session BFD en attente du pair resource.type="gce_router"
("BFD Event" ET "bfd enabled, state [Init, NoDiagnostic]")
Une session BFD a été trouvée resource.type="gce_router"
("BFD Event" ET "to [Up, NoDiagnostic]")
Une session BFD a échoué (le timer Rx a expiré) resource.type="gce_router"
("BFD Event" ET "to [Down, ControlDetectionTimeExpired]")
Une session BFD a échoué (l'état du pair est Down ou AdminDown) resource.type="gce_router"
("BFD Event" ET "to [Down, NeighborSessionDown]")
Une session BFD est désactivée localement resource.type="gce_router"
("BFD Event" ET "bfd disabled")

Journal des événements de quota de routage

Cloud Router écrit les événements de quota de route dans Cloud Logging sous router.googleapis.com/route_quota_events via la ressource surveillée gce_network_region. Ces journaux vous aident à surveiller l'utilisation des préfixes de route par rapport à vos quotas et à identifier les routes supprimées.

Les événements de quota de route sont consignés aux niveaux de gravité suivants :

  • WARNING : l'utilisation des routes approche de la limite de quota (l'utilisation atteint ou dépasse 75% de la limite régionale ou globale).
  • ERROR : l'utilisation des routes atteint ou dépasse 100% de la limite. Les routes excédentaires ne peuvent pas être programmées et sont supprimées. Si des itinéraires sont supprimés en raison d'un quota épuisé, l'entrée de journal inclut des informations sur les itinéraires supprimés dans le champ jsonPayload.affectedResource.routes.

Champs des événements de quota de routage

Les entrées de journal de quota de route contiennent une charge utile JSON structurée (jsonPayload) avec les champs suivants :

Champ Description
eventTime Code temporel de l'événement de quota.
routeQuotaEvent.helperMessage Message décrivant l'état du quota (par exemple, avertissement lorsque l'utilisation d'un quota de préfixes uniques Cloud Router approche ou a dépassé sa limite).
routeQuotaEvent.regionalRouteCount Utilisation du quota Préfixes de routage dynamique Cloud Router uniques propre à une région, par région et par réseau VPC. L'utilisation représente le nombre de préfixes de route uniques traités par le plan de contrôle des routes dynamiques dans une région donnée d'un réseau VPC, reçus de toutes les sessions BGP Cloud Router dans cette même région et ce même réseau.
routeQuotaEvent.regionalRouteLimit La limite du quota Préfixes de routage dynamique Cloud Router uniques propre à une région, par région et par réseau VPC. Cette limite représente le nombre maximal de préfixes de routes uniques pouvant être traités par le plan de contrôle des routes dynamiques dans une région donnée d'un réseau VPC, reçus de toutes les sessions BGP Cloud Router dans cette même région et ce même réseau.
routeQuotaEvent.globalRouteCount Le quota Préfixes de routes dynamiques Cloud Router uniques d'autres régions, par région et par réseau VPC. L'utilisation représente le nombre de préfixes de route uniques traités par le plan de contrôle des routes dynamiques dans une région donnée d'un réseau VPC, reçus de toutes les sessions BGP Cloud Router dans d'autres régions du même réseau.
routeQuotaEvent.globalRouteLimit Quota Préfixes de routes dynamiques Cloud Router uniques d'autres régions, par région et par réseau VPC. Cette limite représente le nombre maximal de préfixes de routes uniques pouvant être traités par le plan de contrôle des routes dynamiques dans une région donnée d'un réseau VPC, reçus de toutes les sessions BGP Cloud Router dans d'autres régions du même réseau.
affectedResource.routes[] Entrée contenant les attributs des préfixes supprimés qui n'ont pas entraîné la création de routes dynamiques lorsque l'utilisation du quota de préfixes uniques d'un Cloud Router dépasse sa limite (présent dans les événements de gravité ERROR). Chaque entrée inclut les attributs suivants :
  • ipPrefix : préfixe (destination) au format CIDR.
  • nextHopIpAddresses : adresses IP BGP des sessions BGP Cloud Router ayant appris le préfixe.
  • medValue : attribut MED.
  • srcRouterIds : ID des routeurs Cloud Router qui gèrent les sessions BGP.

Métriques

Cloud Router publie des métriques sur Cloud Monitoring. Pour obtenir la liste des métriques publiées pour Cloud Router, consultez la section Métriques de surveillance pour Cloud Router.

Toutes les métriques Cloud Router couvrent le trafic IPv4 et IPv6.

Afficher les métriques à l'aide de l'API

Vous pouvez accéder à ces métriques à l'aide de l'API Cloud Monitoring. Pour en savoir plus, consultez la page Lire les données de métrique.

Afficher les métriques à l'aide des tableaux de bord Monitoring

Vous pouvez également créer un tableau de bord personnalisé dans Cloud Monitoring pour analyser ces métriques. Pour en savoir plus, consultez la page Gérer les tableaux de bord personnalisés.

Pour créer un tableau de bord personnalisé, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Monitoring.

    Accéder à Monitoring

  2. Sélectionnez Tableaux de bord, puis, sur la page Aperçu des tableaux de bord, cliquez sur Créer un tableau de bord.

  3. Facultatif : Mettez à jour le titre du tableau de bord avec un nom descriptif pour votre tableau de bord.

  4. Dans la bibliothèque de graphiques, sélectionnez le graphique que vous souhaitez ajouter. Par exemple, pour ajouter un graphique en ligne au tableau de bord, cliquez ou faites glisser l'entrée de la bibliothèque de graphiques vers la zone du graphique.

  5. Dans Titre du graphique, modifiez le titre du graphique ou utilisez le titre suggéré.

  6. Dans la section Quelles données souhaitez-vous afficher ?, procédez comme suit :

    1. Dans Type de ressource, cliquez sur le champ Type à filtrer, puis saisissez Cloud Router.
    2. Dans Métrique, ajoutez une métrique Cloud Router.

  7. Ajustez les contrôles de filtre pour limiter l'affichage à certains routeurs ou sessions.

  8. Pour ajouter une autre métrique, cliquez sur Ajouter une métrique.

Certaines métriques concernent le routeur Cloud Router, tandis que d'autres concernent une session BGP sur un routeur Cloud Router donné. Les métriques Cloud Router sont affichées sous la forme router-name, tandis que les métriques de la session BGP sont affichées sous la forme router-name(bgp-name).

Métriques de surveillance pour Cloud Router

Les chaînes "Type de métrique" de ce tableau doivent être précédées du préfixe router.googleapis.com/. Ce préfixe a été omis dans les entrées du tableau. Lorsque vous interrogez une étiquette, utilisez le préfixe metric.labels. (par exemple, metric.labels.LABEL="VALUE").

Type de métrique Étape de lancement (Niveaux de la hiérarchie des ressources)
Nom à afficher
Genre, type, unité
Ressources surveillées		 Description
Libellés
best_received_routes_count DG  (projet)
Nombre de routes reçues
GAUGE, INT64, 1
gce_router		 Nombre actuel de meilleures routes reçues par le routeur. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
bfd/control/receive_intervals GA  (projet)
Intervalle entre les paquets de contrôle BFD reçus
GAUGE, INT64, ms
gce_router		 Intervalle entre les paquets de contrôle BFD reçus. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bfd/control/received_packets_count GA  (projet)
Paquets de contrôle reçus
DELTA, INT64, 1
gce_router		 Nombre de paquets de contrôle reçus de cette session BFD. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bfd/control/rejected_packets_count GA  (projet)
Paquets de contrôle refusés
DELTA, INT64, 1
gce_router		 Nombre de paquets de contrôle refusés de cette session BFD. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bfd/control/transmit_intervals GA  (projet)
Intervalles de transmission des paquets de contrôle BFD
GAUGE, INT64, ms
gce_router		 Intervalles de transmission des paquets de contrôle BFD. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bfd/control/transmitted_packets_count GA  (projet)
Paquets de contrôle transmis
DELTA, INT64, 1
gce_router		 Nombre de paquets de contrôle transmis de cette session BFD. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bfd/session_flap_events_count GA  (projet)
Oscillation de session BFD
DELTA, INT64, 1
gce_router		 Nombre de chaque type d'événement d'oscillation (passage à l'état "Down") BFD pour cette session BFD. Un événement d'oscillation de session fait référence à la transition depuis l'état "Up". Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
event_type : raison de l'oscillation BFD (par exemple, "AdminDown" ou "ControlDetectionTimeExpired").
bfd/session_up GA  (projet)
État de la session BFD
GAUGE, INT64, 1
gce_router		 Indicateur d'établissement d'une session BFD. 1 indique que la session est opérationnelle. 0 indique que la session est interrompue. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
peer_ip : adresse IP du pair de la session BFD.
bgp/received_routes_count DG  (projet)
Nombre de routes reçues par BGP
GAUGE, INT64, 1
gce_router		 Nombre actuel de routes reçues dans une session BGP. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
bgp_peer_name : nom de la session BGP.
bgp/sent_routes_count DG  (projet)
Nombre de routes envoyées par BGP
GAUGE, INT64, 1
gce_router		 Nombre actuel de routes envoyées dans une session BGP. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
bgp_peer_name : nom de la session BGP.
bgp/session_up DG  (projet)
État de la session BGP
GAUGE, INT64, 1
gce_router		 Indicateur d'établissement d'une session BGP. 1 indique que la session est opérationnelle. 0 indique que la session est interrompue. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
bgp_peer_name : nom de la session BGP.
bgp_sessions_down_count DG  (projet)
Nombre de sessions BGP indisponibles
GAUGE, INT64, 1
gce_router		 Nombre des sessions BGP indisponibles sur le routeur. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
bgp_sessions_up_count DG  (projet)
Nombre de sessions BGP actives
GAUGE, INT64, 1
gce_router		 Nombre des sessions BGP actives sur le routeur. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
dynamic_routes/learned_routes/any_dropped_unique_destinations BÊTA  (projet)
Toutes les destinations uniques supprimées
GAUGE, BOOL, 1
gce_network_region 		Métrique booléenne indiquant si des destinations uniques ont été supprimées dans une région du réseau à cause d'un dépassement de quota. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 60 secondes.
routing_mode : mode de routage de la route, parmi ["global" - appris des régions distantes ; "régional" - appris des régions locales].
dynamic_routes/learned_routes/dropped_unique_destinations BÊTA  (projet)
Destinations uniques supprimées
GAUGE, INT64, 1
gce_network_region 		Nombre de destinations uniques qui ont été supprimées dans une région du réseau en raison d'un dépassement de quota. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 60 secondes.
routing_mode : mode de routage de la route, parmi ["global" - appris des régions distantes ; "régional" - appris des régions locales].
dynamic_routes/learned_routes/unique_destinations_limit BÊTA  (projet)
Limite de destinations uniques
GAUGE, INT64, 1
gce_network_region 		Nombre maximal de destinations uniques autorisées par le quota de routage pour cette région du réseau. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 60 secondes.
routing_mode : mode de routage de la route, parmi ["global" - appris des régions distantes ; "régional" - appris des régions locales].
dynamic_routes/learned_routes/used_unique_destinations BÊTA  (projet)
Destinations uniques utilisées
GAUGE, INT64, 1
gce_network_region 		Nombre de destinations uniques utilisées par les routes apprises pour cette région du réseau. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 60 secondes.
routing_mode : mode de routage de la route, parmi ["global" - appris des régions distantes ; "régional" - appris des régions locales].
nat/allocated_ports DG  (projet)
Ports alloués
GAUGE, INT64, {port}
nat_gateway		 Nombre de ports alloués à toutes les VM via la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
nat_ip : adresse IP NAT des ports.
nat/closed_connections_count DG  (projet)
Nombre de connexions fermées
DELTA, INT64, {connection}
nat_gateway		 Nombre de connexions fermées via la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/dropped_received_packets_count DG  (projet)
Nombre de paquets reçus supprimés
DELTA, INT64, {packet}
nat_gateway		 Nombre de paquets reçus et supprimés par la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/dropped_sent_packets_count DG  (projet)
Nombre de paquets envoyés supprimés
DELTA, INT64, {packet}
nat_gateway		 Nombre de paquets envoyés et supprimés par la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
reason : raison de la suppression de paquets. Voici des valeurs possibles : "OUT_OF_RESOURCES", "ENDPOINT_INDEPENDENCE_CONFLICT".
nat/nat_allocation_failed DG  (projet)
Échec de l'allocation NAT
GAUGE, BOOL, 
nat_gateway		 Indique si l'allocation d'adresses IP NAT à une VM de la passerelle NAT a échoué. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 120 secondes.
nat/new_connections_count DG  (projet)
Nombre de nouvelles connexions
DELTA, INT64, {connection}
nat_gateway		 Nombre de connexions créées sur la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/open_connections DG  (projet)
Connexions ouvertes
GAUGE, INT64, {connection}
nat_gateway		 Nombre de connexions actuellement ouvertes sur la passerelle NAT. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/port_usage DG  (projet)
Utilisation du port
GAUGE, INT64, {port}
nat_gateway		 Nombre maximal de connexions entre la VM et un seul point de terminaison Internet (IP:port). Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/received_bytes_count DG  (projet)
Nombre d'octets reçus
DELTA, INT64, By
nat_gateway		 Nombre d'octets reçus (destination -> VM) via la passerelle NAT. Cette valeur est échantillonnée toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/received_packets_count DG  (projet)
Nombre de paquets reçus
DELTA, INT64, {packet}
nat_gateway		 Nombre de paquets reçus (destination -> VM) via la passerelle NAT. Cette valeur est échantillonnée toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/sent_bytes_count DG  (projet)
Nombre d'octets envoyés
DELTA, INT64, By
nat_gateway		 Nombre d'octets envoyés (VM -> destination) via la passerelle NAT. Cette valeur est échantillonnée toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
nat/sent_packets_count DG  (projet)
Nombre de paquets envoyés
DELTA, INT64, {packet}
nat_gateway		 Nombre de paquets envoyés (VM -> destination) via la passerelle NAT. Cette valeur est échantillonnée toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 225 secondes.
ip_protocol : protocole de la connexion. Il peut s'agir de TCP, UDP ou ICMP.
router_up DG  (projet)
Tâches du routeur opérationnelles
GAUGE, INT64, 1
gce_router		 Nombre de tâches logicielles de routeur qui s'exécutent correctement. Une valeur supérieure ou égale à 1 indique que le routeur est opérationnel, bien que toutes les tâches logicielles ne soient pas en cours d'exécution. Comparez le nombre renvoyé au nombre attendu de tâches logicielles pour le routeur. La valeur 0 indique que le routeur est arrêté. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
sent_routes_count DG  (projet)
Nombre de routes envoyées
GAUGE, INT64, 1
gce_router		 Nombre actuel de routes envoyées par le routeur. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.

Tableau généré le 08-10-2026 à 15:22:12 UTC.

Étapes suivantes

  • Pour résoudre les problèmes liés à l'utilisation de Cloud Router, consultez la page Dépannage.