{section}
{column}

h1. Introduction

The Petals BC Soap is composed of several internal components. Each one can be monitored and provides several metrics:
* consumer side:
** incoming requests
*** incoming information request counter,

* provider side:
** outgoing web-service request counter,
** outgoing web-service request response times,
** web-service client pool.

Moreover, as the Petals BC Soap is based on the Petals CDK, all common metrics are also provided, see [Monitoring Petals CDK-based components].

{column}
{column:width=35%}
{panel:title=Table of contents}{toc:outline=true}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list|showAnonymous=true|showCount=true|showLastTime=true}{panel}
{column}
{section}

h1. Monitoring the consumer side

h2. Monitoring the thread pool processing incoming requests

!petals-bc-soap-http-thread-pool.png|align=center!

See [Creating a graph using a simple data|How to create a graph with Cacti#Creating a graph using a simple data] to graph the stats of the thread pool processing incoming requests:
* Script/Command of the data input method: {{petals-cli.sh \-h <petals_host> \-n <petals_jmx_port> \-u <petals_jmx_user> \-p <petals_jmx_password> \-c \-- monitoring \-o petals-bc-soap \-f http-thread-pool \-- \-n <petals-bc-soap-id>}}
{tip}If you have only one Petals BC SOAP installed on your Petals node, the input field {{petals-bc-soap-id}} can be replaced by its value{tip}
* Output fields of the script/command:
|| Name || Description || Type ||
| {{AllocatedThreadsMax}} | The maximum number of allocated threads | GAUGE |
| {{AllocatedThreadsCurrent}} | The current number of allocated threads | GAUGE |
| {{IdleThreadsMax}} | The maximum number of idle threads | GAUGE |
| {{IdleThreadsCurrent}} | The current number of idle threads | GAUGE |
| {{MaxSize}} | The maximum size of the thread pool | GAUGE |
| {{MinSize}} | The minimum size of the thread pool | GAUGE |
| {{EnqueuedRequestsMax}} | The maximum number of requests that are enqueued waiting a thread to be processed | GAUGE |
| {{EnqueuedRequestsCurrent}} | The current number of requests that are enqueued waiting a thread to be processed | GAUGE |

h2. Monitoring the incoming requests

!petals-bc-soap-incoming-http-requests-count.png|align=center!

See [Creating a graph using a simple data|How to create a graph with Cacti#Creating a graph using a simple data] to graph the incoming requests:
* Script/Command of the data input method: {{petals-cli.sh \-h <petals_host> \-n <petals_jmx_port> \-u <petals_jmx_user> \-p <petals_jmx_password> \-c \-- monitoring \-o petals-bc-soap \-f incoming-http-requests-count \-- \-n <petals-bc-soap-id> \-r}}
{tip}If you have only one Petals BC SOAP installed on your Petals node, the input field {{petals-bc-soap-id}} can be replaced by its value{tip}
* Output fields of the script/command:
|| Name || Description || Type ||
| {{Information}} | Number of information request received | COUNTER |
| {{Unknown}} | Number of unknown request received | COUNTER |
| {{WS}} | Number of web-service request received | COUNTER |
| {{ServiceContracts}} | Number of web-service contract request received | COUNTER |

h2. Monitoring the incoming web-service requests per operation and execution status

!petals-bc-soap-incoming-ws-requests-count.png|align=center!

See [Creating a graph using a data query|How to create a graph with Cacti#Creating a graph using a data query] to graph the stats about incoming web-service requests per operation:
* the data query definition to put in a file:
{code}
<interface>
<name>Get web-service request number of the BC Soap per operation</name>
<script_path>petals-cli.sh</script_path>
<arg_prepend>-h localhost -n 7700 -u petals -p petals -c -- monitoring -o petals-bc-soap -f incoming-ws-requests-count</arg_prepend>
<arg_index>-- -n petals-bc-soap --list-operations</arg_index>
<arg_query>-- -n petals-bc-soap --query-operations</arg_query>
<arg_get>-- -n petals-bc-soap --query-operations</arg_get>
<output_delimeter>!</output_delimeter>
<index_order>filterName</index_order>
<index_order_type>alphanumeric</index_order_type>
<!--index_title_format>|chosen_order_field|</index_title_format-->

<fields>
<filterName>
<name>Operation name</name>
<direction>input</direction>
<query_name>NAME</query_name>

</pending>
</fields>
</interface>
{code}

!petals-bc-soap-incoming-ws-requests-response-times.png|align=center!

See [Creating a graph using a data query|How to create a graph with Cacti#Creating a graph using a data query] to graph the stats about response times of incoming web-service requests per operation:
* the data query definition to put in a file:
{code}
<interface>
<name>Get web-service response times of the BC Soap per operation</name>
<script_path>petals-cli.sh</script_path>
<arg_prepend>-h localhost -n 7700 -u petals -p petals -c -- monitoring -o petals-bc-soap -f incoming-ws-requests-response-times</arg_prepend>
<arg_index>-- -n petals-bc-soap --list-operations</arg_index>
<arg_query>-- -n petals-bc-soap --query-operations</arg_query>
<arg_get>-- -n petals-bc-soap --query-operations</arg_get>
<output_delimeter>!</output_delimeter>
<index_order>filterName</index_order>
<index_order_type>alphanumeric</index_order_type>
<!--index_title_format>|chosen_order_field|</index_title_format-->

<fields>
<filterName>
<name>Operation name</name>
<direction>input</direction>
<query_name>NAME</query_name>

</errorMin>

</faultMin>
</fields>
</interface>
{code}

h2. Monitoring the web-service client pools per operation of external web-service

!petals-bc-soap-ws-clients-pools.png|align=center!

See [Creating a graph using a data query|How to create a graph with Cacti#Creating a graph using a data query] to graph the stats about the web-service client pools per operation of external web-service:
* the data query definition to put in a file:
{code}
<interface>
<name>Get web-service client pools of the BC Soap per operation</name>
<script_path>/home/cdeneux/petals-cli-2.1.1-SNAPSHOT/bin/petals-cli.sh</script_path>
<arg_prepend>-h localhost -n 7700 -u petals -p petals -c -- monitoring -o petals-bc-soap -f ws-clients-pools</arg_prepend>
<arg_index>-- -n petals-bc-soap --list-operations</arg_index>
<arg_query>-- -n petals-bc-soap --query-operations</arg_query>
<arg_get>-- -n petals-bc-soap --query-operations</arg_get>
<output_delimeter>!</output_delimeter>
<index_order>filterName</index_order>
<index_order_type>alphanumeric</index_order_type>
<!--index_title_format>|chosen_order_field|</index_title_format-->

<fields>
<filterName>
<name>Operation name</name>
<direction>input</direction>
<query_name>URL</query_name>
</filterName>
<inUseCur>
<name>Web-service clients currently in use</name>
<direction>output</direction>
<query_name>INUSE_CUR</query_name>
</inUseCur>
<inUseMax>
<name>Maximum number of web-service clients to use concurrently</name>
<direction>output</direction>
<query_name>INUSE_MAX</query_name>
</inUseMax>
<exhaustions>
<name>Exhaustions</name>
<direction>output</direction>
<query_name>EXHAUSTIONS</query_name>
</exhaustions>
</fields>
</interface>
{code}
* Output fields of the script/command:
|| Name || Description || Type ||
| {{inUseMin}} | Current number of web-service clients in use | GAUGE |
| {{inUsemax}} | Maximum number of web-service clients to use concurrently | GAUGE |
| {{exhaustions}} | Number of exhaustions | COUNTER |

h2. Monitoring the outgoing web-service requests per operation and execution status

!petals-bc-soap-outgoing-ws-requests-count.png|align=center!

See [Creating a graph using a data query|How to create a graph with Cacti#Creating a graph using a data query] to graph the stats about outgoing web-service requests per operation:
* the data query definition to put in a file:
{code}
<interface>
<name>Get outgoing web-service request number of the BC Soap per operation</name>
<script_path>petals-cli.sh</script_path>
<arg_prepend>-h localhost -n 7700 -u petals -p petals -c -- monitoring -o petals-bc-soap -f outgoing-ws-requests-count</arg_prepend>
<arg_index>-- -n petals-bc-soap --list-operations</arg_index>
<arg_query>-- -n petals-bc-soap --query-operations</arg_query>
<arg_get>-- -n petals-bc-soap --query-operations</arg_get>
<output_delimeter>!</output_delimeter>
<index_order>filterName</index_order>
<index_order_type>alphanumeric</index_order_type>
<!--index_title_format>|chosen_order_field|</index_title_format-->

<fields>
<filterName>
<name>Operation name</name>
<direction>input</direction>
<query_name>NAME</query_name>

</pending>
</fields>
</interface>
{code}

!petals-bc-soap-outgoing-ws-requests-response-times.png|align=center!

See [Creating a graph using a data query|How to create a graph with Cacti#Creating a graph using a data query] to graph the stats about response times of outgoing web-service requests per operation:
* the data query definition to put in a file:
{code}
<interface>
<name>Get outgoing web-service response times of the BC Soap per operation</name>
<script_path>petals-cli.sh</script_path>
<arg_prepend>-h localhost -n 7700 -u petals -p petals -c -- monitoring -o petals-bc-soap -f outgoing-ws-requests-response-times</arg_prepend>
<arg_index>-- -n petals-bc-soap --list-operations</arg_index>
<arg_query>-- -n petals-bc-soap --query-operations</arg_query>
<arg_get>-- -n petals-bc-soap --query-operations</arg_get>
<output_delimeter>!</output_delimeter>
<index_order>filterName</index_order>
<index_order_type>alphanumeric</index_order_type>
<!--index_title_format>|chosen_order_field|</index_title_format-->

<fields>
<filterName>
<name>Operation name</name>
<direction>input</direction>
<query_name>NAME</query_name>

</errorMin>

</faultMin>
</fields>
</interface>
{code}