• Stars
    star
    261
  • Rank 151,228 (Top 4 %)
  • Language
  • License
    MIT License
  • Created about 7 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Monitor your GitHub Repos with Docker & Prometheus

Build Status

A Docker Stack which Monitors your GitHub Repos

Here's a quick start to stand-up a Docker Prometheus stack containing Prometheus, Grafana and github-exporter to collect and graph GitHub statistics.

Pre-requisites

Before we get started installing the Prometheus stack. Ensure you install the latest version of docker and docker-compose on your Docker host machine. This has also been tested with Docker for Mac and it works well.

Installation

Clone the project to your Docker host.

If you would like to change which targets should be monitored or make configuration changes edit the /prometheus/prometheus.yml file. The targets section is where you define what should be monitored by Prometheus. The names defined in this file are actually sourced from the service name in the docker-compose file. If you wish to change names of the services you can add the "container_name" parameter in the docker-compose.yml file.

Configuration

In order to pull GitHub stats consistently it is recommended you create a personal access token inside of GitHub. This token will allow you to query the GitHub API more frequently than a public user. Create GitHub Token. It is only necessary to give the repo scope to the token permission.

Copy the GitHub Token you created and paste into the bottom of the docker-compose.yml file under the metrics service section replacing the GITHUB_TOKEN with your newly created token.

The REPOS variable can also be updated to point to the Repos that you wish to monitor. In my example I monitor freeCodeCamp and Docker.

 metrics:
  tty: true
  stdin_open: true
  expose:
    - 9171
  image: infinityworks/github-exporter:latest 
  environment:
    - REPOS=freeCodeCamp/freeCodeCamp, docker/docker
    - GITHUB_TOKEN=<GitHub API Token see README>
  networks:
    - back-tier

Once configurations are done let's start it up. From the /prometheus project directory run the following command:

$ docker-compose up -d

That's it. docker-compose builds the entire Grafana and Prometheus stack automagically.

The Grafana Dashboard is now accessible via: http://<Host IP Address>:3000 for example http://192.168.10.1:3000

username - admin password - foobar (Password is stored in the config.monitoring env file)

The DataSource and Dashboard for Grafana are automatically provisioned. You can still install the dashboard manually if you choose below.

Manual Install Dashboard

I created a Dashboard template which is available on GitHub Stats Dashboard. Simply download the dashboard and select from the Grafana menu -> Dashboards -> Import

This dashboard is intended to help you get started with graphing your GitHub Repos. If you have any changes you would like to see in the Dashboard let me know so I can update Grafana site as well.

Troubleshooting

It appears some people have reported no data appearing in Grafana. If this is happening to you be sure to check the time range being queried within Grafana to ensure it is using Today's date with current time.

More Repositories

1

prometheus

A docker-compose stack for Prometheus monitoring
4,208
star
2

docker-monitoring

Docker-Monitoring based on Cadvisor, InfluxDB, and Grafana
465
star
3

docker-traefik-prometheus

A Docker Swarm Stack for monitoring Traefik with Promethues and Grafana
309
star
4

docker-compose-demo

A short demo on how to use Docker Compose to create a Web Service connected to a load balancer and a Redis Database.
Python
179
star
5

grafana_dashboard

A Grafana Dashboard for monitoring Docker with Prometheus
58
star
6

crypto-currency-tracker

Track your Crypto Currencies with this Docker & Prometheus Stack
54
star
7

docker-pulls

A simple compose script to use in conjunction with the prometheus stack to monitor Docker pulls.
20
star
8

mac-background

A Python script which grabs random images from Unsplash and set it as your Mac OSX background image
Python
14
star
9

traefik-ghost

A Docker Stack using Traefik Proxy & Ghost 1.x
5
star
10

Ghost-Standalone

A Docker powered Ghost installation with volumes
CSS
4
star
11

webslides

A Dockerized version of http://www.Webslides.tv
4
star
12

vscode-docker-demo

Demo code for the DockerCon VS Code demo
Python
4
star
13

docker-ch-meetup10

10th Docker Switzerland User Group Meetup Docker Swarm Demo
4
star
14

docker-LAMP

A small Docker LAMP stack
3
star
15

docker-ecs-demo

This is a demo repo for deploying containers directly to AWS ECS
Python
3
star
16

linux_tweet_app

This a demo autobuild
HTML
2
star
17

traefik-migration

A Repo to help you migrate Traefik from 1.7 to 2.x
2
star
18

vegasbrianc

1
star
19

hugo

The really cool Hugo Static Website generator Dockerized
1
star
20

prom

Prometheus Docker Build
1
star
21

K8s-demo

Docker Kuberenetes Stack Demo
1
star