Celestia Bridge Monitoring

---

Monitoring based on the following components to monitor DA node without pointing on additional local OTEL collector.

• grafana - displaying collected metrics
• node_exporter - monitor server host (network, hardware).
• prometheus - capturing the metrics for Grafana
• loki - data source to display DA logs.
• promtail - sending logs to loki.
• alertmanager - integrated with discord webhook but could be integrated with any supported receivers.
• custom DA exporter - getting metrics (DA height, network height, peers, data received/sent etc.).

Dashboards

Bridge Node

Server

Prerequisites

---

• Docker should be installed with sudo/root privilege. After installation needs to be logout and login again.

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

sudo usermod -aG docker $USER

• Celestia DA needs to be installed with systemd so logs are available in journalctl. Name of the unit file must match the official doc: https://docs.celestia.org/nodes/systemd/.
• Port 9100 should be opened as far node_exporter connected to host prometheus couldn't access to it over standard container name, it points to node_exporter over public IP.
• Port 9999 should be opened to be able to access grafana.
• Make sure your DA node is accessible over RPC port and public IP. Example:

[RPC]
  Address = "0.0.0.0"
  Port = "26658"
  SkipAuth = false

Getting started

---

Download repository

git clone https://github.com/staketown/celestia-da-monitoring.git
cd celestia-da-monitoring

Prepare env and set variables

Edit prapare.sh script with setting your own YOUR_DISCORD_WEB_HOOK, YOUR_BRIDGE_RPC_HERE and NETWORK (default is set to celestia, don't forget to set to mocha if you are going to use for testnet bridge node).

Run script

chmod +x prepare.sh && ./prepare.sh

Start monitoring

Build exporter (should be done once or needs to upgrade)

docker compose build --no-cache

Start monitoring stack

docker compose up -d

Reference list

• Some logic taken from celestia tools by P-OPSTeam
• Celestia official doc
• How to get discord webhook