Step 1. Enable Access to Cloud Storage

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

After ChaosSearch is deployed, 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

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. (If you are the primary/tenant user, skip the Account ID field. Subaccount users must supply the account ID for the environment.)

The Storage page usually opens by default. If cloud storage access has already been set up, the page displays a list of cloud-storage buckets configured for access by the ChaosSearch role, and any object groups that have been created to index content within those buckets. (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 any cloud storage buckets in the left menu of 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 environment (e.g., AWS or GCP). A sample AWS Credentials page follows where you can supply the AWS Role ARN. (The GCP page is similar, but prompts 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 update the list of buckets to which the ChaosSearch role has been granted read access for indexing. If an expected bucket is missing, you can try to import it to add it to the list. 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:

1520

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.