Una alternativa a la instalación GUI es la línea de comandos.
Para ejecutar el Datadog Agent en tus instancias Azure como una extensión, utiliza el comando que coincide con tu entorno. Sustituye <SITE_PARAMETER> por el valor del parámetro de sitio de tu cuenta Datadog en la página de sitios Datadog, y <DATADOG_API_KEY> por tu clave de API Datadog.
La extensión Azure puede aceptar tanto parámetros normales como protegidos.
Los parámetros normales incluyen:
Variable
Tipo
Descripción
site
Cadena
Definir el sitio de ingesta de Datadog, por ejemplo: SITE=
agentVersion
Cadena
La versión del Agent a instalar, siguiendo el formato x.y.z o latest
agentConfiguration
URI
(Opcional) URI al blob Azure que contiene la configuración del Agent como archivo zip.
agentConfigurationChecksum
Cadena
La suma de comprobación SHA256 del archivo zip de configuración del Agent, obligatoria si se define agentConfiguration.
Los parámetros protegidos incluyen:
Variable
Tipo
Descripción
api_key
Cadena
Añade la clave de API de Datadog al archivo de configuración.
Nota: Si agentConfiguration y api_key se definen al mismo tiempo, la clave de API que se encuentra en agentConfiguration tiene prioridad. Ten en cuenta también que si se define una clave de API en la máquina de destino, no es posible modificarla con Set-AzVMExtension.
Definición de un URI de configuración
Este ejemplo muestra cómo definir una configuración para que la utilice el Datadog Agent .
El URI de configuración del Datadog Agent debe ser un URI de almacenamiento de blobs Azure.
La extensión Azure del Datadog Agent para Windows comprobará que el URI agentConfiguration provenga del dominio .blob.core.windows.net.
La configuración del Datataog Agent debe crearse desde la carpeta %PROGRAMDATA%\Datadog.
Nota: Una vez instalado el Datadog Agent, la configuración sólo podrá cambiarse al actualizar a una versión más reciente.
Configurar una versión específica del Agent
Este ejemplo muestra cómo especificar una versión del Agent para instalar. Por defecto, la extensión Azure del Datadog Agent para Windows instalará la última versión del Datadog Agent.
Nota: Las versiones anteriores no son compatibles, por lo que no es posible instalar una versión del Datadog Agent anterior a la instalada actualmente en la máquina de destino. Para instalar una versión menos reciente del Datadog Agent, desinstala primero la versión anterior eliminando la extensión Azure del Datadog Agent para Windows en el equipo de destino. La eliminación de la extensión Azure del Datadog Agent para Windows no elimina la configuración del Datadog Agent.
az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest"}' --protected-settings '{"api_key":"<DATADOG_API_KEY>"}' --no-auto-upgrade-minor-version
Encontrarás más información sobre la sintaxis para configurar extensiones de instancias Azure en la [referencia de la CLI de la extensión Azure][1].
La extensión Azure puede aceptar tanto parámetros normales como protegidos.
Los parámetros normales incluyen:
Variable
Tipo
Descripción
site
Cadena
Definir el sitio de ingesta de Datadog, por ejemplo: SITE=
agentVersion
Cadena
La versión del Agent a instalar, siguiendo el formato x.y.z o latest
agentConfiguration
URI
(Opcional) URI al blob Azure que contiene la configuración del Agent como archivo zip.
agentConfigurationChecksum
Cadena
La suma de comprobación SHA256 del archivo zip de configuración del Agent, obligatoria si se define agentConfiguration.
Los parámetros protegidos incluyen:
Variable
Tipo
Descripción
api_key
Cadena
Añade la clave de API de Datadog al archivo de configuración.
Nota: Si agentConfiguration y api_key se definen al mismo tiempo, la clave de API que se encuentra en agentConfiguration tiene prioridad. Ten en cuenta también que si se define una clave de API en la máquina de destino, no es posible modificarla con api_key.
Definición de un URI de configuración
Este ejemplo muestra cómo especificar una configuración para que la utilice el Datadog Agent.
El URI de configuración del Datadog Agent debe ser un URI de almacenamiento de blobs Azure.
La extensión Azure del Datadog Agent para Linux comprueba que el URI agentConfiguration proviene del dominio .blob.core.windows.net.
La configuración del Datataog Agent debe crearse a partir de la carpeta /etc/datadog-agent/.
az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest", "agentConfiguration":"https://<CONFIGURATION_BLOB>.blob.core.windows.net/<FILE_PATH>.zip", "agentConfigurationChecksum":"<SHA256_CHECKSUM>"}' --protected-settings '{"api_key":"<DATADOG_API_KEY>"}' --no-auto-upgrade-minor-version
Instalar en Azure Arc
Para ejecutar el Datadog Agent en tus instancias Azure Arc como una extensión, utiliza el comando que coincide con tu entorno.
