Skip to content

Prometheus Blackbox Exporter#

The Blackbox Exporter allows probing of endpoints over HTTP, HTTPS, DNS, TCP, and ICMP. It is used to monitor the external and internal availability of services.

Overview#

Configuration#

Modules#

The exporter is configured with a custom module http_2xx for HTTP checking:

  • Prober: http
  • Timeout: 5 seconds
  • Features: Follows redirects, prefers IPv4, and skips TLS verification (useful for internal self-signed certs or avoiding expiry noise).

Service Monitor & Targets#

The deployment includes a ServiceMonitor that automatically scrapes the following targets using the http_2xx module.

External Targets (Public Endpoints):

  • Docs: https://docs.igresc.com/
  • Personal Site: https://sergicastro.com/healthcheck
  • Authentik: https://auth.igresc.com/-/health/ready/
  • Immich: https://photos.igresc.com/
  • Jellyfin: https://jellyfin.igresc.com/
  • Mealie: https://mealie.igresc.com/
  • Navidrome: https://music.igresc.com/

Internal Targets (Cluster Internal):

  • Authentik Service: https://authentik-server.auth.svc.cluster.local/-/health/ready/

GitOps Strategy#

  • Base: apps/base/prometheus-blackbox defines the HelmRepository and the base HelmRelease.
  • Production: apps/production/prometheus-blackbox/blackbox-exporter-release.yaml patches the configuration to add the specific probe targets and module definitions.