You can migrate your Logz.io Log Management accounts between hosting regions. We’ll be frank - it can take a bit of effort, but with the right scripting and API implementation, can be done fairly quickly.

Implications

Before you set out to migrate your account, you will want to take the following implications into consideration:

  • Pre-migration data can’t be transferred
  • Pre-migration data can’t be restored from the archive
  • The migration will reset your account’s data shipping tokens. Consequently, you will need to update your data shipping configurations with the new token and listener host/region details.
  • Logz.io Metrics and Distributed Tracing are subject to availability. If applicable, reach out to your Logz.io Customer Success Manager to verify that they are available on your target region.

Migration checklist

The following is a comprehensive step-by-step guide for migrating an existing Logz.io Log Management account to a different hosting region.

The guide assumes a robust implementation that makes use of most of Logz.io’s offerings. Perform the steps that are relevant to you. For example, the sub accounts step is optional, but probably relevant if your pre-migration account has sub-accounts and you want to recreate them in your new, post-migration account.

The process can be performed by API or manually, as you prefer. You may also consider writing scripts to expedite the process.

Create a new account in the target region

Open a new Logz.io trial account in your region of choice. Contact your Logz.io Customer Success Manager or Account Manager to request a complimentary upgrade to match your existing account while you are in transition.

If you have custom parsing, ask your Logz.io Customer Success Manager or Account Manager for assistance migrating your parsing pipelines.

(Re-)Create your sub-accounts

Retrieve all sub-accounts and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve the settings for all of your Log Management accounts.
  2. In your post-migration account:
    1. Create a new sub-account with the matching settings. Repeat for each sub account.
    2. Update your main account with the appropriate settings and daily capacity.
Export & Import your Kibana objects

Export any and all Kibana objects you want to keep and import them into your new account. These include saved searches, visualizations, and dashboards.

The process can be performed by API or manually. Export & import guides:

(Re-)Create your archive settings

Retrieve your archive settings and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve the archive settings. Repeat for each sub account.
  2. In your post-migration account, set up log archiving. Repeat for each sub account, as necessary.

If you prefer to perform the process manually, see the archiving guide.

Note that only one archive can be active per account.

(Re-)Create your drop filters

Retrieve all drop filters and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve the drop filters for all of your Log Management accounts. Repeat for each sub account.
  2. In your post-migration account, create a new drop filter. Repeat for each filter and sub account, as necessary.

If you prefer to perform the process manually, see the drop filters guide.

If the filters were created from the backend, contact your Customer Success Manager for help migrating your drop filters.

(Re-)Create your Optimizers

In your post-migration account, open your Manage Accounts page, and create your Timeless account/s. Learn more

Re-create your Optimizers manually in your Logz.io account. Learn more.

Optimizers are currently not supported by the Logz.io API.

(Re-)Create your endpoints

Retrieve all notification endpoints and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve all notification endpoints for your main Log Management account. Repeat for each sub account.
  2. In your post-migration account, create a new endpoint. Repeat for each endpoint and account, as necessary.

If you prefer to perform the process manually, see the notification endpoints guide.

Export & import logging alerts

Retrieve all logging alerts you want to keep and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve all log alerts. Repeat for each sub account.
  2. Update and prepare the alerts with your new, post-migration account information:
    1. Update the account IDs, under the parameter accountIdsToQueryOn. If your alerts are set to run on all accounts, this will not be necessary. (That is, if the parameter QueryOnAllAccounts is set to true.)
    2. Update the notification endpoints, if relevant, under the parameter notificationEndpointIds.
  3. In your post-migration account, create a new alert with the matching settings. Repeat for each alert and account.

If you prefer to perform the process manually, see the alert guide.

(Re-)Create your scheduled reports

Re-create your reports manually in your Logz.io account. Learn more.

Scheduled reports are currently not supported by the Logz.io API.

(Re-)Create your users

Retrieve all existing users and re-create them in your new account. You can do so using the Logz.io API endpoints as follows:

  1. In your pre-migration account, retrieve users for all associated accounts.
    • This endpoint returns a list of users in the main account and all associated sub accounts as an array of JSON objects per account.
    • If a user appears in multiple accounts, it will be listed separately under each account.
  2. In your post-migration account, create a new user/admin user. Repeat for each user and account.

If you prefer to perform the process manually, see the user management guide.

Email Support to enable SSO

If you would like to enable your Single-Sign On (SSO) on the new account, Email Support for assistance. Learn more