쿼리 성능 통계 분석
이 페이지에서는 쿼리 통계 대시보드를 사용하여 쿼리 성능을 감지하고 분석하는 방법을 설명합니다.
쿼리 통계 개요
쿼리 통계 대시보드를 사용하여 측정항목 관련 쿼리를 모니터링합니다. 측정항목을 기반으로 가장 자주 사용되는 쿼리와 최적화가 필요할 수 있는 지연 시간이 긴 쿼리를 식별할 수 있습니다. 쿼리 통계 대시보드를 사용하여 다음 작업을 수행할 수 있습니다.
- 쿼리 성능 최적화: 지연 시간이 길고 최적화가 필요할 수 있는 쿼리를 식별합니다.
- 쿼리 비용 관리: 비용이 많이 드는 쿼리를 찾아 비용을 줄이도록 최적화합니다.
- 쿼리 통계 모니터링: 시간 경과에 따른 쿼리 통계를 추적합니다.
- 색인 추천: 누락되거나 최적이 아닌 복합 색인을 식별하고 대시보드에서 직접 추천 색인을 만듭니다(Enterprise 버전).
쿼리 통계 데이터
쿼리 통계에는 다음 API 메서드의 데이터가 포함됩니다.
특정 프로젝트, 데이터베이스, 1분~30일의 기간에 대해 이러한 메서드를 사용하는 쿼리에 관한 데이터를 볼 수 있습니다. 구조가 동일한 쿼리의 데이터는 하나의 정규화된 쿼리 아래에 캡처됩니다.
쿼리 통계는 쿼리에 관한 다음 정보를 반환합니다.
| 정규화된 쿼리 텍스트 | 텍스트로 표현된 쿼리 구조입니다. |
| 실행 횟수 | 선택한 기간의 실행 횟수입니다. |
| 오류 수 | 선택한 기간의 오류 수입니다. |
| 평균 실행 시간(밀리초) | 데이터베이스가 쿼리를 처리하는 데 걸린 평균 시간(밀리초)입니다. |
| 반환된 평균 결과 수 | 쿼리에서 반환된 결과 수입니다. 결과에는 문서, 컬렉션 ID, 집계된 버킷이 포함됩니다. |
| 스캔된 평균 문서 수 | 쿼리에서 스캔된 문서 수입니다. |
| 스캔된 색인 항목의 평균 수 | 쿼리를 실행하기 위해 검사한 색인 항목 수입니다. |
| 평균 시간별 부하 | 평균 지연 시간을 기준으로 상위 쿼리를 필터링하는 데 도움이 되는 데이터입니다. |
| 총 (청구 가능) 읽기 작업 수별 부하 | 총 청구 가능한 읽기 작업을 기준으로 상위 쿼리를 필터링하는 데 도움이 되는 데이터입니다. |
| 색인 추천 | Enterprise 버전 데이터베이스의 쿼리에 대한 권장 복합 색인, 사용된 색인, 예상 워크로드 영향 |
데이터 세부사항 및 보관
데이터 세부사항은 지정된 기간에 따라 다릅니다.
- 최대 6시간 전 간격의 경우 1분 단위
- 최대 4일 전 간격의 경우 10분 단위
- 최대 30일 전 간격의 경우 1시간 단위
쿼리 통계의 최대 데이터 보관은 30일입니다. 1분 데이터는 6시간 동안 저장되고 10분 데이터는 4일 동안 저장되며 시간별 데이터는 30일 동안 저장됩니다.
쿼리 통계 보기
Firestore 데이터베이스의 쿼리 통계를 보려면 다음을 수행합니다.
Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.
데이터베이스 목록에서 데이터베이스를 선택합니다.
탐색 메뉴에서 쿼리 통계를 클릭합니다.
쿼리 인사이트 페이지에는 정규화된 쿼리 통계 테이블과 함께 상위 쿼리의 시계열 그래프가 표시됩니다. 쿼리 성능을 분석하려면 다음 안내를 따르세요.
- 기간을 선택하여 이전 추세 또는 거의 실시간 측정항목을 1분 간격으로 확인합니다.
- 로드 유형 목록을 사용하여 평균 지연 시간 또는 총 읽기 작업별로 상위 쿼리의 순위를 지정합니다.
- 테이블에서 개별 쿼리를 선택하여 그래프에서 실행 수, 지연 시간, 스캔한 문서, 스캔한 색인 항목, 오류 수를 표시하고 비교합니다.
색인 추천
쿼리 통계의 색인 추천은 Firestore Enterprise 버전 데이터베이스에서 자주 실행되는 쿼리 형태에 대해 누락되거나 최적화되지 않은 복합 색인 구성을 자동으로 식별합니다.Firestore Enterprise 버전에서는 일치하는 복합 색인이 없어도 쿼리를 실행할 수 있으므로 전체 컬렉션 스캔 또는 메모리 내 정렬 작업이 느려질 수 있습니다. 쿼리 통계 대시보드는 이전 쿼리 실행 통계를 분석하고 타겟팅된 복합 색인을 제안하여 쿼리 지연 시간을 최적화하고 청구 가능한 스캔 문서를 줄입니다.
색인 추천 작동 방식
오프라인 일괄 파이프라인은 이전 상위 쿼리를 주기적으로 평가합니다.
- 쿼리 구조 분석: 자주 실행되는 쿼리에서 동등, 정렬, 범위 조건자를 추출합니다.
- 후보 색인 생성: 색인 순서 지정 휴리스틱(동등 > 정렬 > 범위)을 사용하여 잠재적인 복합 색인 정의를 생성합니다.
- 최적화 도구 평가: 후보 색인을 쿼리 엔진의 비용 모델에 삽입하여 기준 쿼리 실행 비용을 가상 색인 생성 실행 계획과 비교합니다.
- 워크로드 영향 순위: 예상 총 워크로드 비용 절감액을 기준으로 권장 색인을 영향 등급으로 분류합니다.
- 높음: 전체 컬렉션 스캔을 선택적 색인 탐색으로 변환하여 문서 읽기 및 실행 지연 시간을 크게 줄입니다.
- 중간: 사전 정렬된 색인 결과를 제공하여 인메모리 정렬과 같은 비용이 많이 드는 작업을 제거합니다.
- LOW: 탐색 기능이 약간 개선됩니다.
추천 색인 보기 및 만들기
Google Cloud 콘솔에서 색인 추천을 보고 추천 색인을 만들려면 다음 안내를 따르세요.Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.
데이터베이스 목록에서 Enterprise 버전 데이터베이스를 선택합니다.
탐색 메뉴에서 쿼리 통계를 클릭합니다.
쿼리 테이블에서 쿼리 형태를 선택하여 추천 카드를 확인합니다. 카드에는 다음이 표시됩니다.
- 권장 복합 색인 정의(컬렉션, 필드, 정렬 순서 또는 배열 포함 속성)
- 예상 워크로드 영향 등급(HIGH, MEDIUM 또는 LOW)입니다.
- 사용된 색인 또는 전체 컬렉션 스캔이 수행되었음을 나타내는 표시
추천 카드에서 색인 만들기를 클릭합니다. 컬렉션, 쿼리 범위, 필드가 자동 입력된 대화상자가 열립니다.
만들기를 클릭하여 색인 빌드를 시작합니다. Google Cloud 콘솔의 색인 페이지에서 색인 빌드 진행 상황을 모니터링할 수 있습니다.
지원되는 버전 및 모드
색인 추천은 다음을 포함한 Firestore Enterprise 버전 데이터베이스에서 지원됩니다.
- 기본 모드의 Firestore
- MongoDB 호환성을 갖춘 Firestore
Standard 버전 데이터베이스는 색인 추천에 지원되지 않습니다.
제한사항
- 실시간 리스너는 쿼리 통계에 포함되지 않습니다.
- 쿼리 통계 데이터는 쿼리 실행 후 몇 분 이내에 사용할 수 있습니다.
- 색인 추천은 실시간이 아닌 이전 쿼리 데이터를 기반으로 주기적으로 생성됩니다.
- 색인 추천은 새 복합 색인을 추천하며 기존 색인을 수정하거나 삭제하도록 추천하지 않습니다.
- 자동 색인 생성은 지원되지 않습니다. 추천 색인은 수동으로 만들어야 합니다.
- 쿼리 정규화는 리터럴 값을 자리표시자로 바꿉니다. 색인 추천은 특정 런타임 값이 아닌 정규화된 쿼리 템플릿을 기반으로 합니다.
- 비용 평가는 실시간 데이터 샘플링이 아닌 휴리스틱을 사용합니다. 권장 색인이 모든 시나리오에서 성능을 개선하지는 않을 수 있으며 색인을 만들면 쓰기 및 스토리지 오버헤드가 추가됩니다.
가격 책정
쿼리 통계 또는 색인 추천에는 추가 비용이 없습니다.
필요한 역할
쿼리 통계 대시보드를 보고 권장 색인을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
쿼리 통계 보기: Datastore 뷰어(
roles/datastore.viewer) -
추천 색인을 만듭니다.
- 데이터 스토어 색인 관리자(
roles/datastore.indexAdmin) - Cloud Datastore 소유자(
roles/datastore.owner) - 편집자(
roles/editor) - 소유자(
roles/owner)
- 데이터 스토어 색인 관리자(
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 쿼리 통계 대시보드를 보고 추천 색인을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
쿼리 통계 대시보드를 보고 권장 색인을 만들려면 다음 권한이 필요합니다.
-
쿼리 통계 보기:
datastore.insights.get -
추천 색인을 만듭니다.
-
datastore.indexes.create -
datastore.indexes.update
-
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.