Manage your buckets

Your account is organized into Teams and Buckets. Buckets are a way of organizing your tests into logical groupings. Each bucket can contain multiple tests.

• Create a new bucket in your team
• Move a test to a different bucket
• Bucket Utilization API

Create a new bucket in your team

Follow these steps:

1. Log in to BlazeMeter and navigate to the API Monitoring tab.
2. Click Tests.
   You are taken to your dashboard.
3. Click the Bucket drop-down menu on the left side next to Tests.
   The list shows all your teams and buckets within the teams.
   You can also filter by bucket name or a Key.
4. Click Create Bucket at the bottom of the list to create a new bucket. You will be taken to a Create Bucket page.
5. Select the Team to add the bucket to.
6. Name the bucket.
7. Optional: Enable the Create as Private Bucket option to restrict view and access to assigned users only.
8. Optional: Enable the Bucket name must be unique option to prevent duplicate bucket names.
9. Click Create Bucket.

Move a test to a different bucket

Follow these steps:

1. Log in to BlazeMeter and navigate to the API Monitoring tab.
2. Click Tests.
   You are taken to your dashboard.
3. Click More... to expand the menu on the left side and click Settings.
4. Scroll down to the Move Test section.
5. Select a Bucket that you want to move the test to and click Move Test.

Example scenarios

The following example scenarios show real life situations where you go over the limit of the maximum number of tests running concurrently.

• Scenario 1
  Let's say you have 1 bucket with 250 tests in it, only one cloud location enabled for them of US Virginia, and every test is scheduled to run every minute. What is going to happen is, 200 of those tests will start running. The remaining 50 tests will be added to a queue, and as soon as the initial 200 tests finish running the remaining tests will start being executed. If your tests are long-running tests for any reason, this can lead to the queues in the system getting bigger, and that could lead to tests expiring because of timeout issues.
• Scenario 2
  Let's say you have 1 bucket with 200 tests in it, each test has two cloud locations enabled of US Virginia and US Illinois, and every test is scheduled to run every minute. Since each test has two cloud locations, every minute you'll have 400 tests running concurrently. But since each cloud location will only have a maximum of 200 tests running concurrently, as long as your tests finish running in under a minute, you shouldn't see any issues.
• Scenario 3
  Let's say you have 1 bucket with 100 tests in it, and each test has three Radar Agent locations, and every test is scheduled to run every minute. Since there are 3 locations, every minute 200 tests will start running among the 3 different agents, while 100 tests will be added to the queue and wait for the initial tests to be completed before they can start running. Like we mentioned above, on-premise agents work differently than our public locations. Even though in this scenario there are 3 separate agents representing 3 locations in your environment, they can still only run a maximum of 200 tests at the same time.

Bucket Utilization API

We have enhanced the Bucket Detail API to also list the percentage of concurrent tests running in each location compared to the limit of 200 tests per location per bucket. The API can be called with the list_utilizations_gt parameter that accepts a number (integer value) from 1 to 100 as follows:

v1/buckets/<bucket_key>?list_utilizations_gt=<value>

The API output for threshold-percentage=80 with utilization will look like the following example:

api.runscope.com/v1/buckets/<bucket_key>?list_utilizations_gt=80

{
"data": {
 "auth_token": null,
 "default": false,
 "key": "ov2f2tq1floq",
 "name": "Mobile Apps",
 "team": {
 "name": "Mobile Team",
 "uuid": "7a7a0917-91d7-43ef-b8f4-fe31762167e0"
},
"verify_ssl": true,
"locations_utilization_%": {
 "remote": 82, 
 "us california": 86, 
 "us iowa": 90
}
},
"meta": {
"status": "success"
}

You can see that three locations exceeded the threshold value of 80%. All Radar agents 82%, US California: 86% and US Iowa: 90%.