IBM Cloud Docs
Planning for the migration of Analysis instances with platform logs flag enabled in the account

Planning for the migration of Analysis instances with platform logs flag enabled in the account

Plan for your migration of IBM® Log Analysis instances with the platform flag enabled to IBM Cloud Logs instances.

Migrating IBM Log Analysis instances to IBM Cloud Logs in IBM Cloud requires:

  • Migration of the IBM Log Analysis instance
  • Configuration of the logging agent to send data to the Cloud Logs instance
  • Configuration of IBM Cloud Logs Routing to define to which Cloud Logs instance platforms logs generated in a region are routed

High-level view of the migration tool
High-level view of the migration tool

When you configure the IBM Cloud Logs Routing service, you are controlling where platform logs are routed in the account. For migration, it is very important that you first configure IBM Cloud Logs Routing and define a Log Analysis target to configure the current default behavior in the account. Afterwards, you can define a Cloud Logs target to send the same data to the migrated IBM Cloud Logs instance. If you do not define a Log Analysis target first, platform logs will stop being routed to your current IBM® Log Analysis 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 Log Analysis instance:

  • Cloud Object Storage (to store data and metrics)

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

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

  • Event Streams for managing streaming of data through a topic

  • IBM Cloud Logs Routing

Migration steps