Compartilhar via

Converter a configuração do workspace em configurações de DCR

Enquanto o Agente do Log Analytics herda a configuração dos workspaces do Log Analytics, o Agente do Azure Monitor depende de regras de coleta de dados (DCRs) para configuração.

A configuração do espaço de trabalho para o gerador de configuração de DCR consiste em um PowerShell que lê a configuração do seu espaço de trabalho e gera vários modelos ARM de DCR, com base nas configurações de MMA presentes no espaço de trabalho.

Pré-requisitos

  • PowerShell versão 7.1.3 ou superior é recomendado (versão mínima 5.1)
  • Módulo do Az PowerShell para extrair informações de configuração do agente do espaço de trabalho Módulo do Az PowerShell. Para instalar o módulo Az PowerShell, consulte Instalar o Azure PowerShell no Windows
  • Acesso de leitura/gravação ao recurso de espaço de trabalho especificado

Instalação e execução

Baixe o script do PowerShell no GitHub.

O script recupera a configuração das configurações do agente legado do espaço de trabalho e gera modelos DCR ARM para cada tipo de DCR compatível na pasta de saída especificada. Mais de um modelo pode ser criado, um para cada tipo de DCR.

Para vários workspaces com coletas de dados configuradas, você deve executar o script para cada workspace. O IIS registra em log que o script também cria uma função de coleta de dados adicional como parte dessa configuração.

Quando o script for concluído, ele solicitará que você teste a implantação do modelo em seu ambiente. Escolha permitir que ele implante o modelo para você ou armazene a pasta de saída especificada pelo modelo

Observação

O script não associa as DCRs ao workspace. Você deve criar suas próprias DCRAs (associações de regra de coleta de dados) para associar as DCRs aos servidores relevantes. Isso permite que você controle a implantação de DCRs nos servidores e teste as DCRs em uma amostra de servidores antes de implantar em escala.

Para executar o script, copie o seguinte comando e substitua os parâmetros por seus valores:

	.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath

Parâmetros de script

Nome Obrigatória Descrição
SubscriptionId SIM A ID da assinatura do workspace
ResourceGroupName SIM O Grupo de recursos do workspace
WorkspaceName SIM O nome do workspace (as IDs de recurso do Azure não diferenciam maiúsculas de minúsculas)
DCRName SIM O nome base usado em cada uma das 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

Saídas:

  • Para cada DCR type com suporte, o script produz um modelo do ARM de DCR pronto para ser implantado e um conteúdo de DCR para usuários que não precisam do modelo do ARM.

Tipos de DCR com suporte atualmente:

  • Windows contém apenas WindowsPerfCounters e WindowsEventLogs fontes de dados
  • OLinux contém LinuxPerfCounters e apenas fontes de dados Syslog
  • Os Logs personalizados contêm apenas fontes de dados logFiles
  • Os logs do IIS contêm apenas fontes de dados iisLogs
  • Extensão DependencyAgent
  • As Extensões contêm apenas fontes de dados extensions junto com quaisquer fontes de dados perfCounters associadas
    • VMInsights

Implantação

Para obter informações sobre como implantar as DCRs, consulte Regras de coleta de dados no Azure Monitor e Criar e editar DCRs (regras de coleta de dados) no Azure Monitor

Aviso

Você não deve usar uma tabela de log personalizada existente usada por agentes do MMA. Seus agentes de MMA não conseguirão gravar na tabela depois que o primeiro agente AMA gravar na tabela. Você deve criar uma nova tabela para o AMA usar para evitar a perda de dados do MMA.

Próximas etapas