로그 검색 (Search Logs)
Log Explorer에서는 로그를 검색하고 목록으로 볼 수 있어요. 하지만 가장 가치 있는 인사이트는 로그를 규모 있게 집계할 때 나오는 경우가 많아요. 검색 기능으로 로그를 필터링하고, 그 로그를 시계열 차트, 상위 목록, 트리 맵, 파이 차트, 테이블로 시각화해 로그 데이터 전반의 추세·패턴·이상치를 더 잘 이해할 수 있어요.
출처: 문서
본문
자연어 쿼리 (Natural language queries)
다음 Datadog 사이트(app.ddog-gov.com, us2.ddog-gov.com) 사용자에게 중요한 참고 사항:
⚠️ Natural Language Queries는 Datadog 사이트 ({% placeholder "user-datadog-site-name" /%}) 에서 사용할 수 없어요.
Natural Language Queries (NLQ)를 사용하면 찾고 싶은 것을 평범한 영어로 설명할 수 있어요. Datadog가 요청을 구조화된 로그 쿼리로 자동 번역해서, 복잡한 구문을 몰라도 로그를 더 쉽게 탐색할 수 있어요. 이 기능에 접근하려면 검색 필드에서 Ask를 클릭해요.
시스템은 자연어 입력을 Datadog 쿼리로 번역하고 서비스, 속성, 태그, 시간 범위 같은 컨텍스트를 이해해요. 관련 필드를 자동으로 감지하고, 사용자가 간단한 설명으로 시각화를 만들 수 있게 해줘요 — 예를 들어 "Top 20 services by errors" 또는 "Show errors from service X in the past 24 hours" 같은 거예요.
NLQ를 비활성화하려면 org_management 권한이 있어야 해요. Organization Settings > Preferences로 이동해 Natural Language Queries 기능을 꺼요.
검색 쿼리
Log Explorer 검색은 시간 범위와 검색 쿼리로 구성되며, key:value와 전체 텍스트 검색을 결합해요. Log Explorer 오른쪽 상단의 시간 범위 선택기를 사용해 검색 시간 창을 고를 수 있어요. 커스텀 시간 범위 설정에 대한 자세한 내용은 Custom Time Frames 문서를 참고해요.
웹 스토어 서비스가 만들고, 오류 상태이며, 지난 15분 동안 발생한 로그를 필터링하려면 service:payment status:error rejected 같은 커스텀 쿼리를 만들고 시간 범위를 Past 15 minutes로 설정해요:
인덱스된 로그는 전체 텍스트 검색과 key:value 검색 쿼리를 모두 지원해요.
참고: key:value 쿼리는 사전에 패싯을 선언할 필요가 없어요.
전체 쿼리 구문 참고 자료는 Search Syntax 문서를 참고해요.
검색창 기능
Log Explorer 검색창에는 쿼리를 더 효율적이고 정확하게 작성하는 데 도움이 되는 여러 기능이 있어요.
구문 강조와 오류 검증
구문 강조는 입력 유형(키, 값, 자유 텍스트, 제어 문자)을 명확히 구분해 줘요. 예를 들어 service와 status는 키, auth-dotnet과 error는 값, 500과 check-token은 자유 텍스트, 괄호는 제어 문자예요. 상태 속성은 상태별로 색상이 지정돼요(error은 빨강, info는 파랑).
오류 검증은 key:value 쌍의 누락된 값, 불완전한 범위 쿼리, 닫히지 않은 괄호 같은 구문 오류를 식별하고 수정을 제안해요.
자동 완성
검색창의 자동 완성 기능은 로그의 기존 키와 값, 최근 검색, 저장된 보기를 사용해 쿼리 작성을 도와줘요.
자동 완성은 입력에 따라 패싯과 값을 제안하며, 패싯 패널에 나타나는 순서대로 표시돼요. 패싯을 선택하고 :를 입력하면 지난 15분 동안의 로그 수 기준 내림차순으로 값이 나타나요.
최근 100개의 검색이 유지되어 입력하는 대로 제안돼요. 쿼리와 일치하는 Saved Views도 제안되며, Saved Views 패널과 같은 순서로 표시돼요.
검색창의 스타일링과 자동 완성 비활성화하기
검색창 오른쪽의 버튼을 토글하면 raw 모드로 검색할 수 있어요. raw 모드에서는 구문 강조, 검색 알약 스타일링, 자동 완성이 제거돼요:
검색창은 마우스로도, 키보드 명령으로도 상호작용할 수 있어요. 예를 들어 텍스트 선택에 CMD-A, 복사에 CMD-C, 잘라내기에 CMD-X, 붙여넣기에 CMD-V를 사용해요.