Converter configuração de espaço de trabalho em configurações de DCR

  • Artigo

Enquanto o Log Analytics Agent herda sua configuração dos espaços de trabalho do Log Analytics, o Azure Monitor Agent depende de regras de coleta de dados (DCRs) para a configuração

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

Pré-requisitos

  • A versão 7.1.3 ou superior do PowerShell é recomendada (versão mínima 5.1)
  • Módulo Az PowerShell para extrair informações de configuração do agente do espaço de trabalho 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 de espaço de trabalho especificado

Instalação e execução

Baixe o script do PowerShell do Git Hub.

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

Para vários espaços de trabalho com coleções de dados configuradas, você deve executar o script para cada espaço de trabalho. O IIS registra o script e 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 entre permitir que ele implante o modelo para você ou armazene a pasta de saída especificada pelo modelo

Nota

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

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

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

Parâmetros do script

Nome Obrigatório Descrição
SubscriptionId SIM A ID de assinatura do espaço de trabalho
ResourceGroupName SIM O grupo de recursos do espaço de trabalho
WorkspaceName SIM 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 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

Realizações:

  • Para cada suporte 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.

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
  • Os Logs do IIS contêm iisLogs apenas fontes de dados
  • Extensão DependencyAgent
  • As extensões contêm extensions fontes de dados somente junto com quaisquer fontes de dados perfCounters associadas
    • VMInsights

Implementação

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

Aviso

Você não deve usar uma tabela de log personalizada existente usada por agentes do MMA. Seus agentes MMA não poderão gravar na tabela quando 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óximos passos