# 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="/files/00ae8nRLtxi5ctpMDxi6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/RZSlF4JYrLyQ5ZT3r7yJ" alt=""><figcaption></figcaption></figure>

3 - Click in "Add new panel" button

<figure><img src="/files/MyPUIP8T4s7BkPnVeGd8" alt=""><figcaption></figcaption></figure>

4 - Select Loki datasource

<figure><img src="/files/stEReZf81YPEd0Aj4g70" alt=""><figcaption></figcaption></figure>

5 - Define the content filter in Loki query

<figure><img src="/files/feq0E2J5jdAZ1RZwQ05r" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/YIADeeP3btppKfnpSRVU" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stakepool.dev.br/polygon/binaries/monitoring-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.