https://github.com/mbelloiseau/website-monitoring

Monitore your websites availability, http status code (current and history), certificate, redirects and more with Grafana and Prometheus blackbox exporter.
https://github.com/mbelloiseau/website-monitoring

availability grafana grafana-dashboard monitoring observability prometheus website-monitoring

Last synced: about 1 month ago
JSON representation

Monitore your websites availability, http status code (current and history), certificate, redirects and more with Grafana and Prometheus blackbox exporter.

• Host: GitHub
• URL: https://github.com/mbelloiseau/website-monitoring
• Owner: mbelloiseau
• Created: 2020-09-09T18:52:17.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-07T11:26:46.000Z (4 months ago)
• Last Synced: 2024-09-08T10:56:35.861Z (3 months ago)
• Topics: availability, grafana, grafana-dashboard, monitoring, observability, prometheus, website-monitoring
• Language: Shell
• Homepage:
• Size: 1.12 MB
• Stars: 97
• Watchers: 6
• Forks: 36
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# website-monitoring

![web-1](screenshots/website-monitoring_1.png)

Monitore your websites availability, http status code (current and history), certificate, redirects and more with

* [Prometheus](https://github.com/prometheus/prometheus)

* [Prometheus blackbox exporter](https://github.com/prometheus/blackbox_exporter)

* [Grafana](https://github.com/grafana/grafana)

## Dependencies

* [docker](https://docs.docker.com/install/)

* [docker-composer](https://docs.docker.com/compose/install/)

## Usage

* `git clone [email protected]:mbelloiseau/website-monitoring.git && cd website-monitoring`

* Edit `config/prometheus/targets.yml` (see targets.yml.example) or use `./gen_target.sh website-1.tld website-2.tld ...`

* Create and start containers `docker-compose up -d`

* [Visualize dashboards](http://localhost:3000/)

If you already have Prometheus and Prometheus blackbox exporter up and running just import the dashboards ([website-monitoring](dashboards/website-monitoring.json) or [overview](dashboards/overview.json)) and use the right [datasource](screenshots/import.png) and [jobs](screenshots/import.png) (http_job and icmp_job)

## Dashboards

###  Website monitoring

  

* HTTP status code

* HTTP redirects

* HTTP version

* TLS version

* Certificate validity

* ICMP

* DNS lookup time

* Availability over the last 24 hours, 3 days and 7 days

* Probe duration and status code history

![web-2](screenshots/website-monitoring_2.png)

![web-3](screenshots/website-monitoring_3.png)

### Overview

* Total number of targets

* Percentage of HTTP 200 status code

* Percentage of targets using SSL

* Global invalid status code history

![overview](screenshots/overview_1.png)

## Tips and tricks

### PromQL

Some useful PromQL queries

* Number of days till certificate expiration

  * `(probe_ssl_earliest_cert_expiry{instance=~"$target",job="$http_job"} - time()) / (60*60*24)`

* Display bad HTTP status code

  * `probe_http_status_code{job="$http_job",instance=~"$target"} != 200`

* Count the number of each status code

  * `count_values("code", probe_http_status_code)`

* Percentage of HTTP 200

  * `((count(count by (instance) (probe_http_status_code == 200))) / (count(count by (instance) (probe_http_status_code)))) * 100`

### Misc

* Request blackbox exporter

  * `curl -s "localhost:9115/probe?module=http_2xx&target=target.tld"`