TORRUS_NODEID(8) torrus TORRUS_NODEID(8)
NAME
nodeid - Torrus utility
SYNOPSIS
torrus nodeid --tree=TREENAME --cmd=CMD options...
DESCRIPTION
This command provides a way to integrate Torrus with external OSS systems. It operates with nodeid, a unique identifier for Torrus
datasource subtrees and leaves.
The command prints the data on the standard output in JSON data format.
OPTIONS
--tree=TREE
[Mandatory] Defines the datasouerce tree.
--cmd=CMD
[Mandatory] Defines the action command. The following commands are supported:
o info
Prints information about the nodeid. Requires --nodeid.
o search
Performs a prefix or substring search on node IDs and prints the results. Requires --prefix or --substring.
o render
Renders a specified datasource node and prints the resulting MIME type and the file name. Requires --nodeid and --view.
Optional --out defines a file name to copy the output to.
--nodeid=NODEID
Specifies the Node ID string for the commands info and render.
--details
Toggles verbose output for the commands info and search.
--prefix=STR
Specifies the prefix search string for the command search.
--substring=STR
Specifies the search substring for the command search.
--view=VIEW
Specifies the view name for the command render. The following views are defined by standard Torrus XML files and render a PNG graph:
"short", "last24h-small", "last24h", "lastweek", "lastmonth", "lastyear". The following views are printing the datasource value in a
text format: "rrd-print-daily", "rrd-print-last".
--out=FILE
If defined, instructs the utility to copy the rendered data into a specified file. Otherwise the file is created in the standard
renderer's cache directory.
--help
Displays a help message.
SEE ALSO
torrus(8)
NOTES
See more documentation at Torrus home page: http://torrus.org
AUTHOR
Stanislav Sinyagin <ssinyagin@yahoo.com>
torrus 2.03 2013-07-26 TORRUS_NODEID(8)