쿼리 분석 보기

이 기능은 현재 더 이상 지원되지 않습니다. 공식적인 지원 종료 및 완전한 제거는 2025년 12월 5일에 시행됩니다. 따라서 모든 $search.tracking 요청에 대해 Atlas는 이 날짜부터 Atlas UI에 표시할 쿼리 데이터를 더 이상 수집하지 않으며, 이 기능의 UI도 제거됩니다. 질문이나 추가 도움이 필요하시면 MongoDB 지원 포털을 통해 지원팀에 문의하시거나, 계정 담당자에게 연락해 주세요.

Atlas Search의 쿼리 분석 기능은 미리보기 기능으로 제공됩니다. 해당 기능과 관련 문서는 미리보기 기간 동안 언제든지 변경될 수 있습니다. 자세한 내용은 미리보기 기능을 참조하세요.

텀 를 쿼리 데 사용한 인덱스 에 대한 Atlas UI Query Analytics 페이지에서 tracking 옵션을 사용하여 추적한 MongoDB Search 쿼리 용어에 대한 지표 볼 수 있습니다. 쿼리에 검색 에 태그를 지정하다 하는 방법을 학습 검색어 추적을 참조하세요.

이 페이지에서는 추적된 쿼리에 대해 Atlas 캡처하는 지표 와 Atlas UI 에서 MongoDB Search 인덱스 에 대한 쿼리 분석 보는 방법에 대해 설명합니다.

참고

Atlas UI 에서 추적된 검색 에 대한 분석 정보를 보려면 MongoDB v5.0 이상 실행 M10 이상의 클러스터 있어야 합니다. MongoDB Search는 무료 및 Flex 클러스터의 쿼리에 대한 검색 를 추적 하거나 분석 표시하지 않습니다.

쿼리 분석 페이지로 이동

Atlas Search & Vector Search 에서 클러스터 의 페이지로 이동합니다.

Search & Vector Search 옵션 또는 Data Explorer에서 MongoDB 검색 페이지로 이동할 수 있습니다.

아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.
사이드바에서 Database 제목 아래의 Search & Vector Search를 클릭합니다.
클러스터가 없는 경우 Create cluster를 클릭하여 클러스터를 생성합니다. 자세히 알아보려면 클러스터 생성을 참조하세요.
프로젝트에 여러 클러스터가 있는 경우 Select cluster 드롭다운에서 사용할 클러스터를 선택한 후 Go to Atlas Search를 클릭합니다.
검색 & 벡터 검색 페이지가 표시됩니다.

아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.
사이드바에서 Database 제목 아래의 Data Explorer를 클릭합니다.
데이터베이스를 확장하고 컬렉션을 선택합니다.
컬렉션의 Indexes 탭을 클릭합니다.
Atlas Search 페이지가 표시됩니다.

인덱스의 이름을 클릭합니다.

이 페이지는 인덱스 정의에 포함된 Index Configurations와 Field Mappings를 비롯한 인덱스 개요를 보여줍니다. 페이지 왼쪽에는 다음 페이지로 이동할 수 있는 탐색 옵션도 제공됩니다.

인덱스 개요 - 이 인덱스에 대한 구성 보기
검색 Tester - 이 인덱스를 사용하여 collection 검색
쿼리 분석 - 이 인덱스를 사용한 추적 텀에 대한 쿼리에 대한 분석 보기

이 MongoDB Search 인덱스 사용하여 실행 추적된 쿼리에 대한 분석 보려면 Query Analytics 를 클릭합니다.

Atlas는 선택한 인덱스만 사용하여 실행된 추적된 검색 텀에 대한 쿼리에 대한 쿼리 분석을 표시합니다.

추적된 검색 텀에 대한 쿼리 분석 보기

Query Analytics 페이지에는 현재 날짜, 지난 7일, 지난 30일 또는 지난 90일과 같은 사전 정의된 날짜 범위 또는 지정한 사용자 지정 범위( UTC)에 대해 다음이 표시됩니다. 일 세분성:

추적된 모든 $search 쿼리에 대한 지표
결과가 없는 쿼리의 지표

클릭하여 확대

추적된 모든 $search 쿼리에 대한 지표

이 섹션에는 다음 지표가 표시됩니다.

Approx # of Tracked $search Queries - tracking 옵션이 포함된 $search 쿼리의 대략적인 개수입니다.
Approx % of Top 10 Tracked Queries - tracking 옵션이 있는 상위 10개 쿼리이기도 한 $search 쿼리의 비율입니다.

