Step 1. Enable Access to Cloud Storage

How to get started and connect ChaosSearch to your storage buckets and objects.

After ChaosSearch is deployed—either as a free-trial deployment, proof-of-value (POV) deployment, or production deployment—you will have a domain name, tenant account and password, and an external ID for your ChaosSearch environment. You need these details to log in for the first time.

Log in to ChaosSearch

If you're the primary user at your site, connect to the ChaosSearch console at the domain name for your deployment following the instructions in your setup email. Log in using your ChaosSearch account and password. (You can skip the Account ID field as the tenant user; only subaccount users must supply that field.)

When you log in as a primary/tenant account, the system usually displays the Storage area with a list of cloud-storage buckets that have been configured for access by the ChaosSearch role, and any object groups that have been created to index content within those buckets. (Subaccount users could be configured to start with other pages like Search Analytics for example.)

Storage Buckets and ChaosSearch Role Credentials

If you do not see your buckets (or any buckets) on the Storage page, the cloud access credentials might not have been specified for the deployment.

To check and provide credentials, you must be logged in as the tenant user.

  1. Click your account name in the top right corner to display the tasks menu.
  2. Open the Settings/Help page.
  3. On the left there is an option to specify credentials for the configured cloud storage credentials (e.g., AWS or GCPe. A sample AWS Credentials page follows where you can supply the AWS Role ARN. (The GCP page is similar, but asks for the service account information.) If you are not sure how to obtain service credentials, see the instructions in Configure Cloud Storage Access.

After you specify, or correct, the credentials information, the Storage tab will show a list of the buckets to which the ChaosSearch role has been granted read access for indexing. If there is still an issue with buckets that are missing or that you cannot access, see Configure Cloud Storage Access for details about the cloud access policies recommended for the cloud environments.

Bucket Access

If you select a bucket that your role is not permitted to use, the system blocks access and displays a message:


The buckets list in the left pane has a search field to narrow the list to only those bucket and object group names that contain a string that you type.

The ellipses menu (three stacked dots icon after the filter field) has options to sort the bucket list, refresh the list, select all groups, show/hide hidden buckets, or to import a bucket. See Storage Overview for more details on how to use the buckets menu and the features.

What’s Next

After you have configured or verified access to your cloud storage buckets, create one or more object groups to index cloud storage files.