d2e2c21684
New year, new copyright, new expected unknown issues with various files that won't be covered by the script and/or will be but shouldn't change. I'll do the details on Jan 1, but would appreciate this being preapproved so I can actually get it merged by then. CHANGELOG_BEGIN CHANGELOG_END |
||
---|---|---|
.. | ||
grafana | ||
graphite | ||
docker-compose.yml | ||
README.md | ||
reset-all.sh | ||
summary.js |
Basic Usage
-
Launch Grafana & Graphite:
$ docker-compose up -d
-
Explore available dashboards:
$ open http://localhost:3000/ # login with admin/admin
-
Power off when done:
$ docker-compose down
Fresh Restart
This will purge all data and configuration changes, and restart Graphite and Grafana:
$ reset-all.sh
Customizing Graphite
After startup, you can explore and adjust the current Graphite configuration in ./graphite/conf
.
Configuration changes remain effective after restarts, but they will be purged by reset-all.sh
.
At the first start, i.e., if the configuration directory is empty, Graphite will reset the configuration to the default.
If you want to change the default configuration, put your adjusted configuration files into ./graphite/default_conf
.
Changes to the default configuration will not be purged by reset-all.sh
.
The following changes have been made to the default configuration:
-
storage-aggregation.conf
: Removed a section that would aggregate metrics ending in.count
usingsum
. Such metrics will be aggregated by using theavg
function instead. Rationale: CodahaleMeter
s andCounter
s will report metrics ending in.count
containing the total number of events measured. Such metrics need to be aggregated with theavg
function, as they reflect the total number of events (as opposed to the delta w.r.t. the last report). -
storage-aggregation.conf
: Changed the defaultxFilesFactor
from0.3
to0.0
. Rationale: If a metric is reported only once per minute, Graphite would discard the metric values after the first aggregation step. -
storage-schemas.conf
: Changed the default retention schedule to10s:7d,1m:30d,10m:1800d
.
Customizing Grafana
The easiest way to customize Grafana is through the web ui. Changes will be persisted to the Grafana db and remain effective after restarts.
You can also import dashboards programmatically:
- Export the dashboard to a json file through the Grafana UI. (Go to the dashboard, share, export, ...)
- Put the dashboard file into
./grafana/dashboards
- Restart:
docker-compose restart
.