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 - 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.