Skip to content

Commit

Permalink
Merge pull request #8 from ar51an/2.2
Browse files Browse the repository at this point in the history
2.2
  • Loading branch information
ar51an authored Dec 21, 2023
2 parents ea9ce3d + d362140 commit 3716366
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 12 deletions.
24 changes: 12 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,23 +31,23 @@
🔸 Unbound metrics exporter in `Go`
🔸 Log aggregation with `Loki`
🔸 Unbound `setup` is available at [unbound-redis](https://github.com/ar51an/unbound-redis)
🔸 Refer to `info.md` for dashboard details
🔸 Refer to `info.md` for dashboard details and `release.md` for changes

#### Specs:
> |Grafana|Prometheus|Loki |Go |OS |HW |
> |:------|:---------|:------|:-------|:----------------------------|:-----------------------|
> |`9.3.16`|`2.24.1` |`2.7.3`|`1.19.4`|`raspios-bullseye-arm64-lite`|`Raspberry Pi 4 Model B`|
> |Grafana |Prometheus|Loki |Go |OS |HW |
> |:-------|:---------|:------|:-------|:----------------------------|:-----------------------|
> |`10.1.0`|`2.42.0` |`2.8.4`|`1.21.5`|`raspios-bookworm-arm64-lite`|`Raspberry Pi 4 Model B`|
#
### Steps
  🔸 Grafana ➜ Prometheus ➜ Unbound Exporter ➜ Loki ➜ Import Dashboard
#### ❯ Grafana
* **Download:**
There are 2 versions **OSS** and **Enterprise**. OSS version is more than enough. Enterprise version installs too many extra packages (like unattended-upgrades and more). Below cmd downloads _Grafana OSS_ for arm64.
> `wget https://dl.grafana.com/oss/release/grafana_9.3.16_arm64.deb`
> `wget https://dl.grafana.com/oss/release/grafana_10.1.0_arm64.deb`
* **Install:**
> `sudo dpkg -i grafana_9.3.16_arm64.deb`
> `sudo dpkg -i grafana_10.1.0_arm64.deb`
> `ℹ️` **Note:**
> A tweaked `grafana.ini` is available in the release. It reduces memory footprint, removes usage collection, stops calls to grafana server/repo and has few more optimizations. You can use _grafana.ini_ **either** from the release **or** the default one. Default config is located at `/etc/grafana/grafana.ini`
Expand All @@ -63,7 +63,7 @@
#
#### ❯ Prometheus
* **Install:**
* **Install:**
> `sudo apt install prometheus`
* **Config:**
Expand All @@ -76,7 +76,7 @@
Node exporter exports machine metrics. It is installed as part of prometheus pkg and runs as systemd service. It is not needed for _unbound-dashboard_. Unless you are already using it, remove node exporter. Below cmd will remove 8 node-exporter related pkgs.
> **Remove:**
> `sudo apt --purge autoremove prometheus-node-exporter`
> **Disable Scrape Config:**
> **Disable scrape config:**
> Provided `prometheus.yml` has _node_ exporter scrapping config removed.
* **UI:**
Expand Down Expand Up @@ -125,12 +125,12 @@
#### ❯ Loki
* **Download:**
Download `Loki` and `Promtail`
> `curl -O -L "https://github.com/grafana/loki/releases/download/v2.7.3/loki_2.7.3_arm64.deb"`
> `curl -O -L "https://github.com/grafana/loki/releases/download/v2.7.3/promtail_2.7.3_arm64.deb"`
> `curl -O -L "https://github.com/grafana/loki/releases/download/v2.8.4/loki_2.8.4_arm64.deb"`
> `curl -O -L "https://github.com/grafana/loki/releases/download/v2.8.4/promtail_2.8.4_arm64.deb"`
* **Install:**
> `sudo dpkg -i loki_2.7.3_arm64.deb`
> `sudo dpkg -i promtail_2.7.3_arm64.deb`
> `sudo dpkg -i loki_2.8.4_arm64.deb`
> `sudo dpkg -i promtail_2.8.4_arm64.deb`
* **Logging:**
Enable Unbound logging.
Expand Down
5 changes: 5 additions & 0 deletions release.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
#### Release Notes:
* **2.2 Release:**
Updated dashboard to support Grafana 10.1.0
unbound-exporter compiled with Golang 1.21.5
Updated documentation to reflect RaspberryPi OS Bookworm changes

* **2.1 Release:**
Improved dashboard with new panels.
To update from 2.0 to 2.1, simply delete the current dashboard and import the new dashboard json in Grafana.
Expand Down

0 comments on commit 3716366

Please sign in to comment.