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 probe:

- 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 argument 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.

helm:

Usage

Helm must be installed to use the charts. Please refer to Helm’s documentation to get started.

Once Helm has been set up correctly, add the repo as follows:

helm repo add orihomie https://orihomie.github.io/helm-charts

If you had already added this repo earlier, run helm repo update to retrieve the latest versions of the packages. You can then run helm search repo orihomie to see the charts.

To install the chart:

helm install domain-exporter orihomie/domain-exporter

To uninstall the chart:

helm delete domain-exporter

manually:

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

Stargazers over time

This site is open source. Improve this page.