> For the complete documentation index, see [llms.txt](https://services.shachopra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://services.shachopra.com/story-testnet-odyssey/story-dashboard.md).

# Story Dashboard

## Grafana Dashboard by shachopra

### <https://story-dashboard.shachopra.com/d/be0knjlubeakgd/story-dashboard>

#### Grafana Dashboard Reference JSON file:  <https://raw.githubusercontent.com/shachopra-ai/story-grafana/refs/heads/main/grafana_dashboard.json>

### Setting Up Grafana Dashboard for Node Monitoring

#### 1. Install docker

* Official website: [https://docs.docker.com/engine/install/ubuntu/](https://docs.docker.com/engine/install/ubuntu)

#### 2. Install Grafana

* Create Docker Compose Configuration for Grafana: docker-compose-grafana.yml

```
cd $HOME
mkdir docker
mkdir docker/grafana

cd $HOME/docker/grafana
```

```
nano docker-compose-grafana.yml
```

```
services:
  grafana:
    image: grafana/grafana
    container_name: grafana
    restart: unless-stopped
    ports:
     - '3000:3000'
    volumes:
      - grafana-storage:/var/lib/grafana
volumes:
  grafana-storage: {}
```

```
docker-compose -f docker-compose-grafana.yml up -d
```

* This Docker Compose setup deploys Grafana in a Docker container
* Access Grafana by navigating to [http://your-ip:3000](http://your-ip:3000/)

#### 3. Install Prometheus

* Create Docker Compose Configuration for Prometheus: docker-compose-prometheus.yml

```
cd $HOME
mkdir docker/prometheus

cd $HOME/docker/prometheus
```

```
nano docker-compose-prometheus.yml
```

```
services:
  prometheus:
    image: prom/prometheus
    container_name: prom
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
    ports:
      - 9092:9090
    restart: unless-stopped
    volumes:
      - ./prometheus:/etc/prometheus
      - prom_data:/prometheus
volumes:
  prom_data:
```

* Create Prometheus Configuration File: prometheus.yml

```
cd $HOME
mkdir docker/prometheus/prometheus
cd $HOME/docker/prometheus/prometheus
```

```
nano prometheus.yml
```

```
global:
  scrape_interval: 15s
  scrape_timeout: 10s
  evaluation_interval: 15s
alerting:
  alertmanagers:
    - static_configs:
      - targets: []
      scheme: http
      timeout: 10s
      api_version: v1
scrape_configs:
  - job_name: "prometheus"
    static_configs:
      - targets: ["your-ip:9092"]
  - job_name: "story"
    static_configs:
      - targets: ["<your-ip>:47660"]
  - job_name: "exporter"
    static_configs:
      - targets: ["<your-ip>:9100"]
  - job_name: "geth"
    metrics_path: /debug/metrics/prometheus
    static_configs:
      - targets: ["<your-ip>:6060"]
```

```
cd $HOME/docker/prometheus
```

```
docker-compose -f docker-compose-prometheus.yml up -d
```

* This Docker Compose setup deploys Prometheus in a Docker container
* If prometheus is successfully setup, then you can access [http://your-ip:909](http://your-ip:9092/)

#### 4. Configure story config.toml & modify Geth Service file

```
nano $HOME/.story/story/config/config.toml
```

```
#make sure prometheus is set to true
prometheus = true
prometheus_listen_addr = 47660
```

```
nano /etc/systemd/system/story-geth.service
```

```
[Unit]
Description=Story Geth daemon
After=network-online.target

[Service]
User=$USER
ExecStart=$HOME/go/bin/story-geth --odyssey --syncmode full --http --ws --metrics --metrics.addr 0.0.0.0 --metrics.port 6060
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

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

```
systemctl daemon-reload
```

#### 5. Install Node Exporter

* Download Node Exporter

```
cd $HOME
wget https://github.com/prometheus/node_exporter/releases/download/v1.8.2/node_exporter-1.8.2.linux-amd64.tar.gz
tar xvf node_exporter-1.8.2.linux-amd64.tar.gz
cd node_exporter-1.8.2.linux-amd64
```

* Move the Node Exporter Binary

```
sudo cp node_exporter /usr/local/bin
```

* Create a Node Exporter User

```
sudo useradd --no-create-home --shell /bin/false node_exporter
sudo chown node_exporter:node_exporter /usr/local/bin/node_exporter
```

* Configure the Service

```
sudo nano /etc/systemd/system/node_exporter.service
```

```
[Unit]
Description=Node Exporter
Wants=network-online.target
After=network-online.target

[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter
Restart=always
RestartSec=3

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

* Start the service

```
sudo systemctl daemon-reload
sudo systemctl enable node_exporter
sudo systemctl start node_exporter
sudo systemctl status node_exporter.service
```

* If node exporter is successfully setup, then you can access [http://your-ip:9100](http://your-ip:9100/)

#### 6. Configuring and Using Grafana

Configure Grafana through its web interface ([http://your-ip:3000](http://your-ip:3000/)) to connect to your data sources & create dashboards.

* Go to [http://your-ip:3000](http://your-ip:3000/) and click on data sources in Connections menu.
* Choose **Prometheus** as data source type
* Add Prometheus server URL: [http://your-ip:9092](http://your-ip:9092/)
* Then click Save & test.
* Then go to Dashboards & click on new dashboard.
* Then click on Import dashboard.
* Upload dashboard JSON file: [Reference JSON file](https://raw.githubusercontent.com/shachopra-ai/story-grafana/refs/heads/main/grafana_dashboard.json)