Verificarea stării Connector-ului este roșie
VaultPAM execută sonde periodice de verificare a stării pentru fiecare Connector și gazdele de resurse pe care le deservește. Când indicatorul de stare devine roșu (sau afișează Degraded), una din patru cauze este aproape întotdeauna responsabilă. Pierderea conectivității rețelei este cea mai frecventă; nepotrivirile de versiune sunt cele mai rare, dar ușor de confirmat.
Simptome
- Rândul Connector-ului din Connectors afișează un indicator roșu de stare sau statusul Degraded.
- Un badge de stare pe un anumit Safe arată că Connector-ul care îl deservește este în stare defectuoasă.
- Alertele sunt declanșate pentru
ControlPlaneTunnelHeartbeatTimeoutsHighsau o metrică similară. - Sesiunile lansate prin Connector eșuează sau sunt lente la conectare.
- Starea Connector-ului era verde recent și a devenit roșie fără o schimbare aparentă.
Ce înseamnă stările de stare
| Stare | Semnificație |
|---|---|
| Online | Connector-ul și toate gazdele de resurse sondite sunt accesibile. |
| Degraded | Connector-ul este accesibil, dar cel puțin o sondă de gazdă de resursă eșuează. |
| Offline | Connector-ul nu este accesibil din planul de control. |
| Needs recovery | Connector-ul și-a pierdut identitatea durabilă și nu se poate reconecta în mod normal. Starea internă a runtime-ului este needs_recovery; Connector-ul nu revine tăcut la jetonul bootstrap original și eșuează în închidere până când un operator pornește fluxul de recuperare controlată. |
Un indicator roșu de stare corespunde cu Degraded (Connector activ, unele gazde inactive) sau Offline (Connector-ul în sine inaccesibil).
Cauze
1. Pierderea conectivității rețelei
Gazda Connector-ului și-a pierdut calea de ieșire către planul de control VaultPAM (portul 443), sau o schimbare a politicii de rețea a blocat ruta.
Verificare: De pe gazda Connector-ului, executați:
curl -v https://dev.euwarden.com/healthz
Dacă aceasta eșuează, Connector-ul nu poate atinge planul de control. De asemenea, verificați dacă mașina Connector-ului în sine este încă accesibilă (ping, SSH sau RDP în ea).
Remediere: Restaurați calea de rețea de ieșire. Confirmați că firewallurile corporative sau grupurile de securitate cloud permit TCP 443 de la gazda Connector-ului la planul de control. După restaurarea conectivității, Connector-ul se va reconecta automat în 30 de secunde — nu este necesară nicio repornire manuală.
2. Gazda de resursă inaccesibilă
Connector-ul poate fi sănătos în sine, dar una sau mai multe gazde de resurse pe care le sondează (țintele înregistrate în Safes-urile conectate) au devenit inaccesibile din rețeaua Connector-ului. Aceasta produce o stare Degraded mai degrabă decât Offline.
Verificare: Identificați care gazdă de resursă este marcată. În Connectors → selectați Connector → Health details, este posibil să vedeți rezultate sondei per-gazdă. De pe mașina Connector-ului, testați accesibilitatea la ținta afectată:
nc -zv <target-host> <target-port>
Remediere: Restaurați ruta de la mașina Connector-ului la gazda de resursă. Sonda va reveni la următorul ciclu de verificare a stării (de obicei la fiecare 60 de secunde). Nu este necesară nicio repornire a Connector-ului.
3. Expirarea sondei
Sondele de stare au o expirare configurabilă. Dacă gazda de resursă sau Connector-ul răspunde lent — din cauza unei sarcini mari a procesorului, a unui serviciu blocat sau a unei căi de rețea supraîncărcate — sonda poate expira chiar dacă gazda este tehnic accesibilă. Stările roșii intermitente care se rezolvă de la sine intră adesea în această categorie.
Verificare: Deschideți Connectors → selectați Connector → Health history. Dacă starea de stare alternează între roșu și verde fără intervenție, expirările sondei sunt cauza probabilă. Confirmați că gazda de resursă nu este sub o sarcină neobișnuită.
Remediere: Dacă expirarea sondei este constant prea scurtă pentru timpul de răspuns normal al gazdei, rugați un operator VaultPAM să crească expirarea sondei în configurația Connector-ului. Dacă gazda este supraîncărcată, rezolvați problema de sarcină pe sistemul țintă.
4. Nepotrivire de versiune Connector
VaultPAM lansează periodic actualizări Connector. Dacă un Connector rulează o versiune care nu mai este acceptată, planul de control poate înceta acceptarea rapoartelor de stare ale acestuia sau o poate marca ca degradată până când Connector-ul este actualizat.
Verificare: Deschideți Connectors → selectați Connector → Details. Comparați câmpul Version cu versiunea cea mai recentă acceptată de Connector listată în System → Connector versions sau în notele de lansare VaultPAM.
Remediere: Actualizați Connector-ul la versiunea acceptată curentă. Procedura de actualizare depinde de metoda de implementare:
- Docker: trageți cea mai recentă imagine și recreați containerul.
- Native / VM: descărcați binarul actualizat și reporniți serviciul.
- Kubernetes: actualizați eticheta imaginii în manifestul implementării și aplicați.
După actualizare, Connector-ul va realoca folosind identitatea durabilă existentă — nu este necesitat niciun jetonul de înrolare nou.
5. Needs recovery
Dacă statusul este Needs recovery, Connector-ul și-a pierdut identitatea durabilă și nu va vindeca prin cauzele normale de stare roșie de mai sus.
Verificare: Deschideți Connectors și confirmați că statusul este Needs recovery mai degrabă decât Degraded sau Offline.
Remediere: Urmați My connector is offline și utilizați ramura guided-recovery. Nu continuați să încercați din nou pașii obișnuiți de recuperare a stării din acest articol.
Pași de rezoluție
- Deschideți Connectors → selectați Connector și observați dacă statusul este Degraded (Connector activ, gazde inactive), Offline (Connector inaccesibil) sau Needs recovery. Dacă este Needs recovery, opriți-vă aici și urmați My connector is offline.
- Dacă Offline: de pe gazda Connector-ului, executați
curl -v https://dev.euwarden.com/healthz. Dacă eșuează, restaurați calea de rețea de ieșire la planul de control. - Dacă Degraded: verificați care sonde de gazdă de resursă eșuează în Connectors → selectați Connector → Health details. De pe mașina Connector-ului, executați
nc -zv <target-host> <target-port>pentru fiecare gazdă defectuoasă și restaurați conectivitatea. - Dacă statusul alternează intermitent fără intervenție, verificați expirările sondei și sarcina gazdei de resursă.
- Comparați versiunea Connector-ului cu versiunea acceptată. Actualizați dacă este învechită.
- După orice remediere, așteptați 60–90 de secunde și reîmprospătați pagina Connectors. Indicatorul de stare se actualizează automat la următorul ciclu de sondă.
Cale de escaladare
Dacă verificarea stării rămâne roșie după parcurgerea tuturor patru cauze:
- Observați numele Connector-ului, statusul curent și ora în care starea de stare s-a schimbat.
- Colectați jurnalele Connector-ului (ultimele 200 de linii):
- Docker:
docker logs -n 200 vaultpam-connector - systemd:
journalctl -u vaultpam-connector -n 200
- Docker:
- Includeți ieșirea
curl -v https://dev.euwarden.com/healthzde pe gazda Connector-ului. - Deschideți un tichet de suport cu: nume Connector, stare, ieșire jurnal și rezultate test conectivitate rețea.