Usage

Learn how to use the usage page to monitor usage of ArcGIS Location Platform services, such as places, geocoding, routing, and others. Additionally, this tool displays usage statistics for hosted data such as feature data, files, map tiles, vector tiles, and scene services within ArcGIS.

The usage page breaks down usage by service type, illustrating usage trends over time. This breakdown enables you to precisely track where your resources are allocated and identify areas that may require optimization or attention. On this page, you will find a list of services, offering the flexibility to display either all available services or filter the list of services to those with or without usage, by date ranges, by specific developer credentials, or data services. You can expand the usage details for each service as required, providing deeper insights into their usage patterns.

Date range filter

Use the date range filter to define the range of dates you want to use to review service usage. The options are:

Current billing cycle: consider usage from the first day of the billing cycle up to and including today. Note that for today, not all service usage may be recorded until the conclusion of the billing day as each service has different recording and logging procedures and may not be immediately reflected in your usage graph.

Last 30 days: review usage recorded in the past 30 days up to today.

Last 60 days: review usage recorded in the past 60 days up to today.

Custom date range: when you select a custom date range you enter the first day and the last day to consider for usage activity. The maximum range of dates cannot exceed 60 days.

All services

All services displays a list of all ArcGIS Location Platform services and hosted data storage recorded to your account (across all your developer credentials and other usage metered to your logged in user), along with their respective usage metrics. You can filter the list of displayed service usage by type of usage (show all services, show only services with recorded usage, or show only services without recorded usage) and billing cycle date range filters.

Developer credentials

You can select a specific developer credential (API keys and OAuth applications) to review service usage recorded to that credential. A list of available developer credentials appears in the left-side panel. You can filter this list based on various criteria including tags, type of credential, or a search phrase checked against the item name and title. The credential list can also be sorted alphabetically or by last modified date.

Once you select a specific credential from the list, the item information appears along with the service usage graph. The data shown is filtered by the date range you selected. Each item can be expanded to display a calendar where you see each date usage was recorded. The amount of usage appears in the table, and you can roll-over a spark-line dot or the calendar date to view the exact amount of usage recorded on that day.

In the item details panel there are two buttons:

• Manage credential will navigate to the portal item page where you can update the item meta data and credential properties.
• Download CSV to download a CSV file containing the usage data shown in the usage graph.

You can alter the date range for the usage graph by selecting the desired date range in the drop-list control near the top of the page. Current billing cycle, Previous billing cycle, and the list of Previous billing periods are all aligned to your billing start date to match the given billing period. The Custom date range option will prompt for a start and end date. This date range cannot exceed 60 days.

You can also generate a single CSV report that includes all your developer credentials that have recorded usage in a request billing period or date range. To do this, click on the Create report button near the top-right area of the page. A modal dialog appears prompting you for the time period you wish to report on and the file name for your report.

Layers and data services

The Layers and data services tab display a list of your hosted data types such as feature layer, tile layer, and scene layer. Usage for these services are recorded as query and edit bandwidth in bytes. A list of available services appears in the left-side panel. You can filter this list based on various criteria including tags, type of service, or a search phrase checked against the item name and title. The service list can also be sorted alphabetically or by last modified date.

Once you select a specific service from the list, the item information appears along with the service usage graph. The data shown is filtered by the date range you selected. Each item can be expanded to display a calendar where you see the dates usage was recorded. The amount of usage appears in the table, and you can roll-over a spark-line dot or the calendar date to view the exact amount of usage recorded on that day.

In the item details panel there are two buttons:

• Manage layer and service will navigate to the portal item page where you can update the item meta data.
• Download CSV to download a CSV file containing the usage data shown in the usage graph.

Download usage CSV for single developer credential

When you select a specific developer credential or data service and date range you can download a CSV of the usage activity recorded to that resource. The CSV file contains the following data:

