mrnonz / domain_exporter

Exports the expiration time of your domains as prometheus metrics.

domain_exporter

Exports the expiration time of your domains as prometheus metrics.

Environment variables

• DOMAIN_EXPORTER_URL_PREFIX - use when HTTP endpoint served with a prefix, e.g.:

  For this endpoint http://example.org/exporters/domains set to /exporters/domains.

  Not really required since useful only to prevent breaking human-oriented links.

  Defaults to empty string.

Configuration

On the prometheus settings, add the domain_exporter prober:

- job_name: domain
  metrics_path: /probe
  relabel_configs:
    - source_labels: [__address__]
      target_label: __param_target
    - target_label: __address__
      replacement: localhost:9222 # domain_exporter address
  static_configs:
    - targets:
      - carlosbecker.com
      - carinebecker.com
      - watchub.pw

It works more or less like prometheus's blackbox_exporter.

Alerting rules examples can be found on the _examples folder.

You can configure domain_exporter to always export metrics for specific domains. Create configuration file:

domains:
- google.com
- reddit.com

And pass file path as agrument to domain_exporter:

domain_exporter --config domains.yaml

Install

homebrew:

brew install caarlos0/tap/domain_exporter

docker:

docker run --rm -p 9222:9222 caarlos0/domain_exporter

apt:

echo 'deb [trusted=yes] https://repo.caarlos0.dev/apt/ /' | sudo tee /etc/apt/sources.list.d/caarlos0.list
sudo apt update
sudo apt install domain_exporter

yum:

echo '[caarlos0]
name=caarlos0
baseurl=https://repo.caarlos0.dev/yum/
enabled=1
gpgcheck=0' | sudo tee /etc/yum.repos.d/caarlos0.repo
sudo yum install domain_exporter

deb/rpm/apk:

Download the .apk, .deb or .rpm from the releases page and install with the appropriate commands.

manually:

Download the pre-compiled binaries from the releases page or clone the repo build from source.

Stargazers over time