Ο έλεγχος υγείας του Connector είναι κόκκινος
Το VaultPAM εκτελεί περιοδικές δοκιμές υγείας σε κάθε Connector και τους hosts πόρων που εξυπηρετεί. Όταν ο δείκτης υγείας γίνεται κόκκινος (ή εμφανίζει Degraded), σχεδόν πάντα είναι υπεύθυνη μία από τέσσερις αιτίες. Η απώλεια συνδεσιμότητας δικτύου είναι η πιο συνηθισμένη. οι ασυμφωνίες έκδοσης είναι η λιγότερο συνηθισμένη αλλά είναι εύκολο να επιβεβαιωθούν.
Συμπτώματα
- Η σειρά του Connector στο Connectors εμφανίζει κόκκινο δείκτη υγείας ή την κατάσταση Degraded.
- Ένα σήμα υγείας σε ένα συγκεκριμένο Safe δείχνει ότι ο Connector που το εξυπηρετεί είναι ανθυγιές.
- Οι ειδοποιήσεις ενεργοποιούνται για
ControlPlaneTunnelHeartbeatTimeoutsHighή ένα παρόμοιο μετρικό. - Οι περίοδοι λειτουργίας που εκκινούνται μέσω του Connector αποτυγχάνουν ή συνδέονται αργά.
- Η υγεία του Connector ήταν πράσινη πρόσφατα και έγινε κόκκινη χωρίς προφανές αίτιο.
Τι σημαίνουν οι καταστάσεις υγείας
| Κατάσταση | Σημασία |
|---|---|
| Online | Ο Connector και όλα τα δοκιμασμένα hosts πόρων είναι προσιτά. |
| Degraded | Ο Connector είναι προσιτός αλλά τουλάχιστον μία δοκιμή host πόρου αποτυγχάνει. |
| Offline | Ο Connector δεν είναι προσιτός από το control plane. |
| Needs recovery | Ο Connector έχει χάσει την ανθεκτική του ταυτότητα και δεν μπορεί να συνδεθεί κανονικά. Η εσωτερική κατάσταση runtime είναι needs_recovery. ο Connector δεν επιστρέφει σιωπηλά στο αρχικό token bootstrap και αποτυγχάνει κλειστά μέχρι ένας χειριστής να ξεκινήσει τη ροή ελεγχόμενης ανάκτησης. |
Ένας κόκκινος δείκτης υγείας αντιστοιχεί σε Degraded (Connector ενεργός, ορισμένα hosts ανενεργά) ή Offline (ο ίδιος ο Connector ανεπίτευκτος).
Αιτίες
1. Απώλεια συνδεσιμότητας δικτύου
Ο host του Connector έχει χάσει την εξερχόμενη διαδρομή του προς το control plane του VaultPAM (port 443), ή μια αλλαγή πολιτικής δικτύου έχει μπλοκάρει τη διαδρομή.
Έλεγχος: Από τον host του Connector, εκτελέστε:
curl -v https://dev.euwarden.com/healthz
Εάν αποτύχει, ο Connector δεν μπορεί να φτάσει το control plane. Ελέγξτε επίσης εάν το ίδιο το μηχάνημα του Connector είναι ακόμα προσιτό (ping, SSH ή RDP σε αυτό).
Επίλυση: Επαναφέρετε την εξερχόμενη διαδρομή δικτύου. Επιβεβαιώστε ότι τα εταιρικά firewalls ή οι ομάδες ασφάλειας cloud επιτρέπουν TCP 443 από τον host του Connector στο control plane. Μετά την επαναφορά της συνδεσιμότητας, ο Connector θα συνδεθεί ξανά αυτόματα εντός 30 δευτερολέπτων — δεν απαιτείται μη χειροκίνητη επανεκκίνηση.
2. Host πόρου ανεπίτευκτος
Ο Connector μπορεί να είναι υγιές από μόνο του αλλά ένα ή περισσότερα hosts πόρων που δοκιμάζει (τους στόχους που είναι εγγεγραμμένοι στα συνδεδεμένα Safes) έχουν γίνει ανεπίτευκτα από το δίκτυο του Connector. Αυτό παράγει μια κατάσταση Degraded παρά Offline.
Έλεγχος: Προσδιορίστε ποιο host πόρου έχει σημαία. Στο Connectors → επιλέξτε Connector → Health details, ενδέχεται να δείτε αποτελέσματα δοκιμών ανά host. Από το μηχάνημα του Connector, δοκιμάστε την προσιτότητα στον επηρεασμένο στόχο:
nc -zv <target-host> <target-port>
Επίλυση: Επαναφέρετε τη διαδρομή από το μηχάνημα του Connector στον host πόρου. Η δοκιμή θα ανακτηθεί στον επόμενο κύκλο ελέγχου υγείας (συνήθως κάθε 60 δευτερόλεπτα). Δεν απαιτείται επανεκκίνηση του Connector.
3. Timeout δοκιμής
Οι δοκιμές υγείας έχουν ένα ρυθμιζόμενο timeout. Εάν ο host πόρου ή ο Connector είναι αργός να ανταποκριθεί — λόγω υψηλού CPU load, μιας κρεμάστρας υπηρεσίας ή μιας υπερφορτωμένης διαδρομής δικτύου — η δοκιμή ενδέχεται να timeout ακόμη και αν ο host είναι τεχνικά προσιτός. Οι διακοπτόμενες κόκκινες καταστάσεις που επιλύονται μόνες τους συχνά εμπίπτουν σε αυτήν την κατηγορία.
Έλεγχος: Ανοίξτε Connectors → επιλέξτε Connector → Health history. Εάν η κατάσταση υγείας πέφτει μεταξύ κόκκινης και πράσινης χωρίς παρέμβαση, τα timeout δοκιμών είναι η πιθανή αιτία. Επιβεβαιώστε ότι ο host πόρου δεν είναι υπό ασυνήθιστο φορτίο.
Επίλυση: Εάν το timeout της δοκιμής είναι συνεχώς πολύ σύντομο για τον κανονικό χρόνο απόκρισης του host, ζητήστε από έναν χειριστή VaultPAM να αυξήσει το timeout της δοκιμής στη ρύθμιση παραμέτρων του Connector. Εάν ο host είναι υπερφορτωμένος, αντιμετωπίστε το ζήτημα του φορτίου στο σύστημα στόχο.
4. Ασυμφωνία έκδοσης Connector
Το VaultPAM κυκλοφορεί περιοδικά ενημερώσεις Connector. Εάν ένας Connector εκτελεί μια έκδοση που δεν υποστηρίζεται πλέον, το control plane ενδέχεται να σταματήσει να δέχεται τις αναφορές υγείας του ή να τη σημαία ως υποβαθμισμένη μέχρι να ενημερωθεί ο Connector.
Έλεγχος: Ανοίξτε Connectors → επιλέξτε Connector → Details. Συγκρίνετε το πεδίο Version με την τελευταία υποστηριζόμενη έκδοση Connector που παρατίθεται σε System → Connector versions ή στις σημειώσεις κυκλοφορίας VaultPAM.
Επίλυση: Ενημερώστε τον Connector στην τρέχουσα υποστηριζόμενη έκδοση. Η διαδικασία ενημέρωσης εξαρτάται από τη μέθοδο ανάπτυξης:
- Docker: σύρετε την τελευταία εικόνα και δημιουργήστε ξανά το container.
- Native / VM: κάντε λήψη του ενημερωμένου binary και επανεκκινήστε την υπηρεσία.
- Kubernetes: ενημερώστε την ετικέτα εικόνας στο manifest ανάπτυξης και εφαρμόστε.
Μετά την ενημέρωση, ο Connector θα ξαναζευγαρωθεί χρησιμοποιώντας την υπάρχουσα ανθεκτική του ταυτότητα — δεν απαιτείται νέο token εγγραφής.
5. Χρειάζεται ανάκτηση
Εάν η κατάσταση είναι Needs recovery, ο Connector έχει χάσει την ανθεκτική του ταυτότητα και δεν θα θεραπευθεί μέσω των κανονικών αιτιών κόκκινης υγείας παραπάνω.
Έλεγχος: Ανοίξτε Connectors και επιβεβαιώστε ότι η κατάσταση είναι Needs recovery παρά Degraded ή Offline.
Επίλυση: Ακολουθήστε My connector is offline και χρησιμοποιήστε τον κλάδο ελεγχόμενης ανάκτησης. Μην συνεχίσετε να δοκιμάζετε τα συνηθισμένα βήματα ανάκτησης υγείας σε αυτό το άρθρο.
Βήματα επίλυσης
- Ανοίξτε Connectors → επιλέξτε Connector και σημειώστε εάν η κατάσταση είναι Degraded (Connector ενεργός, hosts ανενεργά), Offline (Connector ανεπίτευκτος) ή Needs recovery. Εάν είναι Needs recovery, σταματήστε εδώ και ακολουθήστε My connector is offline.
- Εάν Offline: από τον host του Connector, εκτελέστε
curl -v https://dev.euwarden.com/healthz. Εάν αποτύχει, επαναφέρετε την εξερχόμενη διαδρομή δικτύου στο control plane. - Εάν Degraded: ελέγξτε ποιες δοκιμές host πόρου αποτυγχάνουν στο Connectors → επιλέξτε Connector → Health details. Από το μηχάνημα του Connector, εκτελέστε
nc -zv <target-host> <target-port>για κάθε host που αποτυγχάνει και επαναφέρετε τη συνδεσιμότητα. - Εάν η κατάσταση αλλάζει περιστασιακά χωρίς παρέμβαση, ελέγξτε τα timeout δοκιμών και το φορτίο του host πόρου.
- Συγκρίνετε την έκδοση του Connector με την υποστηριζόμενη έκδοση. Ενημερώστε εάν είναι παρωχημένη.
- Μετά από οποιαδήποτε επιδιόρθωση, περιμένετε 60–90 δευτερόλεπτα και ανανεώστε τη σελίδα Connectors. Ο δείκτης υγείας ενημερώνεται αυτόματα στον επόμενο κύκλο δοκιμής.
Διαδρομή κλιμάκωσης
Εάν ο έλεγχος υγείας παραμένει κόκκινος μετά την εργασία μέσα από και τέσσερις αιτίες:
- Σημειώστε το όνομα του Connector, την τρέχουσα κατάσταση και την ώρα που άλλαξε η κατάσταση υγείας.
- Συλλέξτε τα αρχεία καταγραφής του Connector (τελευταίες 200 γραμμές):
- Docker:
docker logs -n 200 vaultpam-connector - systemd:
journalctl -u vaultpam-connector -n 200
- Docker:
- Συμπεριλάβετε την έξοδο του
curl -v https://dev.euwarden.com/healthzαπό τον host του Connector. - Ανοίξτε ένα ticket υποστήριξης με: όνομα Connector, κατάσταση, έξοδο καταγραφής και αποτελέσματα δοκιμής συνδεσιμότητας δικτύου.