> Source: https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PsqlDebug/

# Fejlfinding for PostgreSQL-clusteret

> **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`](https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Forbindelsesfejl til databasen i PostgreSQL-clusteret for CyberElements Bastion kan have forskellige årsager. Dette afsnit præsenterer en generel fejlfindingsmetode, som skal tilpasses til din situation.

## Kontrol af clusterets status

> **Information**
>
> Ved at kontrollere clusterets status kan du hurtigt finde den eller de noder, der svigter.

Du kan kontrollere clusterets status med følgende kommando, som skal køres på hver node i PostgreSQL-clusteret:

```
1
```

> **Eksempel på resultat på en platform, der fungerer**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovenfor tyder alt på, at PostgreSQL-clusteret fungerer: forsinkelsen (lag) er 0 MB for alle `Replica`-noder, og alle noder står på listen med status `running`. Du skal få dette resultat på alle noder for at bekræfte, at `patroni` og `etcd` fungerer.

> **Eksempel på resultat, når der er et kommunikationsproblem mellem noderne**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovenfor er forsinkelsen på 230 MB unormal: den kan tyde på et kommunikationsproblem mellem node 3 og node 1.
> Hvis problemet varer ved efter flere timer, er det bekræftet.

> **Eksempel på resultat, når en node ikke er startet eller stoppet korrekt**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovenfor viser tilstanden (kolonnen `State`), at node 1 er ved at starte. Hvis status `started` varer ved i flere minutter eller endda timer, kan der være et problem med `patroni` eller `etcd` på den pågældende node.
> Node 2 har tilstanden `stopped`: den er stoppet. Når en node i clusteret svigter, vises denne oplysning kun midlertidigt, før noden fjernes fra listen.

> **Eksempel på resultat, når `etcd` svigter på den aktuelle node**
>
> ```
> 1
> 2
> 3
> ```
>
> Resultatet ovenfor viser en forbindelsesfejl til `etcd`, som forhindrer, at PostgreSQL-clusterets status kan hentes.

> **Eksempel på output, når en af noderne er ude af synkronisering**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I output ovenfor 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.
> Følg proceduren for [desynkronisering af en node](https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) for at løse dette problem.

## Kontrol af tjenesternes status

Når den node, der svigter, er identificeret, skal du identificere den tjeneste, der ikke fungerer korrekt. PostgreSQL-clusterets to vigtigste tjenester er `patroni` og `etcd`.

> **Information**
>
> Tjenesten `patroni` afhænger af tjenesten `etcd`: hvis `etcd` ikke fungerer, fungerer `patroni` heller ikke.

For at identificere den tjeneste, der svigter, kan du køre følgende kommandoer:

```
1
2
```

Disse kommandoer viser tjenestens status sammen med dens sidste 10 loglinjer.

> **Advarsel**
>
> En tjeneste med status `active (running)` fungerer ikke nødvendigvis: den kan køre og samtidig skrive fejllogs. Det er derfor vigtigt at læse tjenestens logs for at forstå dens faktiske tilstand.

> **Eksempel på resultat for `etcd`, når tjenesten fungerer**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Eksempel på resultat for `etcd`, når tjenesten er i fejltilstand**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> I resultatet ovenfor har tjenesten `etcd` status `failed`, og den fejl, der forhindrede den i at starte, er den på linje 17: tjenesten kan ikke læse indholdet af mappen `/var/lib/etcd/cleanroom`. I så fald skal du [justere tilladelserne til mappen](https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Eksempel på resultat for `patroni`, når tjenesten fungerer**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```

> **Eksempel på resultat for `patroni`, når tjenesten er i fejltilstand**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> ```
>
> I tilfældet ovenfor har tjenesten status `active (running)` uden reelt at fungere: loggene viser forskellige forbindelsesfejl til `etcd`, som `patroni` har brug for.
> I dette eksempel er det ikke nødvendigvis `patroni`, der er årsagen: da den afhænger af `etcd`, skal du først løse problemerne med `etcd` og derefter kontrollere status for `patroni` igen.

## Fejlfindingsprocedurer for tjenesterne

Nedenfor finder du en fejlfindingsprocedure pr. tjeneste. Hvis både `etcd` og `patroni` fungerer forkert, skal du starte med `etcd`.

- **[Fejlfinding for `etcd`](https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedure, der skal følges, når tjenesten `etcd` fungerer forkert.
- **[Fejlfinding for `patroni`](https://docs.cyberelements.io/bastion/4.6/da/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedure, der skal følges, når tjenesten `patroni` fungerer forkert.
