Petals Documentation > Petals ESB > Petals ESB 4.2 > Container User Guide > Monitoring Petals ESB > Monitoring Petals ESB with Cacti > Monitoring Petals components > Monitoring Petals CDK-based components

Monitoring Petals CDK-based components

Introduction

All components based on the Petals Component Development Kit provide following metrics:

  • provider side:
    • message exchange acceptor thread pool metrics,
    • message exchange processor object pool metrics,
    • message exchange processor thread pool metrics,
    • service provider invocation number per operation and execution status,
    • service provider invocation response times per operation and execution status,
  • consumer side:
    • no metric.
In this documentation, the term "Allocated threads" must be understood as "Active threads", see PETALSDISTRIB-37. This naming error will be fixed in the next version.
Table of contents
Contributors
No contributors found for: authors on selected page(s)

Monitoring the provider side

Monitoring the message exchange acceptor thread pool

See Creating a graph using a simple data to graph the stats of the thread pool accepting message exchanges:

  • 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 generic -f mex-acceptor-thread-pool -- -n <component-id>
  • 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

Monitoring the message exchange processor object pool

See Creating a graph using a simple data to graph the stats of the object pool of message exchanges:

  • 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 generic -f mex-processor-object-pool -- -n <component-id>
  • Output fields of the script/command:
    Name Description Type
    BorrowedObjectsMax The maximum number of borrowed objects GAUGE
    BorrowedObjectsCurrent The current number of borrowed objects GAUGE
    IdleObjectsMax The maximum number of idle objects GAUGE
    IdleObjectsCurrent The current number of idle objects GAUGE
    MaxSize The maximum size of the object pool GAUGE
    MinIdleSize The minimum size of the object pool GAUGE
    Exhaustions The number of exhaustions of the object pool COUNTER

Monitoring the message exchange processor thread pool

See Creating a graph using a simple data to graph the stats of the thread pool of message exchanges:

  • 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 generic -f mex-processor-thread-pool -- -n <component-id>
  • 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

Monitoring the service provider invocation number per operation and execution status

Unable to render embedded object: File (service-provider-invocations-count.png) not found.

See Creating a graph using a data query to graph the stats about invocation number of a service provider:

  • the data query definition to put in a file: 
    <interface>
        <name>Get service provider invocation 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 generic -f service-provider-invocations-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>
                </filterName>
                <succeeded>
                        <name>Succeeded invocation counter</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED</query_name>
                </succeeded>
                <error>
                        <name>Failed invocation counter</name>
                        <direction>output</direction>
                        <query_name>ERROR</query_name>
                </error>
                <fault>
                        <name>Faulty invocation counter</name>
                        <direction>output</direction>
                        <query_name>FAULT</query_name>
                </fault>
                <pending>
                        <name>Pending invocation counter</name>
                        <direction>output</direction>
                        <query_name>PENDING</query_name>
                </pending>
        </fields>
</interface>
  • Output fields of the script/command:
    Name Description Type
    succeeded The succeeded invocation counter COUNTER
    error The failed invocation counter COUNTER
    fault The faulty invocation counter COUNTER
    pending The pending invocation counter GAUGE

Monitoring the service provider invocation response times per operation and execution status

Unable to render embedded object: File (service-provider-invocations-response-times.png) not found.

See Creating a graph using a data query to graph the stats about invocation response times of a service provider:

  • the data query definition to put in a file: 
    <interface>
        <name>Get service provider invocation 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 generic -f service-provider-invocations-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>
                </filterName>
                <succeededMin>
                        <name>Succeeded invocation: Min response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_MIN</query_name>
                </succeededMin>
                <succeededAvg>
                        <name>Succeeded invocation: Avg response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_AVG</query_name>
                </succeededAvg>
                <succeededMax>
                        <name>Succeeded invocation: Max response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_MAX</query_name>
                </succeededMax>
                <succeeded10p>
                        <name>Succeeded invocation: 10-percentil response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_10P</query_name>
                </succeeded10p>
                <succeeded50p>
                        <name>Succeeded invocation: 50-percentil response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_50P</query_name>
                </succeeded50p>
                <succeeded90p>
                        <name>Succeeded invocation: 90-percentil response time</name>
                        <direction>output</direction>
                        <query_name>SUCCEEDED_90P</query_name>
                </succeeded90p>
                <pendingMin>
                        <name>Pending invocation: Min response time</name>
                        <direction>output</direction>
                        <query_name>PENDING_MIN</query_name>
                </pendingMin>
                ...
                <errorMin>
                        <name>Failed invocation: Min response time</name>
                        <direction>output</direction>
                        <query_name>ERROR_MIN</query_name>
                </errorMin>
                ...
                <faultMin>
                        <name>Faulty invocation: Min response time</name>
                        <direction>output</direction>
                        <query_name>FAULT_MIN</query_name>
                </faultMin>
        </fields>
</interface>
  • Output fields of the script/command:
    Name Description Type
    succeededMin The min response time of succeeded invocations GAUGE
    succeededAvg The average response time of succeeded invocations GAUGE
    succeededMax The max response time of succeeded invocations GAUGE
    succeeded10p The 10-percentil response time of succeeded invocations GAUGE
    succeeded50p The 50-percentil response time of succeeded invocations GAUGE
    succeeded90p The 90-percentil response time of succeeded invocations GAUGE
    pendingMin The min response time of pending invocations GAUGE
    pendingAvg The average response time of pending invocations GAUGE
    pendingMax The max response time of pending invocations GAUGE
    pending10p The 10-percentil response time of pending invocations GAUGE
    pending50p The 50-percentil response time of pending invocations GAUGE
    pending90p The 90-percentil response time of pending invocations GAUGE
    errorMin The min response time of failed invocations GAUGE
    errorAvg The average response time of failed invocations GAUGE
    errorMax The max response time of failed invocations GAUGE
    error10p The 10-percentil response time of failed invocations GAUGE
    error50p The 50-percentil response time of failed invocations GAUGE
    error90p The 90-percentil response time of failed invocations GAUGE
    faultMin The min response time of faulty invocations GAUGE
    faultAvg The average response time of faulty invocations GAUGE
    faultMax The max response time of faulty invocations GAUGE
    fault10p The 10-percentil response time of faulty invocations GAUGE
    fault50p The 50-percentil response time of faulty invocations GAUGE
    fault90p The 90-percentil response time of faulty invocations GAUGE
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.