The API Metrics Dashboard gives your ReadMe project administrators the ability to segment your APIs logs by response status code, endpoint, request method, user or any combination of those four filters.
After you set up API Metrics (see Getting Started With API Metrics), you can view the API Metrics Dashboard at dash.readme.io/project/
There are three overall sections of the dashboard:
- Search/Filter Bar
- Overview Cards
- Detailed Logs
Select one or any combination of the following categories to segment the logs.
- HTTP Response Status Code
- HTTP Request Method (GET, PUT, POST, DELETE, etc.)
To use the search bar, select a category and type in a search term. The results of the filtered segment will appear in the overview cards and detailed log.
Note that "User" is defined depending on how you identify your own API users in your database. So, a "user" may refer to one person or a group of people using a single API key, for example. You configure the user's identifier and label when you set up API Metrics.
The three cards display the following information based on the currently filtered segment:
- Top Metrics — Users and Endpoints with the highest API usage
- Status Codes — Pie chart and list overviews of HTTP response status codes
- Usage Metrics — Total Calls, Total Users, Average Response Time, Average Calls Per Project
With these overview cards, you can get answers to many important questions about your API usage at a glance:
- Who are my most/least frequent users?
- How are my endpoints performing overall?
- Which users are having troubles?
- Which endpoints are causing troubles?
Read more about the insights that API Metrics can provide here.
Based on the currently filtered segment, you have access to the full list of logs for every call made to your API. At a glance, you'll be able to see the following information in your full list of logs:
- Request Method
- Response Status Code
- User (this will be whatever you send in to label/identify your users when configuring API Metrics)
- User Agent (i.e. info about the user's browser, operating system, application, etc.)
When you click on individual logs, you'll be able to see additional details:
- Request Headers
- Response Headers
- Response Body
What Can You Do with This Information?
With the ability to view detailed logs about your API usage and see exactly what customers send you and what you're sending back, troubleshooting issues will be a breeze.
Updated 8 months ago