Skip to content
Back to solution packs catalog
Signed artifact v0.1.0 Synthetic HTTP Security & Posture Apache-2.0

HTTP API & TLS Certificate Posture

io.serviceradar.http-api-and-tls-posture

Monitors multi-step synthetic HTTP API health, JSON payload assertions, httptrace latency thresholds, and TLS leaf certificate expiry posture.

What's inside: 2 checks · 2 alert rules · 1 dashboard

Overview

HTTP API and TLS Certificate Posture

First-party ServiceRadar Solution Pack (io.serviceradar.http-api-and-tls-posture) providing multi-step synthetic HTTP API journey monitoring with httptrace latency thresholds and TLS leaf certificate expiry checks.

Included Resources

Declarative Checks (2)

  • http-api-journey-health -- Edge http_journey check verifying /healthz and /readyz endpoints with JSON assertions, optional api_auth credential slot binding, and httptrace latency thresholds.
  • tls-certificate-expiry-posture -- Edge tls_handshake check inspecting leaf_days_remaining against configurable warning and critical day thresholds.

Stateful Alert Rules (2)

  • http_api_journey_down (enabled) -- Opens a critical alert when the synthetic HTTP API journey transitions to down.
  • tls_certificate_expiry_warning (paused) -- Opt-in alert rule triggered when TLS leaf certificate validity enters the warning window.

Authored Dashboards (1)

  • http-api-and-tls-overview -- Unified SRQL overview dashboard tracking monitored synthetic endpoints, failing HTTP/TLS checks, and open posture alerts.

Declarative Checks

Service & posture check DAGs (2)

HTTP API Journey Health

http-api-journey-health

target: service_targets Every 60s 4 nodes · 3 edges

Executes a multi-step synthetic HTTP API health journey with JSON payload assertions and httptrace latency thresholds.

