Compartir a través de

Conversión de la configuración del área de trabajo en configuraciones de DCR

  • Artículo

Mientras que el agente de Log Analytics hereda su configuración de las áreas de trabajo de Log Analytics, el agente de Azure Monitor se basa en reglas de recopilación de datos (DCR) para la configuración

La configuración del área de trabajo en el generador de configuraciones de DCR es una instancia de PowerShell que lee la configuración del área de trabajo y produce varias plantillas de ARM de DCR, en función de las configuraciones de MMA presentes en el área de trabajo.

Requisitos previos

  • Se recomienda PowerShell versión 7.1.3 o posterior (versión mínima: 5.1)
  • Módulo de Az PowerShell para extraer la información de configuración del agente del área de trabajo. Para instalar el módulo de Az PowerShell, consulte Instalación de Azure PowerShell en Windows
  • Acceso de lectura/escritura al recurso del área de trabajo especificado

Instalación y ejecución

Descargue el script de PowerShell desde GitHub.

El script recupera la configuración de las configuraciones del agente heredado del área de trabajo y genera plantillas de ARM de DCR para cada tipo de DCR admitido en la carpeta de salida especificada. Se puede crear más de una plantilla, una para cada tipo de DCR.

Para varias áreas de trabajo con colecciones de datos configuradas, debe ejecutar el script para cada área de trabajo. IIS registra el script y también crea un rol de recopilación de datos adicional como parte de esa configuración.

Cuando se complete el script, se le pedirá que pruebe la implementación de la plantilla en su entorno. Elija permitir que implemente la plantilla automáticamente o almacene la plantilla en la carpeta de salida especificada

Nota:

El script no asocia los DCR al área de trabajo. Debe crear sus propias asociaciones de reglas de recopilación de datos (DCR) para asociar las DCR a los servidores pertinentes. Esto le permite controlar la implementación de las DCR en los servidores y probar las DCR en un ejemplo de servidores antes de implementarlas a escala.

Para ejecutar el script, copie el siguiente comando y reemplace los parámetros por sus valores:

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

Parámetros de script

Nombre Obligatorio Descripción
SubscriptionId SÍ El identificador de suscripción del área de trabajo
ResourceGroupName SÍ El grupo de recursos del área de trabajo
WorkspaceName SÍ El nombre del área de trabajo (los identificadores de recursos de Azure no distinguen mayúsculas de minúsculas)
DCRName SÍ Nombre base que se usará para cada uno de los DCR de salida
OutputFolder NO Ruta de acceso de la carpeta de salida. Si no se proporciona, se usa la ruta de acceso del directorio de trabajo

Salidas:

  • Para cada DCR type compatible, el script genera una plantilla de ARM de DCR lista para implementarse y una carga de DCR (para los usuarios que no necesitan la plantilla de ARM).

Tipos de DCR admitidos actualmente:

  • Windows contiene solo orígenes de datos WindowsPerfCounters y WindowsEventLogs
  • Linux contiene solo orígenes de datos LinuxPerfCounters y Syslog
  • Los registros personalizados contienen solo orígenes de datos logFiles
  • Los registros de IIS contienen solo orígenes de datos iisLogs
  • Extensión DependencyAgent
  • Las extensiones contienen solo orígenes de datos extensions junto con los orígenes de datos perfCounters asociados
    • VMInsights

Implementación

Para obtener información sobre cómo implementar las DCR, consulte Reglas de recopilación de datos en Azure Monitor y Creación y edición de reglas de recopilación de datos (DCR) en Azure Monitor

Advertencia

No debe usar una tabla de registro personalizada existente que usen los agentes de MMA. Los agentes de MMA no podrán escribir en la tabla una vez que el primer agente AMA escribe en la tabla. Debe crear una nueva tabla para que AMA la use para evitar la pérdida de datos MMA.

Pasos siguientes