Lokitiedostot ovat keskeinen työkalu sivuston vianetsinnässä ja ylläpidossa. Niiden avulla voit selvittää, miksi sivusto hidastelee, miksi päivitys epäonnistui tai mikä lisäosa aiheuttaa virheitä. Seravon ympäristössä lokitiedostot on koottu keskitetysti hakemistoon /data/log/.
Lokien tutkiminen eri työkaluilla
Voit tarkastella lokeja joko suoraan selaimessa tai komentoriviltä SSH-yhteyden kautta.
WordPressin hallintapaneeli
Jos pääset kirjautumaan sivustollesi, löydät tärkeimmät lokit valikosta Työkalut > Lokit. Tämä on helpoin tapa selata viimeisimpiä tapahtumia suoraan graafisessa käyttöliittymässä.
Katso tarkemmat ohjeet täältä: Seravo Plugin – Lokit.
Komentorivi (SSH)
Kaikki lokitiedostot sijaitsevat hakemistossa /data/log/.
Ohjeet SSH-yhteyden muodostamiseen löytyvät täältä: Miten saan SSH/SFTP-yhteyden WordPress-sivustolleni?
Hyödyllisiä komentoja:
wp-watch-logs: Seuraa kaikkia sivuston lokitiedostoja reaaliajassa yhdellä komennolla.wp-watch-php: Seuraa PHP-virhelokeja reaaliajassa yhdellä komennolla.tail -f /data/log/php-error.log: Seuraa PHP-virhelokia reaaliajassa.less /data/log/nginx-error.log: Avaa lokitiedosto selattavaksi (painaqpoistuaksesi).
Saatavilla olevat lokitiedostot
Alla on listaus Seravon ympäristössä asiakkaiden saatavilla olevista lokitiedostoista. Huomioithan, että hakemistossa voi näkyä myös muita tiedostoja, jos käyttämäsi lisäosat tai omat skriptisi generoivat omia lokejaan.
Tärkeimmät vianetsintälokit
Lokitiedosto | Kuvaus ja sisältö |
php-error.log | Tärkein loki vianetsinnässä. Sisältää PHP-virheet, varoitukset ja tiedostopolut rivinumeroineen. |
php-slow.log | Suorituskykyloki. Tallentaa PHP-skriptit, joiden suoritus on kestänyt yli 10 sekuntia. |
nginx-error.log | WWW-palvelimen virheloki. Sisältää tiedot epäonnistuneista pyynnöistä ja sovelluspalomuurin (WAF) tekemistä estoista. |
nginx-access.log | WWW-palvelimen kävijäloki. Sisältää IP-osoitteen, aikaleiman, URL-polun, vastauksen tilakoodin, User Agentin sekä Seravon oman sid-koodin. |
Muutoshistoria ja hallinta
Lokitiedosto | Kuvaus ja sisältö |
wp-settings.log | Sivuston hallinnalliset muutokset. Tallentaa lisäosien aktivoinnit, poistot ja päivitykset käyttäjäkohtaisesti. |
wp-user.log | Käyttäjähallinnan loki. Tallentaa tiedot roolien muutoksista, salasanojen nollauksista ja uusien käyttäjien luomisesta (sisältää ID-tiedot). |
command.log | Sisältää historian suoritetuista |
wp-login.log | Kirjautumisloki. Onnistuneet ja epäonnistuneet kirjautumisyritykset IP-osoitteineen. |
update.log | Lokitiedot Seravon automaattisen päivitysjärjestelmän toiminnasta. |
Tietoturva ja järjestelmä
Lokitiedosto | Kuvaus ja sisältö |
php-compatibility.log | PHP-yhteensopivuustarkistusten tulokset. |
mail.log | Sivuston kautta lähtevän sähköpostiliikenteen (Postfix) tiedot. |
php-mail.log | PHP:n |
security.log | Tietoturvaloki. Sisältää tiedot automaattisista tarkistuksista sekä ilmoitukset epäilyttävistä poikkeamista. |
mariadb-error.log | Tietokantapalvelimen virheilmoitukset. |
redis.log | Redis-objektivälimuistin toimintaan liittyvät tiedot. |
wp-theme-security.log | Teemojen tietoturvaan liittyvät lokitiedot. |
wp-common.log | Merkinnät pyynnöistä, jotka liittyvät sivuston muutoksiin (esim. WAF- tai XML-RPC-muutokset). |
wp-svc.log | Taustapalveluiden (services) tila- ja virhetiedot. |
bootstrap.log | Järjestelmän käynnistykseen liittyvät tiedot. |
runit.log | Palveluiden hallintaan (runit) liittyvät tiedot. |
chromedriver.log | Testauksessa käytettävän Chromedriverin loki. |
Lokien sisällön tulkitseminen
Seravon lokit on muotoiltu tarjoamaan mahdollisimman paljon tietoa ongelmanratkaisuun. Alla on muutamia esimerkkejä siitä, mitä voit lukea riveiltä:
php-error.log
Tämä on tärkein työkalu WordPress-virheiden ratkaisemiseen. Loki kertoo tarkalleen, mikä tiedosto ja mikä rivi koodissa aiheutti ongelman.
Fatal error: Kriittinen virhe, joka pysäyttää sivuston latautumisen (esim. kirjoitusvirhe koodissa tai puuttuva tiedosto).
Warning/Notice: Pienempiä virheitä tai huomautuksia, jotka eivät yleensä kaada sivustoa, mutta kertovat huonosti optimoidusta koodista.
Lue lisää HTTP-virhekoodeista: Jos sivusto palauttaa virhekoodin (kuten 403, 429 tai 504), löydät tarkemmat selitykset ja korjausohjeet täältä: Mitä HTTP-virhekoodit tarkoittavat?
nginx-error.log
Tämä loki sisältää tiedot palvelintasolla estetyistä pyynnöistä ja yhteysvirheistä. Alla muutamia esimerkkejä:
phpflood: Sivuston dynaamisia PHP-sivuja on ladattu liian nopeasti samasta lähteestä.loginflood: Kirjautumisyrityksiä on tullut liian tiheään (suojaa Brute Force -hyökkäyksiltä).ajaxflood: WordPressinadmin-ajax.php-tiedostoon kohdistuu poikkeuksellisen paljon kutsuja.restflood: WordPress REST API -rajapintaan kohdistuu liikaa pyyntöjä lyhyessä ajassa.Upstream timed out: PHP-prosessi kesti liian kauan, ja palvelin katkaisi yhteyden (yleistä 504-virheiden yhteydessä).Connect() failed: nginx ei saanut yhteyttä PHP-prosessiin (esim. ei vapaita prosesseja saatavilla tai kaatuminen).No such file or directory: Viittaus tiedostoon, jota ei löydy palvelimelta.
nginx-access.log
Jokainen pyyntö sisältää Seravon oman istuntotunnisteen eli sid-koodin. Jos sivusto antaa virheilmoituksen, sama koodi näkyy usein virhesivulla. Voit etsiä lokista vastaavan koodin nähdäksesi tarkat tiedot kyseisestä pyynnöstä:
... "sid:f7bbfc84905...;upstream:-;" 0.000
wp-user.log ja wp-settings.log
Nämä lokit ovat erinomaisia sivuston muutoshistorian seurantaan. Näet suoraan, kuka käyttäjä (ID) muutti toisen käyttäjän roolia tai kuka päivitti tietyn lisäosan ja milloin.
mail.log ja php-mail.log
Sivustolta lähtevien sähköpostien lokit. Voit lukea tarkemmat ohjeet vianselvityksen avuksi täältä: WordPress-sähköpostin perillemenon varmistaminen
Lokien säilytys
Lokeja rotatoidaan ja pakataan viikoittain levytilan säästämiseksi. Säilytämme arkistoituja lokeja yhden vuoden ajan, mikä mahdollistaa myös vanhempien tapahtumien tutkimisen jälkikäteen.