signal value verdict HTTP_JOURNEY Synthetic API Journey api_auth EXTRACT_FIELD Extract httptrace Latency httptrace.total_ms THRESHOLD_ASSERT Latency Thresholds total_ms ALERT_OUTPUT API Journey Verdict verdict -> service_state
Check credential slots: api_auth (generic_http)
Canonical check JSON (checks/http-journey-health.json)
{
  "alert_policy": {
    "cooldown_seconds": 300,
    "emit_ocsf_transition": true,
    "open_on_statuses": [
      "down"
    ],
    "priority": 2,
    "renotify_seconds": 21600,
    "threshold": 1,
    "window_seconds": 300
  },
  "credential_slots": [
    {
      "description": "Optional bearer token or API credential for authenticated synthetic API probes.",
      "provider": "generic_http",
      "purpose": "Synthetic HTTP API health journey",
      "required": false,
      "role": "bearer_token",
      "slot": "api_auth"
    }
  ],
  "description": "Executes a multi-step synthetic HTTP API health journey with JSON payload assertions and httptrace latency thresholds.",
  "edges": [
    {
      "id": "e1",
      "source": "journey_1",
      "source_handle": "signal",
      "target": "extract_latency",
      "target_handle": "in"
    },
    {
      "id": "e2",
      "source": "extract_latency",
      "source_handle": "value",
      "target": "assert_latency",
      "target_handle": "in"
    },
    {
      "id": "e3",
      "source": "assert_latency",
      "source_handle": "verdict",
      "target": "out_1",
      "target_handle": "in"
    }
  ],
  "inputs": [
    {
      "default": {
        "$pack_param": "warn_ms"
      },
      "description": "Warning total HTTP journey latency in milliseconds",
      "key": "warn_ms",
      "max": 30000,
      "min": 50,
      "type": "integer"
    },
    {
      "default": {
        "$pack_param": "crit_ms"
      },
      "description": "Critical total HTTP journey latency in milliseconds",
      "key": "crit_ms",
      "max": 60000,
      "min": 100,
      "type": "integer"
    }
  ],
  "managed": true,
  "name": "HTTP API Journey Health",
  "nodes": [
    {
      "config": {
        "credential_slot": "api_auth",
        "steps": [
          {
            "assertions": [
              {
                "field": "status",
                "op": "==",
                "value": "ok"
              }
            ],
            "expected_statuses": [
              200
            ],
            "extract": [
              {
                "expression": "$.status",
                "key": "api_status",
                "source": "jsonpath"
              }
            ],
            "id": "healthz",
            "method": "GET",
            "name": "API Health Endpoint",
            "url": {
              "$pack_param": "api_target_url"
            }
          },
          {
            "assertions": [
              {
                "field": "ready",
                "op": "==",
                "value": true
              }
            ],
            "expected_statuses": [
              200
            ],
            "id": "readyz",
            "method": "GET",
            "name": "API Readiness Endpoint",
            "url": "https://api.example.com/readyz"
          }
        ],
        "timeout_ms": 10000
      },
      "id": "journey_1",
      "kind": "http_journey",
      "label": "Synthetic API Journey"
    },
    {
      "config": {
        "cast": "number",
        "field": "httptrace.total_ms",
        "output_key": "total_ms",
        "source_type": "field"
      },
      "id": "extract_latency",
      "kind": "extract_field",
      "label": "Extract httptrace Latency"
    },
    {
      "config": {
        "crit": {
          "op": ">=",
          "value": "{{inputs.crit_ms}}"
        },
        "field": "total_ms",
        "warn": {
          "op": ">=",
          "value": "{{inputs.warn_ms}}"
        }
      },
      "id": "assert_latency",
      "kind": "threshold_assert",
      "label": "Latency Thresholds"
    },
    {
      "config": {
        "verdict_map": {
          "degraded": "api_journey_slow",
          "down": "api_journey_failed",
          "healthy": "api_journey_healthy",
          "unknown": "api_journey_unknown"
        }
      },
      "id": "out_1",
      "kind": "alert_output",
      "label": "API Journey Verdict"
    }
  ],
  "pack_id": "io.serviceradar.http-api-and-tls-posture",
  "pack_version": "0.1.0",
  "parameter_overrides": {},
  "schedule": {
    "interval_seconds": 60,
    "jitter_seconds": 10,
    "timeout_seconds": 30
  },
  "schema_version": 1,
  "slug": "http-api-journey-health",
  "state": "enabled",
  "target_binding": {
    "mode": "service_targets",
    "target_ids": [
      "https://api.example.com/healthz"
    ],
    "url": "https://api.example.com/healthz"
  },
  "ui_layout": {
    "nodes": {
      "assert_latency": {
        "x": 640,
        "y": 120
      },
      "extract_latency": {
        "x": 360,
        "y": 120
      },
      "journey_1": {
        "x": 80,
        "y": 120
      },
      "out_1": {
        "x": 920,
        "y": 120
      }
    }
  }
}

TLS Certificate Expiry Posture

tls-certificate-expiry-posture

target: service_targets Every 300s 3 nodes · 2 edges

Inspects TLS leaf certificate remaining validity days against warning and critical expiry thresholds.

