Skip to content

Commit

Permalink
📝 Add grafana documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Samuel Guillemet committed Feb 8, 2024
1 parent 5e46c34 commit ca9e431
Show file tree
Hide file tree
Showing 9 changed files with 80 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,3 +172,5 @@ $> ./cli.sh project <component> test
The project is monitored with prometheus and grafana. You can access the grafana dashboard at http://localhost:3000 with anonymous access.

You will have dashboards for kafka cluster and the different components of the project.

Check the [Grafana documentation](docs/Grafana.md) for more information.
1 change: 1 addition & 0 deletions components/website-backend/tests/app/core/test_config.py
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ def test_env_dev_override_db_type_sqlite(monkeypatch: pytest.MonkeyPatch):

def test_env_prod(monkeypatch: pytest.MonkeyPatch):
monkeypatch.setenv("SECRET_KEY", "FAKE_VALUE")
monkeypatch.setenv("BASE_ACCOUNT_USERNAME", "FAKE_VALUE")
monkeypatch.setenv("BASE_ACCOUNT_PASSWORD", "FAKE_VALUE")
monkeypatch.setenv("POSTGRES_HOST", "localhost")
monkeypatch.setenv("POSTGRES_DB", "FAKE_VALUE")
Expand Down
77 changes: 77 additions & 0 deletions docs/Grafana.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# Grafana Dashboards

## Introduction

Grafana is a multi-platform open source analytics and interactive visualization web application. It provides charts, graphs, and alerts for the web when connected to supported data sources. It is expandable through a plug-in system. End users can create complex monitoring dashboards using interactive query builders.

## Prometheus

Prometheus is an open-source monitoring and alerting toolkit. It is a part of the Cloud Native Computing Foundation. It collects metrics from configured targets at given intervals, evaluates rule expressions, displays the results, and can trigger alerts if some condition is observed to be true.

## Configuration

The different configurations for the Grafana dashboards are stored in the `monitoring` directory.

```
monitoring/
├── grafana
│ └── provisioning
│ ├── dashboards
│ │ ├── dashboards.yml
│ │ └── data
│ │ ├── Engine metrics
│ │ │ ├── Market Data Subscription.json
│ │ │ ├── Market Matcher.json
│ │ │ ├── Order Book.json
│ │ │ ├── Order stream.json
│ │ │ ├── Quickfix server.json
│ │ │ └── Trade stream.json
│ │ └── Kafka metrics
│ │ ├── KMinion Cluster Dashboard - Prometheus Exporter for Apache Kafka.json
│ │ ├── KMinion Consumer Group Dashboard - Prometheus Exporter for Apache Kafka.json
│ │ └── KMinion Topic Dashboard - Prometheus Exporter for Apache Kafka.json
│ └── datasources
│ └── datasources.yml
└── prometheus
└── prometheus.yml
```

The `grafana` directory contains the configuration for the Grafana dashboards. The `provisioning` directory contains the configuration for the dashboards and the data sources. The `prometheus` directory contains the configuration for the Prometheus server.

## Dashboards

### Quickfix Server

![alt text](imgs/quickfix-server-grafana.png)

---

### Order Book

![alt text](imgs/order-book-grafana.png)

---

### Order Stream

![alt text](imgs/order-stream-grafana.png)

---

### Market Matcher

![alt text](imgs/market-matcher-grafana.png)

---

### Market Data Subscription

![alt text](imgs/market-data-grafana.png)

---

### Trade Stream

![alt text](imgs/trade-stream-grafana.png)

---
Binary file added docs/imgs/market-data-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/market-matcher-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/order-book-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/order-stream-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/quickfix-server-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/trade-stream-grafana.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ca9e431

Please sign in to comment.