Removing an instance

You can remove an instance of the IBM Log Analysis service from the IBM Cloud UI or through the command line.

As of 28 March 2024 the IBM Log Analysis and IBM Cloud Activity Tracker services are deprecated and will no longer be supported as of 30 March 2025. Customers will need to migrate to IBM Cloud Logs, which replaces these two services, prior to 30 March 2025. For information about IBM Cloud Logs, see the IBM Cloud Logs documentation.

Considerations if you are using archiving

If you are using archiving, make sure all archiving has completed and that you have stopped archiving before you remove your instance. Removing an instance while archiving is still active can result in archive records being lost.

Removing an instance

When you remove an instance from the IBM Cloud, clean up by completing the following tasks:

Write down the list of sources that forward metrics to the IBM Log Analysis instance that you want to remove. You must remove the logging agent from each source.
Remove permissions that are granted to users to work with the instance.

If you manage access by using dedicated access groups to work with a specific instance, you must remove these access groups.

If you manage access to multiple logging instances by using access groups, you must remove the policies that grant permissions to the instance that you want to remove.

If you grant individual policies to users, you must gather the list of users that have permissions to work with that instance. Then, for each user that you identify, you must remove the policies that relate to the instance that you want to delete.

Then, delete the instance from the IBM Cloud Dashboard.

Removing an instance through the IBM Cloud UI

To remove an instance of IBM Log Analysis by using the IBM Cloud UI, complete the following steps:

Log in to your IBM Cloud account.

After you log in, the IBM Cloud UI opens.
Go to the menu icon > Observability to access the Observability Dashboard.
Click Logging. The list of logging instances is displayed.
Click the Actions icon next to the instance that you want to delete.
Click Delete.

Removing an instance through the CLI

To remove an instance of IBM Log Analysis through the command line, complete the following steps:

[Pre-requisite] Install the IBM Cloud CLI.

For more information, see Installing the IBM Cloud CLI.
Log in to IBM Cloud. Run the following command: ibmcloud login

Get information about the instance that you plan to delete.

ibmcloud resource service-instance INSTANCE-NAME --output JSON

Remove any service key associated with the instance.

Find the service keys that are associated with an instance:
```
ibmcloud resource service-keys --instance-id INSTANCE-GUID
```
Run the following command to delete 1 service key. You must delete all.
```
ibmcloud resource service-key-delete SERVICE-KEY-NAME
```
Remove the instance. Run the ibmcloud resource service-instance-delete command:
```
ibmcloud resource service-instance-delete NAME
```
Where NAME is the name of the instance.

For example, to remove an instance, run the following command:
```
ibmcloud resource service-instance-delete logging-instance-01
```