Monitoring service

Ping

The Ping integration monitors service availability by periodically pinging a URL and reporting the response time and HTTP status back to Dreambase. It is the integration behind the Monitoring service's around-the-clock health checks.

Ping is the integration of the Monitoring service. It handles its own webhook route:

POST/ping/webhook
Run a health check & report the result

What it does

On a schedule, the Dreambase API sends a HEALTH_CHECK eventfor each deployment. The integration responds immediately and performs the check in the background: it resolves any environment reference in the target URL by calling back into the API with its scoped token, pings the resolved URL honoring the timeout, and records the status, HTTP status code, and response time — then reports the result back to Dreambase, which updates the deployment's health.

Two deployments, one integration

Ping ships both as part of the Monitoring service and bundled into the App Hosting service, so health checks can be served from either deployment. Both speak the same contract and report to the same place.

Inputs

InputRequiredDescription
urlyesThe URL to ping for health monitoring (e.g. https://example.com/health). May be an environment-variable reference.
timeoutSecondsoptionalHow many seconds to wait before treating the ping as a timeout (default 10).

Events it handles

  • WEBHOOK_CHALLENGE — echo the challenge to verify the endpoint.
  • HEALTH_CHECK — ping a deployment's URL and report its status, status code, and response time.

Health you can see at a glance

Results from Ping feed the health indicators on every deployment in the app, so the same signal that drives alerting also drives the dashboards you watch.