To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.
To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.
개요
이 가이드는 Datadog의 Azure 통합을 구성하는 사용자를 위한 고급 구성 옵션과 참조 아키텍처는 물론 특정 사용 사례에 대한 대체 구성 옵션을 제공합니다.
참조 아키텍처
이 가이드의 다이어그램은 Azure 시작하기의 단계를 따를 때의 구성 프로세스와 결과를 시각적으로 보여줍니다. 이 가이드는 Datadog이 사용자의 Azure 환경과 상호 작용하는 방식에 대한 자세한 개요를 제공하며 일반적인 보안, 규정 준수 및 거버넌스 관련 질문에 답변합니다.
대체 구성
Azure 시작하기에 문서화된 설정 프로세스는 권장되는 단계이며 대부분의 사용자에게 이상적인 구성을 제공합니다. 이 문서의 대체 구성 옵션은 특정 사용 사례에 더 적합할 수 있습니다. 성능, 기능 또는 관리 용이성 측면의 상충 관계는 필요에 따라 설명됩니다.
메트릭 및 데이터 수집
Datadog의 Azure 통합을 활성화하면 Datadog이 다음을 수행할 수 있습니다.
지정된 범위 내 모든 구독의 모든 리소스 검색 및 모니터링
Azure Monitor에서 사용 가능한 모든 메트릭이 수집되도록 검색된 메트릭 정의를 자동으로 업데이트
다양한 일반 메타데이터와 리소스별 메타데이터(사용자 지정 Azure 태그 포함)를 수집하고 이를 Datadog의 관련 리소스 메트릭에 태그로 적용
Azure 메타데이터 API를 쿼리하고 응답을 사용하여 Datadog에서 유용한 메트릭 생성함으로써 Azure Monitor를 제공하지 않는 인사이트 확보
사용된 Azure API와 수집된 데이터는 통합의 표준 버전을 사용하는지 Azure Native 버전을 사용하는지에 관계없이 동일합니다.
아래 다이어그램은 Azure 시작하기에 설명된 Azure 통합 구성의 프로세스와 결과 아키텍처를 간략하게 설명합니다.
이 작업이 완료되면 데이터 수집이 자동으로 시작됩니다. 앱 등록을 통해 Datadog은 Azure AD(Active Directory)에서 토큰을 요청할 수 있습니다. Datadog은 이 토큰을 다양한 Azure API에 대한 API 호출 권한으로 사용하여 제공된 범위 내에서 리소스를 검색하고 데이터를 수집합니다. 이 지속적인 프로세스는 기본적으로 2분 간격으로 실행되며 Azure 환경에서 데이터를 검색하고 수집하는 데 사용됩니다. 데이터 수집 프로세스는 아래 그림과 같습니다.
위의 메트릭 및 로그 수집 다이어그램은 클라이언트 암호를 통한 인증을 사용합니다. Secretless Auth를 사용하면 앱 등록은 Azure 페더레이션 자격 증명 및 OpenID Connect(OIDC) 워크로드 ID 페더레이션을 통해 Datadog의 ID를 신뢰합니다. 이는 저장된 클라이언트 암호를 대체합니다. 기존 앱 등록을 Secretless Auth로 이동하려면 기존 앱 등록을 Secretless Auth로 마이그레이션을 참조하세요.
로그 수집
아래 다이어그램은 자동 로그 포워딩을 사용하여 Azure에서 Datadog으로 로그를 전달하기 위한 참조 아키텍처를 제공합니다. 선택한 구독에 배포된 제어 평면은 리소스를 검색하고 진단 설정을 구성합니다. Azure Container Apps 작업과 스토리지 계정으로 구성된 로그 포워더는 리소스가 로그를 생성하는 각 리전에 배포되며, 로그 볼륨에 맞춰 확장되거나 축소됩니다.
다음 참조 아키텍처는 기존 이벤트 허브 로그 포워딩 설정에 적용됩니다. 새 배포에는 대신 자동 로그 포워딩을 사용하세요.
제공된 템플릿 사용
기본 Azure 이벤트 허브 로깅 가이드의 Deploy to Azure 버튼은 이벤트 허브 및 포워더 함수 쌍을 생성하기 위한 템플릿을 제공합니다. 이 템플릿을 사용하여 직접 배포하는 것 외에도 기본 ARM 템플릿을 자체 코드형 인프라 배포의 시작점으로 사용할 수 있습니다.
이러한 템플릿은 활동 로그에 대한 선택적 진단 설정 하나를 제외하고는 진단 설정을 추가하지 않습니다. 리소스 로그의 경우 ARM 템플릿이나 Terraform을 사용하여 리소스에 진단 설정을 프로그래밍 방식으로 추가하는 것이 좋습니다. 이러한 진단 설정은 리소스 로그를 Datadog으로 보내야 하는 모든 리소스에 추가되어야 합니다.
리전 고려 사항
진단 설정은 리소스와 동일한 리전에 있는 이벤트 허브로만 리소스 로그를 보낼 수 있습니다. Datadog으로 리소스 로그를 보내려는 리소스가 포함된 각 리전에 이벤트 허브 및 포워더 함수 쌍을 추가합니다.
하지만 진단 설정은 리소스와 동일한 구독에 있는 이벤트 허브로 로그를 전송하는 것으로 제한되지는 않습니다. Azure 테넌트 내에 여러 구독이 있는 경우 동일한 리전 내에서 단일 이벤트 허브 및 포워더 함수를 공유할 수 있습니다.
대용량 로그 고려 사항
로그 볼륨이 확장됨에 따라 일반적으로 이벤트 허브에서 병목 현상이 발생할 수 있습니다. 많은 양의 로그를 제출할 계획이라면 파티션을 추가하거나 프리미엄 또는 전용 계층을 사용하는 것을 고려할 수 있습니다.
특히 로그 볼륨이 큰 경우 동일한 리전 내에 이벤트 허브 및 포워더 함수 쌍을 추가하고 그 사이에서 트래픽 분할을 고려할 수 있습니다.
Azure Datadog Extension 설치 명령
Azure에 설치
Datadog은 Azure 인스턴스에서 에이전트 배포를 지원하는 Azure 확장 프로그램을 제공합니다.
Azure 인스턴스에서 Datadog Agent 확장 프로그램을 실행하려면 환경에 맞는 명령을 사용하세요. Datadog 사이트 페이지에서 <SITE_PARAMETER>를 Datadog 계정 사이트 파라미터 값으로 바꾸고 <DATADOG_API_KEY>를 Datadog API 키로 바꿉니다.
참고: Agent 버전 7 이상을 설치하려면 Python 3.9 이상이 필요합니다.
(선택 사항) Agent 구성을 ZIP 파일로 포함하는 Azure Blob에 대한 URI입니다.
agentConfigurationChecksum
문자열
Agent 구성 ZIP 파일의 SHA256 체크섬입니다. agentConfiguration이 지정된 경우 필수입니다.
보안 설정에는 다음이 포함됩니다.
변수
유형
설명
api_key
문자열
구성 파일에 Datadog API 키를 추가합니다.
참고: agentConfiguration 및 api_key가 동시에 지정된 경우 agentConfiguration에서 발견된 API 키가 우선합니다. 또한 대상 머신에 API 키가 설정된 경우 Set-AzVMExtension을 사용하여 변경할 수 없습니다.
구성 URI 지정
본 예시에서는 Datadog Agent에서 사용할 구성을 지정하는 방법을 알아봅니다.
Datadog Agent 구성 URI는 반드시 Azure Blob 스토리지 URI여야 합니다.
Datadog Windows Agent Azure Extension에서는 agentConfiguration URI를 .blob.core.windows.net 도메인에서 가져오는지 확인합니다.
Datadog Agent 구성은 %PROGRAMDATA%\Datadog 폴더에서 생성해야 합니다(사용 가능한 모든 구성 옵션은 Windows용 Agent 구성 파일 예시 참조).
기존 Agent의 구성을 재사용하려면 다음 단계를 수행하세요.
기존 Agent의 %ProgramData%\Datadog 폴더에서 추가 설치 아티팩트나 파일을 제거해 이 폴더에 통합 구성과 함께 datadog.yaml 파일 및 conf.d 폴더만 포함되도록 합니다.
참고: Datadog Agent가 설치되면 구성은 최신 버전으로 업그레이드할 때만 변경할 수 있습니다.
특정 버전의 Agent 설정
이 예시는 설치할 Agent 버전을 지정하는 방법을 보여줍니다. 기본적으로 Datadog Windows Agent Azure Extension은 최신 버전의 Datadog Agent를 설치합니다.
참고: 다운그레이드는 지원되지 않으므로 대상 머신에 현재 설치된 버전보다 낮은 버전의 Datadog Agent는 설치할 수 없습니다. 더 낮은 버전의 Datadog Agent를 설치하려면 대상 머신에서 Datadog Windows Agent Azure Extension을 제거하여 이전 버전을 먼저 삭제하세요. Datadog Windows Agent Azure Extension을 제거해도 Datadog Agent 구성은 제거되지 않습니다.
Datadog은 Azure 통합으로 모니터링되는 각 리소스에 대해 추가 메트릭인 azure.*.count를 생성합니다. 예를 들어, Datadog에서 모니터링하는 Azure 가상 머신은 azure.vm.count를 보고합니다.
azure.*.count 메트릭은 지원이 중단된 azure.*.status보다 개선된 메트릭입니다.
카운트 메트릭
azure.*.count 메트릭은 다음 2가지 기본적 정보를 제공합니다.
해당 유형의 리소스 수
Azure에서 보고한 각 리소스 상태
azure.*.count 메트릭은 해당 리소스 유형에 대한 다른 메트릭과 동일한 네임스페이스에 생성됩니다(예: azure.network_loadbalancers.count). 여기에는 해당 네임스페이스의 다른 메트릭과 동일한 메타데이터 태그가 모두 포함되며 status에 대한 추가 태그도 포함됩니다.
사용 사례
azure.*.count 메트릭을 사용하여 다음 작업을 수행할 수 있습니다.
모든 항목에 대해 azure.vm.count를 그래프로 표시하고 status로 합산하여 시간 경과에 따른 상태별로 분류된 가상 머신 수에 대한 보기를 생성합니다.
대시보드에 쿼리 위젯을 생성하여 특정 리소스 유형의 수를 표시합니다. 사용 가능한 태그를 사용하여 리전, 리소스 그룹, 종류 또는 상태와 같은 관련 집계로 카운트 범위를 지정합니다.
다양한 Azure 리소스의 상태에 대해 경고하도록 모니터링을 생성합니다.
참고: 경우에 따라 기본 시각화 설정으로 인해 차트나 쿼리 위젯에서 리소스가 간헐적으로 이중으로 계산되는 것처럼 보일 수 있습니다. 이는 특정 상태로 범위가 지정된 모니터링 또는 위젯에는 영향을 주지 않습니다.
Interpolation > none으로 설정하거나 .fill(null)을 사용하여 차트나 쿼리 위젯에서 보간을 꺼 이 효과를 줄일 수 있습니다.
대부분의 리소스 유형의 경우 가능한 상태는 다음과 같습니다.
실행 중
사용 불가
알 수 없음
강등됨
실패
가상 머신 상태는 아래 상태를 포함하여 더욱 상세합니다.
실행 중
중지됨_재할당됨
중지됨
알 수 없음
사용 불가
강등됨
실패
상태가 query_failed인 경우 Azure에서 리소스 상태 공급자를 활성화해야 합니다.
올바른 검색 구문을 사용했는지, 검색에 올바른 속성이나 태그가 포함되어 있는지 확인하세요.
진단 설정이 없음:
Datadog으로 보낼 리소스, 활동 로그 및 Entra ID 로그에 진단 설정이 추가되었는지 확인하세요.
참고: source:azure.activedirectory 쿼리를 사용하여 Entra ID 로그를 검색할 수 있습니다.
자동 로그 포워딩 문제 해결
이름 충돌이 발생했는지 검사
기본 파라미터 중 하나와 리소스 이름이 동일한 Azure 리소스가 있는 경우 이름 충돌이 발생할 수 있습니다. Azure에서는 개별 구독 내에서 리소스 이름 공유를 허용하지 않습니다. 환경 내에 아직 존재하지 않는 고유한 이름으로 기본 파라미터의 이름을 변경하는 것이 좋습니다.
참고: 이 오류로 인해 템플릿을 다시 실행하는 경우 전체 리소스 그룹을 제거하여 새로 배포하는 것이 좋습니다.
리소스 공급자가 등록되었는지 확인
오류The subscription is not registered to use namespace 'Microsoft.EventHub'로 인해 템플릿 배포에 실패하는 경우:
Azure는 각 서비스에 대한 리소스 공급자(예: Azure Event Hubs의 경우 Microsoft.EventHub)를 보유하고 있습니다. 사용 중인 Azure 구독이 필수 리소스 공급자에 등록되어 있지 않으면 스크립트가 실패합니다.
적절한 리소스 공급자에 등록하여 이 문제를 해결하세요. 아래 예시 명령을 CloudShell에서 실행하고 <RESOURCE_PROVIDER_NAME>을 리소스 공급자 이름(예: Microsoft.EventHub)으로 대체합니다.
az provider register --namespace <RESOURCE_PROVIDER_NAME>
참고: 함수 앱 설정에서 Datadog 사이트 및 API 키가 설정되었는데 수정되면 앱이 다시 시작될 수 있습니다.
잠재적인 이벤트 허브 병목 현상 식별
수신 메시지는 급증하는데 발신 메시지가 감소한다면 병목 현상이 발생했음을 의미합니다. 다음 메트릭을 사용하여 조사:
수신 메시지 확인:
azure.eventhub_namespaces.incoming_messages
수신 데이터 확인:
azure.eventhub_namespaces.incoming_bytes
발신 메시지 확인:
azure.eventhub_namespaces.outgoing_messages
발신 데이터 확인:
azure.eventhub_namespaces.outgoing_bytes
Microsoft.EventHub 스로틀 요청 확인:
azure.eventhub_namespaces.throttled_requests
Microsoft.EventHub 서버 오류 확인:
azure.eventhub_namespaces.server_errors
참고: 18시간보다 오래된 로그는 삭제되므로 로그 지연 시간을 늘리면 데이터가 손실될 수 있습니다.
병목 현상을 해결하기 위해 다음 작업 중 하나를 수행할 수 있습니다.
더 많은 처리량(최대 32)을 처리하도록 이벤트 허브 파티션을 확장합니다. 현재 위치 확장(in-place scaling)은 프리미엄 또는 전용 계층에서만 사용할 수 있으므로, 원하는 파티션 수로 새 Event Hub를 만든 다음 진단 설정 및 포워더 트리거를 다시 구성해야 합니다. 확장 관련 조언은 Azure 지원 팀에 문의하세요.
로그 포워더를 Datadog의 여러 파이프라인으로 분할하여 각 파이프라인이 우선순위와 같은 규칙에 따라 특정 리소스 하위 집합을 처리하도록 합니다. 이렇게 하면 동시에 처리할 수 있는 로그 수가 증가합니다.
더욱 안정적이고 효율적이며 비용 효율적인 로그 수집을 위해 자동 로그 포워더로 전환하세요. 모든 Azure 리소스에서 Datadog으로 로그 포워딩 프로세스를 완전히 자동화합니다.
여러 앱 등록 모니터링
여러 앱 등록을 통해 모니터링되는 구독은 액세스 구성이 중복될 수 있습니다. 이 설정은 권장되지 않으며 통합 문제나 시스템 충돌이 발생할 수 있고, Azure Monitor 비용이 증가할 수도 있습니다.
인프라 목록의 전원이 꺼진 Azure VM
Azure에서 VM 전원을 끄면 Datadog Azure 통합 기능이 해당 VM에 대한 메트릭 azure.vm.status를 계속 수집합니다. 이 메트릭에는 status:running, status:not_running 또는 status:unknown 태그가 지정됩니다.
이는 의도된 동작이지만, 이로 인해 VM이 인프라 목록에 계속 남아 있게 됩니다. VM이 이 메트릭만 보고하는 경우 청구 가능한 호스트 수에 포함되지 않습니다. 자세한 청구 정보는 Datadog 청구 페이지를 참조하세요.
Azure VM을 제거하면 3시간 내에 인프라스트럭처 목록에서 제거됩니다.
앱에 Azure VM이 나타나지만 메트릭이 보이지 않음
Datadog에 Azure 통합을 제대로 설치하면 15분 내에 Azure VM과 다른 서비스의 메트릭이 표시되기 시작합니다.
15분 후 인프라스트럭처 목록에 Azure VM이 나타나는데 메트릭이 보고되지 않는 경우, 이 문제에는 여러 원인이 있을 수 있습니다.
올바른 메트릭을 보고 있는지 확인합니다.
클래식 가상 머신 메트릭은 azure.vm 네임스페이스로 시작하며, ARM 배포 가상 머신 메트릭은 azure.compute_virtualmachines 네임스페이스로 시작합니다.
이 두 네임스페이스가 메트릭을 반환하지 않는 경우 Azure Portal 내 가상 머신에 대해 Diagnostics가 활성화되어 있는지 확인하세요. Boot 진단과 Basic 메트릭만 필요합니다.
클래식 가상 머신의 경우:
For ARM deployed VMs:
가상 머신이 실행 중인지 확인해야 합니다.
통합 기능은 중지되거나 할당 해제된 가상 머신에 대한 성능 메트릭을 수집하지 않습니다. azure.vm.count 메트릭과 running, stopped, stopped_deallocated의 status 태그 값을 사용하여 호스트의 상태를 확인합니다. 해당 호스트의 상태가 status:running인지 확인하고, 호스트가 Azure 포털에서 실행 중인지 확인합니다.
azure.*.count 메트릭 관련 문제
Azure 통합이 메트릭을 보고하지만 azure.*.count를 보고하지 않거나 azure.*.count가 status:query_failed를 반환하는 경우, Azure 구독에서 Azure 리소스 상태 공급자를 등록해야 합니다.
Azure 명령줄 인터페이스 사용:
azure login # Login to the Azure user associated with your Datadog accountazure config mode arm
azure provider register Microsoft.ResourceHealth