API Gateway Analytics
The analytics dashboards display a variety of charts to provide an overview of API Gateway performance and its API usage. The data for these dashboards come from the API Gateway destination store.
The analytics dashboards display a variety of charts to provide an overview of API Gateway performance and its API usage. The data for these dashboards come from the API Gateway destination store.
In API Gateway there are two types of dashboards. Each of these dashboards has various filters that can be applied as per the required metrics to be monitored.
API Gateway dashboard. Displays API Gateway-wide analytics such as Summary of APIs, API usage, API trends, the top performing API and the non-performing API analytics, audit logs, applications and package related event information. This can be accessed by expanding the menu options icon , in the title bar, and selecting Analytics.
API-specific dashboard. Displays API specific analytics such as API invocation trends by response time, success and failure rates, API performance, consumer or application traffic for a specific API. This can be accessed from the API details page.
Custom dashboard. Displays API Gateway-wide analytics or API specific analytics as configured. Click > Analytics to access API Gateway-wide analytics. A custom dashboard is a collection of visualizations. You can add the visualizations as per your requirement and compile the visualizations as a custom dashboard.
The dashboard displays depend on the events and metrics generated in API Gateway and their types. An event is a kind of notification or alert generated by the API Gateway Metrics and Event Notification module. Various types of event are generated based on the behavior of the transactions in the system. Events generated by API Gateway are real time events made persistent in the store and sent to configured destinations.
These are the types of events generated in API Gateway:
Transactional event: Provides a summary of each runtime transaction in the system. It is generated when a Log Invocation policy is included for the API. For example, if an API has the policy attached to it, then for every invoke the system generates a transaction event. API Gateway provides a system global policy, Transaction logging, which are pre-configured in the product. This policy is, by default, deactivated. The transaction logging policy has standard filters and a log invocation policy that logs request or response payloads to a specified destination.
Error event: Provides details of an error that occurred during an API invoke. This event is generated whenever there is an error in the system during a runtime service invocation. This is configured as part of destination configuration.
Monitoring event: Provides a summary of event details along with the breach information when there is a threshold breach in any of the configured parameters. Monitoring could be done based on various parameters such as Total Request Count, Total Success Count, Response Time, and Availability. Monitoring can be done at the consumer application level too so that each consumer can be tracked individually. These events are generated when a Monitor performance and Monitor SLA Policy is included for the API. In addition, the Traffic Optimization policy generates these events for every API invocation only when there is a breach in the parameters configured in the policy or once per alert interval based on the alert frequency configured in the policy.
Policy violation event: Provides a summary of the policy violations that occurred in the system. When a policy attached to an API is violated, the system generates the policy violation event for alerting the provider. The Identity and Access, Authorization, and Schema Validation policies generate these events. This is configured as part of destination configuration. In addition, the Traffic Optimization policy generates these events for every API invocation only when there is a breach in the parameters configured in the policy.
Lifecycle event: Provides a summary of the life cycle of the API Gateway instance. Whenever the instance is started or stopped, a life cycle notification is generated. This is configured as part of destination configuration.
Threat protection event: Provides a summary of the threat protection filter and rule violations. When a filter or rule is violated, the system generates the threat protection violation event. This is configured a part of destination configuration.
Note: Internalization is not supported in API Gateway dashboards.
You can view the API Gateway dashboard by expanding the menu options icon , in the title bar, and selecting Analytics. The dashboard displays the API Gateway-wide analytics based on the metrics monitored.
The dashboard displays the API Gateway-wide analytics based on the metrics monitored. Click > Analytics to access API Gateway-wide analytics.
To filter the API Gateway-wide analytics, select the time interval using the options:
Quick select. Specify the time interval. Click Apply to filter the analytics based on the time interval.
Commonly used. Select a commonly used time interval, and the filter is applied automatically. To view the API Gateway-wide analytics between a time interval, click Custom range > From Date > To Date > Apply.
Recently used. Select a recently used time interval, and the filter is applied automatically.
When you log in and view the analytics, the last used time interval is saved for each dashboard. When you view the dashboard again, the last used time interval for that dashboard is applied. The last used time interval is valid for the current session only. You can click on the specific event in the list under Legend to view the specific event in any of the widgets. You can view additional details for an event by hovering the cursor over a particular color in the graphical representations.
In the Applications dashboard, you can filter the data using the filter for Applications in the specified time interval. The Applications drop-down list displays all the applications. When you select an application, its data is displayed. By default, the data displayed is for all the applications.
In the Packages dashboard, you can filter the data using the filter for Packages in the specified time interval. The Packages drop-down list displays all the packages. When you select a package, its data are displayed. By default, the data displayed is for all the packages.
In the Audit logs dashboard, you can filter the data using the filter for Audit logs in the specified time interval. It displays the data of all the auditable events.
In the Cache statistics dashboard, you can filter the cache statistics data depending on the Node name and Application type specified in the specified time interval.
In the Application logs dashboard, you can filter the application logs depending on the node, origin of log and so on in the specified time interval. Click Download to download the aggregated logs, the logs collected from different sources such as API Gateway server logs, API Gateway UI logs, Internal Data Store logs, dashboard logs and platform logs. The downloaded logs would contain the logs filtered as per the time interval filter applied.
In the API usage details dashboard, you can filter the data using the filter for the API invocations in the specified time interval (in years). By default, the data displayed is for all the API invocations. This dashboard is visible only when API Gateway uses a transaction-based licensing model when each API invocation is considered as a transaction and API Gateway keeps a track of these transactions.
Note: The threat protection analytics information is visible only if you select the Alert destination as flow service in the Policies > Threat protection > Alert settings section.
Category | Metric | Description |
---|---|---|
Summary | Overall events | Displays a pie chart that lists different events being monitored and each of these event categories is depicted with different colors. |
Application activity | Displays the application activity in API Gateway during the specified time. | |
Runtime events | Displays the run time event details such as time when the event was generated, API Name, the application that generated the event, event type, description of the alert generated due to the event, status, and the source of event. | |
Payload size | Displays the payload size of the request and responses during data transfer in the specified time.
This data is picked up from the transactional event that is triggered when a log invocation policy is applied to the API. |
|
Package performance | Displays a pie chart depicting package performance during the specified time. The different colours in the pie chart depict different packages this API belongs to. | |
Trends | Events over time | Displays the trending of events generated by the APIs across API Gateway over time. |
API trend by success | Displays the trending of APIs based on their success rate in the performance metrics. | |
API trend by failure | Displays the trending of APIs based on their failure rate in the performance metrics. | |
Overall error trends | Displays a graph depicting the performance of all the APIs in the system based on the error event generated. Each of these event categories is depicted with different colors. | |
Applications | Events per application | Displays a pie chart that depicts the activity of events per application being monitored and each of these categories is depicted with different colors. |
Violations per application | Displays the number of violations per application based on the events generated such as monitoring, SLA violation, and policy violations. | |
Activity rate of consumed packages | This bar chart displays the package that the selected application has consumed (when an application is chosen in the filter).
Hover the cursor over the bar chart to see the number of invocations to the package using the specified application. |
|
Activity rate for consumed APIs | Displays the activity rate for all the APIs that are consumed by the application during the specified time. | |
Runtime events | Displays the run time event details such as API Name, event type, date when the event was created, the agent on which the event was generated, description of the alert generated due to the event, the source of event, and the application that generated the event. | |
Packages | Package invocations | Displays the number of package invocations during the specified time. |
Trending subscription for package | Displays the trending subscriptions for the package based on the number of invocations.
The different colours in the donut pie chart depict the trending behavior of the different applications in the package. |
|
Trending APIs in the package | Displays the number of invocations for an API for an application for the selected package over the specified time interval. | |
Threat protection | Threat protection filters | Displays the graphical representation of the events based on the filter violations during the specified time. |
Threat protection rules | Displays the graphical representation of the events based on the rule violations during the specified time. | |
Threat protection events | Displays the threat protection event details such as Time, filter name, rule name, resource path, server host, and request time. | |
Audit logs | Time | Displays the time the event occurred. |
User | Displays the name of the user who caused the event. | |
Status | Displays the current status of the transaction. The available values are:
|
|
Source machine | Displays the host name of the machine on which the event occurred. | |
Object type | Displays the type of API Gateway object on which the event occurred. The available values are:
|
|
Object | Displays the UUID that uniquely identifies the object in the database. | |
Message | Displays the success message or error message as a result of the event. | |
Client IP address | Displays the IP address of the machine on which the event occurred. | |
Action | Displays the type of action for the event. The available values are:
|
|
Payload | Displays the content of data payload for the event. | |
API usage details - Dashboard | API Gateway invocation usage | This bar chart displays the trending of API invocations across API Gateway.
Hover the cursor over the bar chart to see the number of API invocations for the current month. |
API Gateway invocation usage details | Displays the details of the number of API invocations for each month. | |
API usage details | Displays the API invocation details for each API such as API Name, API usage for each month and year. | |
API usage details - Report | API usage detail report | Displays the transaction count of API usages across stages. |
Stage wise count | Displays the stage-wise count of API usages. | |
Custom dashboards | Create your own visualizations and compile the visualizations as custom dashboards.
To create custom dashboards, see Creating custom dashboards. You can export and import the assets (visualizations and dashboards) from external Kibana to API Gateway custom dashboard, and API Gateway custom dashboard to external Kibana. The export and import are possible between API Gateway instances running on the same tenant. API Gateway does not support importing the assets across different tenants. Note:You can import the assets created in Kibana 7.7.1 in to API Gateway. |
You can view the common metering dashboard by expanding the menu options icon , in the title bar, and selecting the Analytics > API usage details > Report. The dashboard displays the API usage metrics across all stages and also for specific stage. You can also view and download the API usage report.
By default, the current billing cycle’s API usage metrics are populated in the All stages and Stage wise count boxes. You can click the respective boxes and click Apply filter to filter the analytics based on the time interval chosen. You can select the time interval from the drop-down options. If you select custom, you can type the From date and To date to specify the time interval for which you want to view the API-specific analytics. You can also view and download the API usage report based on the applied filter.
You must have the manage user administration functional privilege to view and download the API usage details. You can view the API usage that is stage-specific or across stages.
The API usage report shows the transaction usage across all stages. When you click on API usage details > Report, it loads the transaction usage across all stages and also stage-specific transaction usages for the current month. You can then view API transaction usage report for all or single stage and also download these as PDF or CSV reports.
To view an API usage report
Expand the menu options icon , in the title bar, and select Analytics.
Click API usage details > Report.
You can view the API detail report for transaction counts for APIs across stages as follows:
a. Click All stages.
b. Select the time interval from the drop-down options, and click Apply filter to filter the analytics based on the time interval chosen.
If you select Custom, you can type the From Month and To Month to specify the time interval in which you want to view the API usage analytics across stages.
You can view the API detail report for transaction counts for APIs in a single stage as follows:
a. Expand Stage wise count.
b. Click the stage for which you want to view the API usage report.
c. Select the time interval from the drop-down options, and click Apply filter to filter the analytics based on the time interval chosen.
If you select Custom, you can type the From Month and To Month to specify the time interval in which you want to to view the API usage analytics for the selected stage.
You must have the manage user administration functional privilege to view and download the API usage details. You can view the API usage that is stage-specific or across stages.
To download an API usage report
Expand the menu options icon , in the title bar, and select Analytics.
Click API usage details > Report.
You can download the API detail report for transaction counts for APIs in All stages as follows:
a. Click All stages.
b. Select the time interval from the drop-down options, and click Apply filter to filter the analytics based on the time interval chosen.
If you select Custom, you can type the From Month and To Month to specify the time interval in which you want to view the API usage analytics across stages.
c. To download a report:
Click Download as PDF report to download the report in the PDF format. The PDF report has the details such as API name, version and the API usage per month globally across stages.
Click Download CSV report to download the report in the CSV format. The CSV report has the details such as API name, version and the API usage per month globally across stages.
Click Download detailed CSV report to download the date-wise API usage report in the CSV format. The CSV report has the details such as API name, version and the API usage per day for the selected period across stages.
You can download the API detail report for transaction counts for APIs in a single stage as follows:
a. Expand Stage wise count.
b. Click the stage for which you want to view the API usage report.
c. Select the time interval from the drop-down options, and click Apply filter to filter the analytics based on the time interval chosen.
If you select Custom, you can type the From Month and To Month to specify the time interval in which you want to view the API usage analytics for the selected stage.
d. To download a report:
Click Download as PDF report to download the report in the PDF format. The PDF report has the details such as API name, version and the API usage per month in the selected stage.
Click Download CSV report to download the report in the CSV format. The CSV report has the details such as API name, version and the API usage per month in the selected stage.
Click Download detailed CSV report to download the date-wise API usage report in the CSV format. The CSV report has the details such as API name, version and the API usage per day for the selected period in the selected stage.
You can view the API-specific dashboard by navigating to the API details page and clicking the Analytics icon for the specific API. The dashboard displays the following analytics based on the metrics monitored.
To filter the API-specific analytics, select the time interval using the options:
Quick select. Specify the time interval. Click Apply to filter the analytics based on the time interval.
Commonly used. Select a commonly used time interval, and the filter is applied automatically. To view the API-specific analytics between a time interval, click Custom range > From Date > To Date > Apply.
Recently used. Select a recently used time interval, and the filter is applied automatically.
When you log in and view the analytics, the last used time interval is saved for each dashboard. When you view the dashboard again, the last used time interval for that dashboard is applied. The last used time interval is valid for the current session only.
For the specified time interval you can also filter based on an API. The API drop-down list displays all the APIs. On selecting an API, the data displayed is for the selected API.
You can click on the specific event in the list under Legend to view the specific event in any of the widgets. You can view additional details for an event by hovering the cursor over a particular color in the graphical representations.
Metric | Description |
---|---|
Events over time | Displays the trending of events generated by the selected API over time. |
API invocations | Displays the number of time the API was invoked during the specified time. |
API invocations -Status wise | Displays the number of successful API invocations and failed API invocations during the specified time. API invocations - Status wise API invocations is the sum of successful API invocations and failed API invocations |
API invocation pattern | Displays API invocation over period of time during the specified time interval in the form of a line graph. |
Gateway vs Provider time | Displays the comparison between gatewayTime performance and providerTime performance. |
Native service performance | Displays information on how fast the native service responds to the request received in the specified time based on the data in the transactional event. |
Response code trend | Displays the trend based on the response codes received from various events for the API during the specified time. |
API trend by response | Displays the trending of the selected API based on the response time from the performance metrics for that API. |
Success vs Failure | Displays the trending of API based on its success rate as compared to its failure rate in the performance metrics for the specified time. |
Runtime events | Displays the run time event details for the selected API. Displays information on the event type, date when the event was created, the agent on which the event was generated, description of the alert generated, the source of event, and the application that generated the event. |
Service result cache | Displays a bar graph showing the number of responses served from cache and the number of responses fetched from the native service at the operation level for the selected API during the specified time. The Service result cache metric graphical representation is not supported for GraphQL API. |
Method level invocations | Displays the method level invocations per operation for the API during the specified time. You can hover the cursor over the stacked bar chart to view the various methods invoked per operation or resource and also the operations or resources for the selected API during the specified time. The Service result cache metric graphical representation is not supported for GraphQL API. |
Pre-requisites:
You must have the API Gateway’s manage custom dashboards functional privilege assigned to manage the custom dashboards in Global analytics.
The Custom dashboards has two options:
View. To view custom dashboards. You can select the custom dashboard that you want to view from the drop-down list.
Build. To build custom dashboards. Here, you can create and add visualizations to build custom dashboards.
Note:
Software AG recommends that you do not modify any default visualizations. If you modify any default visualizations, an upgrade or restart of API Gateway server overwrites the modifications.
Improper visualizations or long running queries in the visualizations can impact the performance of the Elasticsearch.
You can create custom dashboards for both API Gateway-wide analytics and API-specific analytics from the > Analytics page. You can create the visualizations and dashboards in the Kibana interface, and the dashboards are rendered in API Gateway user interface,
To create custom dashboards
Click > Analytics.
Click Custom dashboards > Build.
Build custom dashboard. For instructions, see Kibana documentation.
For API-specific custom dashboard, type apiId:”” in the search box and then save the dashboard. This filter creates a custom dashboard specific to API-specific analytics.
To view the custom dashboard for API Gateway-wide analytics, click View and select the dashboard from the drop-down list.
To view the custom dashboard for API-specific analytics, click APIs > API name > Analytics. Select the custom dashboard from the drop-down list.
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 Portal
Audit Log
CentraSite
Elasticsearch
Local Log
The runtime events and metrics payload is generated by API Gateway at run-time. The columns that make up the events and metrics data model for API Gateway are listed below:
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI1 |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationIp | IP address of the application associated with the API invocation. Example:10.20.248.33 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
callbackRequest | Indicates whether the event is generated for a callback request. Possible values are:
|
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
customFields | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
errorOrigin | The origin of error. Example: Nativeservice |
eventType | The type of event that occurred. Example: Transactional |
externalCalls | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}] |
gatewayTime | Duration in milliseconds, to process a request by API Gateway. This does not include native service processing duration. gatewayTime = totalTime - providerTime Example: 20 |
httpMethod | The HTTP method used to invoke the API. Example: GET |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
queryParameters | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
reqPayload | The API request payload data. Example: RequestPayload |
requestHeaders | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
responseHeaders | Response header in the outgoing response. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, PUT","Connection":"close","Date":"Fri, 30 Mar 2018 08:25:45 GMT","Access-Control-Allow-Headers":"Content-Type, api_key, Authorization","Content-Type":"application/xml"} |
nativeHttpMethod | The HTTP method used to invoke the native service. Example: GET. |
nativeRequestHeaders | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899", "postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
nativeReqPayload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
nativeResponseHeaders | Response header in the outgoing response from the native service to API Gateway. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods": "GET, POST, DELETE,PUT","Connection":"close","Date": "Fri, 07 Jun 2019 12:44:13 GMT","Access-Control-Allow-Headers": "Content-Type,api_key, Authorization","Content-Type": "application/json"} |
nativeResPayload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
nativeURL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
status | Status of the API request. Possible values are: SUCCESS, FAILURE |
totalDataSize | The total combined size of request and response payloads in bytes. Example: 100 |
totalTime | Time in milliseconds required to invoke the API provider. This time includes the overhead incurred by API Gateway. Overhead includes security overhead for encryption, decryption, and load-balance retries. Example: 120 |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
errorDesc | Message that describes the error that occurred. Example: Invocation for SampleAPI was rejected based on policy violation, response code: 503 |
eventType | The type of event that occurred. Example: Error Event |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
userAgent | Name of the client used to invoke the API. Example: Postman |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: EnforcePolicy-HardLimit |
alertType | The type of alert generated for the event. Possible values are: Monitor, sla |
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventSource | The source where the event occurred. Example: API_Gateway_Instance |
eventType | The type of event that occurred. Example: Monitor Event |
httpMethod | The HTTP method used to invoke the API. Example: GET |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
Column | Description |
---|---|
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: LifeCycle |
gatewayStatus | Status of the API Gateway instance. Possible values are: STARTED or STOPPED |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: A violation was detected for policy (Unknown-Policyuser ): application could not be identified. Anonymous access is not allowed for this service! |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
alertType | The type of alert generated for the event. Example: PolicyViolation |
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Policy Violation Event |
httpMethod | The HTTP method used to request the API access. Example: GET |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
userAgent | Name of the client used to invoke the API. Example: Postman |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
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. If invocations fail due to policy violations, this parameter could still be as high as 100. Example: 100 |
avgResponseTime | The average amount of time it took the API to complete each invocation in the current interval. Response time is measured from the moment API Gateway receives the request until the moment it returns the response to the caller. Example: 135 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Performance Metrics Event |
faultCount | The number of failed API invocations in the current interval. Example: 10 |
intervalStart | The starting date and time from which you want to examine metrics. Example: 1526294632172 |
intervalStop | The ending date and time until which you want to examine metrics. Example: 1526294632182 |
maxResponseTime | The maximum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 343 |
minResponseTime | The minimum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 10 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
successCount | The number of successful API invocations in the current interval. Example: 100 |
totalCount | The total number of API invocations (successful and unsuccessful) in the current interval. Example: 110 |
Column | Description |
---|---|
id | The unique identifier for an event. Example: 8e05267a-45c9-45f0-a3dd-8b2ee1e98ca2 |
creationDate | Date and time when the event was generated in API Gateway. Date and time when the event was generated in API Gateway. |
eventType | The type of event that occurred. Example: Transactional |
alertAction | A helpful action taken on the API for the alert. Example: DENY |
filterName | Name of the threat protection filter. Example: DoSFilter |
message | If the API invocation failed, message that describes the error that occurred. Example: Global Denial of Service limits were reached: Maximum requests limit of 2 in 120 seconds has been exceeded. |
requestHost | Hostname of the machine from which the API access request was submitted. Example: 10.60.34.152 |
requestTime | Date and time the request was submitted. Example: 1501671101509 |
requestType | The type of request that was received for the API. Example: ALL |
resourcePath | The relative URI path of a resource that was used for API invocation. Example: invoke/pub.date/getCurrentDate |
ruleName | The API Gateway rule that triggered the event. Example: GlobalDoSRule |
serverHost | The name or IP address of the machine on which the thread protection server is running. Example: 10.60.34.83 |
serverPort | The port number on which the thread protection server is configured to listen for incoming requests. Example: 8911 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured API Portal destination. The columns that make up the events and metrics data model for API Portal are listed below:
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. <Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
consumerId | The unique identifier for the consumer associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
consumerIp | IP address of the consumer associated with the API invocation. Example: 10.1.1.211 |
consumerName | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a security policy that is configured for the API. Example: SampleApplication |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
customFields | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
errorOrigin | The origin of error. Example: Nativeserivce |
eventType | The type of event that occurred. Example: Transactional |
externalCalls | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":" These external calls can be to a native service or service registry. <br>Example: [{“externalCallType”:“SERVICE_REGISTRY_CALL”,“externalURL”:“http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": “200”},{“externalCallType”:“NATIVE_SERVICE_CALL”,“externalURL”:“https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}]` |
gatewayTime | Duration in milliseconds, to process a request by API Gateway. This does not include native service processing duration. gatewayTime = totalTime - providerTime Example: 20 |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
providerTime | Time in milliseconds required for API Gateway to invoke a native provider and receive a response. This time includes the overhead incurred by API Gateway. Overhead includes the time it takes for a provider to process a request and return a response, plus any network latency to or from the provider. Subtracting total time from provider time must give a rough indicator of the API Gateway overhead. Example: 20 |
queryParameters | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
requestHeaders | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
response | The API response payload data. Example: <ResponsePayload> |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
responseHeaders | Response header in the outgoing response. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, PUT","Connection":"close","Date":"Fri, 30 Mar 2018 08:25:45 GMT","Access-Control-Allow-Headers":"Content-Type, api_key, Authorization","Content-Type":"application/xml"} |
nativeHttpMethod | The HTTP method used to invoke the native service. Example: GET. |
nativeRequestHeaders | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899", "postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
nativeReqPayload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
nativeResPayload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
nativeURL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
status | Status of the API request. Possible values are: SUCCESS, FAILURE |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
totalDataSize | The total combined size of request and response payloads in bytes. Example: 100 |
totalTime | Time in milliseconds required to invoke the API provider. This time includes the overhead incurred by API Gateway. Overhead includes security overhead for encryption, decryption, and load-balance retries. Example: 120 |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
consumerId | The unique identifier for the consumer associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
consumerIp | IP address of the consumer associated with the API invocation. Example: 10.20.248.33 |
consumerName | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a security policy that is configured for the API. Example: SampleApplication |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
errorDesc | Message that describes the error that occurred. Service invocation for SampleAPI was rejected based on policy violation, response code: 503 |
eventType | The type of event that occurred. Example: Error Event |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 503 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: EnforcePolicy-HardLimit |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
alertType | The type of alert generated for the event. Example: sla |
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Monitor Event |
monitorAttr | The monitored attribute which has breached the configured SLA. Example: AVGRESPONSETIME GT 1.0, SUCCESSCOUNT EQ 3, REQUESTCOUNT GT 10 |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventStatus | Status of the API Gateway instance. Possible values are: STARTED or STOPPED |
eventType | The type of event that occurred. Example: LifeCycle |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: A violation was detected for policy (Unknown-Policyuser ): application could not be identified. Anonymous access is not allowed for this service! |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
alertType | The type of alert generated for the event. Example: PolicyViolation |
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
consumerId | The unique identifier for the consumer associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
consumerIp | IP address of the consumer associated with the API invocation. Example: 10.20.248.33 |
consumerName | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Policy Violation Event |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: c0f84954-9732-11e5-b9f4-f159eafe47b1 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
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. If invocations fail due to policy violations, this parameter could still be as high as 100. Example: 100 |
avgResponseTime | The average amount of time it took the API to complete each invocation in the current interval. Response time is measured from the moment API Gateway receives the request until the moment it returns the response to the caller. Example: 135 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Performance Metrics Event |
faultCount | The number of failed API invocations in the current interval. Example: 10 |
includeFaults | Includes failed API invocations. Possible values are: true, false |
intervalStart | The starting date and time from which you want to examine metrics. Example: 2015-08-26 04:13:35 PM |
intervalStop | The ending date and time until which you want to examine metrics. Example: 2015-08-26 04:13:45 PM |
maxResponseTime | The maximum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 343 |
minResponseTime | The minimum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 10 |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts. |
successCount | The number of successful API invocations in the current interval. Example: 100 |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
totalCount | The total number of API invocations (successful and unsuccessful) in the current interval. Example: 110 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured Audit Log destination. The columns that make up the events and metrics data model for Audit Log are listed below:
Column | Description |
---|---|
API_ID | The unique identifier for the API. Example: ec1473cc-40a0-479e-9126-474a917c3c89 |
API_NAME | Name of the API in which the event occurred. Example: SampleAPI |
API_VERSION | The system-assigned version identifier for the API. Example: 1.0 |
AUDITTIMESTAMP | Date and time when the event was written to the log. Example: 2017-08-07 07:22:22 |
CONSUMER_IP | IP address of the consumer associated with the API invocation. Example: 10.60.37.42 |
CONSUMER_NAME | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a policy that is configured for the API. Example: SampleApplication |
CONTEXTID | The unique identifier for the current context information API Gateway uses to connect related entries from different logs. This column is currently not used. It appears as NULL or as an empty string. Example: 81546147-41a8-4998-8150-02ba67bb08c2 |
CORRELATIONID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
CUSTOMFIELDS | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
ERROR_ORIGIN | The origin of error. Example: Nativeservice |
EVENT_PK | The primary key (PK) that uniquely identifies the event that occurred. Example: 1 |
EXTERNAL_CALLS | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}] |
INSERTTIMESTAMP | Date and time when the event was generated in API Gateway. Example: 2017-08-07 07:22:22 |
MSGID | The ID assigned to the message by the API provider. This column is currently not used. Example: 361dc2f8-a60b-fc21-8545-9b07fce1a479 |
NATIVE_ENDPOINT | The endpoint URL of the native API that is invoked. Example: http://petstore.swagger.io/v2/pet/55 |
NATIVE_HTTP_METHOD | The HTTP method used to invoke the native service. Example: GET. |
NATIVE_REQUEST_HEADERS | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899","postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
NATIVE_REQ_PAYLOAD | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
NATIVE_RESPONSE_HEADERS | Response header in the outgoing response from the native service to API Gateway. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods": "GET, POST, DELETE,PUT","Connection":"close","Date": "Fri, 07 Jun 2019 12:44:13 GMT","Access-Control-Allow-Headers": "Content-Type,api_key, Authorization","Content-Type": "application/json"} |
NATIVE_RES_PAYLOAD | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
NATIVE_URL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
OPERATION_NAME | Name of the API operation or resource that is invoked. Example: /pet/{petId} |
PROVIDER_TIME | Time in milliseconds required for API Gateway to invoke a native provider and receive a response. This time includes the overhead incurred by API Gateway. Overhead includes the time it takes for a provider to process a request and return a response, plus any network latency to or from the provider. Subtracting total time from provider time must give a rough indicator of the API Gateway overhead. Example: 1336 |
QUERY_PARAMETERS | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
REQUEST_HEADERS | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
RESPONSE_HEADERS | Response header in the outgoing response. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, PUT","Connection":"close","Date":"Fri, 30 Mar 2018 08:25:45 GMT","Access-Control-Allow-Headers":"Content-Type, api_key, Authorization","Content-Type":"application/xml"} |
ROOTCONTEXTID | The unique identifier for the root context information API Gateway uses to connect related entries from different logs. This column is currently not used. It appears as NULL or as an empty string. Example: 81546147-41a8-4998-8150-02ba67bb08c2 |
SERVERID | The API Gateway server on which the transaction event occurred. This column is currently not used. It appears as NULL or as an empty string. Example: *SampleHost:80 |
SERVICE_NAME | Name of the service in which the event occurred. Example: Swagger_Petstore |
SESSION_ID | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: 6dfcd849198c4a7e96b4ff89bc2deaf5 |
SOURCE_GATEWAY_NODE | Source API Gateway’s IP address. Example: 10.0.75.1 |
STATUS | Status of the API request. Possible values are: SUCCESS, FAILURE |
TOTAL_TIME | Time in milliseconds required to invoke the API provider. This time includes the overhead incurred by API Gateway. Overhead includes security overhead for encryption, decryption, and load-balance retries. Example: 1042 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured CentraSite destination. The columns that make up the events and metrics data model for CentraSite are listed below:
Column | Description |
---|---|
ApiUserVersion | The system-assigned version identifier for the API. Example: 1.0 |
Consumer | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a policy that is configured for the API. Example: SampleApplication |
ConsumerId | The unique identifier for the consumer associated with the API invocation. Example: be8b27d6-8f79-4c6e-b06c-a628d2ba30c3 |
Consumer IP Address | IP address of the consumer associated with the API invocation. Example: 10.60.20.169 |
CorrelationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
Created Time | Date and time when the event was generated in API Gateway. Example: 2017-08-09 01:27:45 AM |
CustomFields | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
ErrorOrigin | The origin of error. Example: Nativeservice |
Event Type | The type of event that occurred. Example: Transaction Event |
External Calls | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}] |
Native HTTP Method | The HTTP method used to invoke the native service. Example: GET. |
Native Request Headers | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899", "postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
Native Req Payload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
Native Response Headers | Response header in the outgoing response from the native service to API Gateway. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods": "GET, POST, DELETE,PUT","Connection":"close","Date": "Fri, 07 Jun 2019 12:44:13 GMT","Access-Control-Allow-Headers": "Content-Type,api_key, Authorization","Content-Type": "application/json"} |
Native Res Payload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
Native URL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
PartnerId | The unique identifier for the partner that generated the audit record. Example: unknown |
Provider Round Trip Time | Time in milliseconds required for API Gateway to invoke a native provider and receive a response. This time includes the overhead incurred by API Gateway. Overhead includes the time it takes for a provider to process a request and return a response, plus any network latency to or from the provider. Subtracting total time from provider time must give a rough indicator of the API Gateway overhead. Example: 1700 |
queryParameters | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
requestHeaders | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
RequestPayload | The API request payload data. Example: <RequestPayload> |
responseHeaders | Response header in the outgoing response. Example: `{“Server”:“Jetty(9.2.9.v20150224)”,“Access-Control-Allow-Origin”:”*“,“Access-Control-Allow-Methods”:“GET, POST, DELETE, PUT”,“Connection”:“close”,“Date”:“Fri, 30 Mar 2018 08:25:45 GMT”,“Access-Control-Allow-Headers”:“Content-Type, api_key, Authorization”,“Content-Type” |
ResponsePayload | The API response payload data. Example: <ResponsePayload> |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
Total Round Trip time | Time in milliseconds required to invoke the API provider. This time includes the overhead incurred by API Gateway. Overhead includes security overhead for encryption, decryption, and load-balance retries. Example: 1707 |
Gateway | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Request Status | Status of the API request. Possible values are: SUCCESS, FAILURE |
Column | Description |
---|---|
ApiUserVersion | The system-assigned version identifier for the API. Example: 1.0 |
Consumer | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a policy that is configured for the API. Example: SampleApplication |
ConsumerId | The unique identifier for the consumer associated with the API invocation. Example: be8b27d6-8f79-4c6e-b06c-a628d2ba30c3 |
Consumer IP Address | IP address of the consumer associated with the API invocation. Example: 10.60.20.169 |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
Created Time | Date and time when the event was generated in API Gateway. Example: 2017-08-09 08:24:04 AM |
Error Source | The source where the error occurred. Example: e1cc3c7b-495d-11e7-a5a6-88cf17308ba4 |
Error Description | Message that describes the error that occurred. Example: Resource / not found |
Event Type | The type of event that occurred. Example: Error Event |
Gateway | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
PolicyName | Name of the policy that is enforced on the API. Example: Log Invocation |
Alert Description | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: MSLA_ALERT MESSAGE |
Alert Source | Name of the API Gateway policy that generated the alert message. Example: Monitorpolicy, EnforcePolicy-HardLimit |
Alert Type | The type of alert generated for the event. Possible values are: Monitor, Sla |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
apiName | Name of the API in which the event occurred. Example: pet1 |
apiName | Name of the API in which the event occurred. Example: pet1 |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
Monitored Attribute | The monitored attribute which has breached the configured SLA. Example: AVGRESPONSETIME GT 1.0, SUCCESSCOUNT EQ 3, REQUESTCOUNT GT 10 |
native_endpoint | The endpoint URL of the native API that is invoked. Example: http://petstore.swagger.io/v2/pet/55 |
operationName | Name of the API operation that is invoked. Example: Using a Calculator API, you can perform various operations such as addition, subtraction, multiplication, and division. When an addition operation is invoked in API Gateway, then the operation field name is populated as addInts |
sessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
targetName | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
ApiUserVersion | The system-assigned version identifier for the API. Example: 1.0 |
Alert Source | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
Alert Type | The type of alert generated for the event. Example: PolicyViolation |
Alert Description | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: A violation of policy was detected : Unable to identify the application for the request |
Consumer | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a policy that is configured for the API. Example: unknown |
ConsumerId | The unique identifier for the consumer associated with the API invocation. Example: unknown |
Consumer IP Address | IP address of the consumer associated with the API invocation. Example: 10.60.37.118 |
Created Time | Date and time when the event was generated in API Gateway. Example: 2017-08-09 08:25:52 AM |
Event Type | The type of event that occurred. Example: Policy Violation Event |
Gateway | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
Column | Description |
---|---|
TimeStamp | Date and time when the event was generated in API Gateway. Example: 2017-08-26 04:13:35 PM |
Target | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
LifeCycleStatus | Status of the API Gateway instance. Possible values are: STARTED or STOPPED |
LifeCycleAlertDescription | The alert notification message for the lifecycle event. Example: Alert_Message |
Column | Description |
---|---|
AVG_RESP_TIME | The average amount of time it took the API to complete each invocation in the current interval. Response time is measured from the moment API Gateway receives the request until the moment it returns the response to the caller. Example: 1376 |
FAULT_COUNT | The number of failed API invocations in the current interval. Example: 1 |
INCLUDE_FAULTS | Includes failed API invocations. Possible values are: true, false |
INTERVAL_START | The starting date and time from which you want to examine metrics. Example: 02 Aug 2017 10:51:31 GMT |
INTERVAL_STOP | The ending date and time until which you want to examine metrics. Example: 02 Aug 2017 10:52:31 GMT |
MAX_RESP_TIME | The maximum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 1401 |
MIN_RESP_TIME | The minimum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 1352 |
OPERATION_NAME | Name of the API operation that is invoked. Example: /pet/{petId} |
SERVICE_KEY | The Universally Unique Identifier (UUID) for the service in which the event occurred. This column is currently not used by APIs created in API Gateway. It is used to support the APIs that are migrated from CentraSite or Mediator to API Gateway. |
SUCCESS_COUNT | The number of successful API invocations in the current interval., Example: 1 |
TARGET_NAME | Name of the API Gateway instance reporting the event. Example: API_Gateway_Instance |
totalCount | The total number of API invocations (successful and unsuccessful) in the current interval. Example:2 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured Elasticsearch destination. The columns that make up the events and metrics data model for Elasticsearch are listed below:
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: af70b2de-c9c5-4f40-94be-7d8622743e42 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.60.37.42 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
cachedResponse | Indicates whether the response is sent to the client from the cached data present in API Gateway through the Service result caching policy or the response is received from Native service and sent to client. Possible values are: Cached, Not-Cached |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
isCallbackRequest | Indicates whether the event is generated for a callback request. Possible values are:
|
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
customFields | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
errorOrigin | The origin of error. Example: Nativeservice |
eventType | The type of event that occurred. Example: Transactional |
externalCalls | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}] |
httpMethod | The HTTP method used to invoke the API. Example: GET |
nativeHttpMethod | The HTTP method used to invoke the native service. Example: GET. |
nativeRequestHeaders | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899", "postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
nativeReqPayload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
nativeResponseHeaders | Response header in the outgoing response from the native service to API Gateway. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods": "GET, POST, DELETE,PUT","Connection":"close","Date": "Fri, 07 Jun 2019 12:44:13 GMT","Access-Control-Allow-Headers": "Content-Type,api_key, Authorization","Content-Type": "application/json"} |
nativeResPayload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
nativeURL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
operationName | Name of the API operation that is invoked. Example: /pet/{petId} |
packageId | The unique identifier for the API package. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
packageName | Name of the API package. Example: Travel Package |
planId | The unique identifier for the API plan. Example: d0f84954-9732-11e5-b9f4-f159eafe47b2 |
planName | Name of the API plan. Example: Gold Plan |
providerTime | Time in milliseconds required for API Gateway to invoke a native provider and receive a response. This time includes the overhead incurred by API Gateway. Overhead includes the time it takes for a provider to process a request and return a response, plus any network latency to or from the provider. Subtracting total time from provider time must give a rough indicator of the API Gateway overhead. Example: 1367 |
queryParameteres | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
reqPayload | The API request payload data. Example: <RequestPayload> |
requestHeaders | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
resPayload | The API response payload data. Example: <ResponsePayload> |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 404 |
responseHeaders | Response header in the outgoing response. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, PUT","Connection":"close","Date":"Fri, 30 Mar 2018 08:25:45 GMT","Access-Control-Allow-Headers":"Content-Type, api_key, Authorization","Content-Type":"application/xml"} |
serverID | The API Gateway server on which the transaction event occurred. This column is currently not used. It appears as NULL or as an empty string. Example: SampleHost:80 |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
status | Status of the API request. Possible values are: SUCCESS, FAILURE |
totalDataSize | The total combined size of request and response payloads in bytes. Example: 51 |
totalTime | Time in milliseconds required to invoke the API provider. This time includes the overhead incurred by API Gateway. Overhead includes security overhead for encryption, decryption, and load-balance retries. Example: 1401 |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: af70b2de-c9c5-4f40-94be-7d8622743e42 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.60.37.42 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
correlationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
errorDesc | Message that describes the error that occurred. Example: Native service provider error. Code : 404 |
eventSource | The source where the event occurred. Example: API_Gateway_Instance |
eventType | The type of event that occurred. Example: Error |
httpMethod | The HTTP method used to invoke the API. Example: GET |
operationName | Name of the API operation that is invoked. Example: /pet/{petId} |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 404 |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
sourceGatewayNode | Source API Gateway’s IP address. Example: 10.0.75.1 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: EnforcePolicy-HardLimit |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Monitorpolicy |
alertType | The type of alert generated for the event. Example: Monitor |
apiId | The unique identifier for the API. Example: af70b2de-c9c5-4f40-94be-7d8622743e42 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.60.37.42 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventSource | The source where the event occurred. Example: API_Gateway_Instance |
eventType | The type of event that occurred. Example: Monitor |
httpMethod | The HTTP method used to request the API access. Example: GET |
monitorAttr | The monitored attribute which has breached the configured SLA. Example: AVGRESPONSETIME GT 1.0, SUCCESSCOUNT EQ 3, REQUESTCOUNT GT 10 |
operationName | Name of the API operation that is invoked. Example: /pet/{petId} |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 200 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: A violation was detected for policy (Unknown-Policyuser ): application could not be identified. Anonymous access is not allowed for this service! |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
alertType | The type of alert generated for the event. Example: PolicyViolation |
apiId | The unique identifier for the API. Example: af70b2de-c9c5-4f40-94be-7d8622743e42 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: 9434e90d-65c3-4e37-8ccb-595b8df3e645 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.60.37.42 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventSource | The source where the event occurred. Example: API_Gateway_Instance |
eventType | The type of event that occurred. Example: PolicyViolation |
httpMethod | The HTTP method used to request the API access. Example: GET |
operationName | Name of the API operation that is invoked. Example: /pet/{petId} |
responseCode | The HTTP response status code that indicates success or failure of the requested operation. Example: 503 |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
Column | Description |
---|---|
apiId | The unique identifier for the API. Example: af70b2de-c9c5-4f40-94be-7d8622743e42 |
apiName | Name of the API in which the event occurred. Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
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. If invocations fail due to policy violations, this parameter could still be as high as 100. Example: 100.0 |
avgResponseTime | The average amount of time it took the API to complete each invocation in the current interval. Response time is measured from the moment API Gateway receives the request until the moment it returns the response to the caller. Example: 1376 |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: PerformanceData |
faultCount | The number of failed API invocations in the current interval. Example: 1 |
includeFaults | Includes failed API invocations. Possible values are: true, false |
intervalStart | The starting date and time from which you want to examine metrics. Example: 02 Aug 2017 10:51:31 GMT |
intervalStop | The ending date and time until which you want to examine metrics. Example: 02 Aug 2017 10:52:31 GMT |
maxResponseTime | The maximum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 1401 |
minResponseTime | The minimum amount of time (in milliseconds) it took for the API to complete an invocation in the current interval. Example: 1352 |
sourceGatewayDetails | Details of events generated only from Microgateway. The details include Microgateway Id, Source Gateway Host, Source Gateway Port, Source Gateway Version, Microgateway pool. |
sourceGateway | Source of event generation. Possible values: APIGateway or Microgateway. |
operationName | Name of the API operation that is invoked. Example: /pet/{petId} |
successCount | The number of successful API invocations in the current interval. Example: 1 |
totalCount | The total number of API invocations (successful and unsuccessful) in the current interval. Example: 2 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured Email destination. The columns that make up the events and metrics data model for Email are listed below:
Column | Description |
---|---|
apiName | Name of the API in which the event occurred. Example: SampleAPI |
consumerId | The unique identifier for the consumer associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
consumerName | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a security policy that is configured for the API. Example: SampleApplication |
CorrelationID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
Description | Message that describes the date and time the API was invoked and the application associated with the API invocation. Invoked at 4/24/18 1:50 PM Consumer Name: Unknown Consumer ID: Unknown |
ErrorOrigin | The origin of error. Example: Nativeservice |
External Calls | List the external calls from API Gateway. These external calls can be to a native service or service registry. Example: [{"externalCallType":"SERVICE_REGISTRY_CALL","externalURL":"http://service.registry.com","callDuration":49,"callStartTime":1562244570486,"callEndTime":1562244570535,"responseCode": "200"},{"externalCallType":"NATIVE_SERVICE_CALL","externalURL":"https://petstore.swagger.io/v2/store/inventory","callDuration":1285,"callStartTime":1562244569252,"callEndTime":1562244570537,"responseCode":"200"}] |
Native Endpoint | The endpoint URL of the native API being invoked. Example: http://petstore.swagger.io/v2/pet/55 |
Native HTTP Method | The HTTP method used to invoke the native service. Example: GET. |
Native Request Headers | Request header in the incoming request from the API Gateway to native service. Example: {"Authorization":"**************","Accept": "*/*","Authorization": "**************", "Accept":"*/*","Cache-Control": "no-cache","User-Agent": "PostmanRuntime/7.13.0","Postman-Token":"381424fa-e3b3-4058-8df9-4abf9d72c899", "postmanHeader": "hello","accept-encoding": "gzip, deflate", "Content-Type": "application/x-www-form-urlencoded"} |
Native Req Payload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
Native Response Headers | Response header in the outgoing response from the native service to API Gateway. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods": "GET, POST, DELETE,PUT","Connection":"close","Date": "Fri, 07 Jun 2019 12:44:13 GMT","Access-Control-Allow-Headers": "Content-Type,api_key, Authorization","Content-Type": "application/json"} |
Native Res Payload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
Native URL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
Operation/Resource Name | Name of the operation or resource that is being invoked on the API. Example: /pet/{petId} |
Policy Action Name | Name of the runtime policy that is enforced on the API. Example: Log Invocation |
Source Gateway Node | Source API Gateway’s IP address. Example: 10.0.75.1 |
Status | Status of the API invocation. Possible values are: SUCCESS, FAILURE |
Version | The system-assigned version identifier for the API. Example: 1.0 |
Column | Description |
---|---|
apiname | Name of the API in which the event occurred. Example: SampleAPI |
alertSource | The type of alert generated for the event. Example: Monitor |
alertType | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: Test |
apiGWHostName | Name of the host which serves the request. Example: SAG-HS09MG2 |
monitorAttr | The monitored attribute which has breached the configured SLA. Example: AVGRESPONSETIME GT 1.0, SUCCESSCOUNT EQ 3, REQUESTCOUNT GT 10 |
applicationId | The unique identifier for the consumer associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationName | Name of the consumer associated with the API invocation. A consumer name is populated as unknown when API Gateway is unable to identify the consumer using a policy that is configured for the API. Example: SampleApplication |
Native Endpoint | The endpoint URL of the native API that is being invoked. Example: http://petstore.swagger.io/v2/pet/55 |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
The runtime events and metrics payload generated by API Gateway at run-time is published to the configured Local Log destination. The columns that make up the events and metrics data model for Local Log are listed below:
Column | Description |
---|---|
apiName | Name of the API in which the event occurred. Example: SampleAPI |
ApiVersion | The system-assigned version identifier for the API. Example: 1.0.0 |
Application ID | The unique identifier for the application associated with the API invocation. Example: 7908eb44-d107-4670-929d-89111fc9347c |
ApplicationIP | IP address of the application associated with the API invocation. Example: 10.60.37.42 |
Application Name | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
Correlation ID | The unique identifier that is automatically generated for every request coming to API Gateway and can be used to query the log. Example: MED38e9cfa4-2348-408b-9462-124b2181c1a6:656 |
customFields | The custom fields an API Provider can provide to log a new field and value for a transaction event. Example: {“customfield”:“customvalue”} |
Error Origin | The origin of error. Example: Nativeservice |
EventSource | The source where the event occurred. Example: API_Gateway_Instance |
Native HTTP Method | The HTTP method used to invoke the native service. Example: GET. |
nativeRequestPayload | The native service request data. Example: {"param1" : "value1", "param2" : 10} |
nativeResponsePayload | The native service response data. Example: {"id":2,"category":{ "id":2, "name":"string"},"name":"pysen","photoUrls":["string"],"tags":[{"id":0, name":"string"}],"status":"available"} |
Native URL | URL of the native service. Example: http://petstore.swagger.io/v2/pet/2 |
Operation/Resource name | Name of the API operation or resource that is invoked. Example: /pet |
Partner ID | The unique identifier for the partner that generated the audit record. Example: unknown |
queryParams | This is applicable only for REST APIs. Query parameters present in the incoming REST request. Example: {“status”:“available”} |
RequestHeaders | Request header in the incoming request from the client. Example: {"Cache-Control":"max-age=0","Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8","Upgrade-Insecure-Requests":"1","Connection":"keep-alive","User-Agent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36","Host":"mcdaso02:5555","Accept-Encoding":"gzip, deflate","Accept-Language":"en-US,en;q=0.9,ta;q=0.8","Content-Type":"application/x-www-form-urlencoded"} |
ResponseHeaders | Response header in the outgoing response. Example: {"Server":"Jetty(9.2.9.v20150224)","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, DELETE, PUT","Connection":"close","Date":"Fri, 30 Mar 2018 08:25:45 GMT","Access-Control-Allow-Headers":"Content-Type, api_key, Authorization","Content-Type":"application/xml"} |
SessionId | A string the API Gateway server generates to uniquely identify each session. This is either the IS session token or the automatically generated GUID if the token is missing from the message context. Example: 81439d366e874bc79d9f81490e30e6e0 |
Source Gateway Node | Source API Gateway’s IP address. Example: 10.0.75.1 |
TargetEPR | The endpoint URL of the native API that is invoked. Example: http://petstore.swagger.io/v2/pet/55 |
Column | Description |
---|---|
alertDesc | Text of the alert message sent to a configured destination when the performance conditions are violated. The alert message is specified in the policy definition of an API. Example: EnforcePolicy-HardLimit |
alertSource | Name of the API Gateway policy that generated the alert message. Example: Unknown-Policy |
apiName | Name of the API in which the event occurred.Example: Example: SampleAPI |
apiVersion | The system-assigned version identifier for the API. Example: 1.0 |
applicationId | The unique identifier for the application associated with the API invocation. Example: c0f84954-9732-11e5-b9f4-f159eafe47b2 |
applicationIp | IP address of the application associated with the API invocation. Example: 10.20.248.33 |
applicationName | Name of the application associated with the API invocation. An application name is populated as unknown when API Gateway is unable to identify the application using a security policy that is configured for the API. Example: SampleApplication |
creationDate | Date and time when the event was generated in API Gateway. Example: 1501671101509 |
eventType | The type of event that occurred. Example: Policy Violation Event |
monitorAttr | The monitored attribute which has breached the configured SLA. Example: AVGRESPONSETIME GT 1.0, SUCCESSCOUNT EQ 3, REQUESTCOUNT GT 10 |
Native Endpoint | The endpoint URL of the native API that is invoked. Example: http://petstore.swagger.io/v2/pet/55 |
Operation/Resource name | Name of the API operation or resource that is invoked. Example: /pet |