애플리케이션 성능 모니터링(APM) 연결 오류

추적 라이브러리 기능이 있는 애플리케이션을 Datadog 에이전트에 연결할 수 없는 경우, 트레이서 시작 로그 또는 트레이서 디버그 로그에서 연결 오류를 찾아보세요. 애플리케이션 로그에서 찾을 수 있습니다.

애플리케이션 성능 모니터링(APM) 연결 문제를 나타내는 오류

해당 메시지가 표시되면 트레이스가 Datadog 에이전트에 전송되고 있지 않은 것입니다.

라이브러리 오류 추적

애플리케이션 로그

애플리케이션이 Datadog 에이전트에 연결할 수 없는 경우, 다음 로그 메시지가 애플리케이션이 로그를 전송하는 위치로 전송됩니다.

Error sending traces to agent: Couldn't connect to server
Failed to connect to localhost port 8126: Connection refused

Datadog 에이전트 오류

agent status 명령(에이전트 6.20.0/7.20.0에서 사용 가능)에 애플리케이션 성능 모니터링(APM)이 실행 중이지 않거나 localhost:8126에 연결할 수 없다고 표시되는 경우, Datadog 에이전트에 애플리케이션 성능 모니터링(APM)이 설정되어 있지 않아 트레이스를 Datadog 백엔드로 전송할 수 없는 상태입니다.

APM Agent
=========
  Status: Not running or unreachable on localhost:8126.

연결 문제 트러블슈팅

추적 라이브러리 또는 Datadog 에이전트 오류가 표시되는 경우 다음 몇 가지 방법으로 문제를 해결할 수 있습니다.

호스트 기반 설정

애플리케이션 및 Datadog 에이전트가 컨테이너화되지 않은 경우, 추적 라이브러리가 있는 애플리케이션은 트레이스를 localhost:8126 또는 127.0.0.1:8126으로 전송하려고 시도합니다. 이는 Datadog 에이전트가 해당 트레이스의 수신 대기하는 위치이기 때문입니다.

Datadog 에이전트에 애플리케이션 성능 모니터링(APM) 수신 대기중이 아니라고 표시되는 경우, 점검 포트가 Datadog 에이전트의 애플리케이션 성능 모니터링(APM) 구성 요소가 기본값으로 사용하는 포트 8126과 충돌하는 상태입니다.

근본 원인을 파악할 수 없다면 다음 정보와 함께 Datadog 지원 팀에 문의하세요.

  • 애플리케이션 및 Datadog 에이전트를 배포하는 환경 정보.
  • 프록시를 사용하는 경우 해당 프록시 설정에 대한 정보.
  • 기본 포트를 8126에서 다른 포트로 변경하려는 경우 해당 포트에 대한 정보.
  • Datadog 에이전트 플레어(flare).

컨테이너화된 설정

네트워크 설정 점검

컨테이너화된 설정의 경우 Datadog 에이전트도 컨테이너화되어 다른 곳에 위치하므로 트레이스를 localhost 또는 127.0.0.1로 전송하는 것은 종종 올바르지 않을 수 있습니다. 참고: Fargate의 Amazon ECS 및 Fargate의 AWS EKS는 해당 규칙에서 제외됩니다.

애플리케이션과 Datadog 에이전트 사이의 네트워킹이 해당 설정 요구사항과 일치하는지 확인하세요.

특히 Datadog 에이전트가 8126 포트(또는 정의한 포트)에 접근할 수 있는지, 애플리케이션이 Datadog 에이전트 위치로 트레이스를 직접 전송할 수 있는지 점검하세요. 이를 확인하려면 애플리케이션 컨테이너에서 다음 명령을 실행하여 {agent_ip} 및 {agent_port} 변수를 교체합니다.

curl -X GET http://{agent_ip}:{agent_port}/info

본 명령이 실패하면 컨테이너는 에이전트에 접근할 수 없습니다. 문제의 원인에 대한 힌트를 얻으려면 다음 섹션을 참조하세요.

