README.md

Grafana XXL

Dockerized Grafana with all preinstalled plugins from https://grafana.net/plugins.

Please donate to author, so he can continue to publish another awesome projects for free:

Running your Grafana XXL Docker image

Start your image binding the external port 3000:

docker run -d --name=grafana-xxl -p 3000:3000 monitoringartist/grafana-xxl:latest

Try it out, default admin user is admin/admin.

Grafana XXL with persistent storage (recommended)

# create /var/lib/grafana as persistent volume storage
docker run -d -v /var/lib/grafana --name grafana-xxl-storage busybox:latest

# start grafana-xxl
docker run \
  -d \
  -p 3000:3000 \
  --name grafana-xxl \
  --volumes-from grafana-xxl-storage \
  monitoringartist/grafana-xxl:latest

Running specific version of Grafana XXL

# specify right tag, e.g. 2.6,3.1,dev (latest nigthly build) - see Docker Hub for available tags
docker run \
  -d \
  -p 3000:3000 \
  --name grafana-xxl \
  monitoringartist/grafana-xxl:dev

Building Grafana XXL for ARM

You need ARM-version Grafana's deb (for example from here). Also you need ARM-version of gosu (from here)

# armhf
docker build \
  --tag grafana-xxl \
  --build-arg GRAFANA_DEB_URL=https://github.com/fg2it/grafana-on-raspberry/releases/download/v5.0.4/grafana_5.0.4_armhf.deb \
  --build-arg GOSU_BIN_URL=https://github.com/tianon/gosu/releases/download/1.10/gosu-armhf .

# arm64
docker build \
  --tag grafana-xxl \
  --build-arg GRAFANA_DEB_URL=https://github.com/fg2it/grafana-on-raspberry/releases/download/v5.0.4/grafana_5.0.4_arm64.deb \
  --build-arg GOSU_BIN_URL=https://github.com/tianon/gosu/releases/download/1.10/gosu-arm64 .

Configuring your Grafana container

All options defined in conf/grafana.ini can be overriden using environment variables by using the syntax GF__. For example:

docker run \
  -d \
  -p 3000:3000 \
  --name=grafana-xxl \
  -e "GF_SERVER_ROOT_URL=http://grafana.server.name" \
  -e "GF_SECURITY_ADMIN_PASSWORD=secret" \
  monitoringartist/grafana-xxl:latest

More information in the grafana configuration documentation: http://docs.grafana.org/installation/configuration/

Configuring AWS credentials for CloudWatch support (only Grafana 3.+)

docker run \
  -d \
  -p 3000:3000 \
  --name=grafana-xxl \
  -e "GF_AWS_PROFILES=default" \
  -e "GF_AWS_default_ACCESS_KEY_ID=YOUR_ACCESS_KEY" \
  -e "GF_AWS_default_SECRET_ACCESS_KEY=YOUR_SECRET_KEY" \
  -e "GF_AWS_default_REGION=eu-west-1" \
  monitoringartist/grafana-xxl:latest

You may also specify multiple profiles to GF_AWS_PROFILES (e.g. GF_AWS_PROFILES=default another).

Supported variables:

• GF_AWS_PROFILES: list of AWS profiles for Cloudwatch datasource
• GF_AWS_${profile}_ACCESS_KEY_ID: AWS access key ID (required).
• GF_AWS_${profile}_SECRET_ACCESS_KEY: AWS secret access key (required).
• GF_AWS_${profile}_REGION: AWS region (optional).

Auto upgrade plugins

Container tries to upgrade all installed plugins in the container automatically before Grafana start. If you want to disable this behaviour, please use environment variable -e UPGRADEALL=false.

Supported monitoring services

• Hawkular
• Raintank

Integrations

• Puppet for dockerized grafana-xxl
• Ansible for dockerized grafana-xxl
• docker-compose for dockerized grafana-xxl

Author

Devops Monitoring Expert, who loves monitoring systems and cutting/bleeding edge technologies: Docker, Kubernetes, ECS, AWS, Google GCP, Terraform, Lambda, Zabbix, Grafana, Elasticsearch, Kibana, Prometheus, Sysdig, ...

Summary:

• 1000+ GitHub stars
• 6000+ Grafana dashboard downloads
• 800 000+ Docker image pulls

Professional devops / monitoring / consulting services: