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

# Felsökning av PostgreSQL-clustret

> **Information**
>
> Hela proceduren ska utföras som `root`. För att höja dina privilegier till `root` kan du använda kommandot `su -`.

> **Varning**
>
> För att kunna följa denna procedur måste du ha utfört de [ytterligare konfigurationerna för `patronictl`](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

Anslutningsfel mot databasen i PostgreSQL-clustret för CyberElements Bastion kan ha olika orsaker. I det här avsnittet presenteras en allmän felsökningsmetod som du anpassar efter ditt fall.

## Kontrollera clustrets status

> **Information**
>
> Genom att kontrollera clustrets status kan du snabbt lokalisera den eller de noder som inte fungerar.

Du kan kontrollera clustrets status med följande kommando, som ska köras på varje nod i PostgreSQL-clustret:

```
1
```

> **Exempel på resultat på en plattform som fungerar**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovan tyder allt på att PostgreSQL-clustret fungerar: fördröjningen (lag) är 0 MB för alla `Replica`-noder och alla noder finns i listan med statusen `running`. Du måste få detta resultat på alla noder för att bekräfta att `patroni` och `etcd` fungerar.

> **Exempel på resultat när det finns ett kommunikationsproblem mellan noderna**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovan är fördröjningen (lag) på 230 MB onormal: den kan tyda på ett kommunikationsproblem mellan nod 3 och nod 1.
> Om problemet kvarstår efter flera timmar bekräftar detta misstanken.

> **Exempel på resultat när en nod inte har startats eller stoppats korrekt**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I resultatet ovan visar tillståndet (kolumnen `State`) att nod 1 håller på att starta. Om statusen `started` kvarstår i flera minuter, eller till och med timmar, kan det finnas ett problem med `patroni` eller `etcd` på den noden.
> Nod 2 är i tillståndet `stopped`: den är stoppad. När en nod i clustret slutar fungera visas denna information bara tillfälligt, innan noden tas bort från listan.

> **Exempel på resultat när `etcd` inte fungerar på den aktuella noden**
>
> ```
> 1
> 2
> 3
> ```
>
> Resultatet ovan visar ett anslutningsfel mot `etcd`, vilket gör att det inte går att hämta PostgreSQL-clustrets status.

> **Exempel på utdata när en av noderna är osynkroniserad**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> I utdata ovan ligger noden `PSQL_1` inte längre på samma `TL` som de andra. För att clustret ska fungera måste alla noder ligga på samma `TL`: en skillnad visar att en av noderna är osynkroniserad.
> Följ proceduren för [desynkronisering av en nod](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) för att lösa problemet.

## Kontrollera tjänsternas status

När den nod som inte fungerar har identifierats måste du identifiera den tjänst som inte fungerar som den ska. De två huvudtjänsterna som används i PostgreSQL-clustret är `patroni` och `etcd`.

> **Information**
>
> Tjänsten `patroni` är beroende av tjänsten `etcd`: om `etcd` inte fungerar fungerar inte heller `patroni`.

För att identifiera den tjänst som inte fungerar kan du köra följande kommandon:

```
1
2
```

Dessa kommandon visar tjänstens status tillsammans med dess 10 senaste loggrader.

> **Varning**
>
> En tjänst med statusen `active (running)` fungerar inte nödvändigtvis: den kan köras samtidigt som den skriver felloggar. Det är därför viktigt att läsa tjänstens loggar för att förstå dess faktiska tillstånd.

> **Exempel på resultat för `etcd` när tjänsten fungerar**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Exempel på resultat för `etcd` när tjänsten är i feltillstånd**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> I resultatet ovan har tjänsten `etcd` statusen `failed`, och det fel som hindrade den från att starta är det på rad 17: tjänsten kan inte läsa innehållet i katalogen `/var/lib/etcd/cleanroom`. I så fall ska du [justera behörigheterna för katalogen](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Exempel på resultat för `patroni` när tjänsten fungerar**
>
> ```
>  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
> ```

> **Exempel på resultat för `patroni` när tjänsten är i feltillstånd**
>
> ```
>  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 fallet ovan har tjänsten statusen `active (running)` utan att faktiskt fungera: loggarna visar olika anslutningsfel mot `etcd`, som `patroni` behöver.
> I det här exemplet är det inte nödvändigtvis `patroni` som är orsaken: eftersom den är beroende av `etcd` ska du först åtgärda problemen med `etcd` och sedan kontrollera statusen för `patroni` igen.

## Felsökningsprocedurer för tjänsterna

Nedan finns en felsökningsprocedur per tjänst. Om både `etcd` och `patroni` inte fungerar som de ska börjar du med `etcd`.

- **[Felsökning av `etcd`](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Procedur att följa när tjänsten `etcd` inte fungerar som den ska.
- **[Felsökning av `patroni`](https://docs.cyberelements.io/bastion/4.6/sv/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Procedur att följa när tjänsten `patroni` inte fungerar som den ska.
