# Lokit

Source: https://instatus.com/help/fi/observability/logs

Avaa **Observability** → **Lokit** tilasivullasi. Uusimmat lokit ovat ylimpänä, ja niiden yläpuolella on kaavio lokimäärästä. Kaavion punainen viiva on virheet, joten näet heti, milloin jokin alkoi.

![Lokiselain, jossa määrät tasoittain, määräkaavio ja uusimmat lokit](https://instatus.com/help/observability/logs.png)

| At a glance | Details |
| :-- | :-- |
| [Hae](https://instatus.com/help/fi/observability/logs#hae) | Kirjoita sanoja, paina Enter |
| [Suodata](https://instatus.com/help/fi/observability/logs#suodata) | level:, service:, trace_id: tai mikä tahansa määrite |
| [Aikaväli](https://instatus.com/help/fi/observability/logs#vaihda-aikaväliä) | Valmiit, oma tai vetämällä kaaviossa |
| [Lue loki](https://instatus.com/help/fi/observability/logs#lue-loki) | Napsauta riviä |
| [Suora](https://instatus.com/help/fi/observability/logs#suora) | Paina L |
| [Vienti](https://instatus.com/help/fi/observability/logs#vienti) | CSV, JSON tai kopioi |

## Hae

Kirjoita sanoja hakukenttään ja paina **Enter**. Sanat löytyvät mistä tahansa viestistä, missä järjestyksessä tahansa. Laita fraasi lainausmerkkeihin löytääksesi sen tarkalleen, esimerkiksi `"rate limited"`.

Kaavio, määrät ja luettelo päivittyvät hakusi mukaan.

![Lainausmerkeissä olevan fraasin haku yhdistettynä palvelusuodattimeen](https://instatus.com/help/observability/logs-search.png)

## Suodata

Napsauta tyhjää hakukenttää nähdäksesi, millä voit suodattaa. Valitse kenttä ja sitten arvo. Jokainen kenttä näyttää yleisimmät arvonsa ja niiden määrät.

![Suodatettavien kenttien luettelo hakukentän alla](https://instatus.com/help/observability/logs-suggestions.png)

| Suodatin       | Löytää                                                                      |
| ------------ | -------------------------------------------------------------------------- |
| `level:`     | Taso: `fatal`, `error`, `warn`, `info`, `debug` tai `trace`              |
| `service:`   | Yhden palvelun lokit                                                      |
| `trace_id:`  | Yhden pyynnön kaikki lokit kaikista palveluista                            |
| Mikä tahansa määrite | Kirjoita sen nimi, esimerkiksi `http.route:` tai `customer.id:`                    |

Suodattimesta tulee tunniste hakukenttään. Poista se napsauttamalla sen **×**. Lisää suodattimen eteen `-` sulkeaksesi sen pois, esimerkiksi `-level:debug`.

### Suodata tason mukaan

Kirjoita `level:` avataksesi tason valinnan. Se näyttää, montako lokia kullakin tasolla on. Valitse useita painamalla **välilyöntiä** ja paina sitten **Enter**. Kaksi pikavalintaa kattaa tavalliset tapaukset: `level:>=warn` pitää varoitukset ja sitä vakavammat, ja `-level:debug` piilottaa debug-kohinan.

![Tason valinta, jossa määrä tasoittain ja kaksi pikavalintaa](https://instatus.com/help/observability/logs-levels.png)

Hakukentän vieressä oleva painike **Palvelu** on pikavalinta suodattimelle `service:`. Kaavion yläpuolella olevan tason napsauttaminen kytkee sen päälle tai pois.

### Hakusyntaksi

| Kirjoita                                  | Löytää                                       |
| -------------------------------------- | ------------------------------------------- |
| `timeout`                              | Lokit, joissa sana on                  |
| `"connection pool"`                    | Täsmälleen tämä fraasi                           |
| `timeout retry`                        | Molemmat sanat, missä järjestyksessä tahansa                    |
| `timeout OR refused`                   | Jompikumpi sana                                 |
| `-timeout` tai `NOT timeout`            | Lokit ilman sanaa                       |
| `level:error service:api`              | Molemmat suodattimet                                |
| `(timeout OR refused) AND service:api` | Ryhmitelty sulkeilla                    |
| `service:"billing worker"`             | Välilyöntejä sisältävä arvo lainausmerkeissä              |

`AND`, `OR` ja `NOT` kirjoitetaan isoilla kirjaimilla. Jos hakua ei voi lukea esimerkiksi siksi, että lainausmerkki jää sulkematta, selain kertoo siitä ja pitää edelliset tulokset.

Viimeisimmät hakusi näkyvät, kun avaat hakukentän, joten usein käyttämäsi haku on yhden napsautuksen päässä.

## Vaihda aikaväliä

Napsauta aikavälipainiketta ja valitse viimeisistä 15 minuutista viimeisiin 7 päivään, tai aseta oma aikaväli kentillä **Alkaen** ja **Päättyen**.

![Aikavälivalikko, jossa valmiit vaihtoehdot ja oma aikaväli](https://instatus.com/help/observability/logs-time-range.png)

Lähennä piikkiin vetämällä sen yli kaaviossa. Takaisin-painike palauttaa edelliseen aikaväliin.

## Lue loki

Napsauta riviä tai siirry siihen nuolilla **↑** **↓** ja paina **Enter**. Tietopaneeli avautuu, ja siinä on:

- Koko viesti ja **Kopioi viesti**.
- **Samankaltaiset lokit** samankaltaisten viestien hakemiseen.
- **N lokia tässä jäljessä**, kun loki kuuluu pyyntöön. Se näyttää pyynnön jokaisen lokin kaikista palveluista.
- Lokin määritteet ja sen resurssi (palvelu, isäntä ja versio, josta se tuli). Napsauta arvoa suodattaaksesi sillä, sulkeaksesi sen pois tai kopioidaksesi sen.

![Virheloki tietopaneelissa, näkyvissä viesti, linkki jälkeen ja määritteet](https://instatus.com/help/observability/logs-detail.png)

Paneelin yläreunan nuolet siirtyvät edelliseen ja seuraavaan lokiin.

## Suora

Paina **L** tai napsauta **Suora** nähdäksesi lokit niiden saapuessa. Uudet lokit ilmestyvät ylös, ja otsikko näyttää, montako saapuu sekunnissa. Haku ja suodattimet ovat yhä voimassa, joten `level:error` suorassa tilassa on suora virhesyöte.

![Suora seuranta, jossa uusia lokeja saapuu ja määrä sekunnissa näkyy](https://instatus.com/help/observability/logs-live.png)

Pysäytä napsauttamalla taukopainiketta tai painamalla **L** uudelleen. Kaavio pitää aikavälin, joka oli ennen suoraa tilaa. Jos lokeja saapuu nopeammin kuin niitä voi näyttää, ilmoitus kertoo siitä: pysäytä ja hae nähdäksesi kaikki.

## Vienti

Valitse haluamasi lokit valintaruuduilla. Luettelon yläpuolelle ilmestyy palkki, jossa on **Vie CSV**, **Vie JSON** ja **Kopioi**.

![Kolme valittua lokia ja luettelon yläpuolella CSV- ja JSON-viennin sekä kopioinnin painikkeet](https://instatus.com/help/observability/logs-export.png)

Hakupalkin lopussa oleva latauspainike vie kaikki luetteloon ladatut lokit CSV-muodossa. Viennit sisältävät jokaisen lokin ajan, palvelun, tason ja viestin. Saat lokin määritteet avaamalla sen ja käyttämällä tietopaneelin toimintoa **Kopioi JSON-muodossa**.

## Pikanäppäimet

| Näppäin               | Toiminto                                 |
| ----------------- | ------------------------------------ |
| `↓` `↑` tai `J` `K` | Siirry lokien välillä                   |
| `Enter`           | Avaa valittu loki                |
| `Esc`             | Sulje tietopaneeli tai valikko      |
| `L`               | Käynnistä tai pysäytä suora seuranta              |
| `Space`           | Valitse useita arvoja valinnassa      |

- [Jäljet](https://instatus.com/help/fi/observability/traces): Näe, mihin kukin pyyntö käyttää aikansa
- [Koontinäkymät](https://instatus.com/help/fi/observability/dashboards): Tärkeimmät luvut yhdelle sivulle