이 섹션에는 선택한 날짜 범위 동안 추적된 쿼리 수의 그래프도 표시됩니다.

그래프 아래의 Show Top Search Queries 을(를) 확장하여 다음 지표를 볼 수 있습니다.

Search Terms	MongoDB Search 쿼리 용어(행당 1개).
Approx #	(동일한 행에 있는) 텀에 대해 추적된 모든 `$search` 쿼리의 대략적인 수입니다.
Approx %	(동일한 행에 있는) 텀에 대해 추적된 모든 `$search` 쿼리의 대략적인 백분율입니다. 선택한 날짜 범위 동안 Atlas가 쿼리를 캡처한 날에 한해 총 쿼리 수 중 쿼리 용어가 포함된 쿼리의 비율입니다. 예시 들어 `coffee` 에 대한 쿼리 실행 경우 MongoDB Search는 다음과 같이 백분율을 계산합니다. 캡처된 날짜에 총 8건의 쿼리 중 `coffee`에 대한 쿼리 4건은 50%와 같습니다. 캡처된 날짜의 총 2건의 쿼리 중 `coffee`에 대한 쿼리 1건은 50%와 같습니다.
View	링크를 통해 텀에 대해 사전 정의된 날짜 범위 또는 사용자 지정 날짜 범위에 대한 다음 지표를 볼 수 있습니다(동일한 행에서). 선택한 날짜 범위 동안 텀에 대해 추적된 쿼리 수 및 비율입니다. 선택한 날짜 범위 동안 해당 텀에 대해 추적된 쿼리 수를 나타내는 그래프입니다. View factors affecting data 를 클릭하면 해당 검색 에 대해 기록된 쿼리가 없는 텀 와 MongoDB Search가 페이지에 표시하는 지표 에 영향을 미치는 요인에 대한 정보가 표시되는 창 열립니다. 자세히 학습하려면 표시된 데이터에 영향을 미치는 요인을 참조하세요. Close 을 클릭하여 창 닫을 수 있습니다. 자세한 내용은 Atlas가 텀을 캡처하는 방법을 참조하세요. Aggregation pipeline Query 섹션에는 다음이 표시됩니다. Sample aggregation pipeline Atlas가 해당 텀에 대해 캡처한 다양한 쿼리를 보여주는 드롭다운입니다. MongoDB API 선택한 파이프라인과 관련된 `mongosh` 쿼리를 보여주는 탭입니다. Export to Language 탭을 사용하여 지원되는 다른 MongoDB 드라이버 언어로 쿼리 구문을 보고, 복사하고, 내보낼 수 있습니다. Open Aggregation Pipeline 링크를 클릭하여 collection의 Aggregation 탭을 엽니다. Aggregation 탭의 collection에 대해 쿼리를 실행하려면 다음을 수행합니다. 쿼리를 복사합니다. Aggregation 탭에서 Create New 클릭합니다. 아직 활성화되지 않은 경우 Preview 를 활성화하고 </> Text 을 클릭합니다. 왼쪽 창에 쿼리를 붙여넣으면 오른쪽 Pipeline Output 창에서 결과를 볼 수 있습니다. < Query Analytics 을(를) 클릭하여 Query Analytics 페이지로 돌아갑니다.

결과가 없는 쿼리의 지표

이 섹션에서는 Atlas가 전체 집계 파이프라인에 대해 결과를 반환하지 않은 쿼리에 대한 다음 지표를 보여줍니다.

Approx # of Search Queries With No Results - 옵션을 사용하여 MongoDB Search에서 결과를 반환하지 않은 $search 쿼리의 대략적인 개수입니다.tracking
Approx % of Search Queries With No Results - $search 옵션을 tracking 사용하는 MongoDB Search에서 어떤 결과도 반환하지 않은 쿼리의 대략적인 비율입니다.

선택한 날짜 범위 에 대해 이 섹션에는 MongoDB Search가 결과를 반환하지 않은 추적된 쿼리 수의 그래프 도 표시됩니다.

그래프 아래의 Show Top No Results Queries 을(를) 확장하여 다음 지표를 볼 수 있습니다.

