Using Built-in API Dashboards | MuleSoft Documentation
# Using Built-in API Dashboards
The API analytics 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 analytics 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.
For Gold and Platinum subscriptions, Anypoint Monitoring retains API analytics metrics data for 30 days. API Manager retains API analytics metrics data for 30 days.   
---  
## Supported Versions of Mule Runtime Engine
Run your Mule app on a supported Mule runtime version. For supported versions, see Mule Runtime Release Notes.
## View the API Analytics Dashboard
  1. Log in to Anypoint Platform with a user account that has permission to access Anypoint Monitoring content.
  2. Navigate to **Anypoint Monitoring**.
  3. From the sidebar, click **Built-in dashboards**.
  4. In **Built-in dashboards** , select the **Environment** , **Resource name** , and **Version/Instance** for the API to view.
  5. Click **View**.
On the API analytics page, you can view information about a running, managed API.
  6. Select the date and time range to view the statistics for and click **Confirm**.
  7. To view API analytics metrics in API Manager, click the **View API in API Manager** link.


## Enhanced Metrics View for API Analytics Dashboards
API analytics 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 API analytics:
API Analytics Dashboards | Charts  
---|---  
Overview Charts | 
  * Request Volume
  * Failed Requests
  * Total 4xx Errors
  * Total 5xx Errors
  * Policy Violations
  * Average Response Time

  
Requests Charts | 
  * Requests
  * Requests by Method
  * Requests by Response Code
  * Requests by Request Size
  * Requests by Response Size

  
Failures Charts | 
  * Failures
  * Failures by Method
  * Requests by Response Code
  * Requests by Request Size
  * Requests by Response Size

  
Performance Charts | 
  * Requests by Performance (line chart)
  * Requests by Performance (table)
  * Slow Requests (Anypoint Integration Advanced package or Titanium subscriptions only)

  
Client Applications Charts | 
  * Requests by Client ID
  * Requests by Client IP
  * Requests by Location

  
### Overview 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.
### Requests Charts
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.


This metric is not supported for APIs deployed through 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.
### Failures Charts
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.


This metric is not supported for APIs deployed through 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.
### Performance Charts
The following charts appear on the **Performance** dashboard: 

Requests by Performance (line chart)
    
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.


This metric is not supported for APIs deployed through Flex Gateway. 

Requests by Performance (table)
    
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.


This metric is not supported for APIs deployed through Flex Gateway. 

Slow Requests
    
The average response times that are greater than one second, grouped by path. This chart is available only if your organization has the Anypoint Integration Advanced package or a Titanium subscription to Anypoint Platform.
  * 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.


This metric is not supported for APIs deployed through Flex Gateway.
### Client Applications Charts
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.


This metric is not supported for APIs deployed through Flex Gateway.
This metric is not supported for APIs deployed through Flex Gateway. 

Slow Requests
    
The average response times that are greater than one second, grouped by path. This chart is available only if your organization has the Anypoint Integration Advanced package or a Titanium subscription to Anypoint Platform.
  * 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.


This metric is not supported for APIs deployed through Flex Gateway.
### Client Applications Charts
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.


This metric is not supported for APIs deployed through 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.
This metric is not supported for APIs deployed through Flex Gateway.
For information about chart metric collection, including the chart group **Other** , see How Endpoint and Operation Use Metrics Are Gathered.
## Endpoint and Operation Metrics Collection (Other Group)
Anypoint Monitoring collects top occurring endpoints or operations for each data collection interval. Endpoints or operations that are not top occurring are sorted into a group called **Other**.
In each data collection interval, top occurring endpoints or operations vary. An endpoint or operation that is top occurring in one interval might not be top occurring in the next.
In Anypoint Monitoring charts and tables, the data comes from multiple data collection intervals. As a result, aggregated data shown in the dashboard is an estimation since the intervals might not have the same top occurring endpoints or operations. The tables show approximate counts for the most commonly occurring endpoints or operations when the **Other** grouping appears.
For example, when an endpoint occurs more often than other endpoints in one interval but less often in another interval, Anypoint Monitoring sorts it into the Other group for the first interval. In this case, the resulting table displays lower than actual values for that endpoint, since the metrics that do not appear are grouped into the **Other** group.
## Anypoint Monitoring Archive API
**Feature available inAdvanced usage and Titanium subscription tiers**  
---  
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.
## Charting Inactivity for Average Response Time
To ensure charts are plotted continuously without interruptions, all average response time charts use a straight line to connect the last available value that precedes a period of app or API inactivity with the next available value. To understand activity in average response time charts, consider behavior in related charts, such as request counts, to get a holistic idea of your API or app’s activity.
## See Also
Anypoint Monitoring Archive API