Azure にインストールする

Datadog は、Azure インスタンスへの Agent デプロイを支援する Azure 拡張機能を提供しています。

GUI のインストールに代わる方法として、コマンドラインがあります。 Azure インスタンスで Datadog Agent を拡張機能として実行するには、環境に合ったコマンドを使用します。<SITE_PARAMETER>Datadog サイトページの Datadog アカウントサイトパラメーター値に、<DATADOG_API_KEY>Datadog API キーに置き換えます。

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

Azure インスタンス拡張機能を設定するための構文の詳細は、Azure Extension Set-AzVMExtension ドキュメントに記載されています。

Azure 拡張機能は、通常の設定と保護された設定の両方を受け入れることができます。

通常の設定は以下の通りです。

変数タイプ説明
site文字列Datadog インテークサイトを設定します。例: SITE=
agentVersion文字列x.y.z または latest というフォーマットの、インストールする Agent のバージョン
agentConfigurationURI(optional) URI to the Azure blob containing the Agent configuration as a zip file.
agentConfigurationChecksum文字列Agent 構成 zip ファイルの SHA256 チェックサム。agentConfiguration が指定された場合、必須です。

保護された設定は以下の通りです。

変数タイプ説明
api_key文字列Datadog API キーを構成ファイルに追加します。

: agentConfigurationapi_key を同時に指定した場合、agentConfiguration に記述された API キーが優先されます。また、ターゲットマシンに API キーが設定されている場合、Set-AzVMExtension で API キーを変更することはできないことに注意してください。

構成 URI の指定

この例では、Datadog Agent が使用する構成を指定する方法を示します。 Datadog Agent の構成 URI は、Azure の blob ストレージの URI である必要があります。 Datadog Windows Agent Azure Extension は、agentConfiguration URI が .blob.core.windows.net ドメインから来たことを確認します。 Datataog Agent 構成は、%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

: Datadog Agent をインストールすると、構成は新しいバージョンにアップグレードするときのみ変更することができます。

特定の Agent のバージョンを設定する

この例では、インストールする Agent のバージョンを指定する方法を示しています。デフォルトでは、Datadog Windows Agent Azure Extension は、Datadog Agent の最新バージョンをインストールします。

: ダウングレードはサポートされていないため、ターゲットマシンに現在インストールされている Datadog Agent のバージョンよりも低いバージョンの Datadog Agent をインストールすることはできません。Datadog Agent の下位バージョンをインストールするには、ターゲットマシン上の Datadog Windows Agent Azure Extension を削除して、以前のバージョンを最初にアンインストールしてください。Datadog Windows Agent Azure Extension を削除しても、Datadog Agent の構成は削除されません。

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
Azure インスタンス拡張機能を設定する構文の詳細については、[Azure Extension CLI リファレンス][1]を参照してください。

Azure 拡張機能は、通常の設定と保護された設定の両方を受け入れることができます。

通常の設定は以下の通りです。

変数タイプ説明
site文字列Datadog インテークサイトを設定します。例: SITE=
agentVersion文字列x.y.z または latest というフォーマットの、インストールする Agent のバージョン
agentConfigurationURI(optional) URI to the Azure blob containing the Agent configuration as a zip file.
agentConfigurationChecksum文字列Agent 構成 zip ファイルの SHA256 チェックサム。agentConfiguration が指定された場合、必須です。

保護された設定は以下の通りです。

変数タイプ説明
api_key文字列Datadog API キーを構成ファイルに追加します。

: agentConfigurationapi_key を同時に指定した場合、agentConfiguration に記述された API キーが優先されます。ターゲットマシンに API キーが設定されている場合、api_key で API キーを変更することはできません。

構成 URI の指定

この例では、Datadog Agent が使用する構成を指定する方法を示します。

  • Datadog Agent の構成 URI は、Azure の blob ストレージの URI である必要があります。
  • Datadog Windows Agent Azure Extension は、agentConfiguration URI が .blob.core.windows.net ドメインから来たことを確認します。
  • Datataog Agent 構成は、/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

Azure Arc にインストールする

Azure Arc インスタンスで Datadog Agent を拡張機能として実行するには、環境に合ったコマンドを使用します。

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>"}'

Azure connectedmachine 拡張機能を設定するための構文の詳細については、az connectedmachine 拡張機能ページに記載されています。

参考資料