로그 사이드 패널 (Log Side Panel)
Datadog는 개별 로그를 다음과 같은 일반적인 사이드 패널 레이아웃으로 보여줘요:
출처: 문서
본문
- 패널의 윗부분에는 일반적인 컨텍스트(context) 정보가 표시돼요.
- 패널의 아랫부분에는 로그의 실제 콘텐츠(content) 가 표시돼요.
컨텍스트는 로그를 만든 인프라와 애플리케이션 컨텍스트를 의미해요. 정보는 태그에서 수집되며, 자동으로 붙은 태그(호스트 이름, 컨테이너 이름, 로그 파일 이름, 서버리스 함수 이름 등)이거나 Datadog Agent 또는 Log Forwarder가 로그에 커스텀 태그(담당 팀, 환경, 애플리케이션 버전 등)로 추가한 것이에요.
콘텐츠는 로그 자체를 의미해요. 로그 메시지와 함께 Log Pipelines을 통해 로그에서 추출·보강된 모든 구조화 정보를 포함해요. 기술 스택의 일반적인 구성 요소가 만든 로그는 파싱·보강이 기본 제공돼요.
- 파일 로그 수집의 경우, 파일 로그 수집을 트리거하는 source 필드를 제대로 설정해야 해요. 참고: Log Integrations.
- 컨테이너 로그 수집의 경우 Autodiscovery를 사용해요.
error.stack, http.method, duration 같은 몇몇 표준 필드는 Log Panel에서 가독성을 위해 특별히 개선된 표시를 가져요. 로그에서 해당 정보를 추출하고 표준 속성 리매퍼로 속성을 다시 매핑해요.
다른 데이터 소스로의 허브
인프라 데이터와 상관 관계 맺기
View in context 버튼은 필터와 일치하지 않더라도 선택한 로그 바로 앞뒤 시점의 로그 줄을 보여주도록 검색 요청을 업데이트해요. 이 컨텍스트는 상황에 따라 달라요. Datadog가 로그의 적절한 컨텍스트를 찾기 위해 태그와 함께 Hostname, Service, filename, container_id 속성을 사용하거든요.
Metrics 탭을 클릭하면 로그를 중심으로 30분 시간대의 기반 인프라 메트릭에 접근할 수 있어요.
위쪽 예약 속성 섹션의 Host와 상호작용해 관련 호스트 대시보드나 Network Analytics 페이지로 이동해요. Container 섹션과 상호작용하면 하위 매개변수로 범위가 좁혀진 컨테이너 페이지로 이동해요.
로그가 서버리스 소스에서 오면 Host 섹션은 해당 serverless 페이지로 연결되는 Serverless 섹션으로 바뀌어요.
APM 데이터와 상관 관계 맺기
Logs와 APM 상관 관계의 모든 기능을 활용하려면 로그에 trace 주입을 활성화하고 Unified Service Tagging 모범 사례를 따라야 해요.
로그 사이드 패널은 trace ID가 있을 때 로그 이벤트에 trace ID를 바로 표시해요. 이 trace ID를 사용해 Log Explorer에서 로그를 필터링할 수 있어요.
Trace 탭을 클릭하면 상위·하위 서비스가 실행 중인 전체 trace의 컨텍스트에서 로그를 볼 수 있어요. View Trace Details를 클릭해 해당 APM 데이터를 깊이 파고들 수 있어요.
로그에 trace ID가 있는데 관련 trace가 수집되지 않았거나 샘플링으로 인해 보존되지 않았다면, 사이드 패널에 trace가 없다는 메시지가 표시돼요. trace와 로그는 독립적으로 샘플링되므로 로그가 샘플 아웃된 trace를 참조할 수 있어요. 이는 설정 오류가 아니에요. 자세한 내용은 로그에 trace ID가 있는데 관련 trace가 없음을 참고해요.
Service 섹션과 상호작용하면 선택한 서비스와 일치하는 trace 부분을 강조할 수 있어요. 이 정보로 Log Explorer의 쿼리를 재조정하고 같은 trace의 다른 로그를 볼 수 있어요.
트러블슈팅 컨텍스트 구성하기
아래 JSON 섹션의 속성 이름과 값과 상호작용해:
- 로그 테이블에서 컬럼 추가 또는 제거
- 검색 요청에 특정 값 추가 또는 제외(include/exclude)
- 속성에서 패싯이나 측정값 만들기 또는 편집하기. Log Facets 참고.
- 속성에서 계산 필드 만들기 또는 편집하기. Calculated Fields 참고.
로그 공유하기
Share 버튼을 사용해 사이드 패널에서 열린 로그를 다른 컨텍스트로 공유할 수 있어요.
- 클립보드에 복사하거나
Ctrl+C/Cmd+C로 로그 JSON을 클립보드에 복사해요. - Share Event는 이메일, Slack 등으로 팀원에게 로그(기본 보기와 함께)를 공유해요. 사용 가능한 Datadog 알림 통합 전부를 확인해 보세요.