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

# Feilsøking av PostgreSQL-clusteren

> **Informasjon**
>
> Hele prosedyren må utføres som `root`. For å heve privilegiene dine til `root` kan du bruke kommandoen `su -`.

> **Adadvarsel**
>
> For å følge denne prosedyren må du ha utført de [ytterligere konfigurasjonene for `patronictl`](https://docs.cyberelements.io/bastion/4.6/no/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Tilkoblingsfeil mot databasen i PostgreSQL-clusteren til CyberElements Bastion kan ha ulike årsaker. Denne delen presenterer en generell feilsøkingsmetode som du må tilpasse til ditt tilfelle.

## Kontrollere statusen til clusteren

> **Informasjon**
>
> Ved å kontrollere statusen til clusteren kan du raskt finne noden eller nodene som svikter.

Du kan kontrollere statusen til clusteren med følgende kommando, som må kjøres på hver node i PostgreSQL-clusteren:

```
1
```

> **Eksempel på utdata på en plattform som fungerer**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I utdataene ovenfor tyder alt på at PostgreSQL-clusteren fungerer: lag-verdien er 0 MB for alle `Replica`-nodene, og alle nodene står i listen med statusen `running`. Du må få disse utdataene på alle nodene for å bekrefte at `patroni` og `etcd` fungerer.

> **Eksempel på utdata når det er et kommunikasjonsproblem mellom nodene**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I utdataene ovenfor er lag-verdien på 230 MB unormal: den kan tyde på et kommunikasjonsproblem mellom node 3 og node 1.
> Hvis problemet vedvarer etter flere timer, er det bekreftet.

> **Eksempel på utdata når en node ikke er riktig startet eller stoppet**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I utdataene ovenfor viser tilstanden (kolonnen `State`) at node 1 starter. Hvis statusen `started` vedvarer i flere minutter, eller til og med timer, kan det være et problem med `patroni` eller `etcd` på den noden.
> Node 2 er i tilstanden `stopped`: den er stoppet. Når en node i clusteren svikter, vises denne informasjonen bare midlertidig, før noden fjernes fra listen.

> **Eksempel på utdata når `etcd` svikter på den gjeldende noden**
>
> ```
> 1
> 2
> 3
> ```
>
> Utdataene ovenfor viser en tilkoblingsfeil mot `etcd`, som hindrer at statusen til PostgreSQL-clusteren kan hentes.

> **Eksempel på utdata når en av nodene er desynkronisert**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I utdataene ovenfor er noden `PSQL_1` ikke lenger på samme `TL` som de andre. For at clusteren skal fungere, må alle nodene være på samme `TL`: en forskjell viser at en av nodene er desynkronisert.
> Følg prosedyren for [desynkronisering av en node](https://docs.cyberelements.io/bastion/4.6/no/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) for å løse dette problemet.

## Kontrollere statusen til tjenestene

Når noden som svikter, er identifisert, må du identifisere tjenesten som ikke fungerer. De to hovedtjenestene som brukes i PostgreSQL-clusteren, er `patroni` og `etcd`.

> **Informasjon**
>
> `patroni`-tjenesten er avhengig av `etcd`-tjenesten: hvis `etcd` ikke fungerer, vil heller ikke `patroni` fungere.

For å identifisere tjenesten som svikter, kan du kjøre følgende kommandoer:

```
1
2
```

Disse kommandoene viser statusen til tjenesten, sammen med de 10 siste logglinjene.

> **Adadvarsel**
>
> En tjeneste med statusen `active (running)` fungerer ikke nødvendigvis: den kan kjøre samtidig som den skriver feillogger. Det er derfor viktig å lese loggene til tjenesten for å forstå den faktiske tilstanden.

> **Eksempel på utdata 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å utdata for `etcd` når tjenesten er i feiltilstand**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> I utdataene ovenfor har `etcd`-tjenesten statusen `failed`, og feilen som hindret den i å starte, er den på linje 17: tjenesten kan ikke lese innholdet i katalogen `/var/lib/etcd/cleanroom`. I dette tilfellet må du [justere tillatelsene på katalogen](https://docs.cyberelements.io/bastion/4.6/no/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Eksempel på utdata 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å utdata for `patroni` når tjenesten er i feiltilstand**
>
> ```
>  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 tilfellet ovenfor har tjenesten statusen `active (running)` uten at den faktisk fungerer: loggene viser ulike tilkoblingsfeil mot `etcd`, som `patroni` trenger.
> I dette eksemplet er det ikke nødvendigvis `patroni` som er årsaken: siden den er avhengig av `etcd`, må du først rette `etcd`-problemene og deretter kontrollere statusen til `patroni` på nytt.

## Feilsøkingsprosedyrer for tjenestene

Nedenfor finner du én feilsøkingsprosedyre per tjeneste. Hvis både `etcd` og `patroni` svikter, begynner du med `etcd`.

- **[Feilsøking av `etcd`](https://docs.cyberelements.io/bastion/4.6/no/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Prosedyre som skal følges når `etcd`-tjenesten svikter.
- **[Feilsøking av `patroni`](https://docs.cyberelements.io/bastion/4.6/no/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Prosedyre som skal følges når `patroni`-tjenesten svikter.
