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

# PostgreSQL-klusterin vianmääritys

> **Tietoa**
>
> Koko toimenpide on suoritettava `root`-käyttäjänä. Voit korottaa oikeutesi `root`-tasolle komennolla `su -`.

> **Varoitus**
>
> Tämän toimenpiteen noudattaminen edellyttää, että olet tehnyt [`patronictl`-työkalun lisämääritykset](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Installation/Install/#additional-configurations-for-patronictl).

CyberElements Bastion -järjestelmän PostgreSQL-klusterin tietokantaan kohdistuvilla yhteysvirheillä voi olla monia syitä. Tässä osiossa esitellään yleinen vianmääritysmenetelmä, joka on mukautettava omaan tilanteeseesi.

## Klusterin tilan tarkistaminen

> **Tietoa**
>
> Klusterin tilan tarkistamalla löydät nopeasti vikaantuneen solmun tai solmut.

Voit tarkistaa klusterin tilan seuraavalla komennolla, joka on suoritettava PostgreSQL-klusterin jokaisella solmulla:

```
1
```

> **Esimerkki tulosteesta toimivalla alustalla**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Yllä olevan tulosteen perusteella kaikki viittaa siihen, että PostgreSQL-klusteri toimii: viive on 0 MB kaikilla `Replica`-solmuilla, ja kaikki solmut ovat luettelossa tilassa `running`. Sinun on saatava tämä tuloste kaikilla solmuilla, jotta voit varmistaa, että `patroni` ja `etcd` toimivat.

> **Esimerkki tulosteesta, kun solmujen välillä on tiedonsiirto-ongelma**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Yllä olevassa tulosteessa 230 MB:n viive on poikkeava: se voi viitata tiedonsiirto-ongelmaan solmun 3 ja solmun 1 välillä.
> Jos ongelma jatkuu usean tunnin jälkeen, tämä vahvistaa sen.

> **Esimerkki tulosteesta, kun solmua ei ole käynnistetty tai pysäytetty oikein**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Yllä olevassa tulosteessa tila (sarake `State`) osoittaa, että solmu 1 on käynnistymässä. Jos tila `started` jatkuu useita minuutteja tai jopa tunteja, kyseisen solmun `patroni`- tai `etcd`-palvelussa voi olla ongelma.
> Solmu 2 on tilassa `stopped`: se on pysäytetty. Kun klusterin solmu vikaantuu, tämä tieto näytetään vain tilapäisesti, ennen kuin solmu häviää luettelosta.

> **Esimerkki tulosteesta, kun `etcd` vikaantuu nykyisellä solmulla**
>
> ```
> 1
> 2
> 3
> ```
>
> Yllä oleva tuloste osoittaa yhteysvirheen `etcd`-palveluun, mikä estää PostgreSQL-klusterin tilan hakemisen.

> **Esimerkki tulosteesta, kun yksi solmuista on epäsynkronissa**
>
> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> ```
>
> Yllä olevassa tulosteessa solmu `PSQL_1` ei ole enää samalla `TL`-aikajanalla kuin muut. Jotta klusteri toimisi, kaikkien solmujen on oltava samalla `TL`-aikajanalla: ero osoittaa, että yksi solmuista on epäsynkronissa.
> Ratkaise ongelma noudattamalla kohdan [Solmun epäsynkronoituminen](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/#node-desynchronization) menettelyä.

## Palveluiden tilan tarkistaminen

Kun vikaantunut solmu on tunnistettu, sinun on tunnistettava virheellisesti toimiva palvelu. PostgreSQL-klusterissa käytettävät kaksi pääpalvelua ovat `patroni` ja `etcd`.

> **Tietoa**
>
> `patroni`-palvelu on riippuvainen `etcd`-palvelusta: jos `etcd` ei toimi, ei myöskään `patroni` toimi.

Voit tunnistaa vikaantuneen palvelun suorittamalla seuraavat komennot:

```
1
2
```

Nämä komennot näyttävät palvelun tilan sekä sen 10 viimeistä lokiriviä.

> **Varoitus**
>
> Palvelu, jonka tila on `active (running)`, ei välttämättä toimi: se voi olla käynnissä ja kirjoittaa samalla virhelokeja. Siksi on tärkeää lukea palvelun lokit sen todellisen tilan ymmärtämiseksi.

> **Esimerkki `etcd`-palvelun tulosteesta, kun palvelu toimii**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

> **Esimerkki `etcd`-palvelun tulosteesta, kun palvelussa on virhe**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```
>
> Yllä olevassa tulosteessa `etcd`-palvelun tila on `failed`, ja sen käynnistymisen estänyt virhe on rivillä 17: palvelu ei pysty lukemaan hakemiston `/var/lib/etcd/cleanroom` sisältöä. Tässä tapauksessa [säädä hakemiston käyttöoikeuksia](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/#error-log-explanations).

> **Esimerkki `patroni`-palvelun tulosteesta, kun palvelu toimii**
>
> ```
>  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
> ```

> **Esimerkki `patroni`-palvelun tulosteesta, kun palvelussa on virhe**
>
> ```
>  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
> ```
>
> Yllä olevassa tapauksessa palvelun tila on `active (running)`, vaikka se ei todellisuudessa toimi: lokit näyttävät useita yhteysvirheitä `etcd`-palveluun, jota `patroni` tarvitsee.
> Tässä esimerkissä vika ei välttämättä ole `patroni`-palvelussa: koska se on riippuvainen `etcd`-palvelusta, korjaa ensin `etcd`-palvelun ongelmat ja tarkista sitten `patroni`-palvelun tila uudelleen.

## Palveluiden vianmääritysmenettelyt

Alla on yksi vianmääritysmenettely kutakin palvelua kohden. Jos sekä `etcd` että `patroni` toimivat virheellisesti, aloita `etcd`-palvelusta.

- **[`etcd`-palvelun vianmääritys](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/EtcdDebug/)**

  ---

  Menettely, jota noudatetaan, kun `etcd`-palvelu toimii virheellisesti.
- **[`patroni`-palvelun vianmääritys](https://docs.cyberelements.io/bastion/4.6/fi/Installation/Dependencies/PostgreSQLCluster/Troubleshooting/PatroniDebug/)**

  ---

  Menettely, jota noudatetaan, kun `patroni`-palvelu toimii virheellisesti.
