status

Shows the cluster’s current status.

faunadb-admin status

Description

The status command displays the current status of the cluster.

Each heading in the output identifies a replica and its operating mode (data+log). Under each replica heading is the status for each node in the replica.

Operational modes

The operating modes could be one of:

  • (data+log): This node both stores data and participates in the transaction log. This is the default state.

  • (data): This node stores a portion of the replica’s data, but does not participate in the transaction log.

  • (compute): This node performs cluster tasks, but does not store data or participate in the transaction log.

Node status

Each line representing a node’s status in the output of the status command includes these fields:

  • Status: The current status of the node, either up or down.

  • State: The current state of the node, either live or removed.

  • WorkerID: This node’s worker identifier.

  • Log Segment: Shows which segment of the transaction log that this node is participating in, and whether or not the node is the RAFT leader for that segment.

  • Address: The node’s IP address.

  • Owns: Reports the ideal amount of data that this node should be responsible for.

  • Goal: Reports the target amount of data that this node should be responsible for.

  • HostID: The node’s UUID, which helps identify this node’s output in various log files and is used for cluster operations.

Example

faunadb-admin status
Loaded configuration from /faunadb/enterprise/default.yml...

Replica: us-west (data+log)
===========================
Status  State  WorkerID  Log Segment  Address      Owns   Goal   HostID
up      live   512       0 (leader)   10.0.0.44    50.0%  50.0%  69c59ab4-52dc-4d91-b4d0-f9e9e70ef040
up      live   516       1 (leader)   10.0.0.45    50.0%  50.0%  0e2dbd0e-9f7d-4b87-b571-9e03d8e419c5

Replica: eu-west (data+log)
===========================
Status  State  WorkerID  Log Segment  Address      Owns   Goal   HostID
up      live   513       0            10.0.0.46    49.8%  49.8%  a20f1df5-c75d-4ab4-bd69-469646bad81d
up      live   514       1            10.0.0.47    50.2%  50.2%  bde23e4d-ed79-471b-8521-7c5ef0e9103f

Replica: ap-northeast (data+log)
================================
Status  State  WorkerID  Log Segment  Address      Owns   Goal   HostID
up      live   515       0            10.0.0.49    50.0%  50.0%  ac2fb4c4-f619-4994-83dc-15a6e4631d02
up      live   517       1            10.0.0.48    50.0%  50.0%  0a464fe1-fdb3-4307-a253-e876abd6e751

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve! documentation@fauna.com

Thank you for your feedback!