Une alternative à l’installation par l’interface graphique est la ligne de commande.
Pour exécuter l’Agent Datadog sous forme dʼextension dans vos instances Azure, utilisez la commande correspondant à votre environnement. Remplacez <SITE_PARAMETER> par la valeur du paramètre site de votre compte Datadog dans la page des sites Datadog, et <DATADOG_API_KEY> par votre clé dʼAPI Datadog.
L’extension Azure peut accepter des paramètres normaux et des paramètres protégés.
Les paramètres normaux comprennent :
Variable
Type
Description
site
Chaîne
Définit le site d’admission Datadog, par exemple SITE=.
agentVersion
Chaîne
La version de lʼAgent à installer, en suivant le format x.y.z ou latest
agentConfiguration
URI
(facultatif) Url vers le blob Azure contenant la configuration de lʼAgent au format zip.
agentConfigurationChecksum
Chaîne
Le checksum SHA256 du fichier zip de la configuration de lʼAgent, obligatoire si agentConfiguration est spécifié.
Les paramètres protégés comprennent :
Variable
Type
Description
api_key
Chaîne
Ajoute la clé d’API Datadog au fichier de configuration.
Remarque : si agentConfiguration et api_key sont spécifiés en même temps, la clé dʼAPI trouvée dans agentConfiguration est prioritaire. Notez également que si une clé dʼAPI est définie sur la machine cible, il n’est pas possible de la modifier avec Set-AzVMExtension.
Spécifier un URI de configuration
Cet exemple montre comment indiquer une configuration à utiliser par lʼAgent Datadog.
L’URI de configuration de lʼAgent Datadog doit être un URI de stockage de blob Azure.
L’extension Windows Azure de lʼAgent Datadog vérifiera que l’URI agentConfiguration provient du domaine .blob.core.windows.net.
La configuration de lʼAgent Datataog doit être créée à partir du dossier %PROGRAMDATA%\Datadog.
Remarque : une fois que lʼAgent Datadog est installé, la configuration ne peut plus être modifiée que lors d’une mise à niveau vers une version plus récente.
Définir une version spécifique de lʼAgent
Cet exemple montre comment indiquer la version de lʼAgent à installer. Par défaut, l’extension Windows Azure de lʼAgent Datadog installe la dernière version de lʼAgent Datadog.
Remarque : les rétrogradations ne sont pas prises en charge, il n’est donc pas possible d’installer une version de lʼAgent Datadog antérieure à celle qui est actuellement installée sur la machine cible. Pour installer une version antérieure de lʼAgent Datadog, désinstallez d’abord la version précédente en supprimant lʼextension Windows Azure de lʼAgent Datadog sur la machine cible. La suppression de lʼextension Windows Azure de lʼAgent Datadog nʼentraîne pas celle de la configuration de lʼAgent Datadog.
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
Pour en savoir plus sur la syntaxe à utiliser pour définir les extensions de lʼinstance Azure, consultez la [référence CLI de lʼextension Azure][1].
L’extension Azure peut accepter des paramètres normaux et des paramètres protégés.
Les réglages normaux comprennent :
Variable
Type
Rôle
site
Chaîne
Définit le site d’admission Datadog, par exemple SITE=
agentVersion
Chaîne
La version de lʼAgent à installer, en suivant le format x.y.z ou latest
agentConfiguration
URI
(facultatif) URI vers le blob Azure contenant la configuration de lʼAgent au format zip.
agentConfigurationChecksum
Chaîne
Le checksum SHA256 du fichier zip de la configuration de lʼAgent, obligatoire si agentConfiguration est spécifié.
Les paramètres protégés comprennent :
Variable
Type
Rôle
api_key
Chaîne
Ajoute la clé d’API Datadog au fichier de configuration.
Remarque : si agentConfiguration et api_key sont spécifiés en même temps, la clé dʼAPI trouvée dans agentConfiguration est prioritaire. Si une clé dʼAPI est définie sur la machine cible, il n’est pas possible de la modifier avec le réglage Set-AzVMExtension.
Spécifier un URI de configuration
Cet exemple montre comment indiquer une configuration à utiliser par lʼAgent Datadog.
L’URI de configuration de lʼAgent Datadog doit être un URI de stockage de blob Azure.
L’extension Linux Azure de lʼAgent Azure vérifie que l’URI agentConfiguration provient du domaine .blob.core.windows.net.
La configuration de l’Agent Datadog doit être créée à partir du dossier /app/.apt/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
Installation sur Azure Arc
Pour exécuter lʼAgent Datadog dans vos instances Azure Arc en tant qu’extension, utilisez la commande qui correspond à votre environnement.
Pour plus d’informations sur la syntaxe à utiliser pour définir les extension Azure connectedmachine, accédez à la page de lʼextension az connectedmachine.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
