Observability on INFINI Pizza

Cluster health

Mon, 01 Jan 0001 00:00:00 +0000

Cluster health #

Returns the cluster health for quick overview.

Get the whole cluster health #

Requests #

GET /_cluster/health

The call is bounded by a 10s timeout; when the cluster cannot answer in time it returns HTTP 503 with "status": "timeout", "timeout": true and points at /_node/_local/recovery for details — treat that as “degraded, still converging” when polling for readiness.

Query Parameters #

level
(Optional, string) Can be one of cluster, regions, collections rollings or shards. Controls the details level of the health information returned. Defaults to cluster.

Get the health of a specific region #

Requests #

GET /_cluster/_region/<region_id>/health

Path parameters #

region_id
(Required, String) The region to query. Currently only the special ID _local — the region that handles this request — is implemented; a remote region UUID answers 501 not implemented yet.

Query Parameters #

level
(Optional, string) Can be one of regions, collections rollings or shards. Controls the details level of the health information returned. Defaults to regions.

Cluster state

Mon, 01 Jan 0001 00:00:00 +0000

Cluster state #

Returns an internal representation of the cluster state for debugging or diagnostic purposes.

Note: despite its name, GET /_cluster/state currently returns the local region’s state — one region entry, not a cluster-wide aggregation. Remote regions cannot be queried yet.

Get the whole cluster state #

Requests #

GET /_cluster/state/<names>

Path Parameters #

names
(Optional, string) A comma-separated list of the following options:
- _all
  Shows all names.
- blocks
  Accepted for Elasticsearch compatibility but not implemented yet — filtering on it returns nothing.
- leader_node
  Shows the leader_node part of the response.
- metadata
  Shows the metadata part of the response.
- nodes
  Shows the nodes part of the response.
- routing_nodes
  Shows the routing_nodes part of the response.
- routing_table
  Shows the routing_table part of the response.
- version
  Accepted for Elasticsearch compatibility but not implemented yet — filtering on it returns nothing.

Get the state of a specific region #

Requests #

GET /_cluster/_region/<region_id>/state/<names>

Path parameters #

region_id
(Required, String) The region to query. Currently only the special ID _local — the region that handles this request — is implemented; a remote region UUID answers 501 not implemented yet.

Node observability APIs

Mon, 01 Jan 0001 00:00:00 +0000

Node observability APIs #

The /_node/_local/* surface exposes this node’s runtime state — recovery progress, build backlog, shard inventory, storage layout, slowlogs, logs and the trash. All of it is read-only except where noted, and every endpoint can be reached on a remote node through the unified forward: replace _local with the node id (/_node/<node_id>/...) — the console’s node pages are built on this.

Runtime knobs live on the sibling Node Settings page.