• Title: item title.
• Description: item description.
• Tags: tags assigned to the item.
• Created date: date in UTC when the item was created.
• Modified date: date in UTC when the item as last updated.
• Report start date: date in UTC when the recorded usage activity begins.
• Report end date: date in UTC when the recorded usage activity ends.
• Scoped services: a list of the scoped privileges assigned to the item.
• Service list: for each service with recorded usage during the select date range, the recorded value and unit type appears in separate columns in the report. Services that are scoped but do not have usage activity in the selected date range will not appear.

Download usage CSV for all developer credentials

When you generate the service usage report for all your developer credentials, the CSV file contains the following information based on the location services that recorded usage in the selected time period:

• Title: item title assigned to the developer credential.
• Tags: tags assigned to the item.
• Short Description: item description.
• Item ID: The unique item ID assigned by your portal.
• Client ID: The unique client ID assigned to your developer credential.
• Service: The service name with usage. A separate row appears for each individual location service that recorded usage in the selected time period.
• Amount: The amount of usage that was recorded. The meaning of the amount is based on the type of units recorded for each individual service.
• Unit: The unit of measure for the type of service (requests, bytes, tiles, geocodes, reports, etc.)

Portal usage report

You can also generate a usage report from your portal. Follow these steps:

1. Log in to your ArcGIS Location Platform account, and then navigate to your portal by clicking My portal .
2. From your portal, navigate to Organization > Status > Reports.
3. Click Create report.
4. Click Single report.
5. From the list of available reports, click Service usage.
6. The report modal appears where you can edit the report name and select a range of dates to include in your report. Select your desired date range: week, month, quarter, and refine the date range using the date pickers.
7. Click Create report.

After a short time to process your request a report will appear in your report list. Click download to download the CSV file, or select any of the other options in the menu.

Your CSV file contains the following data:

• StartTime: start time of the report in Unix timestamp format in GMT.
• EndTime: end time of the report in Unix timestamp format in GMT.
• Key: A list of your developer credentials that have usage recorded in the time period selected.
• Title: The title assigned to this item.
• Item ID: The unique portal item ID assigned to your item.
• ClientID: The client ID assigned to your developer credential.
• APIKey: The API key value. This is only for legacy API keys, otherwise it is blank.
• Owner: The user in your organization who owns this item.
• Service Type: The location service usage that was recorded.
• Service Usage: The usage value for the selected time period. The units of these values will differ depending on the service type.

Portal item report

You can generate a report that details the items and storage consumed with your account. Follow these steps:

1. Log in to your ArcGIS Location Platform account, and then navigate to your portal by clicking My portal .
2. From your portal, navigate to Organization > Status > Reports.
3. Click Create report.
4. Click Single report.
5. From the list of available reports, click Item.
6. The report file name is pre-filled, you can edit this field to choose a different name for your report.
7. Click Create report.

After a short time to process your request a report will appear in your report list. Click download to download the CSV file, or select any of the other options in the menu.

Your CSV file contains the following data:

• Title: The title assigned to this item.
• Item ID: The unique portal item ID assigned to your item.
• Item Url: The service URL of your hosted data service, if one exists for the item.
• Item Type: The type of item.
• Date Created: Date in UTC when the item was created.
• Date Modified: Date in UTC when the item as last updated.
• Content Category: The category of the type of item, if it applies to this item.
• View Counts: The number of times the item page was viewed.
• Owner: The user ID of the owner of the item.
• File Storage Size: The number of megabytes the item consumes in Tiles, Files, and Attachments storage.
• Feature Storage Size: The number of megabytes the item consumes in Features storage.
• Share Level: How the item is shared, private, org (group), or public.
• # of Groups shared with: The number of groups the item is shared with.
• Tags: tags assigned to the item.
• Number of Comments: The number of user comments on the item.
• Is Hosted Service: TRUE if this is a hosted data service.
• Date Last Viewed: The date in UTC when the item page was last viewed.
• In Recycle Bin: Yes if this item is currently in the recycle bin scheduled for future deletion