Provisioning an instance

Provisioning an instance through the Observability dashboard

To provision an instance from the Observability dashboard in the IBM Cloud, complete the following steps:

1. Log in to your IBM Cloud account.

   After you log in, the IBM Cloud UI opens.

2. Click the Menu icon > Observability to access the Observability dashboard.

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

4. Click Create.

5. Select the required service for your instance.

6. Select the location where you plan to provision the instance.

7. Enter a name for the service instance.

8. Select a resource group.

   By default, the default resource group is set.

   Note: If you are not able to select a resource group, check that you have editing permissions on the resource group where you want to provision the instance.

9. Select the Standard service plan.

   By default, the Standard plan is set.

   For more information about service plans, see Service plans and pricing.

10. Choose a retention plan. Valid values are 7 days, 14 days, 30 days, 60 days or 90 days.

11. Click Create.

After you provision an instance, the UI opens.

Provisioning an instance through the catalog

To provision an instance of IBM Cloud Logs through the IBM Cloud catalog, complete the following steps:

1. Log in to your IBM Cloud account.

   After you log in, the IBM Cloud UI opens.

2. Click Catalog. The list of the services that are available in IBM Cloud opens.

3. To filter the list of services that is displayed, select the Logging and Monitoring category.

4. Click the IBM Cloud Logs tile.

5. Select the location where you plan to provision the instance.

6. Enter a name for the service instance.

7. Select a resource group.

   By default, the Default resource group is set.

   Note: If you are not able to select a resource group, check that you have editing permissions on the resource group where you want to provision the instance.

8. Select the Standard service plan.

   By default, the standard plan is set. For more information about service plans, see Service plans and pricing.

9. Choose a retention plan. Valid values are 7 days, 14 days, 30 days, 60 days or 90 days.

10. Click Create.

After you provision an instance, the UI opens.

Provisioning an instance through the CLI

To provision an instance of IBM Cloud Logs through the command line, complete the following steps:

1. [Pre-requisite] Installation of the IBM Cloud CLI.

   For more information, see Installing the IBM Cloud CLI.

   If the CLI is installed, continue with the next step.

2. Log in to the region in the IBM Cloud where you want to provision the instance. Run the following command: ibmcloud login

3. Set the resource group where you want to provision the instance. Run the following command: ibmcloud target

   By default, the default resource group is set.

4. Create the instance. Run the ibmcloud resource service-instance-create command:

   ibmcloud resource service-instance-create NAME logs SERVICE_PLAN_NAME LOCATION -p '{"private_endpoints_only": PRIVATE_ENDPOINT}'
   

   Where

   NAME is the name of the instance

   SERVICE_PLAN_NAME is the type of plan. Valid value is standard.

   LOCATION is the region where the logging instance is created. To get the latest list of locations that are available for the IBM Cloud Logs service, see Locations.

   • PRIVATE_ENDPOINT is either true or false. If true only private endpoints can be used to access the instance.

     Unless otherwise specified when provisioning an instance, the default is for the instance to be accessible by both public and private endpoints.

   For example, to provision an instance with the standard plan that can be accessed only by private endpoints, run the following command:

   ibmcloud resource service-instance-create my-instance logs standard us-south -p '{"private_endpoints_only": true}'