Software AG Products 10.5 | Using API Gateway | API Gateway Analytics | Runtime Events and Metrics Data Model
 
Runtime Events and Metrics Data Model
 
API Gateway
API Portal
Audit Log
CentraSite
Elasticsearch
Email
JDBC
Local Log
API Gateway generates runtime events and Key Performance Indicator (KPI) metrics for the currently active APIs. The types of runtime events that API Gateway can generate are:
Events
Description
Lifecycle
A Lifecycle event is generated each time the API Gateway instance is started or shut down.
Error
An Error event is generated each time an invocation of API results in an error.
Policy Violation
A Policy Violation event is generated each time an invocation of API violates a policy that was configured for the API.
Transaction
A Transaction event is generated each time an API is invoked (successfully or unsuccessfully).
Monitor
A Monitor event is generated when a configured SLA parameter, such as the average response time, fault count, availability, and so on, is breached for the API.
KPI metrics are used to monitor the run-time execution of APIs. Metrics include the maximum response time, average response time, fault count, availability of APIs, and so on. If you include runtime monitoring policies, the policies will monitor the KPI metrics for APIs, and can send alerts to various destinations when user-specified performance conditions for an API are violated. The KPI metrics that API Gateway can generate are:
Metric
Reports on...
Availability
The percentage of time that an API was available during the current interval. A value of 100 indicates that the API was always available. Only the time when the API is unavailable counts against this metric. If invocations fail due to policy violations, this parameter could still be as high as 100.
Average Response Time
The average amount of time it took the API to complete all invocations in the current interval. This is measured from the moment API Gateway receives the request until the moment it returns the response to the client.
Fault Count
The number of failed invocations in the current interval.
Maximum Response Time
The maximum amount of time it took the API to complete an invocation in the current interval.
Minimum Response Time
The minimum amount of time it took the API to complete an invocation in the current interval.
Successful Request Count
The number of successful API invocations in the current interval.
Total Request Count
The total number of requests for each API running in API Gateway in the current interval.
You can configure API Gateway to publish the runtime events and metrics data to different destinations. The following sections describe the runtime events and metrics data model for each of these destinations:
*API Gateway
*API Portal
*Audit Log
*CentraSite
*Elasticsearch
*Email
*JDBC
*Local Log