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 :

  • Les événements de routeur liés à votre routeur cloud
  • 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 Cloud de Confiance , accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Sélectionnez un routeur cloud dans la liste des routeurs cloud.

  3. Dans la colonne Journaux, cliquez sur Afficher.

    Les journaux Cloud Router ont les formats suivants :

    • Événements d'annonce de routeur, BGP et 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 routes 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 enregistré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 mondiale).
  • 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 de l'épuisement du quota, l'entrée de journal inclut des informations à leur sujet 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 de sa limite ou l'a dépassée).
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 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 routes 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 du ou des routeurs Cloud Router qui gèrent la ou 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 Cloud de Confiance , 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

Étapes suivantes

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