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 des informations sur les sessions actives et les routes apprises.

Statut du 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 : 65000 pour le BGP local ou votre propre ASN pour le BGP global.
• Le mot de passe MD5, si vous en avez défini un.
• Un tableau contenant toutes les sessions BGP sur tous les serveurs du projet.

Le tableau répertorie les détails de la 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 l'actualiser manuellement pour toutes les sessions en cliquant sur Update Now.

Cliquez sur la flèche à côté d'une entrée de session pour visualiser et gérer la [session BGP] (#bgp-session-status) à partir de 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 à l'aide 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 pour 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 souhaitez simplement obtenir la 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 fournit des informations sur les sessions BGP pour les sessions IPv4 et IPv6 sur ce serveur, y compris une liste des routes apprises, l'état actuel de la session (#possible-session-status) et la date de la dernière mise à jour de l'état. L'état est automatiquement mis à jour toutes les six heures, mais vous pouvez le mettre à jour manuellement en cliquant sur Update Now.

Cliquez sur Manage à côté d'une entrée de session pour afficher le panneau Activate BGP. Utilisez la bascule pour activer ou désactiver les sessions BGP sur ce serveur. Utilisez la case à cocher Route par défaut pour définir cette route comme route 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 pas la configuration BGP sur le serveur ; si nécessaire, vous pouvez réactiver la session et recommencer à publier des itinéraires sans modifier la configuration du serveur. Si vous réactivez la session, il peut s'écouler 5 à 10 minutes avant que la session ne soit établie.

API

Pour obtenir toutes les sessions en cours d'exécution pour 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 de voisinage 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 - A disabled status will appear on the project's BGP page if you have enabled BGP on your project, but have not yet initiated a BGP session. For example, you may have a session that is announcing an IPv4 address but not a session to IPv6 address. The IPv4 session status is Up and the IPv6 session status is Disabled.
• Up - The BGP session is up. Equinix Metal routers are picking up the IP addresses you are announcing and learning the routes to your servers. In an Equinix IBX, this status also indicates that the BGP session is active on both routers.
• Down - The BGP session is down. Either you haven't set up the host configuration yet, or something in the configuration is not working. If you have checked your host configuration, try disabling and re-initiating the BGP session, wait the 5-10 minutes for the session to come up again. If the session is still down, please contact support.
• Partial - If your server is in an Equinix IBX and the BGP session is up on only one of the two routers, then the status will be Partial. It could indicate that there is maintenance on of the routers. The status should be temporary, but if it persists, please contact support.
• Unknown - A session will have an unknown status right after you have enabled it, while the session is still being established. It typically takes about 5-10 minutes for the status to update. If the status is unknown for longer, try clicking Update Now to manually update it.