개요

모든 Agent 트래픽은 SSL을 통해 전송됩니다. Datadog 서비스 및 사이트에 따라 대상이 결정됩니다. Datadog 사이트에 따른 대상을 보려면 오른쪽의 DATADOG SITE 선택기를 클릭하세요.

설치

Agent 설치를 허용하려면 다음의 도메인을 포함 목록에 추가하세요.

• install.datadoghq.com
• yum.datadoghq.com
• keys.datadoghq.com
• apt.datadoghq.com
• windows-agent.datadoghq.com

대상

APM

trace.agent.
instrumentation-telemetry-intake.

LLM Observabilty

llmobs-intake.

컨테이너 이미지

contimage-intake.

Live Containers, Live Process, Cloud Network Monitoring, Universal Service Monitoring

process.

Network Device Monitoring

ndm-intake.
snmp-traps-intake.
ndmflow-intake.

Network Path

netpath-intake.
Agent v7.75+에서는 Network Path가 소스 호스트의 퍼블릭 IP를 리졸브하기 위해 HTTPS를 사용해 외부 서비스에 접속합니다. 이것은 선택 사항이고 Network Path는 이 기능 없이도 정상 작동하지만, 네트워크가 아웃바운드 트래픽을 제한하고 소스 퍼블릭 IP를 리졸브하고자 하는 경우, 허용 목록에 다음을 추가하세요. icanhazip.com, ipinfo.io, checkip.amazonaws.com, api.ipify.org, whatismyip.akamai.com. 자세한 내용은 Network Path 설정을 참조하세요.

오케스트레이터

orchestrator.
contlcycle-intake.

프로파일링

intake.profile.

Real User Monitoring(RUM)

Cloud Security 취약점

sbom-intake.

Synthetic Monitoring 프라이빗 위치

Synthetics Worker v1.5.0 이상: intake.synthetics. 엔드포인트만 구성하면 됩니다.
Synthetics Worker > v0.1.6의 API 테스트 결과: intake.synthetics.
Synthetics Worker > v0.2.0의 브라우저 테스트 결과: intake-v2.synthetics.
Synthetics Worker < v0.1.5의 API 테스트 결과: api.

로그 및 HIPAA 로그

(사용 중단됨) TCP:
HTTP:
기타: 로그 엔드포인트 참조

HIPAA 로그 레거시(사용 중단됨, TCP 지원되지 않음)

Metrics, 서비스 검사, 이벤트 및 기타 Agent 메타데이터

<VERSION>-app.agent.
예를 들어 Agent v7.31.0은 7-31-0-app.agent.에 보고합니다. 방화벽의 포함 목록에 *.agent. 를 추가해야 합니다.
Agent는 v6.1.0 이후부터 Datadog의 API에 중요하지 않은 기능도 제공하도록 쿼리합니다(예를 들어 구성된 API 키의 유효성 표시).
Agent v7.18.0 또는 6.18.0 이상: api.
Agent < v7.18.0 또는 6.18.0: app.

Agent flare

<VERSION>-flare.agent.
예를 들어 Agent v7.31.0 은 flare 데이터를 7-31-0-flare.agent.로 보냅니다. 방화벽의 포함 목록에 *.agent. 를 추가해야 합니다.

정적 IP 주소

이러한 모든 도메인은 일련의 정적 IP 주소를 가리키는 CNAME 레코드입니다. 이러한 주소는 https://ip-ranges.에서 확인할 수 있습니다..

정보는 이 스키마를 따른 JSON 형식으로 구조화됩니다.

{
    "version": 1,                          // <-- incremented every time this information is changed
    "modified": "YYYY-MM-DD-HH-MM-SS",     // <-- timestamp of the last modification
    "agents": {                            // <-- the IPs used by the Agent to submit metrics to Datadog
        "prefixes_ipv4": [                 // <-- list of IPv4 CIDR blocks
            "a.b.c.d/x",
            ...
        ],
        "prefixes_ipv6": [                 // <-- list of IPv6 CIDR blocks
            ...
        ]
    },
    "api": {...},                          // <-- the IPs used by the Agent for non-critical functionality (querying information from API)
    "apm": {...},                          // <-- the IPs used by the Agent to submit APM data to Datadog
    "logs": {...},                         // <-- the IPs used by the Agent to submit logs to Datadog
    "process": {...},                      // <-- the IPs used by the Agent to submit process data to Datadog
    "orchestrator": {...},                 // <-- the IPs used by the Agent to submit container data to Datadog
    "remote-configuration": {...},         // <-- the IPs used by the Agent to retrieve its dynamic configuration
    "synthetics": {...},                   // <-- the source IPs used by Synthetic workers (not used by the Agent)
    "synthetics-private-locations": {...}, // <-- the IPs used by Synthetics Private Locations workers to submit data to Datadog (not used by the Agent)
    "webhooks": {...}                      // <-- the source IPs used by Datadog to connect to 3rd party infrastructure over HTTP (not used by the Agent)
}

