본문 바로가기
WIKI 기술 지식 베이스

커스텀 로그 구성하기 (Configure Custom Logs)

원문 보기 위키 갱신

Fleet Automation으로 커스텀 로그 수집 설정을 원격에서 대규모로 관리하는 방법을 알려드릴게요. host별로 conf.d 파일을 편집하는 대신 호스트 정보나 태그로 변경 범위를 정해 한 번에 배포할 수 있어요.

출처: 문서

본문

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

이 제품은 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 지원되지 않아요.

Fleet Automation을 사용해 Agent의 커스텀 로그 수집 설정을 원격에서 대규모로 관리할 수 있어요. conf.d 설정 파일을 호스트별로 편집하는 대신 호스트 정보나 태그로 변경 범위를 정하고 일치하는 모든 Agent에 한 번에 배포해요. 배포 전에 범위 내 각 Agent의 구성 diff를 검토해요.

사전 요구 사항 (Prerequisites)

  • 조직에서 Remote Configuration이 활성화되어 있을 것
  • Agent 7.76 이상. Agent 업그레이드 방법은 Agent 업그레이드 참고
  • Linux VM(설치 스크립트나 Ansible Datadog Role로 설치) 또는 Windows VM
  • 대상 Agent에서 로그 수집이 활성화되어 있을 것(datadog.yaml에서 logs_enabled: true). Fleet Automation은 어느 쪽이든 설정 파일을 배포하지만, 로그 수집이 활성화되기 전까지는 Agent가 로그 수집을 시작하지 않아요. 호스트 Agent 로그 수집 참고.

컨테이너화된 워크로드의 Agent에서 커스텀 로그를 구성하는 것은 지원되지 않아요. 컨테이너 환경은 Kubernetes 로그 수집을 참고하세요.

여러 Agent에 걸쳐 커스텀 로그 구성하기

구성 마법사를 진행할 때 Configuration Summary 패널에 현재 선택된 Agent 범위가 표시돼요. 범위 내 특정 Agent의 구성 diff를 미리 보면 변경이 Agent에 어떤 영향을 주는지 확인할 수 있어요.

  1. Fleet Automation에서 Configuration 탭을 열고 Configure Agents를 클릭해요.

  2. 대상을 특정 Agent로 범위를 정해요. 특정 그룹을 대상으로 호스트 정보나 태그로 필터링해요.

  3. Custom Logs를 선택해요.

  4. 작업(operation)을 선택해요(자세한 내용은 How configuration changes are applied 참고):

    • Add New. 새 설정 파일의 파일 이름을 지정하고 안내에 따라 구성을 작성해요. 로그 수집 필드에 대한 설명은 커스텀 로그 수집을 참고하세요. Tags 필드로 수집된 로그에 태그를 붙일 수 있어요. + Add Log Collection을 클릭하면 로그 수집 설정을 더 추가할 수 있어요.
    • Edit & Replace. Select a File을 클릭해 교체할 설정 파일을 선택한 뒤 로그 수집 설정을 업데이트해요.
    • Delete. Select a File to Delete를 클릭해요. 로그 수집 구성을 작성할 때 Visual 모드와 YAML 모드를 전환할 수 있어요. YAML 모드에서는 YAML을 직접 붙여넣을 수 있어요.

  5. 배포 계획을 검토해요. Fleet Automation은 영향받는 각 Agent에 대한 구성 diff를 생성해 정확한 변경 사항을 확인할 수 있게 해 줘요.

  6. Deploy Configuration을 클릭해 배포를 시작해요. 진행 상황은 Deployments 페이지에서 추적할 수 있어요.

구성 변경이 적용되는 방식

각 작업은 Agent의 커스텀 로그 수집에 다르게 변경을 적용해요:

  • Add New: 새 설정 파일을 배포해요.

  • Edit & Replace: 전체 설정 파일을 교체해요. 업데이트에 원하는 모든 값을 포함하세요. 누락한 값은 제거돼요.

  • Delete: 대상 Agent에서 설정 파일을 제거해요.

로그 수집 확인하기

구성을 배포한 뒤:

  1. Fleet Automation에서 대상이 된 Agent 중 하나의 세부 정보 페이지를 열어요.
  2. Configuration 탭에서 새로 추가되거나 업데이트된 커스텀 로그 설정 파일이 오류 상태 없이 나열되는지 확인해요. 이는 구성이 푸시되고 성공적으로 적용됐다는 뜻이에요.

배포는 성공했는데 로그가 도착하지 않는다면 로그 수집 문제 해결 가이드를 참고하세요.

더 알아보기 (Learn more)

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