Returns information about a stream.
XINFO
STREAM
key
[FULL
[COUNT
count]]
This command returns information about the stream stored at
<key>
.
The informative details provided by this command are:
XLEN
)FULL
modifierThe optional FULL
modifier provides a more verbose
reply. When provided, the FULL
reply includes an
entries array that consists of the stream entries (ID
and field-value tuples) in ascending order. Furthermore,
groups is also an array, and for each of the consumer
groups it consists of the information reported by
XINFO GROUPS
and XINFO CONSUMERS
.
The following information is provided for each of the groups:
The following information is provided for each pending entry:
The following information is provided for each consumer:
XREADGROUP
, XCLAIM
,
XAUTOCLAIM
)XREADGROUP
that actually
read some entries into the PEL,
XCLAIM
/XAUTOCLAIM
that actually claimed some
entries)Note that before Redis OSS 7.2.0, seen-time used to denote the last successful interaction. In 7.2.0, active-time was added and seen-time was changed to denote the last attempted interaction.
The COUNT
option can be used to limit the number of
stream and PEL entries that are returned (The first
<count>
entries are returned). The default
COUNT
is 10 and a COUNT
of 0 means that all
entries will be returned (execution time may be long if the stream has a
lot of entries).
One of the following:
Array reply: when the FULL argument is used, a list of information about a stream in summary form.
Array reply: when the FULL argument is used, a list of information about a stream in extended form.
One of the following:
Map reply: when the FULL argument was not given, a list of information about a stream in summary form.
Map reply: when the FULL argument was given, a list of information about a stream in extended form.
O(1)
@read @slow @stream
Default reply:
> XINFO STREAM mystream
1) "length"
2) (integer) 2
3) "radix-tree-keys"
4) (integer) 1
5) "radix-tree-nodes"
6) (integer) 2
7) "last-generated-id"
8) "1638125141232-0"
9) "max-deleted-entry-id"
10) "0-0"
11) "entries-added"
12) (integer) 2
13) "groups"
14) (integer) 1
15) "first-entry"
16) 1) "1638125133432-0"
2) 1) "message"
2) "apple"
17) "last-entry"
18) 1) "1638125141232-0"
2) 1) "message"
2) "banana"
Full reply:
> XADD mystream * foo bar
"1638125133432-0"
> XADD mystream * foo bar2
"1638125141232-0"
> XGROUP CREATE mystream mygroup 0-0
OK
> XREADGROUP GROUP mygroup Alice COUNT 1 STREAMS mystream >
1) 1) "mystream"
2) 1) 1) "1638125133432-0"
2) 1) "foo"
2) "bar"
> XINFO STREAM mystream FULL
1) "length"
2) (integer) 2
3) "radix-tree-keys"
4) (integer) 1
5) "radix-tree-nodes"
6) (integer) 2
7) "last-generated-id"
8) "1638125141232-0"
9) "max-deleted-entry-id"
10) "0-0"
11) "entries-added"
12) (integer) 2
13) "entries"
14) 1) 1) "1638125133432-0"
2) 1) "foo"
2) "bar"
2) 1) "1638125141232-0"
2) 1) "foo"
2) "bar2"
15) "groups"
16) 1) 1) "name"
2) "mygroup"
3) "last-delivered-id"
4) "1638125133432-0"
5) "entries-read"
6) (integer) 1
7) "lag"
8) (integer) 1
9) "pel-count"
10) (integer) 1
11) "pending"
12) 1) 1) "1638125133432-0"
2) "Alice"
3) (integer) 1638125153423
4) (integer) 1
13) "consumers"
14) 1) 1) "name"
2) "Alice"
3) "seen-time"
4) (integer) 1638125133422
5) "active-time"
6) (integer) 1638125133432
7) "pel-count"
8) (integer) 1
9) "pending"
10) 1) 1) "1638125133432-0"
2) (integer) 1638125133432
3) (integer) 1
FULL
modifier.max-deleted-entry-id
,
entries-added
, recorded-first-entry-id
,
entries-read
and lag
fieldsactive-time
field, and changed the
meaning of seen-time
.XACK, XADD, XAUTOCLAIM, XCLAIM, XDEL, XGROUP, XGROUP CREATE, XGROUP CREATECONSUMER, XGROUP DELCONSUMER, XGROUP DESTROY, XGROUP HELP, XGROUP SETID, XINFO, XINFO CONSUMERS, XINFO GROUPS, XINFO HELP, XLEN, XPENDING, XRANGE, XREAD, XREADGROUP, XREVRANGE, XSETID, XTRIM.