Workload Monitors
Performance Counters
When you install PCo, performance counters are created (Group: SAP Plant Connectivity). Combined with process-level counters, these counters can monitor and tune PCo. For more information about PCo performance, see the performance and sizing guide under https://help.sap.com/viewer/p/SAP_PLANT_CONNECTIVITY. The following two counter groups are relevant for the PCo workload:
|
Counter group |
Monitor |
Detailed description |
Prerequisites |
|---|---|---|---|
|
Process (Windows performance counter of the running agent instance) |
Windows Performance Monitor |
Windows standard performance indicators (for example,% CPU load) |
Agent instance is running |
|
SAP Plant Connectivity (PCo-specific performance counter) |
Windows Performance Monitor |
Specific performance indicators (for example, notifications per second) |
Agent instance is running |
The following table lists the most important performance counters of the Process group:
|
Counter |
Description |
|---|---|
|
% Processor Time |
The share of processor utilization of the agent instance process |
|
Private Bytes |
The memory consumption of the agent instance process. |
The following table lists the most important performance counters of the SAP Plant Connectivity group, which you can use for notification scenarios:
|
Counter |
Description |
|---|---|
|
Notification Deliveries/sec |
Primary performance indicator for a notification scenario. Monitors and tunes a running agent instance; can be combined with process CPU utilization to see the effect of the notifications on the processor. |
|
Notification Failures |
Monitors a running agent instance for notification messages in failed state; notification messages are in failed state if the Reliability indicator was not set and the notification message cannot be sent. |
|
Dispatch Thread Count Dispatch Retry Thread Count |
Monitors the overall agent instance load. The maximum number of threads depends on the agent instance setting (Notification Processing tab: Max. Dispatch Threads) and on the number of CPUs. |
|
Data Queue Items |
Monitors the number of notifications in the processing queue. If the value is steadily rising, this is an indication that the destination system cannot handle the notification load fast enough. |
The following table lists the most important performance counters of the SAP Plant Connectivity group, to be used with query scenarios.
|
Counter |
Description |
|---|---|
|
Queries Executed/sec |
Primary performance indicator for a query scenario |
|
Queries Failed |
Total number of failed queries since the agent instance was started |
|
Queries Active Count |
Number of current queries executed in parallel |
The following table lists the most important performance counters of the SAP Plant Connectivity group, to be used in method call scenario, that is when a PCo agent instance acts as an OPC UA or Web server.
|
Counter |
Description |
|---|---|
|
Method Calls |
Total number of calls of PCo OPC UA methods or PCo Web service operations that were executed |
|
Method Calls/sec |
Executed calls of PCo OPC UA methods or PCo Web service operations per second |
|
Method Calls Failed |
Total number of calls of PCo OPC UA methods or PCo Web service operations that were executed and failed |
Activate the writing of performance counters
The writing of performance counters of the SAP Plant Connectivity group is disabled by default for new agent instances. Perform the following steps in order to activate the writing for a PCo agent instance:
-
Stop the agent instance.
-
Open a Windows Explorer window, and navigate to the PCo configuration directory for agent instances: <PROGRAMDATA>\Config\Instances.
-
Identify the file with the suffix .exe.config that belongs to your agent instance. Open that file in a text editor. For example, if your agent instance is named MY_AGENT, open the MY_AGENT.exe.config file in a text editor.
-
Search for the <appSettings> section.
-
Within the <appSettings> section, search for the line<add key="PerformanceCountersEnabled" value="false" />.
If this line does not exist yet, create it between the statements <appSettings> and</appSettings>.
-
Change the value from false to true, so that the line reads :
<add key="PerformanceCountersEnabled" value="true" />
-
Save the file and quit the text editor.
-
Restart the agent instance.
CA Wily Introscope Enterprise Manager (EM)
You can use CA Wily Introscope Enterprise Manager (EM) to monitor and to measure the performance and resource usage of SAP Plant Connectivity at runtime. For more information about CA Wily Introscope Enterprise Manager (EM) see SAP Note 2034074 
.