- 필수 기능
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- 디지털 경험
- 소프트웨어 제공
- 보안
- 로그 관리
- 관리
- 인프라스트럭처
- ci
- containers
- csm
- ndm
- otel_guides
- overview
- slos
- synthetics
- tests
- 워크플로
하단의 설정 옵션을 선택하여 로그 수집을 시작합니다. 이미 로그 전달자 Daemon을 사용하고 있다면 Rsyslog, Syslog-ng, NXlog, FluentD, 또는 로그스태시(Logstash) 전용 설명서를 참조하세요.
로그를 Datadog으로 직접 보내려면 사용할 수 있는 Datadog 로그 수집 엔드포인트 목록을 참조하세요.
참고: 로그를 JSON 형식으로 Datadog에 전송할 시, Datadog에는 특정 의미를 갖는 예약 속성 집합이 존재합니다. 자세한 내용을 확인하려면 예약 속성 섹션을 참조하세요.
datadog.yaml
)에서 logs_enabled: false
을 logs_enabled: true
로 변경합니다. 자세한 정보와 예시를 확인하려면 호스트 에이전트 로그 수집 설명서를 참조하세요.datadog.yaml
)에서 logs_enabled: false
을 logs_enabled: true
로 변경합니다. 자세한 정보와 예시를 확인하려면 호스트 에이전트 로그 수집 설명서를 참조하세요.컨테이너 또는 오케스트레이터 공급자를 선택하고 다음의 로그 수집 전용 지침을 따르세요:
참조:
Datadog 에이전트는 로깅 드라이버를 사용하지 않고 컨테이너의 stdout/stderr에서 직접 로그를 수집할 수 있습니다. 에이전트의 도커(Docker) 점검을 활성화하면 컨테이너 및 오케스트레이터 메타데이터가 로그에 태그로 자동 추가됩니다.
모든 컨테이너에서 로그를 수집하거나 컨테이너 이미지, 라벨 또는 이름으로 필터링한 하위 집합만을 수집할 수 있습니다.
자동탐지 기능을 사용하여 컨테이너 라벨에서 로그를 직접 수집하도록 설정할 수도 있습니다.
쿠버네티스(Kubernetes) 환경에서는 DaemonSet 설치를 활용할 수도 있습니다.
환경에서 Datadog으로 로그를 전송하는 AWS Lambda 함수인 Datadog 포워더(Forwarder)를 사용합니다. AWS 서버리스 환경에서 로그 수집을 활성화하려면 Datadog 포워더(Forwarder) 설명서를 참조하세요.
Datadog은 SSL 암호화 연결과 암호화되지 않은 연결 모두 로깅 엔드포인트를 제공합니다. 되도록 암호화된 엔드포인트를 사용하세요. Datadog 에이전트는 암호화 엔드포인트를 사용하여 Datadog에 로그를 전송합니다. 자세한 내용을 확인하려면 Datadog 보안 문서를 참조하세요.
페이지 오른쪽의 사이트 선택 드롭다운 메뉴에서 Datadog 사이트별 지원 엔드포인트를 확인할 수 있습니다.
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
US | HTTPS | http-intake.logs.datadoghq.com | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
US | HTTPS | agent-http-intake-pci.logs.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 PCI DSS 규정을 준수하도록 설정한 조직에 로그를 전송하는 데 사용됩니다. 자세한 내용을 확인하려면 로그 관리용 PCI DSS 규정 준수를 참조하세요. |
US | HTTPS | agent-http-intake.logs.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
US | HTTPS | lambda-http-intake.logs.datadoghq.com | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
US | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
US | TCP | agent-intake.logs.datadoghq.com | 10514 | 에이전트가 TLS 없이 로그를 전송하는 데 사용됩니다. |
US | TCP 및 TLS | agent-intake.logs.datadoghq.com | 10516 | 에이전트가 TLS로 로그를 전송하는 데 사용됩니다. |
US | TCP 및 TLS | intake.logs.datadoghq.com | 443 | 커스텀 포워더가 SSL 암호화 TCP 연결을 통해 원시값, Syslog 또는 JSON 형식으로 로그를 전송하는 데 사용됩니다. |
US | TCP 및 TLS | functions-intake.logs.datadoghq.com | 443 | Azure 함수가 SSL 암호화 TCP 연결을 통해 원시값, Syslog 또는 JSON 형식의 로그를 전송하는 데 사용됩니다. 참고: 해당 엔드포인트는 기타 클라우드 제공업체에 유용할 수 있습니다. |
US | TCP 및 TLS | lambda-intake.logs.datadoghq.com | 443 | Lambda 함수가 SSL 암호화 TCP 연결을 통해 원시값, Syslog 또는 JSON 형식으로 로그를 전송하는 데 사용됩니다. |
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
EU | HTTPS | http-intake.logs.datadoghq.eu | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
EU | HTTPS | agent-http-intake.logs.datadoghq.eu | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
EU | HTTPS | lambda-http-intake.logs.datadoghq.eu | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
EU | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
EU | TCP 및 TLS | agent-intake.logs.datadoghq.eu | 443 | 에이전트가 SSL 암호화 TCP 연결을 통해 프로토콜 버퍼(protobuf) 형식으로 로그를 전송하는 데 사용됩니다. |
EU | TCP 및 TLS | functions-intake.logs.datadoghq.eu | 443 | Azure 함수가 SSL 암호화 TCP 연결을 통해 원시값, Syslog 또는 JSON 형식의 로그를 전송하는 데 사용됩니다. 참고: 해당 엔드포인트는 기타 클라우드 제공업체에 유용할 수 있습니다. |
EU | TCP 및 TLS | lambda-intake.logs.datadoghq.eu | 443 | Lambda 함수가 SSL 암호화 TCP 연결을 통해 원시값, Syslog 또는 JSON 형식으로 로그를 전송하는 데 사용됩니다. |
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
US3 | HTTPS | http-intake.logs.us3.datadoghq.com | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
US3 | HTTPS | lambda-http-intake.logs.us3.datadoghq.com | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
US3 | HTTPS | agent-http-intake.logs.us3.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
US3 | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
US5 | HTTPS | http-intake.logs.us5.datadoghq.com | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
US5 | HTTPS | lambda-http-intake.logs.us5.datadoghq.com | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
US5 | HTTPS | agent-http-intake.logs.us5.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
US5 | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
AP1 | HTTPS | http-intake.logs.ap1.datadoghq.com | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
AP1 | HTTPS | lambda-http-intake.logs.ap1.datadoghq.com | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
AP1 | HTTPS | agent-http-intake.logs.ap1.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
AP1 | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
사이트 | 유형 | 엔드포인트 | 포트 | 설명 |
---|---|---|---|---|
US1-FED | HTTPS | http-intake.logs.ddog-gov.com | 443 | 커스텀 포워더(Forwarder)가 HTTPS를 통해 JSON 또는 일반 텍스트 형식의 로그를 전송하는 데 사용됩니다. 로그 HTTP API 문서를 참조하세요. |
US1-FED | HTTPS | lambda-http-intake.logs.ddog-gov.datadoghq.com | 443 | Lambda 함수가 로그를 HTTPS를 통해 원시값, Syslog 또는 JSON 형식으로 전송하는 데 사용됩니다. |
US1-FED | HTTPS | agent-http-intake.logs.ddog-gov.datadoghq.com | 443 | 에이전트가 HTTPS를 통해 로그를 JSON 형식으로 전송하는 데 사용됩니다. 호스트 에이전트 로그 수집 문서를 참조하세요. |
US1-FED | HTTPS | logs.
| 443 | 브라우저 SDK가 로그를 HTTPS를 통해 JSON 형식으로 전송하는 데 사용됩니다. |
커스텀 프로세스 또는 로깅 라이브러리는 TCP 또는 HTTP를 통해 로그를 전달할 수 있으며, Datadog 로그와 함께 사용할 수 있습니다 .
HTTP를 통해 Datadog 플랫폼으로 로그를 전송할 수 있습니다. Datadog 로그 HTTP API 문서를 참조하여 시작해 보세요.
OpenSSL, GnuTLS 또는 다른 SSL/TLS 클라이언트를 사용하여 연결을 수동으로 테스트할 수 있습니다. GnuTLS의 경우 다음 명령을 실행합니다.
gnutls-cli intake.logs.datadoghq.com:10516
OpenSSL의 경우 다음 명령을 실행합니다.
openssl s_client -connect intake.logs.datadoghq.com:10516
반드시 로그 엔트리에 [Datadog API 키][1] 접두사를 추가하고 페이로드를 추가해야 합니다.
<DATADOG_API_KEY> Log sent directly using TLS
페이로드 또는 예시에 명시된 Log sent directly using TLS
는 원시값, Syslog 또는 JSON 형식일 수 있습니다. 페이로드가 JSON 형식인 경우 Datadog은 자동으로 해당 속성을 파싱합니다.
<DATADOG_API_KEY> {"message":"json formatted log", "ddtags":"env:my-env,user:my-user", "ddsource":"my-integration", "hostname":"my-hostname", "service":"my-service"}
[1]: /ko/account_management/api-app-keys/#api-keys
OpenSSL, GnuTLS 또는 다른 SSL/TLS 클라이언트를 사용하여 연결을 수동으로 테스트할 수 있습니다. GnuTLS의 경우 다음 명령을 실행합니다.
gnutls-cli tcp-intake.logs.datadoghq.eu:443
OpenSSL의 경우 다음 명령을 실행합니다.
openssl s_client -connect tcp-intake.logs.datadoghq.eu:443
반드시 로그 엔트리에 Datadog API 키 접두사를 추가하고 페이로드를 추가해야 합니다.
<DATADOG_API_KEY> Log sent directly using TLS
페이로드 또는 예시에 명시된 Log sent directly using TLS
는 원시값, Syslog 또는 JSON 형식일 수 있습니다. 페이로드가 JSON 형식인 경우 Datadog은 자동으로 해당 속성을 파싱합니다.
<DATADOG_API_KEY> {"message":"json formatted log", "ddtags":"env:my-env,user:my-user", "ddsource":"my-integration", "hostname":"my-hostname", "service":"my-service"}
해당 사이트에는 TCP 엔드포인트를 권장하지 않습니다. 자세한 내용을 확인하려면 고객지원에 문의하세요.
해당 사이트에서는 TCP 엔드포인트가 지원되지 않습니다.
참조:
해당 제한을 준수하지 않는 로그 이벤트는 시스템에 의해 변환되거나 잘릴 수 있으며, 제시된 시간을 벗어날 경우 색인화되지 않을 수 있습니다. 그러나 Datadog은 사용자 데이터를 최대한 많이 보존하려 노력합니다.
속성은 로그 탐색기에서 필터링 및 검색에 사용되는 로그 패싯을 규정합니다. 속성 및 앨리어싱 전용 문서를 참조하여 예약 및 표준 속성 목록을 확인하고 로그 속성 및 앨리어싱 명명 규칙 지원 방식을 알아보세요.
스택 트레이스(stack trace) 로그 수집 시, 로거 이름, 현재 스레드, 에러 타입, 스택 트레이스 자체 등, Datadog 애플리케이션 내 전용 UI 표시가 있는 특정 속성이 있습니다.
해당 기능을 활성화하려면 다음 속성 이름을 사용합니다.
속성 | 설명 |
---|---|
logger.name | 로거 이름 |
logger.thread_name | 현재 스레드 이름 |
error.stack | 실제 스택 트레이스(stack trace) |
error.message | 스택 트레이스(stack trace)에 포함된 에러 메시지 |
error.kind | 에러의 타입 또는 ‘종류’ (예: ‘예외’ 또는 ‘OSError’) |
참고: 기본적으로 통합 파이프라인은 기본 로깅 라이브러리 파라미터를 해당 특정 속성으로 리매핑하고, 스택 트레이스(stack trace) 또는 트레이스백을 파싱하여 error.message
및 error.kind
을 자동으로 추출하려 합니다.
자세한 내용을 확인하려면 소스 코드 속성 문서 전문을 참조하세요.
로그가 수집되면 로그 탐색기에서 이용할 수 있습니다. 로그 탐색기는 로그에 대한 알림을 검색하고, 보강하고, 확인할 수 있는 기능입니다. 로그 탐색기 문서를 확인하여 로그 데이터 분석을 시작하거나 하단의 추가 로그 관리 문서를 참조하세요.
Additional helpful documentation, links, and articles: