{
  "id": "status",
  "title": "rladmin status",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/status/",
  "summary": "Displays the current cluster status and topology information.",
  "content": "\nDisplays the current cluster status and topology information.\n\n## `status`\n\nDisplays the current status of all nodes, databases, database endpoints, and shards on the cluster.\n\n``` sh\nrladmin status\n        [ extra \u003cparameter\u003e ]\n        [ issues_only]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| extra \\\u003cparameter\\\u003e | Extra options that show more information |\n| issues_only | Filters out all items that have an `OK` status  |\n\n| Extra parameter | Description |\n|-------------------|-------------|\n| extra all | Shows all `extra` information |\n| extra backups | Shows periodic backup status |\n| extra frag | Shows fragmented memory available after the restart |\n| extra nodestats | Shows shards per node |\n| extra rack_id | Shows `rack_id` if customer is not `rack_aware` |\n| extra redis_version | Shows Redis version of all databases in the cluster |\n| extra state_machine | Shows execution of state machine information  |\n| extra watchdog | Shows watchdog status  |\n\n### Returns\n\nReturns tables of the status of all nodes, databases, and database endpoints on the cluster.\n\nIf `issues_only` is specified, it only shows instances that do not have an `OK` status.\n\nIn the `CLUSTER NODES` section, `*node` indicates which node you are connected to.\n\nFor descriptions of the fields returned by `rladmin status extra all`, see the output tables for [nodes](#returns-nodes), [databases](#returns-dbs), [endpoints](#returns-endpoints), and [shards](#returns-shards).\n\n### Example\n\n``` sh\n$ rladmin status extra all\nCLUSTER:\nOK. Cluster master: 1 (198.51.100.2)\nCluster health: OK, [1, 0.13333333333333333, 0.03333333333333333]\nfailures/minute - avg1 1.00, avg15 0.13, avg60 0.03.\n\nCLUSTER NODES:\nNODE:ID ROLE   ADDRESS      EXTERNAL_ADDRESS HOSTNAME     MASTERS SLAVES OVERBOOKING_DEPTH SHARDS CORES FREE_RAM        PROVISIONAL_RAM VERSION   SHA    RACK-ID STATUS\nnode:1  master 198.51.100.2                  3d99db1fdf4b 4       0      10.91GB           4/100  6     14.91GB/19.54GB 10.91GB/16.02GB 6.2.12-37 5c2106 -       OK    \nnode:2  slave  198.51.100.3                  fc7a3d332458 0       0      11.4GB            0/100  6     14.91GB/19.54GB 11.4GB/16.02GB  6.2.12-37 5c2106 -       OK    \n*node:3 slave  198.51.100.4                  b87cc06c830f 0       0      11.4GB            0/100  6     14.91GB/19.54GB 11.4GB/16.02GB  6.2.12-37 5c2106 -       OK    \n\nDATABASES:\nDB:ID NAME      TYPE  STATUS SHARDS PLACEMENT REPLICATION PERSISTENCE ENDPOINT                        EXEC_STATE EXEC_STATE_MACHINE BACKUP_PROGRESS MISSING_BACKUP_TIME REDIS_VERSION\ndb:3  database3 redis active 4      dense     disabled    disabled    redis-11103.cluster.local:11103 N/A        N/A                N/A             N/A                 6.0.16       \n\nENDPOINTS:\nDB:ID     NAME             ID                    NODE       ROLE       SSL        WATCHDOG_STATUS          \ndb:3      database3        endpoint:3:1          node:1     single     No         OK                       \n\nSHARDS:\nDB:ID NAME      ID      NODE   ROLE   SLOTS       USED_MEMORY BACKUP_PROGRESS RAM_FRAG WATCHDOG_STATUS STATUS\ndb:3  database3 redis:4 node:1 master 0-4095      2.08MB      N/A             4.73MB   OK              OK    \ndb:3  database3 redis:5 node:1 master 4096-8191   2.08MB      N/A             4.62MB   OK              OK    \ndb:3  database3 redis:6 node:1 master 8192-12287  2.08MB      N/A             4.59MB   OK              OK    \ndb:3  database3 redis:7 node:1 master 12288-16383 2.08MB      N/A             4.66MB   OK              OK\n```\n\n## `status databases`\n\nDisplays the current status of all databases on the cluster.\n\n``` sh\nrladmin status databases\n        [ extra \u003cparameters\u003e ]\n        [ sort \u003ccolumn_titles\u003e ]\n        [ issues_only ]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| extra \\\u003cparameter\\\u003e | Extra options that show more information |\n| sort \\\u003ccolumn_titles\\\u003e | Sort results by specified column titles |\n| issues_only | Filters out all items that have an `OK` status  |\n\n\n| Extra parameter | Description |\n|-------------------|-------------|\n| extra all | Shows all `extra` information |\n| extra backups | Shows periodic backup status |\n| extra frag | Shows fragmented memory available after the restart |\n| extra nodestats | Shows shards per node |\n| extra rack_id | Shows `rack_id` if customer is not `rack_aware` |\n| extra redis_version | Shows Redis version of all databases in the cluster |\n| extra state_machine | Shows execution of state machine information  |\n| extra watchdog | Shows watchdog status  |\n\n### Returns {#returns-dbs}\n\nReturns a table of the status of all databases on the cluster.\n\nIf `sort \u003ccolumn_titles\u003e` is specified, the result is sorted by the specified table columns.\n\nIf `issues_only` is specified, it only shows databases that do not have an `OK` status.\n\nThe following table describes the fields returned by `rladmin status databases extra all`:\n\n| Field | Description |\n|-------|-------------|\n| DB:ID | Database ID |\n| NAME | Database name |\n| TYPE | Database type: Redis or Memcached |\n| STATUS | Database status |\n| SHARDS | The number of primary shards in the database |\n| PLACEMENT | How the shards are spread across nodes in the cluster, densely or sparsely |\n| REPLICATION | Is replication enabled for the database |\n| PERSISTENCE | Is persistence enabled for the database |\n| ENDPOINT | Database endpoint |\n| EXEC_STATE |  The current state of the state machine |\n| EXEC_STATE_MACHINE | The name of the running state machine |\n| BACKUP_PROGRESS | The database’s backup progress |\n| MISSING_BACKUP_TIME | How long ago a backup was done |\n| REDIS_VERSION | The database’s Redis version |\n\n### Example\n\n``` sh\n$ rladmin status databases sort REPLICATION PERSISTENCE\nDB:ID NAME      TYPE  STATUS SHARDS PLACEMENT REPLICATION PERSISTENCE ENDPOINT                                       \ndb:1  database1 redis active 1      dense     disabled    disabled    redis-10269.testdbd11169.localhost:10269\ndb:2  database2 redis active 1      dense     disabled    snapshot    redis-13897.testdbd11169.localhost:13897\ndb:3  database3 redis active 1      dense     enabled     snapshot    redis-19416.testdbd13186.localhost:19416\n```\n\n## `status endpoints`\n\nDisplays the current status of all endpoints on the cluster.\n\n``` sh\nrladmin status endpoints\n        [ node \u003cid\u003e ]\n        [ db { db:\u003cid\u003e | \u003cname\u003e } ]\n        [ extra \u003cparameters\u003e ]\n        [ sort \u003ccolumn_titles\u003e ]\n        [ issues_only ]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| node \\\u003cid\\\u003e | Only show endpoints for the specified node ID |\n| db db:\\\u003cid\\\u003e | Only show endpoints for the specified database ID |\n| db \\\u003cname\\\u003e | Only show endpoints for the specified database name |\n| extra \\\u003cparameter\\\u003e | Extra options that show more information |\n| sort \\\u003ccolumn_titles\\\u003e | Sort results by specified column titles |\n| issues_only | Filters out all items that have an `OK` status  |\n\n\n| Extra parameter | Description |\n|-------------------|-------------|\n| extra all | Shows all `extra` information |\n| extra backups | Shows periodic backup status |\n| extra frag | Shows fragmented memory available after the restart |\n| extra nodestats | Shows shards per node |\n| extra rack_id | Shows `rack_id` if customer is not `rack_aware` |\n| extra redis_version | Shows Redis version of all endpoints in the cluster |\n| extra state_machine | Shows execution of state machine information  |\n| extra watchdog | Shows watchdog status  |\n\n### Returns {#returns-endpoints}\n\nReturns a table of the status of all endpoints on the cluster.\n\nIf `sort \u003ccolumn_titles\u003e` is specified, the result is sorted by the specified table columns.\n\nIf `issues_only` is specified, it only shows endpoints that do not have an `OK` status.\n\nThe following table describes the fields returned by `rladmin status endpoints extra all`:\n\n| Field | Description |\n|-------|-------------|\n| DB:ID | Database ID |\n| NAME | Database name |\n| ID | Endpoint ID |\n| NODE | The node that hosts the endpoint |\n| ROLE | The proxy policy of the database: single, all-master-shards, or all-nodes |\n| SSL | Is SSL enabled |\n| WATCHDOG_STATUS | The shards related to the endpoint are monitored and healthy |\n\n### Example\n\n``` sh\n$ rladmin status endpoints\nDB:ID     NAME             ID                    NODE        ROLE        SSL    \ndb:1      database1        endpoint:1:1          node:1      single      No     \ndb:2      database2        endpoint:2:1          node:2      single      No     \ndb:3      database3        endpoint:3:1          node:3      single      No\n```\n\n## `status modules`\n\nDisplays the current status of modules installed on the cluster and modules used by databases. This information is not included in the combined status report returned by [`rladmin status`](#status).\n\n``` sh\nrladmin status modules\n        [ db { db:\u003cid1\u003e | \u003cname1\u003e } ... { db:\u003cidN\u003e | \u003cnameN\u003e } ]\n        [ extra { all | compatible_redis_version | min_redis_version | module_id } ]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| db db:\\\u003cid\\\u003e | Provide a list of database IDs to show only modules used by the specified databases\u003cbr /\u003e(for example: `rladmin status modules db db:1 db:2`) |\n| db \\\u003cname\\\u003e | Provide a list of database names to show only modules used by the specified databases\u003cbr /\u003e(for example: `rladmin status modules db name1 name2`) |\n| extra all | Shows all extra information |\n| extra compatible_redis_version | Shows the compatible Redis database version for the module |\n| extra module_id | Shows module IDs |\n| extra\u0026nbsp;min_redis_version | Shows the minimum compatible Redis database version for each module |\n\n### Returns\n\nReturns the status of modules installed on the cluster and modules used by databases.\n\n### Example\n\n```sh\n$ rladmin status modules extra all                \nCLUSTER MODULES:\nMODULE           VERSION   MIN_REDIS_VERSION  ID                                \nRedisBloom       2.4.5     6.0                1b895a180592cbcae5bd3bff6af24be2  \nRedisBloom       2.6.8     7.1                95264e7c9ac9540268c115c86a94659b  \nRediSearch 2     2.6.12    6.0                2c000539f65272f7a2712ed3662c2b6b  \nRediSearch 2     2.8.9     7.1                dd9a75710db528afa691767e9310ac6f  \nRedisGears       2.0.15    7.1                18c83d024b8ee22e7caf030862026ca6  \nRedisGraph       2.10.12   6.0                5a1f2fdedb8f6ca18f81371ea8d28f68  \nRedisJSON        2.4.7     6.0                28308b101a0203c21fa460e7eeb9344a  \nRedisJSON        2.6.8     7.1                b631b6a863edde1b53b2f7a27a49c004  \nRedisTimeSeries  1.8.11    6.0                8fe09b00f56afe5dba160d234a6606af  \nRedisTimeSeries  1.10.9    7.1                98a492a017ea6669a162fd3503bf31f3  \n\nDATABASE MODULES:\nDB:ID      NAME             MODULE            VERSION  ARGS              STATUS \ndb:1       search-json-db   RediSearch 2      2.8.9    PARTITIONS AUTO   OK     \ndb:1       search-json-db   RedisJSON         2.6.8                      OK     \ndb:2       timeseries-db    RedisTimeSeries   1.10.9                     OK      \n```\n\n## `status nodes`\n\nDisplays the current status of all nodes on the cluster.\n\n``` sh\nrladmin status nodes\n        [ extra \u003cparameters\u003e ]\n        [ sort \u003ccolumn_titles\u003e ]\n        [ issues_only ]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| extra \\\u003cparameter\\\u003e | Extra options that show more information |\n| sort \\\u003ccolumn_titles\\\u003e | Sort results by specified column titles |\n| issues_only | Filters out all items that have an `OK` status  |\n\n\n| Extra parameter | Description |\n|-------------------|-------------|\n| extra all | Shows all `extra` information |\n| extra backups | Shows periodic backup status |\n| extra frag | Shows fragmented memory available after the restart |\n| extra nodestats | Shows shards per node |\n| extra rack_id | Shows `rack_id` if customer is not `rack_aware` |\n| extra redis_version | Shows Redis version of all nodes in the cluster |\n| extra state_machine | Shows execution of state machine information  |\n| extra watchdog | Shows watchdog status  |\n\n### Returns {#returns-nodes}\n\nReturns a table of the status of all nodes on the cluster.\n\nIf `sort \u003ccolumn_titles\u003e` is specified, the result is sorted by the specified table columns.\n\nIf `issues_only` is specified, it only shows nodes that do not have an `OK` status.\n\n`*node` indicates which node you are connected to.\n\nThe following table describes the fields returned by `rladmin status nodes extra all`:\n\n| Field | Description |\n|-------|-------------|\n| NODE:ID | Node ID |\n| ROLE | Is the node a primary (`master`) or secondary (`slave`) node |\n| ADDRESS | The node’s internal IP address |\n| EXTERNAL ADDRESS | The node’s external IP address |\n| HOSTNAME | Node name |\n| MASTERS | The number of primary shards on the node |\n| SLAVES | The number of replica shards on the node |\n| OVERBOOKING_DEPTH | Memory available to create new shards, accounting for the memory reserved for existing shards to grow, even if `shards_overbooking` is enabled. A negative value indicates how much memory is overbooked rather than just showing that no memory is available for new shards. |\n| SHARDS | The number of shards on the node |\n| CORES | The number of cores on the node |\n| FREE_RAM | free_memory/total_memory\u003cbr /\u003e**free_memory**: the amount of free memory reported by the OS.\u003cbr /\u003e**total_memory**: the total physical memory available on the node. |\n| PROVISIONAL_RAM | Memory available to create new shards, displayed as available_provisional_memory/total_provisional_memory.\u003cbr /\u003e**available_provisional_memory**: memory currently available for the creation of new shards.\u003cbr /\u003e**total_provisional_memory**: memory that would be available to create new shards if the used memory on the node was 0.\u003cbr /\u003eIf the available provisional memory is 0, the node cannot create new shards because the node has reached its shard limit, is in maintenance mode, or is a quorum-only node. |\n| FLASH | The amount of flash memory available on the node, similar to `FREE_RAM` |\n| AVAILABLE_FLASH | Flash memory available to create new shards, similar to `PROVISIONAL_RAM` |\n| VERSION | The cluster version installed on the node |\n| SHA | The node’s SHA hash |\n| RACK-ID | The node’s rack ID |\n| STATUS | The node’s status |\n\n### Example\n\n``` sh\n$ rladmin status nodes sort PROVISIONAL_RAM HOSTNAME\nCLUSTER NODES:\nNODE:ID     ROLE       ADDRESS          EXTERNAL_ADDRESS          HOSTNAME            SHARDS     CORES          FREE_RAM                 PROVISIONAL_RAM          VERSION        STATUS   \nnode:1      master     198.51.100.2                                 3d99db1fdf4b        4/100      6              14.74GB/19.54GB          10.73GB/16.02GB          6.2.12-37      OK       \n*node:3     slave      198.51.100.4                                 b87cc06c830f        0/100      6              14.74GB/19.54GB          11.22GB/16.02GB          6.2.12-37      OK       \nnode:2      slave      198.51.100.3                                 fc7a3d332458        0/100      6              14.74GB/19.54GB          11.22GB/16.02GB          6.2.12-37      OK       \n```\n\n## `status shards`\n\nDisplays the current status of all shards on the cluster.\n\n``` sh\nrladmin status shards\n        [ node \u003cid\u003e ]\n        [ db {db:\u003cid\u003e | \u003cname\u003e} ]\n        [ extra \u003cparameters\u003e ]\n        [ sort \u003ccolumn_titles\u003e ]\n        [ issues_only ]\n```\n\n### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| node \\\u003cid\\\u003e | Only show shards for the specified node ID |\n| db db:\\\u003cid\\\u003e | Only show shards for the specified database ID |\n| db \\\u003cname\\\u003e | Only show shards for the specified database name |\n| extra \\\u003cparameter\\\u003e | Extra options that show more information |\n| sort \\\u003ccolumn_titles\\\u003e | Sort results by specified column titles |\n| issues_only | Filters out all items that have an `OK` status  |\n\n\n| Extra parameter | Description |\n|-------------------|-------------|\n| extra all | Shows all `extra` information |\n| extra backups | Shows periodic backup status |\n| extra frag | Shows fragmented memory available after the restart |\n| extra shardstats | Shows shards per node |\n| extra rack_id | Shows `rack_id` if customer is not `rack_aware` |\n| extra redis_version | Shows Redis version of all shards in the cluster |\n| extra state_machine | Shows execution of state machine information  |\n| extra watchdog | Shows watchdog status  |\n\n### Returns {#returns-shards}\n\nReturns a table of the status of all shards on the cluster.\n\nIf `sort \u003ccolumn_titles\u003e` is specified, the result is sorted by the specified table columns.\n\nIf `issues_only` is specified, it only shows shards that do not have an `OK` status.\n\nThe following table describes the fields returned by `rladmin status shards extra all`:\n\n| Field | Description |\n|-------|-------------|\n| DB:ID | Database ID |\n| NAME | Database name |\n| ID | Shard ID |\n| NODE | The node on which the shard resides |\n| ROLE | The shard’s role: primary (`master`) or replica (`slave`) |\n| SLOTS | Redis keys slot range of the shard |\n| USED_MEMORY | Memory used by the shard |\n| BACKUP_PROGRESS | The shard’s backup progress |\n| RAM_FRAG | The shard’s RAM fragmentation caused by deleted data or expired keys. A large value can indicate inefficient memory allocation. |\n| FLASH_FRAG | For Auto Tiering databases, the shard’s flash fragmentation |\n| WATCHDOG_STATUS | The shard is being monitored by the node watchdog and the shard is healthy |\n| STATUS | The shard’s status |\n\n### Example\n\n``` sh\n$ rladmin status shards sort USED_MEMORY ID\nSHARDS:\nDB:ID               NAME                       ID                   NODE               ROLE               SLOTS                           USED_MEMORY                     STATUS          \ndb:3                database3                  redis:6              node:1             master             8192-12287                      2.04MB                          OK              \ndb:3                database3                  redis:4              node:1             master             0-4095                          2.08MB                          OK              \ndb:3                database3                  redis:5              node:1             master             4096-8191                       2.08MB                          OK              \ndb:3                database3                  redis:7              node:1             master             12288-16383                     2.08MB                          OK              \n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}