쿼리 구문

검색 쿼리

모든 검색 파라미터는 페이지 URL에 포함되어 있어 보기를 공유하는 데 도움이 될 수 있습니다.

검색 구문

쿼리는 용어와 연산자로 구성됩니다.

용어에는 두 가지 유형이 있습니다.

스팬(span) 속성: 애플리케이션에서 자동 또는 수동 계측을 통해 수집된 스팬(span)의 콘텐츠.
스팬(span) 태그: 스팬(span)과 관련된 컨텍스트 보강. 예를 들어, 서비스가 실행되는 인프라스트럭처를 설명하는 호스트 또는 컨테이너 태그.

여러 용어를 복잡한 쿼리로 결합하려면 다음 불리언 연산자 중 하나를 사용하세요.

연산자	설명	예시
`AND`	Intersection: 모든 용어가 선택한 이벤트에 존재합니다(추가된 것이 없으면 AND가 기본적으로 적용됨).	인증 AND 실패
`OR`	Union: 두 용어 중 하나가 선택한 이벤트에 포함되어 있습니다.	인증 OR 비밀번호
`-`	Exclusion: 다음 용어는 이벤트에 없습니다	인증 AND -비밀번호

속성 검색

스팬(span) 속성을 검색하려면 속성 키 앞에 @을 추가해야 합니다.

예를 들어, 아래 속성이 있는 스팬(span)에 액세스하려면 다음을 사용합니다.

@git.commit.sha:12345

  "git": {
    "commit": {
      "sha": "12345"
    },
    "repository": {
      "id": "github.com/datadog/datadog"
    }
  }

스팬(span) 속성은 트레이스 사이드 패널의 개요 탭에서 확인할 수 있습니다.

참고: 다음 예약된 속성에는 @을 사용할 필요가 없습니다. env, operation_name, resource_name, service, status, span_id, timestamp, trace_id, type, link

태그 검색

스팬(span)은 태그를 생성하는 호스트 및 통합에서 태그를 상속합니다.

예시:

쿼리	일치
`(hostname:web-server OR env:prod)`	인프라스트럭처 태그`hostname:web-server` 또는 예약 된 속성 `env:prod`가 있는 모든 트레이스
`(availability-zone:us-east OR container_name:api-frontend)`	이러한 인프라스트럭처 태그 중 하나라도 포함된 모든 트레이스
`(service:api AND -kube_deployment:canary)`	`canary` 배포에 배포되지 않은 `api` 서비스의 모든 트레이스

스팬(span) 태그는 트레이스 사이드 패널의 인프라스트럭처 탭에서 확인할 수 있습니다.

비표준 태그 형식

태그가 태그 모범 사례를 따르지 않고 key:value 구문을 사용하지 않는 경우 대신 다음 검색 쿼리를 사용하세요.

tags:<MY_TAG>

예를 들어, 다음 태그는 모범 사례를 따르지 않습니다. auto-discovery.cluster-autoscaler.k8s.io/daffy

이 태그를 검색하려면 다음 쿼리를 사용합니다.
tags:"auto-discovery.cluster-autoscaler.k8s.io/daffy"

와일드카드

다중 문자 와일드카드 검색을 수행하려면 다음과 같이 * 기호를 사용합니다:

service:web*은 web으로 시작하는 서비스를 가진 모든 트레이스를 일치시킵니다.
@url:data*은 data로 시작하는 url을 가진 모든 트레이스를 일치시킵니다.

숫자 값

<, >, <=, >=를 사용하여 숫자 속성을 검색합니다. 예를 들어 다음을 사용하여 응답 시간이 100ms를 초과하는 모든 트레이스를 검색합니다.

@http.response_time:>100

특정 범위 내의 수치 속성을 검색하는 것도 가능합니다. 예를 들어 다음을 사용하여 모든 4xx 오류를 검색합니다.

@http.status_code:[400 TO 499]

자동 완성

복잡한 쿼리를 입력하는 것은 번거로울 수 있습니다. 기존 값을 사용하여 검색어를 완성하려면 검색창의 자동 완성 기능을 사용하세요.

특수 문자 이스케이프

다음 속성은 특별한 것으로 간주됩니다 : ?, >, <, :, =,", ~, /, \는 이스케이프를 필요로 합니다. 예를 들어 url에서 user=JaneDoe가 포함된 트레이스를 검색하려면 다음 검색을 입력해야 합니다.

@url:*user\=JaneDoe*

트레이스 속성 내의 공백에도 동일한 논리를 적용해야 합니다. 트레이스 속성에 공백을 두는 것은 권장되지 않지만 이러한 경우 공백을 이스케이프해야 합니다. 속성이 user.first name으로 호출되면 공백을 이스케이프 처리하여 이 속성에 대한 검색을 수행합니다.

@user.first\ name:myvalue

저장된 검색

같은 보기를 매일 만드는 것은 시간 낭비입니다. 저장된 검색에는 검색어, 열 및 기간이 포함됩니다. 검색 이름이나 검색어에 관계없이 자동 완성 기능을 사용하여 해당 검색창에서 사용할 수 있습니다.

저장된 검색을 삭제하려면 Trace search 드롭다운 메뉴 아래의 휴지통 아이콘을 클릭하세요.

서비스 및 엔티티 검색

시간 범위

