{ "STREAM": { "summary": "Returns information about a stream.", "complexity": "O(1)", "group": "stream", "since": "5.0.0", "arity": -3, "container": "XINFO", "history": [ [ "6.0.0", "Added the `FULL` modifier." ], [ "7.0.0", "Added the `max-deleted-entry-id`, `entries-added`, `recorded-first-entry-id`, `entries-read` and `lag` fields" ], [ "7.2.0", "Added the `active-time` field, and changed the meaning of `seen-time`." ] ], "function": "xinfoCommand", "command_flags": [ "READONLY" ], "acl_categories": [ "STREAM" ], "key_specs": [ { "flags": [ "RO", "ACCESS" ], "begin_search": { "index": { "pos": 2 } }, "find_keys": { "range": { "lastkey": 0, "step": 1, "limit": 0 } } } ], "reply_schema": { "oneOf": [ { "description": "Summary form, in case `FULL` was not given.", "type": "object", "additionalProperties": false, "properties": { "length": { "description": "the number of entries in the stream (see `XLEN`)", "type": "integer" }, "radix-tree-keys": { "description": "the number of keys in the underlying radix data structure", "type": "integer" }, "radix-tree-nodes": { "description": "the number of nodes in the underlying radix data structure", "type": "integer" }, "last-generated-id": { "description": "the ID of the least-recently entry that was added to the stream", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "max-deleted-entry-id": { "description": "the maximal entry ID that was deleted from the stream", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "recorded-first-entry-id": { "description": "cached copy of the first entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "entries-added": { "description": "the count of all entries added to the stream during its lifetime", "type": "integer" }, "groups": { "description": "the number of consumer groups defined for the stream", "type": "integer" }, "first-entry": { "description": "the first entry of the stream", "oneOf": [ { "type": "null" }, { "type": "array", "minItems": 2, "maxItems": 2, "items": [ { "description": "entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, { "description": "data", "type": "array", "items": { "type": "string" } } ] } ] }, "last-entry": { "description": "the last entry of the stream", "oneOf": [ { "type": "null" }, { "type": "array", "minItems": 2, "maxItems": 2, "items": [ { "description": "entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, { "description": "data", "type": "array", "items": { "type": "string" } } ] } ] } } }, { "description": "Extended form, in case `FULL` was given.", "type": "object", "additionalProperties": false, "properties": { "length": { "description": "the number of entries in the stream (see `XLEN`)", "type": "integer" }, "radix-tree-keys": { "description": "the number of keys in the underlying radix data structure", "type": "integer" }, "radix-tree-nodes": { "description": "the number of nodes in the underlying radix data structure", "type": "integer" }, "last-generated-id": { "description": "the ID of the least-recently entry that was added to the stream", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "max-deleted-entry-id": { "description": "the maximal entry ID that was deleted from the stream", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "recorded-first-entry-id": { "description": "cached copy of the first entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "entries-added": { "description": "the count of all entries added to the stream during its lifetime", "type": "integer" }, "entries": { "description": "all the entries of the stream", "type": "array", "uniqueItems": true, "items": { "type": "array", "minItems": 2, "maxItems": 2, "items": [ { "description": "entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, { "description": "data", "type": "array", "items": { "type": "string" } } ] } }, "groups": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "name": { "description": "group name", "type": "string" }, "last-delivered-id": { "description": "last entry ID that was delivered to a consumer", "type": "string", "pattern": "[0-9]+-[0-9]+" }, "entries-read": { "description": "total number of entries ever read by consumers in the group", "oneOf": [ { "type": "null" }, { "type": "integer" } ] }, "lag": { "description": "number of entries left to be consumed from the stream", "oneOf": [ { "type": "null" }, { "type": "integer" } ] }, "pel-count": { "description": "total number of unacknowledged entries", "type": "integer" }, "pending": { "description": "data about all of the unacknowledged entries", "type": "array", "items": { "type": "array", "minItems": 4, "maxItems": 4, "items": [ { "description": "Entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, { "description": "Consumer name", "type": "string" }, { "description": "Delivery timestamp", "type": "integer" }, { "description": "Delivery count", "type": "integer" } ] } }, "consumers": { "description": "data about all of the consumers of the group", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "active-time": { "type": "integer", "description": "Last time this consumer was active (successful reading/claiming).", "minimum": 0 }, "name": { "description": "consumer name", "type": "string" }, "seen-time": { "description": "timestamp of the last interaction attempt of the consumer", "type": "integer" }, "pel-count": { "description": "number of unacknowledged entries that belong to the consumer", "type": "integer" }, "pending": { "description": "data about the unacknowledged entries", "type": "array", "items": { "type": "array", "minItems": 3, "maxItems": 3, "items": [ { "description": "Entry ID", "type": "string", "pattern": "[0-9]+-[0-9]+" }, { "description": "Delivery timestamp", "type": "integer" }, { "description": "Delivery count", "type": "integer" } ] } } } } } } } } } } ] }, "arguments": [ { "name": "key", "type": "key", "key_spec_index": 0 }, { "name": "full-block", "type": "block", "optional": true, "arguments": [ { "name": "full", "token": "FULL", "type": "pure-token" }, { "token": "COUNT", "name": "count", "type": "integer", "optional": true } ] } ] } }