Visualize the AEM "metrics.rrd"-file using Graphite and Grafana (and convert the "metrics.rrd" to the real rrd-format).
Starting with AEM 6.4 there will be a metrics reporter enabled that periodically collects metrics and stores them in a time-series data base using RRD4J. The primary purpose of this reporter is to collect metrics data for diagnostics, e.g. to analyze why performance was bad as reported by a customer. The data base contains metrics data with four different granularity levels and with different retention time:
- Per minute averages are kept for the last six hours
- Per five minute averages are kept for the last two days
- Per hour averages are kept for one month
- Per day averages are kept for one year
These are similar to Jackrabbit TimeSeries data already available in AEM with the difference that metrics are stored to the local filesystem and survive restarts.
This tool used DOCKER to build an environment which can:
- convert the RRD4J format to the normal RRD format
- install Graphite to read the RRD-output
- install Grafana to display a dashboads with charts, reading the information from Graphana and outputs it using the browser on " http://localhost " (port: 80).
- Docker for OSx (native)
- Docker for Windows (uses HyperV - VMware and VirtualBox will not work anymore)
Execute within the repository-root folder:
docker-compose build
Place the "metrics.rdd" file and the "metrics.rdd.properties" file from the "AEM configuration-status" into "rrd-file-input" folder (replace the existing sample files).
Execute within the project root folder
docker-compose up
(or for e.g. only the RRD converter "openjdk-rdd-converter")
docker-compose up openjdk-rdd-converter
Open the browser on " http://localhost" to see "Grafana" and open the "AEM Metrics"-dashboard.
