The API dashboards provide charts to monitor API usage, which gives you insight into how your APIs are used and how they are performing.
If you have enabled API auto-discovery, your API metrics are available in the API dashboards in Anypoint Monitoring.
The enhanced metrics view includes detailed information about your APIs, and charts are sorted into dashboards based on the type of data displayed.
Charts displaying the Last 1 hour label show data that was collected during the past 60 minutes, starting with the current time.
|
Note
|
For Gold and Platinum subscriptions, Anypoint Monitoring retains API metrics data for 30 days. API Manager retains API metrics data for 30 days. |
-
In the sidebar, click Built-in dashboards.
-
In Built-in dashboards, select the Environment, Resource name, and Version/Instance for the API to view.
-
Click View.
On the dashboard, you can view information about a running, managed API.
-
Select the date and time range to view the statistics for and click Confirm.
API dashboards provide you with various pages from which you can view different types of charts.
The following charts are available in the enhanced metrics view for APIs:
| API Dashboards | Charts |
|---|---|
|
|
|
|
|
|
|
|
|
The following charts appear on the Overview dashboard:
- Request Volume
-
The sum of requests in the selected time period for the given API. Data is aggregated in one minute increments.
- Failed Requests
-
The sum of failed requests in the selected time period for the given API. Data is aggregated in one minute increments.
- Total 4xx Errors
-
The sum of 400 errors (such as 404, 408, and so on) in the selected time period for the given API.
- Total 5xx Errors
-
The sum of 500 errors (such as 500, 502, and so on) in the selected time period for the given API.
- Policy Violations
-
The sum of requests for policy violations in the selected time period, grouped by policy violation ID. Data is aggregated in one minute increments.
- Average Response Time
-
The average response time of requests in the selected time period for the given API. Data is aggregated in one minute increments.
The following charts appear on the Requests dashboard:
- Requests
-
The sum of requests in the selected time period, grouped by the top N paths. By default, N is 100.
-
If you select a time range within the last hour, data is aggregated in one minute increments.
-
If you select a time range within the last day, data is aggregated in ten minute increments.
-
If you select a time range that is larger than one day, data is aggregated in one hour increments.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
-
- Requests by Method
-
The sum of requests in the selected time period, grouped by method. Data is aggregated in one minute increments.
- Requests by Response Code
-
The sum of requests in the selected time period, grouped by response code. Data is aggregated in one minute increments.
- Requests by Request Size
-
The sum of requests in the selected time period, grouped by request size. Data is aggregated in one minute increments.
- Requests by Response Size
-
The sum of requests in the selected time period, grouped by response size. Data is aggregated in one minute increments.
The following charts appear on the Failures dashboard:
- Failures
-
The sum of failed requests in the selected time period, grouped by the top N paths. By default, N is 100.
-
If you select a time range within the last hour, data is aggregated in one minute increments.
-
If you select a time range within the last day, data is aggregated in ten minute increments.
-
If you select a time range that is larger than one day, data is aggregated in one hour increments.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
-
- Failures by Method
-
The sum of failed requests in the selected time period, grouped by method. Data is aggregated in one minute increments.
- Requests by Response Code
-
The sum of failed requests in the selected time period, grouped by response code. Data is aggregated in one minute increments.
- Requests by Request Size
-
The sum of failed requests in the selected time period, grouped by request size. Data is aggregated in one minute increments.
- Requests by Response Size
-
The sum of failed requests in the selected time period, grouped by response size. Data is aggregated in one minute increments.
These charts appear on the Performance dashboard:
- Requests by Performance
-
The average request response times, grouped by path.
-
If you select a time range within the last hour, data is aggregated in one minute increments.
-
If you select a time range within the last day, data is aggregated in ten minute increments.
-
If you select a time range that is larger than one day, data is aggregated in one hour increments.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
-
- Slow Requests
-
The average response times that are greater than one second, grouped by path.
reuse::partial$billing/pricing.adoc-
If you select a time range within the last hour, data is aggregated in one minute increments.
-
If you select a time range within the last day, data is aggregated in ten minute increments.
-
If you select a time range that is larger than one day, data is aggregated in one hour increments.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
-
The following charts appear on the Client Applications dashboards:
- Requests by Client ID
-
The sum of requests in the period, grouped by client ID. Data is aggregated in one minute increments.
- Requests by Client IP
-
The sum of requests in the period, grouped by client IP address.
-
If you select a time range within the last hour, data is aggregated in one minute increments.
-
If you select a time range within the last day, data is aggregated in ten minute increments.
-
If you select a time range that is larger than one day, data is aggregated in one hour increments.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
-
- Requests by Location
-
The sum of requests during the time period specified, grouped by country. Data retention for the Requests by Location chart is one hour.
NoteThis metric isn’tn supported for APIs deployed through Omni Gateway (formerly Flex Gateway).
For information about chart metric collection, including the chart group Other, see How Endpoint and Operation Use Metrics Are Gathered.
reuse::partial$billing/pricing.adoc
You can access API analytics metrics data directly via the Anypoint Monitoring Archive API. Using this API, you can navigate and discover your API metrics data using a directory hierarchy.
The Anypoint Monitoring Archive API enables you to download files that contain JSON objects that represent one or more metric events. You can write an application to navigate the data collected by the API and integrate it into your own system.
You can also enable non-aggregated API events by setting this property: anypoint.platform.config.analytics.agent.api_raw_metrics.enabled=true.
These events contain more detailed information about each API invocation and can be accessed using the Anypoint Monitoring Archive API under the raw file type.
For more information about this API, see Anypoint Monitoring Archive API in Anypoint Exchange.
Charts and visualizations in the built-in dashboards and Anypoint Insights share API metrics.