히트맵 탐색

이 페이지에서는 Key Visualizer 검사에서 히트맵을 분석하여 Firestore 성능 문제의 원인을 찾아내는 방법을 설명합니다.

이 페이지를 읽기 전에 Key Visualizer 개요를 숙지해야 합니다. 또한 다음을 수행하는 것도 좋습니다.

Key Visualizer 검사를 여는 방법 알아보기
공통 문서 키 패턴 또는 색인 키 패턴의 예시를 참조하세요.

밝기 조정

Key Visualizer 히트맵은 보통 값이나 낮은 값에는 어두운 색, 높은 값에는 밝은 색을 사용합니다. 히트맵에서 패턴을 보기 쉽도록 색상 스케일을 조정할 수 있습니다.

대부분의 측정항목에서 Key Visualizer는 데이터베이스의 전체 사용량에 따라 '높은' 값과 '낮은' 값을 식별합니다. 예를 들어 특정 키 범위에서 초당 읽기를 20회 수행하고 다른 키 범위에서 초당 읽기를 1회 수행하는 경우 Key Visualizer는 해당 키 범위에 밝은 색상을 사용합니다. 밝은 색상이 반드시 문제를 나타내는 것은 아닙니다.

값마다 사용되는 색상을 조정하려면 밝기 조정 아이콘 옆에 있는 + / - 버튼을 사용하세요. 밝기를 높이면 각 색상이 나타내는 값 범위를 줄이는 것이고, 밝기를 낮추면 값 범위를 늘리는 것입니다.

밝기를 기본 설정으로 재설정하려면 밝기 조정 아이콘을 클릭합니다.

기간 및 키 범위 확대

히트맵을 열면 검사에 포함된 기간 및 데이터베이스의 활성 키 범위가 표시됩니다. 특정 기간 또는 특정 키 범위에서 문제가 발견되는 경우 확대하여 문제를 더 면밀히 조사할 수 있습니다.

여러 가지 방법으로 확대하거나 축소할 수 있습니다.

히트맵 내에서 위로 또는 아래로 스크롤합니다.
직사각형 확대/축소 버튼을 클릭한 후에 클릭하고 드래그하여 확대할 영역을 선택합니다.
Shift 키를 누른 상태로 클릭하고 드래그하여 확대할 영역을 선택합니다.
Backspace 또는 Delete 키를 눌러 히트맵의 이전 영역으로 돌아갑니다.
확대/축소 재설정 버튼을 클릭하거나 R 키를 눌러 전체 테이블을 축소하여 봅니다.

키 프리픽스별로 상세히 살펴보기

다음 섹션에서는 예시로 문서 키 스캔을 사용하여 드릴다운하는 방법을 설명합니다. 색인 키의 경우 프리픽스가 색인 키 그룹으로 변경됩니다.

히트맵 왼쪽에 있는 Key Visualizer는 데이터베이스의 계층 구조별로 키를 구성합니다. 이를 통해 특정 키 범위의 데이터를 상세히 살펴볼 수 있습니다.

같은 프리픽스를 가진 키 그룹의 히트맵 데이터를 상세히 보려면 다음 단계를 따르세요.

히트맵의 왼쪽에 있는 키 계층 구조에서 레벨 중 하나 위로 커서를 이동합니다.

Key Visualizer에서 이 레벨의 계층 구조를 보여주는 히트맵 영역이 강조표시됩니다. 이 레벨에 있는 모든 키의 키 프리픽스도 표시됩니다.
조사할 키 계층 구조의 레벨을 클릭합니다.

Key Visualizer가 이 레벨의 계층 구조를 확대합니다.
키 계층 구조의 다른 레벨을 클릭하여 더 확대하거나, Backspace 또는 Delete 키를 눌러 이전 영역으로 돌아갑니다.

측정항목의 세부정보 고정

커서를 히트맵 위로 이동하면 Key Visualizer에서 커서 아래 있는 측정항목의 세부정보가 포함된 도움말이 표시됩니다. 히트맵을 클릭하여 이 도움말을 그 자리에 고정할 수 있습니다. 고정된 도움말은 측정항목에 대해 더 많은 세부정보를 표시합니다. 도움말을 고정하면 도움말의 스크린샷을 만들거나 도움말에 있는 정보를 복사하는 것도 더 쉬워집니다.

측정항목 전환

기본적으로 Key Visualizer 스캔을 열면 사용 패턴의 개요를 제공하는 문서 키의 작업/초 측정항목이 표시됩니다. 다른 측정항목으로 전환하려면 히트맵 위에 있는 측정항목 드롭다운 목록을 클릭한 후 보고 싶은 측정항목을 클릭하세요.

색인 키의 경우 색인 키 사용 개요를 제공하는 색인 쓰기 작업/초 측정항목이 표시됩니다.

각 측정항목에 대한 설명은 Key Visualizer 측정항목을 참조하세요.

문서 키의 서로 다른 측정항목 간 연결 찾기

측정항목을 비교하여 측정항목 간 상관관계를 찾고자 하는 경우 Key Visualizer에서 동시에 여러 측정항목을 볼 수 있습니다. 예를 들어 작업/초 히트맵에 있는 핫스팟이 평균 쓰기 지연 시간 히트맵에 있는 높은 지연 시간과 상관관계가 있는지를 확인하고자 할 수 있습니다.

여러 측정항목과 그 값을 동시에 보려면 오른쪽 상단 근처의 정보 패널 표시를 클릭합니다. 스캔의 오른쪽에 있는 창에 측정항목 목록이 나타납니다.

스캔의 다중 측정항목 창을 보여주는 예시

여러 측정항목을 동시에 조사하려면 다중 측정항목 창에서 다음 도구를 사용하세요.

모든 측정항목의 축소형 히트맵을 표시하거나 숨기려면 오른쪽 상단에서 Expand All 또는 Collapse All을 클릭합니다.
개별 측정항목의 히트맵을 보려면 측정항목 이름을 클릭합니다.
개별 측정항목의 히트맵을 숨기려면 측정항목 이름을 다시 클릭합니다.
기본 창에서 측정항목의 히트맵을 표시하려면 측정항목의 제목 표시줄 왼쪽 가장자리에 있는 화살표를 클릭합니다.
축소형 히트맵 위에 마우스를 올려 해당 활동을 기본 보기에서 봅니다.

키 버킷의 서로 다른 측정항목을 같은 시점에 놓고 비교하기 위해 스캔에서 값을 고정한 후에 같은 시점의 다른 측정항목으로 전환할 수 있습니다.

기본 창의 큰 히트맵에서 관심 있는 위치를 가리킵니다.
클릭하여 도움말을 고정합니다. 사이드 창에 있는 값이 키 버킷과 선택한 시점에 맞춰 고정됩니다.
큰 히트맵에서 측정항목을 표시하려면 해당 측정항목의 왼쪽에 있는 화살표를 클릭합니다. 기본 창의 도움말에 해당 측정항목의 전체 세부정보가 표시됩니다.

다음 단계

문서 키 패턴 또는 색인 키 패턴을 인식하는 방법 알아보기
히트맵에서 볼 수 있는 측정항목 알아보기