Setup Monitoring on SSL Expiry / Uptime with Prometheus Blackbox – Grafana


Blackbox Exporter is a component of the Prometheus monitoring system that allows you to perform active monitoring of network endpoints. It is designed to probe targets and collect metrics related to their availability, responsiveness, and other network-level characteristics.

The Blackbox Exporter operates by sending various types of probes to the specified targets and observing the responses. These probes can include HTTP, HTTPS, TCP, ICMP, DNS, and other protocols, depending on your configuration.

In this post, We will show you how to configure monitoring and alerting on SSL expiry / uptime using Prometheus, Blackbox, alert manager and Grafana on ubuntu 22.04 LTS.

Step 1: Installing Prometheus

Update the package list on your system by running the following command:

sudo apt-get update

Prometheus GPG key and repository already available with ubuntu 22.04 LTS, We can install the Prometheus by using apt-get command.

sudo apt-get install prometheus -y

To get prometheus service.

sudo systemctl status prometheus.service

Prometheus by default started work on port 9090, We can access the Prometheus using http://localhost:9090 or http://IP-ADDRESS:9090, Now we are good to install the blackbox packages.

Step 2: Installing Prometheus Blackbox

To install the prometheus-blackbox-exporter packages by using given command.

sudo apt-get install prometheus-blackbox-exporter
sudo systemctl status prometheus-blackbox-exporter

Configure Prometheus blackbox with given module, use the given command for the same.

sudo tee /etc/prometheus/blackbox.yml<<EOF
    prober: http
     preferred_ip_protocol: ip4
    prober: http
      method: POST
    prober: tcp
    prober: tcp
      - expect: "^+OK"
      tls: true
        insecure_skip_verify: false
    prober: tcp
      - expect: "^SSH-2.0-"
      - send: "SSH-2.0-blackbox-ssh-check"
    prober: tcp
      - send: "NICK prober"
      - send: "USER prober prober prober :prober"
      - expect: "PING :([^ ]+)"
        send: "PONG ${1}"
      - expect: "^:[^ ]+ 001"

To get new configuration changes we need to restart the Prometheus Blackbox service.

sudo systemctl restart prometheus-blackbox-exporter 

We need to make sure prometheus-blackbox-exporter should in up and running condition for the same execute the given command.

sudo systemctl status prometheus-blackbox-exporter 

Step 3: Configure Prometheus

If we have the Prometheus blackbox service up and running, then we are good to add the blackbox configuration with the prometheus.yml configuration file, and here we have the basic configuration of monitoring uptime and an SSL certificate. You should replace the domains as per your needs.

Execute the given command that will append the blackbox configuration with prometheus.yml

sudo nano /etc/prometheus/prometheus.yml

Paste the following configuration and do not forget the replace the domain in order to monitored.

  - job_name: 'blackbox'
    metrics_path: /probe
      module: [http_2xx] # Look for a HTTP 200 response.
    - targets:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__

Save and edit from the nano editor, We are good to restart the prometheus.yml service to connect with blackbox.

sudo systemctl restart prometheus.service

After this, we also need to check the Prometheus service because if we have a misconfiguration, the Prometheus service will fail. Make sure while making changes to the Prometheus configuration, Use the given command to see the Prometheus status.

sudo systemctl status prometheus.service

Step 4: Installing Grafana 10

To save time to install and setup Grafana 10 on a Ubuntu machine, We need to use the bash script to automate a few command sequences, To create bash script, We need to execute the given command.

To create bash script.

sudo nano

Paste the following command.


sudo apt-get update
sudo apt-get install -y adduser libfontconfig1
sudo dpkg -i grafana_10.0.1_amd64.deb
sudo systemctl start grafana-server.service
sudo systemctl enable grafana-server.service

To execute the script.

sudo sh

By default, Grafana is configured with port 3000. If we have a firewall enabled, in that case, we need to open port 3000 and the TCP protocol. Access the Grafana portal by using http://localhost:3000 or http://ip-address:3000, and then update the admin user password.

Accessing Grafana Portal with http://localhost:3000

Default Creds for Grafana newly install server.

password admin

Update admin password.

Grafana dashboard page.

Adding data source for Prometheus.

Go to home > connection > data sources

Click on Add data source button.

Click on Prometheus.

Add the Prometheus server URL and leave another setting as default.

Click on Save & test button, We should get successfully quired the Prometheus API.

Step 5: Importing Grafana Blackbox Dashboard

Once we get the Grafana dashboard we need to add the Prometheus database to get metrics from the agents like Prometheus-Blackbox, To do that we need to follow the given steps.

Click on import dashboard from right side + button as showing in the screenshot.

We should get import dashboard like this one, Where can use import via or upload JSON file.

We should put the 7587 Grafana dashboard ID in order to import the Blackbox dashboard.

Click on Load button.

Select the Prometheus data sources for this dashboard and click on import button.

Here we will get the Prometheus Blackbox monitoring dashboard up and running, which covers website uptime, SSL certificate expiry, and DNS based monitoring.

Step 4: Setting Up Alerting

We are going to use the Prometheus alerting package in order to use create alert rule for SSL expiry and website uptime, however we can also use the use Grafana alert for the same.

To install Prometheus alertmanager.

sudo apt-get install prometheus-alertmanager -y

To validate Alertmanager service.

sudo systemctl status prometheus-alertmanager

To create black-box alerting rule.

sudo nano /etc/prometheus/blackbox-rules.yml

Paste the following alert configuration and you can update as per your needs.

  - name: Blackbox rules
      - alert: SSLCertExpiringSoon
        expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30
        for: 1m
          severity: warning
          description: "TLS certificate will expire in {{ $value | humanizeDuration }} (instance {{ $labels.instance }})"

      - alert: EndpointDown
        expr: probe_success == 0
        for: 5m
          severity: "critical"
          summary: "Endpoint {{ $labels.instance }} down"

Integrate the Blackbox alert rule yml file with Prometheus under rule_file: section also check and update the alearting: section with valid alert manager URL.

sudo nano /etc/prometheus/prometheus.yml

Save and exit from the nano editor and restart the Prometheus service ti get these new changes.

sudo systemctl restart prometheus

Check Prometheus service.

sudo systemctl status prometheus

We should get Prometheus service up and running condition.

Go to the Prometheus web UI with http://localhost:9090 or http://ip-address:9090 and click on Status > Rules to see the alert rule and state for SSL expiry and uptime status.

Validate with Grafana UI, We need to go Home > Alerting > Alerting rule section from Grafana portal.

Note: Depends on the notification channel like SMTP, Slack, MS Teams, Opsgenie and other You should get an alert as per your rules.


We have successfully install and configure the Prometheus Blackbox with Grafana on ubuntu 22.04 LTS, Still you are having any issue, Please leave a comment below.


Setup Monitoring on SSL Expiry / Uptime with Prometheus Blackbox – Grafana

54 thoughts on “Setup Monitoring on SSL Expiry / Uptime with Prometheus Blackbox – Grafana

Leave a Reply

Your email address will not be published. Required fields are marked *

Scroll to top