Monitoring status for Cumulocity IoT
The Cumulocity IoT component provides status values via the user status mechanism. It provides the following metrics (where prefix is user-CumulocityIoTGenericChain.cumulocityCodec):
Key | Description |
prefix.maxLatencyInLastHourMillis | Maximum request latency observed during the last hour, in milliseconds. |
prefix.maxLatencyInLastHourDetails | Details of the maximum latency request. Consists of a tab-separated string containing the following: ![*](chapterTOC_bullet.png) ISO format timestamp in UTC, ![*](chapterTOC_bullet.png) method, path and parameters truncated to 100 characters (in URL format), and ![*](chapterTOC_bullet.png) an optional count of the number of objects if this is a batched request (only com.apama.cumulocity.Measurement requests can be batched). |
prefix.mostRecentSlowRequestDetails | Details of the most recent slow request. A request is slow if the request-response multiplied by the number of pages (or 1) is above CUMULOCITY_LATENCY_SLOW_THRESHOLD_SECS (see
Configuring the Cumulocity IoT transport). Consists of a tab-separated string containing the following: ![*](chapterTOC_bullet.png) ISO format timestamp in UTC, ![*](chapterTOC_bullet.png) method, path and parameters truncated to 100 characters (in URL format), and ![*](chapterTOC_bullet.png) an optional count of the number of objects if this is a batched request (only com.apama.cumulocity.Measurement requests can be batched). |
prefix.requestLatencyEWMAShortMillis | A quickly-evolving exponentially-weighted moving average of request latencies, in milliseconds. Uses 0.5 as the weight to calculate this. This puts more importance on recent latencies than requestLatencyEWMALongMillis. |
prefix.requestLatencyEWMALongMillis | A longer-term exponentially-weighted moving average of request latencies, in milliseconds. Uses 0.1 as the weight to calculate this. |
You can find additional status information relating to the Cumulocity IoT transport in the status elements from the HTTP client. These start with the prefix
user-CumulocityIoTGenericChain.httpClient. For a description of these status elements, see
Monitoring status for the HTTP client.
For more information about monitor status information published by the correlator, see
Managing and Monitoring over REST and
Watching correlator runtime status.
When using
Software AG Command Central to manage your correlator, see also
Monitoring the KPIs for EPL applications and connectivity
plug-ins.
Note:
Command Central integration is deprecated and will be removed in a later release.