Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 months 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 (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-19T22:15:50.000Z (over 1 year ago)
- Last Synced: 2024-06-28T09:35:03.847Z (4 months ago)
- Topics: availability, grafana, grafana-dashboard, monitoring, observability, prometheus, website-monitoring
- Language: Shell
- Homepage:
- Size: 1.11 MB
- Stars: 89
- Watchers: 6
- Forks: 33
- 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"`