Ferramentas para migrar do Log Analytics Agent para o Azure Monitor Agent

  • Artigo

O Azure Monitor Agent (AMA) substitui o agente do Log Analytics (também conhecido como MMA e OMS) para máquinas Windows e Linux, em ambientes Azure e não Azure, incluindo nuvens locais e de terceiros. Os benefícios da migração para o Azure Monitor Agent incluem segurança aprimorada, custo-benefício, desempenho, capacidade de gerenciamento e confiabilidade. Este artigo explica como usar as ferramentas AMA Migration Helper e DCR Config Generator para ajudar a automatizar e acompanhar a migração do Log Analytics Agent para o Azure Monitor Agent.

Flow diagram that shows the steps involved in agent migration and how the migration tools help in generating DCRs and tracking the entire migration process.

Importante

Não remova agentes herdados que estão sendo usados por outras soluções ou serviços do Azure. Use o auxiliar de migração para descobrir quais soluções e serviços você usa hoje.

Importante

O agenteherdado do Log Analytics será preterido até agosto de 2024. Após essa data, a Microsoft não fornecerá mais suporte para o agente do Log Analytics. Migre para o agente do Azure Monitor antes de agosto de 2024 para continuar a ingestão de dados.

Usando o AMA Migration Helper

O AMA Migration Helper é uma solução do Azure Monitor baseada em pasta de trabalho que ajuda você a descobrir o que migrar e acompanhar o progresso à medida que você passa do Log Analytics Agent para o Azure Monitor Agent. Use este painel único de visualização de vidro para agilizar e acompanhar o status da jornada de migração do agente. O auxiliar agora suporta várias assinaturas e inclui recomendações de migração automática com base no seu uso.

Você pode acessar a pasta de trabalho aqui ou encontrá-la no portal do Azure em Monitorar>Pastas de>Trabalho Modelos>Públicos Azure Monitor essentials>AMA Migration Helper.

Screenshot of the Azure Monitor Agent Migration Helper workbook. The screenshot highlights the Subscription and Workspace dropdowns and shows the Azure Virtual Machines tab, on which you can track which agent is deployed on each virtual machine.

Recomendações de migração automática

Screenshot of the Azure Monitor Agent Migration Helper workbook. The screenshot highlights the automatic migration recommendations based on sample usage across machines within selected scope.

Instalando e usando o DCR Config Generator

O Agente do Azure Monitor depende apenas de regras de coleta de dados (DCRs) para configuração, enquanto o Agente do Log Analytics herda sua configuração dos espaços de trabalho do Log Analytics.

Use a ferramenta DCR Config Generator para analisar a configuração do Log Analytics Agent de seus espaços de trabalho e gerar/implantar as regras de coleta de dados correspondentes automaticamente. Em seguida, você pode associar as regras a máquinas que executam o novo agente usando políticas de associação internas.

Nota

Atualmente, o DCR Config Generator não oferece suporte à configuração adicional para soluções ou serviços do Azure dependentes do Log Analytics Agent.

Pré-requisitos\Configuração

  1. Powershell version 7.1.3 ou superior é recomendado (versão mínima 5.1)
  2. Usa Az Powershell module para extrair informações de configuração do agente do espaço de trabalho Módulo Az PowerShell
  3. O usuário precisará de acesso de leitura/gravação ao recurso de espaço de trabalho especificado
  4. Connect-AzAccount e Select-AzSubscription serão usados para definir o contexto para que o script seja executado, portanto, credenciais adequadas do Azure serão necessárias

Para instalar o DCR Config Generator:

  1. Baixe o script do PowerShell.

  2. Execute o script usando os parâmetros de exemplo abaixo:

     .\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
    Nome Obrigatório Descrição
    SubscriptionId SIM Este é o ID de assinatura do espaço de trabalho
    ResourceGroupName SIM Este é o grupo de recursos do espaço de trabalho
    WorkspaceName SIM Este é o nome do espaço de trabalho (as IDs de recursos do Azure não diferenciam maiúsculas de minúsculas)
    DCRName SIM O nome base que será usado para cada um dos DCRs de saída
    OutputFolder Não O caminho da pasta de saída. Se não for fornecido, o caminho do diretório de trabalho será usado

  3. Realizações:

    Para cada suportado DCR type, o script produz um modelo DCR ARM (pronto para ser implantado) e uma carga útil DCR (para usuários que não precisam do modelo ARM). Esta é a lista de tipos de DCR atualmente suportados:

    • O Windows contém WindowsPerfCounters apenas fontes de WindowsEventLogs dados
    • Linux contém LinuxPerfCounters apenas fontes de Syslog dados
    • Os Logs Personalizados contêm logFiles apenas fontes de dados:
      • Cada log personalizado recebe seu próprio modelo DCR ARM
    • Os Logs do IIS contêm iisLogs apenas fontes de dados
    • As extensões contêm extensions fontes de dados somente junto com quaisquer fontes de dados perfCounters associadas
      • VMInsights - Se você gostaria de adicionar suporte para um novo tipo de extensão, entre em contato conosco.

  4. Implante os modelos ARM gerados:

    Portal

    • Na caixa de pesquisa do portal, digite modelo e selecione Implantar um modelo personalizado.

      Screenshot of the Deploy custom template screen.

    • Selecione Crie o seu próprio modelo no editor.

      Screenshot of the template editor.

    • Cole o modelo gerado no editor e selecione Salvar.

    • Na tela Implantação personalizada, especifique uma Assinatura, um grupo de recursos e uma Região.

    • Selecione Rever + criar>Criar.

    PowerShell

     New-AzResourceGroupDeployment -ResourceGroupName <resource-group-name> -TemplateFile <path-to-template>

    Nota

    Você pode incluir até 100 'counterSpecifiers' em uma regra de coleta de dados. 'samplingFrequencyInSeconds' deve ter entre 1 e 300, inclusive.

  5. Associe máquinas às suas regras de recolha de dados:

    1. No menu Monitor, selecione Regras de Coleta de Dados.
    2. Na tela Regras de Coleta de Dados, selecione sua regra de coleta de dados.
    3. Selecione Exibir recursos>Adicionar.
    4. Selecione as suas máquinas >Aplicar.