signal verdict TLS_HANDSHAKE TLS Handshake Probe THRESHOLD_ASSERT Leaf Expiry Thresholds leaf_days_remaining ALERT_OUTPUT TLS Posture Verdict verdict -> service_state
Canonical check JSON (checks/tls-certificate-expiry-posture.json)
{
  "alert_policy": {
    "cooldown_seconds": 600,
    "emit_ocsf_transition": true,
    "open_on_statuses": [
      "down"
    ],
    "priority": 2,
    "renotify_seconds": 43200,
    "threshold": 1,
    "window_seconds": 300
  },
  "credential_slots": [],
  "description": "Inspects TLS leaf certificate remaining validity days against warning and critical expiry thresholds.",
  "edges": [
    {
      "id": "e1",
      "source": "tls_1",
      "source_handle": "signal",
      "target": "assert_expiry",
      "target_handle": "in"
    },
    {
      "id": "e2",
      "source": "assert_expiry",
      "source_handle": "verdict",
      "target": "out_1",
      "target_handle": "in"
    }
  ],
  "inputs": [
    {
      "default": {
        "$pack_param": "tls_warn_days"
      },
      "description": "Warning threshold for remaining TLS leaf certificate days",
      "key": "tls_warn_days",
      "max": 365,
      "min": 1,
      "type": "integer"
    },
    {
      "default": {
        "$pack_param": "tls_crit_days"
      },
      "description": "Critical threshold for remaining TLS leaf certificate days",
      "key": "tls_crit_days",
      "max": 365,
      "min": 1,
      "type": "integer"
    }
  ],
  "managed": true,
  "name": "TLS Certificate Expiry Posture",
  "nodes": [
    {
      "config": {
        "host": {
          "$pack_param": "tls_target_host"
        },
        "min_days_remaining": {
          "$pack_param": "tls_crit_days"
        },
        "port": 443,
        "sni": {
          "$pack_param": "tls_target_host"
        },
        "timeout_ms": 5000
      },
      "id": "tls_1",
      "kind": "tls_handshake",
      "label": "TLS Handshake Probe"
    },
    {
      "config": {
        "crit": {
          "op": "<=",
          "value": "{{inputs.tls_crit_days}}"
        },
        "field": "leaf_days_remaining",
        "warn": {
          "op": "<=",
          "value": "{{inputs.tls_warn_days}}"
        }
      },
      "id": "assert_expiry",
      "kind": "threshold_assert",
      "label": "Leaf Expiry Thresholds"
    },
    {
      "config": {
        "verdict_map": {
          "degraded": "tls_certificate_expiring_soon",
          "down": "tls_certificate_expiry_critical",
          "healthy": "tls_certificate_valid",
          "unknown": "tls_handshake_inconclusive"
        }
      },
      "id": "out_1",
      "kind": "alert_output",
      "label": "TLS Posture Verdict"
    }
  ],
  "pack_id": "io.serviceradar.http-api-and-tls-posture",
  "pack_version": "0.1.0",
  "parameter_overrides": {},
  "schedule": {
    "interval_seconds": 300,
    "jitter_seconds": 15,
    "timeout_seconds": 30
  },
  "schema_version": 1,
  "slug": "tls-certificate-expiry-posture",
  "state": "enabled",
  "target_binding": {
    "host": "api.example.com",
    "mode": "service_targets",
    "port": 443,
    "target_ids": [
      "api.example.com:443"
    ]
  },
  "ui_layout": {
    "nodes": {
      "assert_expiry": {
        "x": 380,
        "y": 120
      },
      "out_1": {
        "x": 680,
        "y": 120
      },
      "tls_1": {
        "x": 80,
        "y": 120
      }
    }
  }
}

Observability Rules

Alert & event rules (2)

Http Api Journey Down

http_api_journey_down

stateful_alert_rule install: enabled severity: 20

Opens a critical alert when the synthetic HTTP API health journey transitions to down.

threshold: 1 window: 300s cooldown: 300s
Canonical rule JSON (rules/http-journey-down-alert.json)
{
  "alert": {
    "severity": "critical",
    "summary": "Synthetic HTTP API journey failed or exceeded critical latency threshold"
  },
  "bucket_seconds": 60,
  "cooldown_seconds": 300,
  "description": "Opens a critical alert when the synthetic HTTP API health journey transitions to down.",
  "event": {
    "log_name": "health.http_api_journey_down"
  },
  "group_by": [
    "check_slug"
  ],
  "install_state": "enabled",
  "kind": "stateful_alert_rule",
  "match": {
    "check_slug": "http-api-journey-health",
    "status": "down"
  },
  "name": "http_api_journey_down",
  "priority": 20,
  "renotify_seconds": 21600,
  "signal": "event",
  "threshold": 1,
  "window_seconds": 300
}

Tls Certificate Expiry Warning

tls_certificate_expiry_warning

stateful_alert_rule install: paused severity: 30

Opt-in warning alert when a monitored TLS leaf certificate enters the configured expiry warning window.

threshold: 1 window: 300s cooldown: 600s
Canonical rule JSON (rules/tls-certificate-expiry-alert.json)
{
  "alert": {
    "severity": "warning",
    "summary": "TLS leaf certificate is approaching expiry threshold"
  },
  "bucket_seconds": 60,
  "cooldown_seconds": 600,
  "description": "Opt-in warning alert when a monitored TLS leaf certificate enters the configured expiry warning window.",
  "event": {
    "log_name": "health.tls_certificate_expiry_warning"
  },
  "group_by": [
    "check_slug"
  ],
  "install_state": "paused",
  "kind": "stateful_alert_rule",
  "match": {
    "check_slug": "tls-certificate-expiry-posture",
    "status": "degraded"
  },
  "name": "tls_certificate_expiry_warning",
  "priority": 30,
  "renotify_seconds": 43200,
  "signal": "event",
  "threshold": 1,
  "window_seconds": 300
}

