Agent Flare

문제 해결에 필요한 정보를 Datadog 지원팀에 보낼 수 있는 flare 기능에 대해 알려드릴게요. flare 명령어로 보내는 방법부터 Datadog 사이트에서 원격으로 보내는 방법, 수동 제출까지 함께 살펴봐요.

출처: 문서

본문

flare를 사용하면 필요한 문제 해결 정보를 Datadog 지원팀에 보낼 수 있어요.

이 페이지에서 다루는 내용:

• flare 명령어로 flare 보내기
• Remote Configuration을 사용해 Datadog 사이트에서 flare 보내기
• 수동 제출

flare는 Agent의 모든 설정 파일과 로그를 아카이브 파일로 모아요. 비밀번호, API 키, Proxy 자격 증명, SNMP 커뮤니티 문자열 같은 민감한 정보는 제거해요. APM이 활성화되어 있으면 flare는 가능할 때 tracer 디버그 로그도 포함해요.

Datadog Agent는 완전히 오픈소스라서 코드 동작을 직접 검증할 수 있어요. flare는 업로드 전에 확인을 요청하므로 필요하다면 보내기 전에 검토할 수 있어요.

Agent에 Remote Configuration이 활성화된 상태로 Datadog 지원팀에 문의하면, 지원팀이 신속하게 도움을 드리기 위해 여러분의 환경에서 flare를 시작할 수도 있어요. flare는 문제 해결 정보를 Datadog 지원팀에 제공해 문제를 해결하는 데 도움을 줘요.

Datadog 사이트에서 flare 보내기

app.ddog-gov.com, us2.ddog-gov.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

선택한 Datadog 사이트({% placeholder "user-datadog-datacenter" /%})에서는 Fleet Automation에서 Agent Flare를 보내는 것이 지원되지 않아요. 대신 수동 flare 제출을 사용하세요.

Datadog 사이트에서 flare를 보내려면 Agent에서 Fleet Automation과 Remote configuration을 활성화했는지 확인하세요.

원격 flare를 보내려면:

1. Fleet Automation 페이지에서 지원이 필요한 Agent를 선택하세요.
2. Support를 클릭해요.
3. Send Support Ticket을 클릭해요.
4. 기존 Zendesk 지원 티켓 번호를 제공해요. 티켓 번호를 제공하지 않으면 대신 티켓이 생성돼요.
5. Debug mode를 활성화하면 Datadog 지원팀이 더 빨리 문제를 해결할 수 있어요. flare를 보낸 후 로그 레벨은 이전 설정으로 되돌아가요.
6. 애플리케이션 문제를 해결 중이라면 flare에 애플리케이션 tracer 레벨 로그가 포함되도록 활성화해요.
7. Send Ticket을 클릭해요.

flare 명령어로 flare 보내기

app.ddog-gov.com, us2.ddog-gov.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

선택한 Datadog 사이트({% placeholder "user-datadog-datacenter" /%})에서는 flare 하위 명령어로 Agent Flare를 보내는 것이 지원되지 않아요. 대신 수동 flare 제출을 사용하세요.

flare를 보내려면 flare 하위 명령어를 사용해요. 아래 명령어에서 <CASE_ID>를 보유한 Datadog 지원 케이스 ID로 바꾸고, 그에 연결된 이메일 주소를 입력하세요.

케이스 ID가 없다면 Datadog에 로그인하는 데 사용한 이메일 주소를 입력해 새 지원 케이스를 만드세요.

아카이브 업로드를 확인해 즉시 Datadog 지원팀으로 보내세요.

Agent

전용 컨테이너 (Dedicated containers)

Agent v7.19+를 사용하고 최신 버전의 Datadog Helm Chart나 Datadog Agent와 Trace Agent가 별도 컨테이너로 있는 DaemonSet을 사용할 때, 다음을 포함하는 Agent Pod을 배포해요:

• Agent 프로세스 컨테이너(Agent + Log Agent) 하나
• process-agent 프로세스 컨테이너 하나
• trace-agent 프로세스 컨테이너 하나
• system-probe 프로세스 컨테이너 하나

각 컨테이너에서 flare를 얻으려면 다음 명령어를 실행하세요:

Agent

kubectl exec -it <AGENT_POD_NAME> -c agent -- agent flare <CASE_ID>

Process Agent

kubectl exec -it <AGENT_POD_NAME> -c process-agent -- agent flare <CASE_ID> --local

Trace Agent

kubectl exec -it <AGENT_POD_NAME> -c trace-agent -- agent flare <CASE_ID> --local

Security Agent

kubectl exec -it <AGENT_POD_NAME> -c security-agent -- security-agent flare <CASE_ID>

System probe

system-probe 컨테이너는 flare를 보낼 수 없으므로 대신 컨테이너 로그를 가져와요:

kubectl logs <AGENT_POD_NAME> -c system-probe > system-probe.log

ECS Fargate

ECS Fargate 플랫폼 v1.4.0을 사용할 때, Amazon ECS Exec을 활성화하면 ECS 작업과 서비스가 실행 중인 Linux 컨테이너에 접근하도록 구성할 수 있어요. Amazon ECS exec를 활성화한 뒤 다음 명령어로 flare를 보내세요:

aws ecs execute-command --cluster <CLUSTER_NAME> \
    --task <TASK_ID> \
    --container datadog-agent \
    --interactive \
    --command "agent flare <CASE_ID>"

참고: ECS Exec은 새 작업에만 활성화할 수 있어요. ECS Exec을 사용하려면 기존 작업을 다시 만들어야 해요.

Cluster Agent

수동 제출 (Manual submission)

Agent flare 프로토콜은 설정과 로그를 먼저 로컬 /tmp 디렉터리에 있는 아카이브 파일로 수집해요. Agent 연결에 문제가 있다면 이 파일을 직접 가져와 지원팀에 제공하세요.

Kubernetes

Kubernetes에서 아카이브 파일을 가져오려면 kubectl 명령어를 사용해요:

kubectl cp datadog-<pod-name>:tmp/datadog-agent-<date-of-the-flare>.zip flare.zip -c agent

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 글:

• Agent 디버그 모드
• Agent 체크 상태 확인하기