Health

Download InfluxDB API Spec
Check the health and readiness of an InfluxDB OSS v2 instance.
GET /health

Retrieve the health of the instance

Returns the health of the instance.

Parameters

Header parameters
Zap-Trace-Span string
OpenTracing span context
Example request Ask AI about this
curl --request GET \
  "http://localhost:8086/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"

Responses

200 The instance is healthy. The response body contains the health check items and status.
checks object[]
commit string
message string
name required string
status required string
Allowed: pass , fail
version string
503 The instance is unhealthy.
checks object[]
commit string
message string
name required string
status required string
Allowed: pass , fail
version string
default Non 2XX error response from server.
code required string
code is the machine-readable error code.
Allowed: internal error , not implemented , not found , conflict , invalid , unprocessable entity , empty value , unavailable , forbidden , too many requests , unauthorized , method not allowed , request too large , unsupported media type
err string
Stack of errors that occurred during processing of the request. Useful for debugging.
message string
Human-readable message.
op string
Describes the logical code operation when the error occurred. Useful for debugging.

Was this page helpful?

Thank you for your feedback!