Docs » Create and manage access tokens » Manage resource usage with access tokens

Manage resource usage with access tokens 🔗

If you have Infrastructure Monitoring Enterprise Edition, you can manage costs associated with sending in data by setting limits on access tokens.

Regardless of the edition you’re using, access tokens also help you control the rate at which you use Infrastructure Monitoring resources. This feature enables you to provide exemplary performance in the user interface.

Token limits per pricing plan 🔗

The limits you can set for a token depend on your pricing plan. Each limit represents the maximum number of resources that can use a specific access token. The following table describes the limits for each pricing plan:

Pricing plan

Available limits

DPM

Maximum data points per minute from all hosts

Host-based pricing

One or more of the following limits:

  • Hosts

  • Docker containers

  • Custom metrics

  • High-resolution metrics

Usage-based pricing

One or more of the following limits:

  • Custom metrics

  • High-resolution metrics

Set up access token limits and alerts 🔗

To set token limits:

  1. Select Manage Token Limit from the token’s actions menu. The Manage Token Limits options appear. Depending on your pricing model, you see up to four cost-related token limits you can set. You can also set the Job Start Rate and Event Search Rate rate-related limits.

  2. Enter a value for the limit or limits you want to set.

    • For cost-related limits, to remove an existing limit, click Remove Limit.

    • For rate-related limits, to remove an existing limit, delete everything from the text box.

  3. To send a notification to recipients when a cost-related usage exceeds one of the limits, click Add Recipient and select the recipient or notification method you want to use.

  4. Click Update.

Set up custom alerts for use with access tokens 🔗

You can create a regular detector to set up an alert for a token when its usage has reached a different level than 90%. You can also use a detector to monitor resource usage by a token if the resource isn’t part of the limits provided by Infrastructure Monitoring.

You can’t set up alerts or notifications for rate-related token limits.

To track token usage, use one of the following metrics:

  • sf.org.numResourcesMonitoredByToken (for hosts and containers)

  • sf.org.numCustomMetricsByToken

  • sf.org.numHighResolutionMetricsByToken

In your detector, filter these metrics using the property tokenName to identify the token you want to monitor.

Manage resource usage for a team 🔗

To manage resource usage by team:

  1. Create a token you want team members to use.

  2. Set limits for the token.

  3. Tell team members to use the specified token when sending data to Infrastructure Monitoring.

Monitor access token usage 🔗

To see usage status for an access token:

  1. Navigate to your profile page.

  2. In the area that lists your organization, click Access Tokens.

  3. Click the token name. The details for the token appear. The display is specific to your pricing model and the limits you’ve set.

Tokens can be Above Limit, Close to Limit, or Below Limit. Token status is Close to Limit if the usage of any of its limits is greater than or equal to 90%.

The usage status is the status of the usage that’s closest to its limit. For example, suppose you have set limits for both Hosts and Custom Metrics for a token. The tokens page will show the usage for the token as Above Limit if the Hosts usage is above its limit, even if the Custom Metrics value is below its limit.

To view usage values for a token, hover over its usage status. To display more detailed information for the token, click the token name.

If API requests are using the token to send data to Infrastructure Monitoring, a chart shows how much ingest levels in the past seven days for each usage limit. The chart displays data at a one-hour resolution.

Infrastructure Monitoring monitors the token whether you set limits for the token or not.