Compartilhar via

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

  • Artigo

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

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

Pré-requisitos

  • PowerShell versão 7.1.3 ou superior é recomendado (versão mínima 5.1)
  • O módulo Az PowerShell efetua pull de informações de configuração do agente do workspace do módulo Az PowerShell. Para instalar o módulo Az PowerShell, consulte Instalar o Azure PowerShell no Windows
  • Acesso de Leitura/Gravação ao recurso do workspace especificado

Instalação e execução

Baixe o script do PowerShell no GitHub.

O script recupera a configuração das configurações do agente herdado do workspace e gera modelos do ARM de DCR para cada tipo de DCR com suporte 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 YES A ID da assinatura do workspace
ResourceGroupName YES O grupo de recursos do workspace
WorkspaceName YES O nome do workspace (as IDs de recurso do Azure não diferenciam maiúsculas de minúsculas)
DCRName YES O nome base usado para cada uma das DCRs de saída
OutputFolder NO 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:

  • O Windows contém WindowsPerfCounters e apenas fontes de dados WindowsEventLogs
  • 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