{ "schema_version": 2, "id": "operate/rs/references/cli-utilities/rladmin/status", "title": "rladmin status", "url": "https://redis.io/docs/latest/operate/rs/7.4/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\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\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\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\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\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 | 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 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\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### 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\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\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-10-21T09:46:20-07:00" }