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.
Navigate to your Organization settings.
On the next page, click Groups.
In the Groups tab, click Edit Allocations.
Enter a value in the Allocation Total field. This number is measured in U.S. dollars.
Click Save Allocations.
Once you've set an allocation total, a group's accumulated costs will appear in the Allocation Used column.
Navigate to your organization settings (Username > Organization).
On the next page, click Add Allocation Threshold.
You can configure your allocation threshold with the settings outlined below.
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.
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.
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.
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.
Click the arrows to cycle the color fields between RGB, HSL, and Hex values.
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.
Use this dropdown menu to select the action for your threshold. Options include:
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.
Use this field to enter a subject for your alert email.
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.
Use this field to enter email addresses for additional users who will receive the threshold alert email.
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(%) fieldAbout 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.
After you’ve customized the settings above, click Save Allocation Threshold.
Your new allocation threshold will appear in your organization’s settings.
In your organization’s settings, click the edit icon to change an allocation threshold.
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.