Commandes pour installer l'extension Azure Datadog

Installation sur Azure

Datadog propose une extension Azure pour faciliter le déploiement de lʼAgent sur les instances dʼAzure :

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.

Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = "<SITE_PARAMETER>"; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = "<DATADOG_API_KEY>"} -DisableAutoUpgradeMinorVersion

Pour plus d’informations sur la syntaxe des extensions d’instances Azure, consultez la documentation relative à lʼextension Azure Set-AzVMExtension.

L’extension Azure peut accepter des paramètres normaux et des paramètres protégés.

Les paramètres normaux comprennent :

VariableTypeDescription
siteChaîneDéfinit le site d’admission Datadog, par exemple SITE=.
agentVersionChaîneLa version de lʼAgent à installer, en suivant le format x.y.z ou latest
agentConfigurationURI(facultatif) Url vers le blob Azure contenant la configuration de lʼAgent au format zip.
agentConfigurationChecksumChaîneLe checksum SHA256 du fichier zip de la configuration de lʼAgent, obligatoire si agentConfiguration est spécifié.

Les paramètres protégés comprennent :

VariableTypeDescription
api_keyChaîneAjoute 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.

Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = "<SITE_PARAMETER>"; "agentConfiguration" = "https://<CONFIGURATION_BLOB>.blob.core.windows.net/<FILE_PATH>.zip"; "agentConfigurationChecksum" = "<SHA256_CHECKSUM>"} -DisableAutoUpgradeMinorVersion

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.

Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = "<SITE_PARAMETER>"; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = "<DATADOG_API_KEY>"} -DisableAutoUpgradeMinorVersion
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 :

VariableTypeRôle
siteChaîneDéfinit le site d’admission Datadog, par exemple SITE=
agentVersionChaîneLa version de lʼAgent à installer, en suivant le format x.y.z ou latest
agentConfigurationURI(facultatif) URI vers le blob Azure contenant la configuration de lʼAgent au format zip.
agentConfigurationChecksumChaîneLe checksum SHA256 du fichier zip de la configuration de lʼAgent, obligatoire si agentConfiguration est spécifié.

Les paramètres protégés comprennent :

VariableTypeRôle
api_keyChaîneAjoute 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.

az connectedmachine extension create --name <NAME> --machine-name <MACHINE_NAME> -g <RESOURCE_GROUP> --publisher Datadog.Agent --type DatadogWindowsAgent --location <LOCATION> --settings '{"site":"<SITE_PARAMETER>"}' --protected-settings '{"api_key":"<DATADOG_API_KEY>"}'
az connectedmachine extension create --name <NAME> --machine-name <MACHINE_NAME> -g <RESOURCE_GROUP> --publisher Datadog.Agent --type DatadogLinuxAgent --location <LOCATION> --settings '{"site":"<SITE_PARAMETER>"}' --protected-settings '{"api_key":"<DATADOG_API_KEY>"}'

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

PREVIEWING: alai97/reorganize-some-sections-in-dora-metrics