Performance testing

The scan time depends heavily on file size, type, and content. To get accurate throughput numbers for your particular workload, we recommend running a performance test:

1. Install bucketAV by following the Setup Guide using the default values.
2. Install the Scan bucket at regular intervals Add-On.
   1. Install Add-On
   2. Set the Stack name to bucketav-performance-test.
   3. Set the BucketAVStackName configuration parameter to the stack name of bucketAV (if you followed the docs, the name is bucketav).
   4. Set the BucketName configuration parameter to the name of an S3 bucket that contains at least 10,000 files. Keep in mind that infected files will be deleted by default!
   5. Remove the default value from the ScheduleExpression parameter to disable the schedule.
   6. Set the PagingBatchSize configuration parameter to 1000.
   7. Set the PagingWaitInSeconds configuration parameter to 0.
   8. Select I acknowledge that AWS CloudFormation might create IAM resources.
   9. Click on the Create stack button to save.
3. Generate load.
   1. Visit the AWS Step Functions Management Console.
   2. Ensure that you are in the correct region.
   3. Navigate to State machines.
   4. Click on the bucketav-performance-test-scan-orchestrator state machine.
   5. Click the Start execution button.
   6. Keep the defaults and click the Start execution button.
4. Open the dashboard. The Scan Queue tile shows the data of interest. You should see the Queue Length go up.
5. Wait another 15 minutes to capture data.
6. Reload the dashboard. In the Scan Queue tile, click on the Files processed legend. Now you only see the metric of importance. Zoom into the area of interest. Now you know the number of files scanned per minute (axis on the right). This is the throughput of one m5.large EC2 instance for your workload.
7. To clean up, remove the CloudFormation stack named bucketav-performance-test.