Guia de migração: Transição de v1 para v3

Este guia fornece instruções passo a passo para migrar seu serviço IBM Cloud Logs Routing da versão 1 ( v1 ) para a versão 3 ( v3 ). Enquanto o v1 fornece um conceito regional, o v3 oferece uma abordagem global com rotas e filtros para ajustar o roteamento dos registros da plataforma às suas necessidades. O processo de migração envolve a configuração de seu novo ambiente v3 e, em seguida, a mudança de v1 para v3.

Observe que haverá uma breve interrupção do serviço (aproximadamente alguns minutos) durante a etapa final da migração, quando os registros da plataforma não forem recebidos.

AVISO: Essa migração é irreversível. Depois de migrar para v3, você não poderá voltar para v1.

Cenários comuns de migração

Antes de iniciar a migração, é importante entender qual cenário corresponde melhor à sua arquitetura de registro atual. Os três cenários a seguir representam as configurações de registro mais comuns e o ajudarão a determinar a configuração apropriada para o seu ambiente v3.

Cenário 1: registro de log centralizado

Em uma configuração de registro centralizado, todos os registros da plataforma de toda a sua conta são consolidados em uma única instância do IBM Cloud Logs.

Essa abordagem simplifica o gerenciamento de registros, fornecendo uma visão unificada de todas as atividades da plataforma em sua conta.

Para implementar esse cenário em v3, você precisará criar um destino que aponte para a instância centralizada de IBM Cloud Logs e configurar uma rota com uma regra curinga para capturar todos os logs da plataforma, independentemente da região de origem.

Cenário 2: registro geográfico

O cenário de registro geográfico foi projetado para organizações que mantêm várias instâncias de registro distribuídas em diferentes localizações geográficas.

Nessa configuração, os logs de plataforma de várias regiões são encaminhados para a instância regional mais próxima ou designada do IBM Cloud Logs com base na proximidade geográfica ou nos requisitos de residência de dados. Essa abordagem equilibra a visibilidade centralizada com a distribuição geográfica, permitindo que você encaminhe logs de várias regiões para um número menor de instâncias IBM Cloud Logs estrategicamente localizadas.

Para implementar esse cenário, você precisará criar vários destinos (um para cada instância geográfica do IBM Cloud Logs ) e configurar rotas com filtros baseados em região apropriados para direcionar os logs para o destino geográfico correto.

Cenário 3: extração regional de madeira

O registro regional representa a abordagem mais distribuída, em que cada região do IBM Cloud tem sua própria instância dedicada do IBM Cloud Logs.

Essa configuração garante o isolamento regional completo dos dados de registro e é frequentemente usada para atender a requisitos rigorosos de residência de dados ou de conformidade. Nesse cenário, os logs de plataforma gerados em uma região específica são encaminhados exclusivamente para a instância IBM Cloud Logs implantada nessa mesma região.

Para implementar esse cenário em v3, será necessário criar um destino e uma rota separados para cada região em que você opera, garantindo que cada rota regional inclua filtros que restrinjam o roteamento de logs apenas à instância IBM Cloud Logs dessa região.

Abordagens de migração

Há duas abordagens para migrar de v1 para v3. Escolha a abordagem que melhor atenda às suas necessidades.

  1. Migração automatizada (recomendada):

    A abordagem de migração automatizada é recomendada para a maioria dos usuários, pois simplifica o processo de migração e reduz o risco de erros de configuração.

    Use as APIs de migração para gerar automaticamente destinos e rotas v3 com base em seus locatários v1 existentes.

    Para obter mais informações, consulte Migração automatizada.

  2. Configuração manual:

    Configure manualmente seu ambiente v3 do zero antes de concluir a migração.

    Selecione uma das opções a seguir:

Compreensão dos estados de migração

O processo de migração passa por vários estados:

  • BEFORE: O estado inicial antes do início da migração. Se uma tentativa de migração anterior falhar, a mensagem de erro será incluída.
  • IN_PROGRESS: O processo de migração está sendo executado ativamente. Isso pode levar vários minutos, dependendo de sua configuração.
  • PENDING_COMPLETION: suas rotas e alvos v3 foram criados com sucesso. Você deve verificar a configuração antes de concluir a migração.
  • COMPLETE: A migração foi concluída com êxito e sua conta agora está usando a configuração v3.

Permissões de IAM para migração

O processo de migração requer permissões específicas do IAM. As seguintes ações globais estão disponíveis para gerenciar a migração:

  • logs-router.migration.post: Configura e inicia a migração. Esse é um processo de duas etapas para configurar os metadados da conta e, em seguida, iniciar a atualização real de todas as regiões. Requer função de administrador.
  • logs-router.migration.get: Recupera o status da migração. Disponível para as funções de Administrador, Editor, Operador e Visualizador.
  • logs-router.migration.delete: Exclui o plano de migração gerado, inclusive todos os destinos e rotas criados automaticamente no site v3. Requer função de administrador.

Você deve ter a função de administrador da plataforma para migrar de V1 para V3.

Para obter mais informações sobre as funções e permissões do IAM, consulte Funções do IAM.