Skip to main content

Enforcing Allocations

This page explains how to set and monitor allocations for your organization’s groups. When a group reaches its allocation total, its users will no longer be able to start clusters.

You can also set custom allocation thresholds for your organization. This feature can alert users when their group approaches its allocation total as well as freeze or shut down clusters when an allocation total is reached.

Note

The steps included on this page can only be completed by ACTIVATE platform administrators and users with the org:admin role. For more information, please see About Group Roles.

Setting Allocations

Navigate to your Organization settings.

Screenshot of the user selecting Organization from the User dropdown menu.

On the next page, click Groups.

Screenshot of the user selecting Groups in their organization settings.

In the Groups tab, click Edit Cost Allocations.

Screenshot of the user clicking the Edit Cost Allocations button.

Enter a value in the Allocation Total field. This number is measured in U.S. dollars.

Click Save Allocations.

Screenshot of the user clicking Save Allocations.

Once you've set an allocation total, a group's accumulated costs will appear in the Allocation Used column.

Screenshot of the allocation usage appearing in the Allocation Used column.

Setting Allocation Thresholds

Navigate to your organization settings (Username > Organization).

Screenshot of the user selecting Organization from the User dropdown menu.

On the next page, click Add Allocation Threshold.

Screenshot of the user clicking the Add Allocation Threshold button.

Configure Allocation Thresholds

You can configure your allocation threshold with the settings outlined below.

Screenshot of all allocation threshold settings.

Threshold(%)

Use this field to set the allocation threshold as a percentage from 0 to 100. For example, if a group’s allocation total is $5,000, an 85% threshold will affect users when their total spend reaches $4,250.

Name

Use this field to name your threshold. Common names for thresholds include warning and shutdown.

Please note that this field must be one word, lower-cased, and contain no numbers or special characters.

Description

Use this field to enter a description for the alert icon that appears on clusters. When users mouse over the icon, this Description appears as a tool tip.

Screenshot of tooltip on an allocation warning on the Home page.

Label Color

Use this selection tool to choose the color of the alert icon that appears on clusters. Click on the colored box to expand it into a color dropper.

Screenshot of color dropper expanding into the color selection tool.

Click the arrows to cycle the color fields between RGB, HSL, and Hex values.

Use Realtime Data

Use this toggle button to enable real-time cost tracking for your threshold.

By default, this option is set to No. If you don’t enable real-time cost tracking, the cost tracking will be calculated using the true cost data from CSPs.

Actions

Use this dropdown menu to select the action for your threshold. Options include:

  • Notify: Users receive an alert via email.
  • Freeze: Users will not be able to start new clusters.
  • Shutdown: All clusters will be shut down.

You can select more than one action at a time for your threshold alert, especially if you want users to receive a notification for freeze or shutdown. For more info, please see Alert Content Template below.

Alert Subject

Use this field to enter a subject for your alert email.

Send To Group

Use this toggle button to send the alert email to all users in a group whenever it reaches its allocation threshold.

By default, this option is set to Yes.

Extra Recipients

Use this field to enter email addresses for additional users who will receive the threshold alert email.

Alert Content Template

Use this field to enter the text of the threshold alert email.

Each action has a default email template that populates this field. You can change the text or replace it completely.

If you write your own alert template, you can use the variables below in the body of your message. The variables will automatically be filled in with the correct information.

  • {allocation}: a group’s total budget allocation
  • {allocation_used}: a group’s current total spend
  • {allocation_used_percent}: the percentage of allocation a group has used
  • {estimated_allocation_used}: a group’s current estimated (real-time) total spend
  • {estimated_allocation_used_percent}: the estimated (real-time) percentage of allocation a group has used
  • {group}: a group’s name
  • {name}: the threshold’s label you entered in the Name field
  • {organization}: your organization’s name
  • {threshold}: the value you entered in the Threshold(%) field
About Alerts

If you want users to be notified about a threshold for the freeze or shutdown actions, you have to add the notify action too.

Save Allocation Thresholds

After you’ve customized the settings above, click Save Allocation Threshold.

Screenshot of the user clicking the Save Cost Allocations button.

Your new allocation threshold will appear in your organization’s settings.

Screenshot of the new allocation appearing in the user's organization settings.

Editing Allocation Thresholds

In your organization’s settings, click the edit icon to change an allocation threshold.

Screenshot of the user clicking the delete icon.

Next, you’ll see the threshold’s configuration page, where you can edit any of the settings in Threshold Configuration above.

Click Save Allocation Threshold when you’re done making changes.