Planning the migrating of your Activity Tracker instance

Overview

Migrating IBM Cloud® Activity Tracker instances to IBM Cloud Logs in IBM Cloud requires the configuration of the IBM Cloud Activity Tracker Event Routing service in the account to define where events are routed and the provisioning of IBM Cloud Logs instances. A migration tool is provided to help you migrate.

Options to migrate:

• Option 1: Migrate the IBM Cloud® Activity Tracker instance by using the migration tool, and then, manually configure the IBM Cloud Activity Tracker Event Routing service afterwards.
• Option 2: Migrate the IBM Cloud® Activity Tracker instance and configure the IBM Cloud Activity Tracker Event Routing service by running the migration tool.

When you configure the IBM Cloud Activity Tracker Event Routing service, you are controlling where events are routed in the account. For migration, it is very important that when you configure IBM Cloud Activity Tracker Event Routing, that you define first a logdna target and a route for the region where the IBM Cloud® Activity Tracker instance is available so you configure the current default behavior in the account. Afterwards, you can define a cloud_logs target and route to send the same data to the migrated IBM Cloud Logs instance. If you do not define a logdna target first, events will stop being routed to your current IBM Cloud® Activity Tracker instance.

Always run the migration tool in a development or staging environment to test and validate the migration command and steps.

The IBM Cloud Logs migration tool migrates IBM Log Analysis and IBM Cloud Activity Tracker instance configurations. Only configuration information is migrated. Data is not migrated.

The following list outlines the services that you need access to to migrate an IBM Cloud® Activity Tracker instance:

• Cloud Object Storage (to store data and metrics)

• Event Notifications (to trigger alerts through Email, PagerDuty, Slack, or webhook)

• IBM Cloud Logs (the new logging service in IBM Cloud Observability)

• IBM Cloud Activity Tracker Event Routing for managing how events are routed in the account

• Event Streams for managing streaming of data through a topic

Migration steps

• Identify the regions where you have provisioned Activity Tracker instances.

• For each instance, follow one of these options:

  • Migrate 1 Activity Tracker instance in the account using full automation.

  • Migrate 1 Activity Tracker instance in the account using a combination of automation and manual steps.

• If you have created an IBM Cloud Logs instance, do the following to configure routing to the new instance.

  • Configuring Activity Tracker Event Routing in the account for a new setup that does not require migration.