Configuring the data bucket for a IBM Cloud Logs instance

Prereqs

• You must have a IBM Cloud Object Storage instance in the same account where your IBM Cloud Logs instance is provisioned.
• You must have permissions to create a bucket in the IBM Cloud Object Storage instance or have the details of an existing bucket.

Data bucket restrictions

IBM Cloud Object Storage buckets used by IBM Cloud Logs as data buckets can be configured only with the following storage classes:

• Smart Tier
• Standard

The following storage classes are not supported by IBM Cloud Logs as data buckets:

• Vault
• Cold Vault

IBM Cloud Object Storage allows you to define archive rules on buckets that archive objects automatically after the defined time period. Archived objects have a lower cost than regular objects, but need to be restored before they can be read again.

IBM Cloud Logs cannot read archived objects. IBM Cloud Logs searching of archived objects in the All Logs view, or querying in Archive queries, returns an error message.

IBM Cloud Object Storage buckets used as IBM Cloud Logs data buckets must not define archive rules that immediately archive objects, or archive objects within a few hours.

If you do not need to search logs older than a certain time period, for example, a month, you can define an IBM Cloud Object Storage archive rule to archive objects older that the time period required for searching. Do not configure archiving for a period of less than 7 days.

By archiving data that you do not need to search, you can retain the log data at a reduced cost. If required, you can restore archived objects if you need to search the data by using IBM Cloud Logs in the future.

Configure an IAM Service to service authorization

You must define a service to service (S2S) authorization between IBM Cloud Logs and IBM Cloud Object Storage to allow IBM Cloud Logs to read and write data into the data bucket. For more information, see Creating a S2S authorization to grant access to a bucket.

Configure the data bucket

Complete the following steps to configure a data bucket for a IBM Cloud Logs instance:

1. Log in to your IBM Cloud account.

   After you log in with your user ID and password, the IBM Cloud dashboard opens.

2. Click the Menu icon > Observability.

3. Select Logging > Instances. You might need to click the Cloud Logs tab to see your IBM Cloud Logs instances.

4. Select the instance to which you want to configure a data bucket.

5. In the Storage section, select Edit.

6. In the Logs data section, configure the Bucket CRN, and the Bucket endpoint.

   Select Insert CRN from search to get the list of buckets in your account. You can choose a CRN from the list.

   Select View endpoints in docs to find the endpoints per location. Choose the endpoint based on your bucket configuration.

7. Click Save to save the configuration.