Azure Datadog 확장 설치 명령

문서 > 통합 > 통합 지침 > Azure Datadog 확장 설치 명령

Azure에 설치

Datadog은 Azure 인스턴스에서 에이전트 배포를 지원하는 Azure 확장을 제공합니다.

GUI 설치 대신 명령줄을 사용할 수 있습니다. Azure 인스턴스에서 Datadog 에이전트 확장을 실행하려면 환경에 맞는 명령을 사용합니다. <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 확장 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 폴더에서 생성해야 합니다.

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 에이전트가 설치되면 설정은 최신 버전으로 업그레이드할 때만 변경할 수 있습니다.

특정 버전의 에이전트 설정

본 예시에서는 설치할 에이전트 버전을 지정하는 방법을 알아봅니다. 기본적으로 Datadog 윈도우즈 에이전트 Azure 확장은 Datadog 에이전트 최신 버전을 설치합니다.

참고: 다운그레이드는 지원되지 않으므로 현재 대상 머신에 설치된 Datadog 에이전트 버전보다 하위 버전을 설치할 수 없습니다. Datadog 에이전트 하위 버전을 설치하려면, 먼저 대상 머신에서 Datadog 윈도우즈 에이전트 Azure 확장을 삭제하여 이전 버전을 삭제합니다. Datadog 윈도우즈 에이전트 Azure 확장을 삭제해도 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

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/ 폴더에서 생성해야 합니다.

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 에이전트 확장을 실행하려면 환경에 맞는 명령을 사용합니다.

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 확장 페이지에서 확인할 수 있습니다.