Search Terms	MongoDB Search 쿼리 용어(행당 1개).
Approx # of Searches	텀에 대한 대략적인 쿼리 수(동일한 행 내)입니다.
Approx % of all Tracked Searches	(동일한 행에 있는) 텀에 대해 추적된 쿼리의 대략적인 백분율입니다. 선택한 날짜 범위 동안 Atlas가 쿼리를 캡처한 날에 한해 총 쿼리 수 중 텀이 포함된 쿼리의 비율입니다. 예시 들어 `coffee` 에 대한 쿼리 실행 경우 MongoDB Search는 다음과 같이 백분율을 계산합니다. 캡처된 날짜에 총 8개의 쿼리 중 `coffee`에 대한 4개의 쿼리가 50%와 같습니다. 캡처된 날짜에 총 2건의 쿼리 중 `coffee`에 대한 쿼리 1건은 50%와 같습니다.
View	링크를 통해 텀에 대해 사전 정의된 날짜 범위 또는 사용자 지정 날짜 범위에 대한 다음 지표를 볼 수 있습니다(동일한 행에서). 선택한 날짜 범위 동안 텀에 대해 추적된 모든 `$search` 쿼리의 수와 백분율입니다. 선택한 날짜 범위 동안 텀에 대해 추적된 `$search` 쿼리 수의 그래프입니다. View factors affecting data 를 클릭하면 해당 검색 에 대해 기록된 쿼리가 없는 텀 와 MongoDB Search가 페이지에 표시하는 지표 에 영향을 미치는 요인에 대한 정보가 표시되는 창 열립니다. 자세히 학습하려면 표시된 데이터에 영향을 미치는 요인을 참조하세요. Close 을 클릭하여 창 닫을 수 있습니다. 자세한 내용은 Atlas가 텀을 캡처하는 방법을 참조하세요. Aggregation pipeline Query 섹션에는 다음이 표시됩니다. Sample aggregation pipeline Atlas가 해당 텀에 대해 캡처한 다양한 쿼리를 보여주는 드롭다운입니다. MongoDB API 선택한 파이프라인과 관련된 `mongosh` 쿼리를 보여주는 탭입니다. Export to Language 탭에서 지원되는 다른 MongoDB 드라이버 언어로 쿼리 구문을 보고, 복사하고, 내보낼 수 있습니다. Open Aggregation Pipeline 링크를 클릭하여 collection의 Aggregation 탭을 엽니다. Aggregation 탭의 collection에 대해 쿼리를 실행하려면 다음을 수행합니다. 쿼리를 복사합니다. Aggregation 탭에서 Create New 클릭합니다. 아직 활성화되지 않은 경우 Preview 를 활성화하고 </> Text 을 클릭합니다. 왼쪽 창에 쿼리를 붙여넣으면 오른쪽 Pipeline Output 창에서 결과를 볼 수 있습니다. < Query Analytics 을(를) 클릭하여 Query Analytics 페이지로 돌아갑니다.

표시되는 데이터에 영향을 미치는 요인

페이지에 표시되는 지표에 영향을 미치는 요인은 여러 가지가 있습니다.

MongoDB Search 쿼리 지표 샘플링을 기반으로 하며, 이는 표시된 모든 지표 의 정확도에 영향을 미칠 수 있습니다.

또한 Atlas는 Atlas가 추적된 $search 쿼리에서 매일 캡처하는 고유 검색 텀 수에 제한이 있습니다. Atlas는 제한에 도달하면 새롭고 고유한 검색어를 캡처하지 않습니다. Atlas가 한도에 도달하면 다음과 같은 영향을 받을 수 있습니다.

추적된 상위 10개 쿼리의 대략적인 비율
Atlas가 상위 검색 텀을 표시하는 순서

텀에 대한 쿼리가 실행되기 전에 Atlas가 캡처를 중지하면 추적된 개별 검색 텀 지표가 영향을 받을 수 있습니다. 이 날에는 Atlas에 해당 텀에 대한 검색이 표시되지 않으므로 공백이 생깁니다.

자세한 내용은 동작을 참조하세요.

학습 계속하기

이 동영상을 따라가며 쿼리 분석 사용하여 MongoDB Search에서 결과를 반환하지 않은 상위 10 개 쿼리 용어 및 쿼리 용어에 대한 지표 조회 방법을 학습 . 또한 동의어를 사용하여 MongoDB Search에서 결과를 반환하지 않은 용어에 대한 검색 개선하는 방법도 학습 .

동영상 길이: 7분