This page applies to Apigee and Apigee hybrid.
View
Apigee Edge documentation.
What does this dashboard tell me?
The Geomap dashboard tracks traffic patterns, error patterns, and quality of service across geographical locations. You can view information about all your APIs, or zoom in on specific ones. This dashboard helps you assess:
- API growth trends - Use the Sum of traffic metric to see where your traffic is coming from. By using different time periods you can see which countries generate the most traffic at which times. You can also record traffic rates over different time periods to see trends in growth.
- Error trends - Use the Sum of error count metric to see where API errors are coming from. By using different time periods you can see which countries generate the most errors at which times. You can also record error rates over different time periods to see trends in growth.
- Quality of service - Use the Average of total response time and Average of target response time metrics to see how your backend services are performing by country.
The Geomap Dashboard
To access the Geomap dashboard:
- If you are using the Apigee UI in Cloud console: Select Analytics > End user analysis and click the Geomap tab.
- If you are using the classic Apigee UI: Select Analyze > End Users > Geomap.
The dashboard opens as shown below (Cloud console version):
What does this dashboard measure?
By default, the dashboard displays the Sum of traffic metric. The following table describes each of the metrics tracked by the Geomap dashboard:
| Metric | Description |
|---|---|
| Sum of traffic | Also known as throughput. The number of API requests and resulting responses seen by the organization. |
| Sum of error count | The total number of all API requests that are unsuccessful, that is, the request does not deliver a response as desired by the end user. |
| Average of total response time | The time an API takes to respond to an incoming request. |
| Average of target response time | The average time it takes the target endpoint to respond to an incoming request for the selected period. |
Using the Cloud Console version of the dashboard
The dashboard has a set of dropdown menus that you can use to filter the information shown in it. The filter dropdown menus are dynamic. For example, if you select an environment from the Environments dropdown, then any proxies, hostnames, countries, and regions associated with that environment are automatically selected in the other dropdown menus, charts, and tables. For more information, see About filter properties in the Looker Studio documentation.
Use the date selector to pick a start and end date to measure. The date selector only lets you select dates in day increments. You can't select a time range increment that is smaller than a day.
The map is interactive. Click a country to see traffic for that country. You can right-click a data table for actions like sorting and exporting data.
What else do I need to know about this dashboard?
By default, the dashboard displays metrics for all API proxies. Alternatively, select an API proxy to measure from the Proxies dropdown menu.
Select an entry under the Countries and Geographical regions lists to drill down on specific countries, states, and cities (depending on the specific geography of the country you are interested in). For example, you can look at United States data, then select a geographical region, and then view a list of cities from which traffic is generated. You can click a city name in the table to see traffic for that city.
This dashboard uses standard controls, like the date selector, hovering over maps for more context, exporting data to CSV, and so on. To learn more, see Using the analytics dashboards.
Make a copy in Looker Studio
If you are using this dashboard in Google Cloud console, you can edit, save, and share a copy of the dashboard in Looker Studio. To get started:
- Click Make a copy in Looker Studio.
- From the dropdown menu, select the report you wish to copy.
- In Looker Studio, click Save and share.
- Click Acknowledge and save.
You can now edit the copy saved in your user account. For details on using Looker Studio to edit and create reports, see the Looker Studio documentation.