https://github.com/romanzipp/loki-dashboard

🧾 An alternative Dashboard Frontend and Logs Browser for Grafana Loki. Deployable as Docker Container
https://github.com/romanzipp/loki-dashboard

docker grafana logs loki monitoring self-hosted

Last synced: 4 days ago
JSON representation

🧾 An alternative Dashboard Frontend and Logs Browser for Grafana Loki. Deployable as Docker Container

• Host: GitHub
• URL: https://github.com/romanzipp/loki-dashboard
• Owner: romanzipp
• License: mit
• Created: 2024-04-20T10:50:03.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-07-14T05:47:33.000Z (5 months ago)
• Last Synced: 2024-10-31T02:42:22.134Z (about 2 months ago)
• Topics: docker, grafana, logs, loki, monitoring, self-hosted
• Language: JavaScript
• Homepage: https://ghcr.io/romanzipp/loki-dashboard
• Size: 1.37 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Loki Dashboard

An alternative **Dashboard** Frontend and **Logs Browser** for [Grafana Loki](https://grafana.com/oss/loki/).

![Screenshot](art/screenshot-01-light.png#gh-light-mode-only)

![Screenshot](art/screenshot-01-dark.png#gh-dark-mode-only)

### Features

🧾 **See all logs ingested into Loki**  

📌 Automatic fetching of **labels** & handy filtering  

📥 Store current filter **state in URL**, set bookmarks for dashboards  

📮 Parsing of **exceptions** & additonal data  

🖌️ Customizable UI  

📦 Deploy as **Docker** container  

⌨️ Override query build with **custom expression**  

➡️ **Pagination** with infinte scrolling  

🌚 Dark mode

## Setup

The project is built as a [Docker container](https://github.com/romanzipp/Loki-Dashboard/pkgs/container/loki-dashboard) via the GitHub `ghcr.io` container registry.

### Docker

The default port `3000` will be expoed.

```

docker pull ghcr.io/romanzipp/loki-dashboard:latest

```

```

docker run -e "LOKI_ENTRYPOINT=http://localhost:3100" -p 3000:3000 romanzipp/loki-dashboard:latest

```

### Nomad (with Docker)

```hcl

job "loki" {

  group "loki-dashboard" {

    network {

      mode = "bridge"

      port "http" {

        to = 3000

      }

    }

    service {

      name = "loki-dashboard"

      port = "http"

      connect {

        sidecar_service {

          proxy {

            upstreams {

              destination_name = "loki" # <- your Grafana Loki service name

              local_bind_port  = 3100

            }

          }

        }

      }

    }

    task "loki-dashboard" {

      driver = "docker"

      config {

        image = "ghcr.io/romanzipp/loki-dashboard:latest"

        ports = ["http"]

      }

      env {

        LOKI_ENTRYPOINT = "http://${NOMAD_UPSTREAM_ADDR_loki}"

      }

    }

  }

  

  group "loki" {

    # ...

  }

}

```

## Configuration

#### 🔠 `LOKI_ENTRYPOINT` (default: `http://localhost:3100`)

The Loki instance base url.

#### #️⃣ `COLORED_ROWS` (default: false)

Color rows with the according level color.

#### 🔢 `COLORED_ROWS_LEVEL_THRESHOLD` (default: null)

If `COLORED_ROWS` is enabled, only add background to rows with a level larger or equal than the set value. Example: 400

#### 🔢 `LABEL_CHAR_LIMIT` (default: 26)

Maximum limit of characters after which to truncate the label text

## License

[MIT License](LICENSE.md)

## Authors

- [Roman Zipp](https://romanzipp.com)