Apache
/
druid
mirror of https://github.com/apache/druid.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
druid/docs/api-reference/supervisor-api.md

4.2 KiB
Raw Blame History

id title sidebar_label
supervisor-api Supervisor API Supervisors

This document describes the API endpoints to manage and monitor supervisors for Apache Druid.

Supervisors

GET /druid/indexer/v1/supervisor

Returns a list of strings of the currently active supervisor ids.

GET /druid/indexer/v1/supervisor?full

Returns a list of objects of the currently active supervisors.

Field Type Description
id String supervisor unique identifier
state String basic state of the supervisor. Available states:UNHEALTHY_SUPERVISOR, UNHEALTHY_TASKS, PENDING, RUNNING, SUSPENDED, STOPPING. Check Kafka Docs for details.
detailedState String supervisor specific state. See documentation of specific supervisor for details: Kafka or Kinesis
healthy Boolean true or false indicator of overall supervisor health
spec SupervisorSpec JSON specification of supervisor

GET /druid/indexer/v1/supervisor?state=true

Returns a list of objects of the currently active supervisors and their current state.

Field Type Description
id String supervisor unique identifier
state String basic state of the supervisor. Available states: UNHEALTHY_SUPERVISOR, UNHEALTHY_TASKS, PENDING, RUNNING, SUSPENDED, STOPPING. Check Kafka Docs for details.
detailedState String supervisor specific state. See documentation of the specific supervisor for details: Kafka or Kinesis
healthy Boolean true or false indicator of overall supervisor health
suspended Boolean true or false indicator of whether the supervisor is in suspended state

GET /druid/indexer/v1/supervisor/<supervisorId>

Returns the current spec for the supervisor with the provided ID.

GET /druid/indexer/v1/supervisor/<supervisorId>/status

Returns the current status of the supervisor with the provided ID.

GET/druid/indexer/v1/supervisor/history

Returns an audit history of specs for all supervisors (current and past).

GET /druid/indexer/v1/supervisor/<supervisorId>/history

Returns an audit history of specs for the supervisor with the provided ID.

POST /druid/indexer/v1/supervisor

Create a new supervisor or update an existing one.

POST /druid/indexer/v1/supervisor/<supervisorId>/suspend

Suspend the current running supervisor of the provided ID. Responds with updated SupervisorSpec.

POST /druid/indexer/v1/supervisor/suspendAll

Suspend all supervisors at once.

POST /druid/indexer/v1/supervisor/<supervisorId>/resume

Resume indexing tasks for a supervisor. Responds with updated SupervisorSpec.

POST /druid/indexer/v1/supervisor/resumeAll

Resume all supervisors at once.

POST /druid/indexer/v1/supervisor/<supervisorId>/reset

Reset the specified supervisor.

POST /druid/indexer/v1/supervisor/<supervisorId>/terminate

Terminate a supervisor of the provided ID.

POST /druid/indexer/v1/supervisor/terminateAll

Terminate all supervisors at once.

POST /druid/indexer/v1/supervisor/<supervisorId>/shutdown

This API is deprecated and will be removed in future releases. Please use the equivalent terminate instead.

Shutdown a supervisor.