Petals CLI 3.4.0-SNAPSHOT > Page Comparison - Command 'monitoring' (v.14 vs v.15)

Command 'monitoring'

Version 14 by Christophe DENEUX
on Feb 18, 2016 13:45.
<< Changes from 13 to 14
compared with
Version 15 by Christophe DENEUX
on Mar 03, 2016 12:18.
Changes from 15 to 16 >>
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (12)

View Page History
...
h4. {anchor:remote-transporter-outgoing-connection-pool}Outgoing connection pools

Several metrics about the outgoing connection pools of the remoter transporter are available through the sub function '{{outgoing-connections}}' of the monitored object '{{tcp-transporter}}'. It's usage is:{code}
[--list-containers] | [--query-containers [NAME] | [MAX_ACTIVE|ACTIVE|MAX_IDLE|IDLE|MAX_SIZE|MIN_SIZE|ESTABLISHED <index>]] | [-t]
{code}
-c <remote-container-name>

\\
'{{--list-containers}}' returns the list of all remote-containers for which connections was established, since the last start of the transporter.
{code}
where '{{<remote-container-name>}}' is the unique name as defined in the topology of the remote container to which outgoing connections are established.
Returned metrics are:
* {{ActiveConnectionsMax}}, the maximum number of active connections (established and used),
* {{ActiveConnectionsCurrent}}, the current number of active connections (established and used),
* {{IdleConnectionsMax}}, the maximum number of idle connections (established but not used),
* {{IdleConnectionsCurrent}}, the current number of idle connections (established but not used),
* {{MaxSize}}, the maximum number of active connections that can be used simultaneously,
* {{MinSize}}, the minimum number of connection established that can be not used,
* {{EstablishedConnections}}, the number of connections established since the last start of the transporter.
>./petals-cli.sh -h localhost -n 7700 -u petals -p petals -c -- monitoring -o tcp-transporter -f outgoing-connections -- --list-containers
sample-0
sample-1
sample-2
{code}

\\
'{{--query-containers}}' returns query result about remote container:
|| Query argument || Description ||
| {{NAME}} | returns remote container names by index. It is used to known which remote container name is associated to index. The output format is: {{<index>!<remote-container>}}, one remote container per line. |
| {{MAX_ACTIVE}} | returns the *max number of active* connections per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{ACTIVE}} | returns the *current number of active* connections per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{MAX_IDLE}} | returns the *max number of idle connections per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{IDLE}} | returns the *current number of idle* connections per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{MAX_SIZE}} | returns the *max size* of the connection pool per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{MIN_SIZE}} | returns the *min size* of the connection pool per remote container. The remote container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
| {{ESTABLISHED}} | returns the *number of connections established* per remote-container since the last startup of the remote transporter. The remote-container is expressed by its index. The output format is: {{<index>!<value>}}, one remote container per line. If an index value is set on the command line, the output is limited to the provided index, and only the value is displayed. |
{code}
> ./petals-cli.sh -h localhost -n 7700 -u petals -p petals -c -- monitoring -o tcp-transporter -f outgoing-connections -- -c sample-1 --query-containers ACTIVE
ActiveConnectionsMax:5 ActiveConnectionsCurrent:2 IdleConnectionsMax:2 IdleConnectionsCurrent:0 MaxSize:10 MinSize:0 EstablishedConnections:13
sample-0!182830
sample-1!86587
sample-2!365448
>./petals-cli.sh -h localhost -n 7700 -u petals -p petals -c -- monitoring -o tcp-transporter -f outgoing-connections -- --query-containers ACTIVE sample-1
86587
{code}

If no remote container is given on the command line, a human readable table is returned displaying values for all remote containers knwon:
\\
'{{-t}}' displays a human readable table of all values about delivered messages:
{code}
> ./petals-cli.sh -h localhost -n 7700 -u petals -p petals -c -- monitoring -o tcp-transporter -f outgoing-connections
...