Surveillance du BGP

Une fois que vous avez activé BGP sur un projet et initié une session, la page BGP de votre projet et la page BGP de votre serveur afficheront toutes deux des informations sur les sessions actives et les routes apprises.

Statut BGP sur le projet

Console

La section Réseau de votre projet, sur la page BGP, contient:

• Quel type de BGP est activé: local ou global.
• L'ASN: 65 000 pour BGP local ou votre propre ASN pour BGP global.
• Le mot de passe MD5, si vous en définissez un.
• Un tableau avec toutes les sessions BGP sur tous les serveurs du projet.

Le tableau présente les détails de session pour chaque serveur, y compris l'état de la session et la date de sa dernière mise à jour. L'état est automatiquement mis à jour toutes les six heures, mais vous pouvez le modifier manuellement pour toutes les sessions en cliquant sur Mettre à jour maintenant.

Cliquez sur la flèche à côté d'une entrée de session pour afficher et gérer la session BGP depuis la page BGP du serveur.

CLI

Vous pouvez obtenir la configuration BGP de votre projet à partir de la commande metal project bgp-config.

metal project bgp-config -p <project_id>

Vous pouvez obtenir une liste de toutes les sessions BGP sur tous les serveurs du projet à partir de la commande metal project bgp-sessions.

metal project bgp-sessions -p <project_id>

API

Dans l'API, récupérez la configuration BGP et les informations de session d'un projet en envoyant une requête GET au point de terminaison /projects/{id}/bgp-config.

curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: <API_TOKEN>" "https://api.equinix.com/metal/v1/projects/{id}/bgp-config" 

Si vous voulez simplement une liste des sessions du projet et leurs détails, envoyez une requête GET au point de terminaison /projects/{id}/bgp/sessions.

curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: <API_TOKEN>" "https://api.equinix.com/metal/v1/projects/{id}/bgp/sessions"

État de la session BGP

Console

Dans l'onglet BGP du serveur, le tableau affiche les informations de session BGP pour les sessions IPv4 et IPv6, notamment la liste des routes apprises, l'état actuel de la session (statut de session) et la date de sa dernière mise à jour. L'état est mis à jour automatiquement toutes les six heures, mais vous pouvez le modifier manuellement en cliquant sur Mettre à jour maintenant.

Cliquer sur Gérer à côté d'une session affiche le panneau Activer BGP. Utilisez le bouton bascule pour activer ou désactiver les sessions BGP sur ce serveur. Utilisez le bouton bascule Route par défaut pour définir cette route comme itinéraire par défaut.

La désactivation d'une session BGP supprime les routes apprises et réinitialise toutes les connexions ouvertes. Soyez prudent avant de désactiver la session. La désactivation de BGP ne supprime aucune configuration BGP sur le serveur ; si nécessaire, vous pouvez réactiver la session et recommencer à publier les routes sans modifier la configuration du serveur. Si vous réactivez la session, l'établissement de la session peut prendre de 5 à 10 minutes.

API

Pour faire fonctionner toutes les sessions d'un serveur, envoyez une requête GET au point de terminaison /devices/{id}/bgp/sessions.

curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: <API_TOKEN>" "https://api.equinix.com/metal/v1/devices/{id}/bgp/sessions"

Pour obtenir des informations relatives à une session BGP spécifique, envoyez une requête GET au point de terminaison /bgp/sessions/{id}.

curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: <API_TOKEN>" "https://api.equinix.com/metal/v1/bgp/sessions/{id}"

Pour obtenir les données voisines d'une session, envoyez une requête GET au point de terminaison /devices/{id}/bgp/neighbors.

curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: <API_TOKEN>" "https://api.equinix.com/metal/v1/devices/{id}/bgp/neighbors"

Statuts de session possibles

Chaque session BGP a un statut possible de Disabled, Up, Down, Partial ou Unknown.

• Disabled - L'état désactivé s'affiche sur la page BGP du projet si vous avez activé BGP, mais n'avez pas encore établi de session BGP. Par exemple, une session peut annoncer une adresse IPv4, mais pas une adresse IPv6. L'état d'une session IPv4 est Up et celui d'une session IPv6 est Disabled.
• Up - La session BGP est établie. Les routeurs Equinix Metal reçoivent les adresses IP que vous annoncez et apprennent les routes vers vos serveurs. Sur un Equinix IBX, ce statut indique également que la session BGP est active sur les deux routeurs.
• Down - La session BGP est interrompue. Soit vous n'avez pas encore configuré l'hôte, soit un élément de la configuration présente un dysfonctionnement. Si vous avez vérifié la configuration de votre hôte, essayez de désactiver puis de réactiver la session BGP. Patientez de 5 à 10 minutes, le temps que la session se rétablisse. Si le problème persiste, veuillez contacter le soutien technique.
• Partial - Si votre serveur est dans un Equinix IBX et que la session BGP est active sur un seul des deux routeurs, l'état sera Partial. Cela peut indiquer qu'une opération de maintenance est en cours sur l'un des routeurs. Cet état devrait être temporaire ; s'il persiste, veuillez contacter le soutien technique.
• Unknown - Une session aura un statut inconnu juste après son activation, le temps que l'établissement de la session se fasse. La mise à jour du statut prend généralement entre 5 et 10 minutes. Si le statut reste inconnu plus longtemps, cliquez sur Mettre à jour maintenant pour le mettre à jour manuellement.