Skip to main content

Migrating Accounts Between Hosting Regions

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.

note

Azure Hosting is now deprecated; however, Azure Shipping and Azure Marketplace remain active and will continue to be supported.

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.

note

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.

note

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 OpenSearch Dashboards objects​

Export any and all OpenSearch Dashboards 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

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.

Important

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.

note

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.

note

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