stream topic info

Lists information about the partitions in the topics that are in a stream.

Permissions Required

To run this command, your user ID must have the following permissions:
  • readAce on the volume
  • lookupdir on directories in the path
  • adminperm, consumeperm, produceperm, or topicperm permission on the stream
Note: The mapr user is not treated as a superuser. MapR Streams does not allow the mapr user to run this command unless that user is given the relevant permission or permissions with access-control expressions.

Syntax

CLI
stream topic info
	 -path <Stream Path> 
	 -topic <Topic Name> 
REST http[s]://<host>:<port>/rest/stream/topic/info?path=<path>&topic=<name>

Parameters

Parameter Description
path The path and name of the stream for which you want to display information about topics.
topic The name of the topic for which you want to display information.

Sample Output

# maprcli stream topic info -path /jtest-BasicListenerTest-LGtopicSubscr0 -topic topic0 -json
{
"timestamp":1438765229877,
"timeofday":"2015-08-05 02:00:29.877 GMT-0700",
"status":"OK",
"total":4,
"data":[
            "numconsumers" : 4,
    "partitions" : [
                             {
                          "partitionid":0,
                   "physicalsize":491520,
                   "logicalsize":2752512,
                   "minoffset":0,
                   "maxoffset":640319,
                               "minoffsetacrossconsumers": 600000,
                   "mintimestamp":1438764130586,
                   "maxtimestamp":1438764131568,
                               "mintimestampacrossconsumers": 1438764131500
                   "fid":"2129.463.526852",
                   "master":"localhost:5660",
                   "servers":"localhost:5660"
                   },
                   {
                   "partitionid":1,
                   "physicalsize":491520,
                   "logicalsize":2752512,

                   "maxoffset":640319,
                               "minoffsetacrossconsumers": 620000,
                   "mintimestamp":1438764130717,
                   "maxtimestamp":1438764131568,
                               "mintimestampacrossconsumers": 1438764131560
                   "fid":"2130.464.526860",
                   "master":"localhost:5660",
                   "servers":"localhost:5660"
                    },
                      ],
               ],
}

Field Descriptions

maxoffset
The maximum offset for this partition.
minoffsetacrossconsumers
All known consumers for this partition have consumed messages at least up to this offset.
mintimestamp
The timestamp of oldest message in the partition.
maxtimestamp
The timestamp of newest message in the partition.
mintimestampacrossconsumers
All known consumers for this partition have consumed messages older than this timestamp.
fid
The inode hosting the head of the partition.
master
For use by MapR support: The master server that is hosting the head of the partition.
servers
For use by MapR support: Lists all of the servers that are hosting the head of the partition.