sbmonitor

StreamBase Monitor — starts the StreamBase Monitor

SYNOPSIS

sbmonitor [OPTION]

DESCRIPTION

sbmonitor is a command-line utility that shows information about the current status and performance of a running StreamBase application. The information shown includes the number of tuples processed by each box, the percentage of CPU time consumed by each box, and the percentage of CPU time consumed by each thread. sbmonitor presents a character-based display that contains the same statistics as the graphical display of the sbmanager command.

While sbmonitor is running, type H to view help on basic controls, such as sorting columns and stopping the monitor.

OPTIONS

-h, --help

Displays help, then exits.

-k

Shows a description of the columns.

-u URI

Sets the URI of the StreamBase Server. The default is sb://localhost:10000/. The URI can also be set using the STREAMBASE_SERVER environment variable. See the sburi page of the Reference Guide (or see sburi(5) at the UNIX shell prompt) for a discussion of the URI format and its shortcuts.

-p TCP-port

Sets the port number only for the StreamBase Server. Useful when the server is localhost and you only need to specify a non-default port, instead of specifying the full URI with the -u option. The default port is 10000.

Note

The -p option is not supported for StreamBase applications that have authentication enabled or are using High Availability features.

--version

Prints version information and exits.

FILES

There is no configuration file for sbmonitor.

ENVIRONMENT

STREAMBASE_SERVER

Optional. Contains the URI for a StreamBase Server instance. Use this variable to set a default StreamBase URI for StreamBase commands that take the –u option. If set, commands use the URI in this variable, overriding their built-in default URI, which is sb://localhost:10000. If this variable is set, you must use the –u option to communicate with any server other than the one specified in this variable. See the sburi page in the Reference Guide for more on StreamBase URIs.

STREAMBASE_RETITLE_TERMINALS

Optional. If set to any value, StreamBase programs assign a terminal window title to match the name of the executable being run. By default terminal titles are not affected.

STREAMBASE_LOG_LEVEL

Optional. Sets the minimum severity of messages that StreamBase will write to syslog or stderr. Default is 0, which gets NOTICE level messages and higher. Reasonable values are -1, to disable NOTICE messages and only show WARN, ERROR and FATAL messages, 1, which adds INFO messages to the standard messages, and 2, which adds DEBUG messages.

SEE ALSO

sbmanager
syslog (3)