Grafana SSL Monitoring Dashboard — REST API for Domain Health Data

Why Engineers Put Domain Data in Grafana

If your team already runs Grafana for infrastructure monitoring, SSL and domain expiry data belongs there too. A cert expiry is as operationally important as disk space or memory pressure — and your on-call engineers should be able to see it in the same place they watch everything else.

DomainCat's REST API returns SSL and domain health as clean JSON, making it straightforward to pull into Grafana using the JSON API data source plugin. You can build stat panels showing days remaining for each cert, table panels listing all domains with their expiry dates, or alert rules that page your on-call when a cert drops below 14 days.

You're not locked into DomainCat's alerting either — once your data is in Grafana, you can use any Grafana alerting destination: PagerDuty, OpsGenie, Slack, email, or your own webhook handler.

The API Endpoints

The DomainCat API is authenticated with a bearer token. Retrieve your API key from the Settings page after signing up.

GET https://domaincat.app/api/domains

GET https://domaincat.app/api/status

Example: GET /api/domains

[
  {
    "id": 42,
    "hostname": "example.com",
    "label": "Main site",
    "group_name": "Clients",
    "issuer": "Let's Encrypt",
    "days_remaining": 24,
    "valid_to": "2026-05-12T00:00:00.000Z",
    "registrar": "Namecheap",
    "domain_expiry": "2027-03-01T00:00:00.000Z",
    "country": "US",
    "last_checked_at": "2026-04-18T10:00:00.000Z"
  }
]

Example: GET /api/status

{
  "total": 47,
  "expiring_soon": 3,
  "ssl_expired": 0,
  "domain_expiring_soon": 2,
  "domain_expired": 0,
  "unchecked": 1
}

Available Fields per Domain

Every domain returned by the API includes the following fields, all of which can be used as Grafana panel data sources or alert conditions:

hostnameThe monitored domain name

labelOptional human-readable label

group_nameClient or project group name

issuerSSL certificate issuer / CA name

days_remainingInteger days until SSL cert expires

valid_toSSL cert expiry in ISO 8601 format

registrarDomain registrar name from WHOIS

domain_expiryDomain registration expiry date

countryHosting country from SSL cert

last_checked_atTimestamp of most recent check

tagsArray of user-defined tag objects

owner_emailPer-domain alert contact email

Connecting DomainCat to Grafana

Use the Grafana JSON API data source plugin to query DomainCat directly. Here's the setup in four steps:

1

Install the JSON API plugin

In your Grafana instance, go to Administration → Plugins and install the JSON API data source (by Marcus Olsson). This plugin can query any REST endpoint that returns JSON.

2

Add DomainCat as a data source

Set the URL to https://domaincat.app/api. Under Headers, add Authorization: Bearer YOUR_API_KEY. You can copy your API key from the DomainCat Settings page.

3

Build panels using the /domains endpoint

Create a table panel querying /domains. Map hostname, days_remaining, valid_to, and domain_expiry as columns. Use days_remaining for color thresholds: green above 30, yellow 8–30, red below 7.

4

Import the free dashboard template

DomainCat provides a pre-built Grafana dashboard JSON that you can import directly. Log into DomainCat and download the template from the Settings → API section to get started immediately.

What You Can Build in Grafana

📊

Expiry Countdown Panels

Stat panels showing days remaining for each cert. Threshold coloring turns yellow at 30 days, red at 7.

📋

Full Domain Table

A sortable table of all domains with hostname, issuer, SSL expiry, domain expiry, and last check time.

🔔

Grafana Alert Rules

Trigger Grafana alerts when days_remaining drops below a threshold — route to PagerDuty, OpsGenie, or Slack.

🏢

Per-Client Dashboards

Filter by group_name to build per-client views. Show only one client's domain health in a dedicated row or panel.

Related Monitoring Tools

Explore other DomainCat monitoring capabilities:

SSL & Domain Data in Grafana