Copy
Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @ { "site" = "<SITE_PARAMETER>" ; "agentVersion" = "latest" } -ProtectedSettings @ { "api_key" = "<DATADOG_API_KEY>" } -DisableAutoUpgradeMinorVersion
Azure 인스턴스 확장을 설정하는 구문에 대한 자세한 내용은 Azure 확장 Set-AzVMExtension 설명 에서 확인할 수 있습니다.
Azure 확장은 일반 설정과 보안 설정을 모두 허용합니다.
일반 설정에는 다음이 포함됩니다.
변수 유형 설명 site
문자열 다음과 같이 Datadog 인테이크 사이트를 설정합니다. 예: SITE=
agentVersion
문자열 설치할 에이전트 버전은 다음의 x.y.z
또는 latest
형식입니다. agentConfiguration
URI (옵션) 에이전트 구성을 zip 파일로 포함하는 Azure 블룹 URL입니다. agentConfigurationChecksum
문자열 에이전트 설정 zip 파일의 SHA256 체크섬(checksum)입니다. agentConfiguration
지정 시 필수입니다.
보안 설정에는 다음이 포함됩니다.
변수 유형 설명 api_key
문자열 Datadog API KEY를 설정 파일에 추가하세요.
참고 : agentConfiguration
와 api_key
을 동시에 지정하면 agentConfiguration
의 API 키가 우선합니다. 또한 대상 머신에 API 키가 설정되어 있다면 Set-AzVMExtension
으로 변경할 수 없습니다.
설정 URI 지정하기 본 예시에서는 Datadog 에이전트에서 사용할 설정을 지정하는 방법을 알아봅니다.
Datadog 에이전트 설정 URI는 Azure 블롭 스토리지 URI여야 합니다.
Datadog 윈도우즈 에이전트 Azure 확장은 agentConfiguration
URI가 .blob.core.windows.net
도메인에서 제공되는지 확인합니다.
Datataog 에이전트 설정은 %PROGRAMDATA%\Datadog
폴더에서 생성해야 합니다.
Copy
Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @ { "site" = "<SITE_PARAMETER>" ; "agentConfiguration" = "https://<CONFIGURATION_BLOB>.blob.core.windows.net/<FILE_PATH>.zip" ; "agentConfigurationChecksum" = "<SHA256_CHECKSUM>" } -DisableAutoUpgradeMinorVersion
참고 : Datadog 에이전트가 설치되면 설정은 최신 버전으로 업그레이드할 때만 변경할 수 있습니다.
특정 버전의 에이전트 설정 본 예시에서는 설치할 에이전트 버전을 지정하는 방법을 알아봅니다. 기본적으로 Datadog 윈도우즈 에이전트 Azure 확장은 Datadog 에이전트 최신 버전을 설치합니다.
참고 : 다운그레이드는 지원되지 않으므로 현재 대상 머신에 설치된 Datadog 에이전트 버전보다 하위 버전을 설치할 수 없습니다. Datadog 에이전트 하위 버전을 설치하려면, 먼저 대상 머신에서 Datadog 윈도우즈 에이전트 Azure 확장을 삭제하여 이전 버전을 삭제합니다. Datadog 윈도우즈 에이전트 Azure 확장을 삭제해도 Datadog 에이전트 설정은 삭제되지 않습니다.
Copy
Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @ { "site" = "<SITE_PARAMETER>" ; "agentVersion" = "latest" } -ProtectedSettings @ { "api_key" = "<DATADOG_API_KEY>" } -DisableAutoUpgradeMinorVersion
Copy
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 확장 CLI 참조][1]에서 확인하세요.
Azure 확장은 일반 설정과 보안 설정을 모두 허용합니다.
일반 설정에는 다음이 포함됩니다.
변수 유형 설명 site
문자열 다음과 같이 Datadog 인테이크 사이트를 설정합니다. 예: SITE=
agentVersion
문자열 x.y.z
또는 latest
형식을 따라 에이전트 버전을 설치합니다.agentConfiguration
URI (옵션) 에이전트 구성을 zip 파일로 포함하는 Azure 블룹 URI입니다. agentConfigurationChecksum
문자열 에이전트 설정 zip 파일의 SHA256 checksum입니다 (agentConfiguration
지정 시 필수).
보안 설정에는 다음이 포함됩니다.
변수 유형 설명 api_key
문자열 Datadog API KEY를 설정 파일에 추가하세요.
참고 : agentConfiguration
와 api_key
을 동시에 지정하면 agentConfiguration
의 API 키가 우선합니다. 대상 머신에 API 키가 설정되어 있다면 api_key
설정으로 변경할 수 없습니다.
설정 URI 지정하기 본 예시에서는 Datadog 에이전트에서 사용할 설정을 지정하는 방법을 알아봅니다.
Datadog 에이전트 설정 URI는 반드시 Azure 블롭 스토리지 URI여야 합니다. Datadog 리눅스 에이전트 Azure 확장은 agentConfiguration
URI가 .blob.core.windows.net
에서 제공되는지 확인합니다. Datataog 에이전트 설정은 /etc/datadog-agent/
폴더에서 생성해야 합니다.
Copy
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