각 섹션에는 전용 엔드포인트가 있습니다. 다음 예를 참고하세요.

• https://ip-ranges./logs.json은 TCP를 통해 로그 데이터를 수신하는 데 사용되는 IP입니다.
• https://ip-ranges./apm.json은 APM 데이터를 수신하는 데 사용되는 IP입니다.

포함

ip-ranges를 모두 포함 목록에 추가하세요. 언제든 부분 집합 하나만 활성 상태이지만, 정기 네트워크 작업 및 유지 관리로 인해 시간이 지나면서 전체 세트 안에 변형 버전이 생깁니다.

포트 열기

다음 포트를 열어 Agent 기능을 모두 활용하세요.

아웃바운드

인바운드

호스트 내에서 로컬로 서로 통신하는 Agent 서비스에만 사용됩니다.

포트 구성

기본 포트를 이미 네트워크상의 기존 서비스가 사용 중이라서 인바운드 포트를 변경해야 하는 경우, datadog.yaml 구성 파일을 편집하세요. 대부분의 포트는 파일의 고급 구성 섹션에서 확인할 수 있습니다.

## @param expvar_port - integer - optional - default: 5000
## @env DD_EXPVAR_PORT - integer - optional - default: 5000
## The port for the go_expvar server.
#
# expvar_port: 5000

## @param cmd_port - integer - optional - default: 5001
## @env DD_CMD_PORT - integer - optional - default: 5001
## The port on which the IPC api listens.
#
# cmd_port: 5001

## @param GUI_port - integer - optional
## @env DD_GUI_PORT - integer - optional
## The port for the browser GUI to be served.
## Setting 'GUI_port: -1' turns off the GUI completely
## Default is:
##  * Windows & macOS : `5002`
##  * Linux: `-1`
##
#
# GUI_port: <GUI_PORT>

APM 수신기 및 DogStatsD 포트는 datadog.yaml 구성 파일에서 각각 Trace Collection Configuration, DogStatsD Configuration 섹션에 있습니다.

## @param dogstatsd_port - integer - optional - default: 8125
## @env DD_DOGSTATSD_PORT - integer - optional - default: 8125
## Override the Agent DogStatsD port.
## Note: Make sure your client is sending to the same UDP port.
#
# dogstatsd_port: 8125

[...]

## @param receiver_port - integer - optional - default: 8126
## @env DD_APM_RECEIVER_PORT - integer - optional - default: 8126
## The port that the trace receiver should listen on.
## Set to 0 to disable the HTTP receiver.
#
# receiver_port: 8126

프록시 사용

프록시 설정에 대한 자세한 구성 가이드는 Agent 프록시 구성을 참조하세요.

데이터 버퍼링

네트워크를 사용할 수 없게 되면 Agent가 메모리에 메트릭을 저장합니다. 메트릭 저장을 위한 메모리 최대 사용량은 forwarder_retry_queue_payloads_max_size 구성 설정으로 정의됩니다. 이 한도에 도달하면 메트릭이 삭제됩니다.

Agent v7.27.0 이상은 메모리 한도에 도달했을 때 메트릭을 디스크에 저장합니다. 이 기능을 활성화하려면 forwarder_storage_max_size_in_bytes를 양수로 설정하세요. 이것이 Agent가 메트릭을 디스크에 저장하는 데 사용할 수 있는 최대 스토리지 공간 양을 나타냅니다(바이트 단위).

메트릭은 forwarder_storage_path 설정에서 정의된 폴더에 저장되며, 이는 기본적으로 Unix 시스템의 경우 /opt/datadog-agent/run/transactions_to_retry, Windows의 경우 C:\ProgramData\Datadog\run\transactions_to_retry입니다.

저장 공간 부족을 방지하기 위해 Agent는 총 사용 저장 공간이 80% 미만인 경우에만 메트릭을 디스크에 저장합니다. 이 한도는forwarder_storage_max_disk_ratio 설정으로 정의됩니다.

Datadog Operator 설치

연결에 한계가 있는 Kubernetes 환경에 Datadog Operator를 설치하는 경우, 레지스트리에 따라 다음과 같은 TCP 포트 443 엔드포인트를 허용 목록에 추가해야 합니다.

• registry.datadoghq.com(Datadog 컨테이너 레지스트리)
  • us-docker.pkg.dev/datadog-prod/public-images(registry.datadoghq.com에서 리디렉션을 수신할 수 있음)
• gcr.io/datadoghq(GCR US)
• eu.gcr.io/datadoghq(GCR Europe)
• asia.gcr.io/datadoghq(GCR Asia)
• datadoghq.azurecr.io(Azure)
• public.ecr.aws/datadog(AWS)
• docker.io/datadog(DockerHub)

추가 자료

추가 유용한 문서, 링크 및 기사:

Datadog 사이트에 대해 알아보기설명서 로그 수집설명서 프로세스 수집설명서 트레이스 수집설명서