애플리케이션 성능 모니터링(APM) 인앱 설정 문서에서부터 시작하시기를 권장합니다.

추적 라이브러리가 트레이스를 전송하려는 위치를 검토합니다.

각 언어당 상기 명시한 오류 로그를 사용하여 트레이스가 어디로 보내지는지 확인하세요.

설정 예시를 확인하려면 하단의 표를 참조하세요. 일부는 해당 문서에 자세히 설명되어 있는 네트워크 구성을 추가로 설정해야 합니다.

설정DD_AGENT_HOST
EC2 Amazon ECSAmazon의 EC2 메타데이터 엔드포인트 평가
Fargate Amazon ECSDD_AGENT_HOST을 설정하지 않음
Fargate AWS EKSDD_AGENT_HOST을 설정하지 않음
AWS Elastic Beanstalk - 싱글 컨테이너게이트웨이 IP (일반적으로 172.17.0.1)
AWS Elastic Beanstalk - 다중 컨테이너Datadog 에이전트 컨테이너 이름에 포인팅된 링크
쿠버네티스(Kubernetes)1) 유닉스 도메인 소켓(Unix Domain Socket), 2) 수동으로 추가된 status.hostIP 또는 3) 어드미션 컨트롤러를 통해서. TCP를 사용하는 경우, 컨테이너에 적용된 네트워크 정책을 확인하세요.
AWS EKS(Non-Fargate)1) 유닉스 도메인 소켓(Unix Domain Socket), 2) 수동으로 추가된 status.hostIP 또는 3) 어드미션 컨트롤러를 통해서.
Datadog 에이전트 및 애플리케이션 도커(Docker) 컨테이너Datadog 에이전트 컨테이너

웹 서버 관련 참고 사항: 트레이서 시작 로그의 agent_url 섹션이 전달된 DD_AGENT_HOST 환경 변수와 일치하지 않는 경우, 특정 서버에 대해 해당 환경 변수가 캐스케이드되는 방식을 확인합니다. 예를 들어, PHP에는 Apache 또는 Nginx가 DD_AGENT_HOST 환경 변수를 올바르게 선택하도록 하는 추가 설정이 있습니다.

추적 라이브러리가 트레이스를 정확하게 전송하는 경우 다음 단계로 진행합니다.

Datadog 에이전트 상태 및 설정을 검토합니다.

Fargate에서 설정되어 있지 않은 경우, Datadog 에이전트 컨테이너에서 exec 수행 및 에이전트 상태 명령어 agent status를 실행할 수 있습니다.

참고: 쿠버네티스(Kubernetes)를 전용 컨테이너와 함께 사용하는 경우 전용 트레이스 에이전트 컨테이너에서 exec를 수행합니다.

애플리케이션 성능 모니터링(APM) 에이전트 섹션에서 다음의 실행 여부를 확인합니다.

=========
APM Agent
=========
  Status: Running
  Pid: <pid number>
  Uptime: <integer> seconds
  Mem alloc: <integer> bytes
  Hostname: <name of datadog agent container>
  Receiver: 0.0.0.0:8126
  Endpoints:
    https://trace.agent.datadoghq.com

  Receiver (previous minute)
  ==========================
    No traces received in the previous minute.
    Default priority sampling rate: 100.0%

설정이 올바른데도 연결 오류가 계속 표시되는 경우 다음 정보와 함께 Datadog 지원 팀에 문의하세요.

  • 애플리케이션 및 Datadog 에이전트를 배포하는 환경 정보.
  • 프록시를 사용하는 경우 해당 프록시 설정에 대한 정보.
  • 애플리케이션 및 Datadog 에이전트 설정에 사용되는 모든 설정 파일.
  • 연결 오류를 요약한 시작 로그 또는 트레이서 디버그 로그.
  • Datadog 에이전트 플레어(flare). 전용 컨테이너의 경우 전용 트레이스 에이전트 컨테이너의 플레어를 전송합니다.
PREVIEWING: brett.blue/embedded-collector-release