32.10. Journalisation, dépannage et support de la MetalLB
Si vous avez besoin de dépanner la configuration de MetalLB, reportez-vous aux sections suivantes pour les commandes les plus couramment utilisées.
32.10.1. Définir les niveaux de journalisation de la MetalLB Copier lienLien copié sur presse-papiers!
MetalLB utilise FRRouting (FRR) dans un conteneur avec le paramètre par défaut de info
, ce qui génère beaucoup de logs. Vous pouvez contrôler la verbosité des journaux générés en paramétrant logLevel
comme illustré dans cet exemple.
Pour en savoir plus sur MetalLB, configurez le site logLevel
à l'adresse debug
comme suit :
Conditions préalables
-
Vous avez accès au cluster en tant qu'utilisateur ayant le rôle
cluster-admin
. -
Vous avez installé l'OpenShift CLI (
oc
).
Procédure
Créez un fichier, tel que
setdebugloglevel.yaml
, dont le contenu ressemble à l'exemple suivant :Copy to Clipboard Copied! Toggle word wrap Toggle overflow Appliquer la configuration :
oc replace -f setdebugloglevel.yaml
$ oc replace -f setdebugloglevel.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteUtilisez
oc replace
car le CRmetallb
est déjà créé et vous modifiez ici le niveau du journal.Affiche les noms des pods
speaker
:oc get -n metallb-system pods -l component=speaker
$ oc get -n metallb-system pods -l component=speaker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
NAME READY STATUS RESTARTS AGE speaker-2m9pm 4/4 Running 0 9m19s speaker-7m4qw 3/4 Running 0 19s speaker-szlmx 4/4 Running 0 9m19s
NAME READY STATUS RESTARTS AGE speaker-2m9pm 4/4 Running 0 9m19s speaker-7m4qw 3/4 Running 0 19s speaker-szlmx 4/4 Running 0 9m19s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteLes pods Speaker et Controller sont recréés pour s'assurer que le niveau de journalisation mis à jour est appliqué. Le niveau de journalisation est modifié pour tous les composants de MetalLB.
Consultez les journaux de
speaker
:oc logs -n metallb-system speaker-7m4qw -c speaker
$ oc logs -n metallb-system speaker-7m4qw -c speaker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Consulter les journaux FRR :
oc logs -n metallb-system speaker-7m4qw -c frr
$ oc logs -n metallb-system speaker-7m4qw -c frr
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
32.10.1.1. Niveaux de journalisation du FRRouting (FRR) Copier lienLien copié sur presse-papiers!
Le tableau suivant décrit les niveaux de journalisation FRR.
Niveau d'enregistrement | Description |
---|---|
| Fournit toutes les informations de journalisation pour tous les niveaux de journalisation. |
|
Informations utiles au diagnostic. Réglé sur |
| Fournit des informations qui doivent toujours être enregistrées mais qui, dans des circonstances normales, ne nécessitent pas d'intervention de la part de l'utilisateur. Il s'agit du niveau de journalisation par défaut. |
|
Tout ce qui peut potentiellement provoquer un comportement incohérent de |
|
Toute erreur fatale au fonctionnement de |
| Désactiver la journalisation. |
32.10.2. Dépannage des problèmes BGP Copier lienLien copié sur presse-papiers!
L'implémentation BGP prise en charge par Red Hat utilise FRRouting (FRR) dans un conteneur dans les pods speaker
. En tant qu'administrateur de cluster, si vous devez résoudre des problèmes de configuration BGP, vous devez exécuter des commandes dans le conteneur FRR.
Conditions préalables
-
Vous avez accès au cluster en tant qu'utilisateur ayant le rôle
cluster-admin
. -
Vous avez installé l'OpenShift CLI (
oc
).
Procédure
Affiche les noms des pods
speaker
:oc get -n metallb-system pods -l component=speaker
$ oc get -n metallb-system pods -l component=speaker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
NAME READY STATUS RESTARTS AGE speaker-66bth 4/4 Running 0 56m speaker-gvfnf 4/4 Running 0 56m ...
NAME READY STATUS RESTARTS AGE speaker-66bth 4/4 Running 0 56m speaker-gvfnf 4/4 Running 0 56m ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Affichez la configuration en cours pour FRR :
oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show running-config"
$ oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show running-config"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <.> La section
router bgp
indique l'ASN pour MetalLB. <.> Confirmez qu'une ligneneighbor <ip-address> remote-as <peer-ASN>
existe pour chaque ressource personnalisée de pair BGP que vous avez ajoutée. <.> Si vous avez configuré BFD, confirmez que le profil BFD est associé au pair BGP correct et que le profil BFD apparaît dans la sortie de la commande. <.> Confirmez que les lignesnetwork <ip-address-range>
correspondent aux plages d'adresses IP que vous avez spécifiées dans les ressources personnalisées du pool d'adresses que vous avez ajoutées.Affiche le résumé BGP :
oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bgp summary"
$ oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bgp summary"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1 1 3
- Confirmez que la sortie comprend une ligne pour chaque ressource personnalisée d'homologue BGP que vous avez ajoutée.
- 2 4 2 4
- La sortie qui montre
0
messages reçus et messages envoyés indique un homologue BGP qui n'a pas de session BGP. Vérifiez la connectivité du réseau et la configuration BGP de l'homologue BGP.
Afficher les pairs BGP qui ont reçu un pool d'adresses :
oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bgp ipv4 unicast 203.0.113.200/30"
$ oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bgp ipv4 unicast 203.0.113.200/30"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Remplacez
ipv4
paripv6
pour afficher les homologues BGP qui ont reçu un pool d'adresses IPv6. Remplacez203.0.113.200/30
par une plage d'adresses IPv4 ou IPv6 provenant d'un pool d'adresses.Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <.> Confirmez que la sortie comprend une adresse IP pour un homologue BGP.
32.10.3. Dépannage des problèmes BFD Copier lienLien copié sur presse-papiers!
L'implémentation de Bidirectional Forwarding Detection (BFD) prise en charge par Red Hat utilise FRRouting (FRR) dans un conteneur dans les pods speaker
. L'implémentation BFD repose sur le fait que les pairs BFD sont également configurés en tant que pairs BGP avec une session BGP établie. En tant qu'administrateur de cluster, si vous devez résoudre des problèmes de configuration BFD, vous devez exécuter des commandes dans le conteneur FRR.
Conditions préalables
-
Vous avez accès au cluster en tant qu'utilisateur ayant le rôle
cluster-admin
. -
Vous avez installé l'OpenShift CLI (
oc
).
Procédure
Affiche les noms des pods
speaker
:oc get -n metallb-system pods -l component=speaker
$ oc get -n metallb-system pods -l component=speaker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
NAME READY STATUS RESTARTS AGE speaker-66bth 4/4 Running 0 26m speaker-gvfnf 4/4 Running 0 26m ...
NAME READY STATUS RESTARTS AGE speaker-66bth 4/4 Running 0 26m speaker-gvfnf 4/4 Running 0 26m ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Affichez les pairs BFD :
oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bfd peers brief"
$ oc exec -n metallb-system speaker-66bth -c frr -- vtysh -c "show bfd peers brief"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Session count: 2 SessionId LocalAddress PeerAddress Status ========= ============ =========== ====== 3909139637 10.0.1.2 10.0.2.3 up <.>
Session count: 2 SessionId LocalAddress PeerAddress Status ========= ============ =========== ====== 3909139637 10.0.1.2 10.0.2.3 up <.>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <.> Confirmez que la colonne
PeerAddress
inclut chaque pair BFD. Si la sortie ne répertorie pas l'adresse IP d'un homologue BFD que vous vous attendiez à voir figurer dans la sortie, dépannez la connectivité BGP avec l'homologue. Si le champ d'état indiquedown
, vérifiez la connectivité des liens et de l'équipement entre le nœud et l'homologue. Vous pouvez déterminer le nom du nœud du module de haut-parleurs à l'aide d'une commande telle queoc get pods -n metallb-system speaker-66bth -o jsonpath='{.spec.nodeName}'
.
32.10.4. Métriques MetalLB pour BGP et BFD Copier lienLien copié sur presse-papiers!
OpenShift Container Platform capture les métriques suivantes qui sont liées à MetalLB, aux pairs BGP et aux profils BFD :
-
metallb_bfd_control_packet_input
compte le nombre de paquets de contrôle BFD reçus de chaque pair BFD. -
metallb_bfd_control_packet_output
compte le nombre de paquets de contrôle BFD envoyés à chaque pair BFD. -
metallb_bfd_echo_packet_input
compte le nombre de paquets d'écho BFD reçus de chaque pair BFD. -
metallb_bfd_echo_packet_output
compte le nombre de paquets d'écho BFD envoyés à chaque pair BFD. -
metallb_bfd_session_down_events
compte le nombre de fois où la session BFD avec un pair est entrée dans l'étatdown
. -
metallb_bfd_session_up
indique l'état de la connexion avec un pair BFD.1
indique que la session estup
et0
indique que la session estdown
. -
metallb_bfd_session_up_events
compte le nombre de fois où la session BFD avec un pair est entrée dans l'étatup
. -
metallb_bfd_zebra_notifications
compte le nombre de notifications BFD Zebra pour chaque pair BFD. -
metallb_bgp_announced_prefixes_total
compte le nombre de préfixes d'adresses IP de l'équilibreur de charge qui sont annoncés aux pairs BGP. Les termes prefix et aggregated route ont la même signification. -
metallb_bgp_session_up
indique l'état de la connexion avec un pair BGP.1
indique que la session estup
et0
indique que la session estdown
. -
metallb_bgp_updates_total
compte le nombre de messages BGPupdate
envoyés à un homologue BGP.
Ressources supplémentaires
- Pour plus d'informations sur l'utilisation du tableau de bord de surveillance, reportez-vous à la section Interrogation des mesures.
32.10.5. A propos de la collecte des données MetalLB Copier lienLien copié sur presse-papiers!
Vous pouvez utiliser la commande CLI oc adm must-gather
pour collecter des informations sur votre cluster, votre configuration MetalLB et le MetalLB Operator. Les fonctionnalités et objets suivants sont associés à MetalLB et à MetalLB Operator :
- L'espace de noms et les objets enfants dans lesquels l'opérateur MetalLB est déployé
- Toutes les définitions de ressources personnalisées (CRD) de l'opérateur MetalLB
La commande CLI oc adm must-gather
collecte les informations suivantes à partir de FRRouting (FRR) que Red Hat utilise pour implémenter BGP et BFD :
-
/etc/frr/frr.conf
-
/etc/frr/frr.log
-
/etc/frr/daemons
fichier de configuration -
/etc/frr/vtysh.conf
Les fichiers de log et de configuration de la liste précédente sont collectés à partir du conteneur frr
dans chaque pod speaker
.
Outre les fichiers journaux et les fichiers de configuration, la commande CLI oc adm must-gather
recueille les résultats des commandes vtysh
suivantes :
-
show running-config
-
show bgp ipv4
-
show bgp ipv6
-
show bgp neighbor
-
show bfd peer
Aucune configuration supplémentaire n'est requise lorsque vous exécutez la commande CLI oc adm must-gather
.
Ressources supplémentaires