Authored Dashboards

Portable dashboards (1)

Synthetic HTTP & TLS Posture

http-api-and-tls-overview

4 panels

Overview of synthetic HTTP API journey health, httptrace latency posture, TLS leaf certificate expiry status, and active HTTP/TLS alerts.

Monitored HTTP & TLS Checks Failing HTTP & TLS Probes Open HTTP & TLS Alerts Synthetic HTTP & TLS Availability Breakdown
Canonical dashboard JSON (dashboards/http-tls-overview.json)
{
  "default_time_range": "last_24h",
  "description": "Overview of synthetic HTTP API journey health, httptrace latency posture, TLS leaf certificate expiry status, and active HTTP/TLS alerts.",
  "metadata": {
    "category": "Synthetic HTTP"
  },
  "panels": [
    {
      "data_binding": {
        "value": "total"
      },
      "display_config": {
        "unit": "checks"
      },
      "layout": {
        "h": 3,
        "w": 4,
        "x": 0,
        "y": 0
      },
      "position": 0,
      "srql_query": "in:services stats:\"count() as total\"",
      "title": "Monitored HTTP & TLS Checks",
      "visual_config": {},
      "visual_type": "stat"
    },
    {
      "data_binding": {
        "value": "failing"
      },
      "display_config": {
        "unit": "checks"
      },
      "layout": {
        "h": 3,
        "w": 4,
        "x": 4,
        "y": 0
      },
      "position": 1,
      "srql_query": "in:services available:false stats:\"count() as failing\"",
      "title": "Failing HTTP & TLS Probes",
      "visual_config": {},
      "visual_type": "stat"
    },
    {
      "data_binding": {
        "value": "open_alerts"
      },
      "display_config": {
        "unit": "alerts"
      },
      "layout": {
        "h": 3,
        "w": 4,
        "x": 8,
        "y": 0
      },
      "position": 2,
      "srql_query": "in:alerts status:open stats:\"count() as open_alerts\"",
      "title": "Open HTTP & TLS Alerts",
      "visual_config": {},
      "visual_type": "stat"
    },
    {
      "data_binding": {
        "category": "available",
        "value": "total"
      },
      "display_config": {},
      "layout": {
        "h": 5,
        "w": 12,
        "x": 0,
        "y": 3
      },
      "position": 3,
      "srql_query": "in:services stats:\"count() as total by available\"",
      "title": "Synthetic HTTP & TLS Availability Breakdown",
      "visual_config": {},
      "visual_type": "category"
    }
  ],
  "slug": "http-api-and-tls-overview",
  "title": "Synthetic HTTP & TLS Posture",
  "variables": {},
  "version": 1
}

Parameters & Bindings

Config inputs & credential slots

Configuration parameters (6)

Key Type Default Bounds Description
warn_ms integer 400 min: 50, max: 30000 Warning total HTTP journey latency threshold in milliseconds.
crit_ms integer 1500 min: 100, max: 60000 Critical total HTTP journey latency threshold in milliseconds.
tls_warn_days integer 30 min: 1, max: 365 Warning threshold for remaining TLS leaf certificate validity in days.
tls_crit_days integer 14 min: 1, max: 365 Critical threshold for remaining TLS leaf certificate validity in days.
api_target_url string "https://api.example.com/healthz" — Target URL for the primary synthetic HTTP API health step.
tls_target_host string "api.example.com" — Target hostname for TLS handshake certificate expiry inspection.

Abstract credential slots (1)

100% secret-free archive

Solution Packs never embed secret material or environment UUIDs. Declared slots bind locally to CNPG unified credentials (network_credential_secrets or network_credential_rules) during installation.

Slot Provider Role Required Purpose
api_auth generic_http bearer_token Optional Synthetic HTTP API health journey

ServiceRadar Developer Portal

Docs, SDKs, solution packs, plugins, and native add-ons for building on ServiceRadar.

© 2026 Carver Automation Corporation. All rights reserved.

ServiceRadar® is a registered trademark of Carver Automation Corporation.