# Monitoring logs

## Centralized Logs with Loki and Promtail

Loki install

#### 1 - Download loki

```
wget https://github.com/grafana/loki/releases/download/v2.8.0/loki-linux-amd64.zip
```

#### 2 - Download Loki example configuration file

```
wget https://raw.githubusercontent.com/grafana/loki/master/cmd/loki/loki-local-config.yaml
```

#### 3 - Create directory for Loki application

```
sudo mkdir /usr/local/bin/loki
```

#### 4 - Unzip loki

```
unzip loki-linux-amd64.zip
```

#### 5 - Copy files to Loki application directory

```
sudo cp loki-linux-amd64 /usr/local/bin/loki
sudo cp loki-local-config.yaml /usr/local/bin/loki
```

#### 6 - Create service file

```
sudo vi /etc/systemd/system/loki.service
```

#### Put this content in the file and save

```
[Unit]
Description=Loki Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/loki/loki-linux-amd64 -config.file=/usr/local/bin/loki/loki-local-config.yaml

[Install]
WantedBy=multi-user.target
```

#### 7 - Reload daemons

```
sudo systemctl daemon-reload
```

#### 8 - Execute the loki

```
sudo systemctl start loki
```

#### 9 - Checking if loki is really running

```
sudo systemctl status loki
```

#### 10 - Enabling service in boot

```
sudo systemctl enable loki
```

Promtail install

#### 1 - Download Promtail

```
wget https://github.com/grafana/loki/releases/download/v2.4.2/promtail-linux-amd64.zip
```

#### 2 - Download Promtail example configuration file

```
wget https://raw.githubusercontent.com/grafana/loki/main/clients/cmd/promtail/promtail-local-config.yaml
```

#### 3 - Create directory for Promtail application

```
sudo mkdir /usr/local/bin/promtail
```

#### 4 - Unzip promtail

```
unzip promtail-linux-amd64.zip
```

#### 5 - Copy files to Promtail application directory

```
sudo cp promtail-linux-amd64 /usr/local/bin/promtail
sudo cp promtail-local-config.yaml /usr/local/bin/promtail
```

#### 6 - Configuring the Promtail configuration file

Open file

```
sudo nano /usr/local/bin/promtail/promtail-local-config.yaml
```

Set the address of the Loki Server that will receive the Log stream, and the path of the files that will be sent.

```
server:
  http_listen_port: 9080
  grpc_listen_port: 0

positions:
  filename: /tmp/positions.yaml

clients:
  - url: http://localhost:3100/loki/api/v1/push

scrape_configs:
- job_name: system
  static_configs:
  - targets:
      - localhost
    labels:
      job: <LABEL NAME OF YOUR JOB>
      __path__: <PATH OF YOUR LOG FILE>
```

#### 7 - Create service file

```
sudo vi /etc/systemd/system/promtail.service
```

Put this content in the file and save

```
[Unit]
Description=Promtail Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/promtail/promtail-linux-amd64 -config.file=/usr/local/bin/promtail/promtail-local-config.yaml

[Install]
WantedBy=multi-user.target
```

#### 8 - Reload daemons

```
sudo systemctl daemon-reload
```

#### 9 - Execute the promtail

```
sudo systemctl start promtail
```

#### 10 - Checking if promtail is really running

```
sudo systemctl status promtail
```

#### 11 - Enabling service in boot

```
sudo systemctl enable promtail
```

### Dashboards Loki query based

1 - In "Dashboards" menu click in "Browse"

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-38b430dae22cb9f670d02d6be02bd6f1d2ad2f07%2Fimage%20(27)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

2 - Click in "New Dashboard" button or click on an existing dashboard

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-bd4820b67dee4e39057000d14367226301a1709f%2Fimage%20(28)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

3 - Click in "Add new panel" button

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-a96063da2f249dd0013374cc064cb7f626310180%2Fimage%20(29)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

4 - Select Loki datasource

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-3adafe27064d3596eeab70c730ca0b2cee0ae8eb%2Fimage%20(30)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

5 - Define the content filter in Loki query

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-6f55eecb62f82bc31283d864e68433ffe9685677%2Fimage%20(31)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

6 - Define title and description of panel and click in save button

<figure><img src="https://577206089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FilWUahKUPyBVUGJl2b1M%2Fuploads%2Fgit-blob-e0bc6d07450ba7ee5913b93f8e244f9e80db2915%2Fimage%20(32)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>