Fejlfinding for patroni¶
Information
Hele proceduren skal udføres som root. For at hæve dine privilegier til root kan du bruge kommandoen su -.
Advarsel
For at følge denne procedure skal du have udført de yderligere konfigurationer for patronictl.
patroni er en orkestrator til høj tilgængelighed for PostgreSQL. Den automatiserer administrationen af et PostgreSQL-cluster ved at håndtere valget af leader-noden, failover og synkronisering af noderne, når der opstår et problem.
I PostgreSQL-clusteret for CyberElements Bastion er patroni afhængig af etcd til at gemme og dele clusterets tilstand. Den overvåger løbende PostgreSQL-instansernes tilstand og sørger for, at der kun er én node, der er udpeget som leader ad gangen.
Hvis leader-noden svigter, orkestrerer patroni automatisk et valg via det distribuerede konfigurationslager etcd for at forfremme en ny leader og bevare tjenestens tilgængelighed.
patroni afhænger derfor af etcd og kan ikke fungere korrekt, hvis etcd ikke fungerer.
Desynkronisering af en node¶
En node i PostgreSQL-clusteret kan undertiden komme ud af synkronisering. Det kan ses i output fra kommandoen patronictl -c /etc/patroni/config.yml topology:
1 2 3 4 5 6 7 | |
I kolonnen TL er noden PSQL_1 ikke længere på samme TL som de andre. For at clusteret kan fungere, skal alle noder være på samme TL: en forskel betyder, at en af noderne er ude af synkronisering.
Kør i så fald følgende kommando på den node, der er ude af synkronisering:
1 | |
Hvor <MEMBER_PATRONI> er navnet på den node, der er ude af synkronisering, som vist i kolonnen Member i topologien.
Er flere noder ude af synkronisering, så resynkroniser alle dem, der ikke er på den højeste TL.
Advarsel
Hvis den node, der er ude af synkronisering, er noden Leader, kan der gå data tabt. Det bør aldrig ske: noden Leader forventes at være på den højeste TL.
Eksempel
I output fra kommandoen patronictl -c /etc/patroni/config.yml topology ovenfor er noden PSQL_1 ude af synkronisering. Brug følgende kommando for at resynkronisere den:
1 | |
Logs¶
Hele proceduren bygger på logs fra tjenesten patroni, som du får med kommandoen nedenfor:
1 | |
Tip
For at følge logs i realtid skal du tilføje indstillingen -f til kommandoen:
1 | |
Information
Logs fra patroni er også tilgængelige i /var/log/syslog.
Forklaring af fejllogs¶
ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)
Når etcd ikke fungerer eller ikke kan nås, kan patroni skrive følgende fejl:
1 2 3 4 5 6 7 8 | |
<PSQL_NODE_NAME>-
Navnet på en af noderne i PostgreSQL-clusteret.
I så fald skal du foretage fejlfinding for etcd.