stream topic info
Lists information about a stream's topic, grouped by partition ID.
Permissions Required
To run this command, your user ID must have the following permissions:readAce
on the volumelookupdir
on directories in the pathadminperm
,consumeperm
,produceperm
, ortopicperm
permission on the stream
NOTE
The mapr
user is not treated as a
superuser. HPE Ezmeral Data Fabric 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 |
|
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 /streamVol/stream1 -topic topic1 -json
{
"timestamp":1521232252550,
"timeofday":"2018-03-16 01:30:52.550 GMT-0700 PM",
"status":"OK",
"total":1,
"data":[
{
"partitionid":0,
"physicalsize":0,
"logicalsize":0,
"maxoffset":-1,
"minoffsetacrossconsumers":0,
"mintimestamp":"1969-12-31T04:00:00.000-0800 PM",
"maxtimestamp":"1969-12-31T04:00:00.000-0800 PM",
"mintimestampacrossconsumers":"1969-12-31T04:00:00.000-0800 PM",
"fid":"2113.32.131400",
"master":"doc24.lab:5660",
"servers":"doc24.lab:5660",
"timestamptype":"createtime",
"logcompactionlaststarted":"1969-12-31T04:00:00.000-0800 PM",
"logcompactionlastcompleted":"1969-12-31T04:00:00.000-0800 PM",
"logcompactionstatus":"not started"
}
]
}
Field Descriptions
partitionid
- The index number of the partition within the topic. The first partition in a topic has an index of 0, the next partition an index of 1, and so on.
physicalsize
- The physical size (in bytes) of the stream topic with data compression.
logicalsize
- The logical size (in bytes) of the stream topic without data compression.
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 HPE support: The master server that is hosting the head of the partition.
servers
- For use by HPE support: Lists all of the servers that are hosting the head of the partition.
timestamptype
- The type of timestamp stored in the topic's message. Possible values: createtime (default) and logappendtime.
logcompactionlaststarted
- Displays the last time log compaction was started if log compaction was enabled. The value is displayed in epoch time. This field displays when there is a change in the value for this field.
logcompactionlastcompleted
- Displays the last time log compaction completed if log compaction was enabled. The value is displayed in epoch time. This field displays when there is a change in the value for this field
logcompactionstatus
- Displays whether log compaction was started or completed.