시간 범위를 사용하면 특정 기간 내의 트레이스를 표시할 수 있습니다. 드롭다운 메뉴에서 사전 설정 범위를 선택(또는 사용자 정의 기간 입력)하여 시간 범위를 빠르게 변경합니다.

스팬(span) 테이블

스팬(span) 테이블은 선택한 컨텍스트와 일치하는 스팬(span) 목록입니다. 컨텍스트는 검색 창 필터와 시간 범위로 정의됩니다.

전체 트레이스 표시

관련 트레이스에 대한 자세한 내용을 보려면 스팬(span)을 클릭하세요.

열

목록에 다른 스팬(span) 태그 또는 속성을 컬럼으로 추가하려면 옵션 버튼을 클릭하고 추가하려는 차원을 선택합니다.

패싯

패싯은 속성 또는 태그의 모든 고유 값을 표시할 뿐만 아니라 표시되는 트레이스 양과 같은 몇 가지 기본 분석을 제공합니다. 이는 데이터를 필터링하는 스위치이기도 합니다.

패싯을 사용하면 지정된 속성을 기반으로 데이터 세트를 피벗하거나 필터링할 수 있습니다. 예시 패싯에는 사용자, 서비스 등이 포함될 수 있습니다.

측정

측정값은 정량적 값에 대한 특정 유형의 패싯입니다.

다음의 경우 측정값을 사용하세요.

여러 추적에서 값을 집계합니다. 예를 들어 Cassandra의 행 수에 대한 측정값을 만들고 요청된 파일 크기 합계당 P95 또는 최상위 리퍼러를 확인합니다.
$1000가 넘는 장바구니 값에 대해 대기 시간이 가장 긴 서비스를 수치적으로 계산합니다.
연속 값을 필터링합니다. 예를 들어 비디오 스트림의 각 페이로드 청크 크기(바이트)입니다.

*유형

동등한 기능에 (큰) 정수나 소수점 값이 오는 수치

단위

쿼리 시간 및 표시 시간에 크기 차수를 처리하기 위한 측정 지원 단위(초 단위 시간 또는 바이트 단위 크기)입니다. 단위는 필드가 아닌 측정값 자체의 속성입니다. 예를 들어, 나노초 단위의 지속 시간 측정을 생각해 보세요. duration:1000가 1000 milliseconds를 의미하는 service:A의 스팬 태그가 있고, duration:500이 500 microseconds를 의미하는 service:B의 스팬 태그가 있습니다. 산술 프로세서와 함께 유입되는 모든 스팬 태그의 기간을 나노초로 확장합니다. service:A의 스팬 태그에 *1000000 승수를 사용하고 service:B의 스팬 태그에 *1000 승수를 사용합니다. duration:>20ms(참조용 검색 구문 참조)을 사용하여 두 서비스 모두에서 동시에 스팬 태그를 일관되게 쿼리하고 최대 1분의 집계 결과를 확인할 수 있습니다.

패싯 생성

속성을 패싯으로 사용하거나 검색에서 사용하려면 해당 속성을 클릭하고 패싯으로 추가하세요.

새 패싯을 생성하면 패싯 패널에서 필터링 및 기본 분석에 활용할 수 있습니다.

패싯 패널

패싯을 사용하여 트레이스를 필터링하세요. 검색창과 URL은 선택 사항을 자동으로 반영합니다.

시각화

Analytic 선택기를 사용하여 Analytics 시각화 유형을 선택합니다.

시계열
상위 목록
표

시계열

선택한 기간 동안 Duration 메트릭(또는 값의 패싯 고유 개수)의 변화를 시각화하고 (선택적으로) 사용 가능한 패싯으로 분할합니다.

다음 시계열 Analytics는 각 서비스에 대해 5분 단위로 pc99 기간의 변화를 보여줍니다.

상위 목록

Duration에 따라 패싯의 상위 값(또는 패싯 고유 값 수)을 시각화합니다.

다음 상위 목록 분석은 서비스의 상위 pc99 기간을 보여줍니다.

테이블

선택한 측정값(목록에서 선택한 첫 번째 측정값)에 따라 패싯의 상위 값을 시각화하고 이 상위 목록에 나타나는 요소에 대한 추가 측정값을 표시합니다. 검색어를 업데이트하거나 두 차원에 해당하는 로그를 조사하세요.

측정 차원이 여러 개인 경우 첫 번째 차원에 따라 상위 값이 결정되고, 첫 번째 차원의 상위 값 내에서 두 번째 차원에 따라 결정되고, 두 번째 차원의 상위 값 내에서 세 번째 차원에 따라 결정됩니다.
측정값이 여러 개일 경우 첫 번째 측정값에 따라 상단 또는 하단 목록이 결정됩니다.
소계만 (상위 또는 하위) 표시되므로 소계는 그룹 내 값의 실제 총계와 다를 수 있습니다. 이 디멘션에 대한 null 또는 빈 값의 이벤트는 하위 그룹으로 표시되지 않습니다.

참고: 하나의 단일 측정값과 하나의 단일 차원에 사용되는 테이블 시각화는 표시만 다를 뿐 상위 목록과 동일합니다.

다음 Table Log Analytics는 지난 15분 동안 고유한 클라이언트 IP 수와 함께 처리량에 따른 상위 상태 코드의 변화를 보여줍니다.