These docs are for Cribl Api 4.17 and are no longer actively maintained.

See the latest version (4.18).

Each Cribl Stream, Cribl Edge, and Cribl Outpost instance exposes a GET /health endpoint that provides information about the status of the server. This endpoint is commonly used with a load balancer to support operational decision-making.

About the Example Request ​

Replace the variables in the example request with the corresponding information for your Cribl deployment.

For on-prem deployments, to use https in the URL for your request as shown in this example, you must configure Transport Layer Security (TLS).

Health checks on Outpost Nodes must use http instead of https.

Retrieve Server Status Information ​

The following examples demonstrate requests to the GET /health endpoint in Cribl.Cloud/hybrid and on-prem deployments.

Requests to GET /health in the global context do not require authentication. Requests to GET /health for a Worker or Edge Node (host context) are sent to the Leader, which proxies the call to the Node. These requests for a Node do require authentication with a Bearer token to authorize the proxy.

Replace the variables in the URL with the correct values for your deployment.

curl --request GET \
--url "https://${workspaceName}-${organizationId}.cribl.cloud/api/v1/health" \
--header "accept: application/json"

curl --request GET \
--url "https://${hostname}:${port}/api/v1/health" \
--header "accept: application/json"

curl --request GET \
--url "https://${workspaceName}-${organizationId}.cribl.cloud/api/v1/w/${nodeId}/health" \
--header "Authorization: Bearer ${token}" \
--header "accept: application/json"

curl --request GET \
--url "https://${hostname}:${port}/api/v1/w/${nodeId}/health" \
--header "Authorization: Bearer ${token}" \
--header "accept: application/json"

The response is a JSON object similar to the following example:

{"status": "healthy","startTime": 1741961168122}

Interpret HTTP Status Codes ​

In the response header, the /health endpoint returns one of the following HTTP status codes:

The HTTP status code 200 OK is a healthy response but indicates only that the server is running. It does not mean that all of the instance’s configured Sources are functioning correctly.

Several HTTP-based Sources allow you to enable a Source-level health check endpoint in their Advanced Settings. See the documentation for each Source for more information.