Key Visualizer 시작하기

개요

Key Visualizer는 기본적으로 사용 설정됩니다.

Key Visualizer에서는 데이터를 즉시 사용할 수 없는 몇 가지 상황이 있습니다.

  • 새로 만든 데이터베이스의 스토리지 및 트래픽 통계를 즉시 사용하지 못할 수 있습니다.
  • 새로 삽입된 행의 트래픽 통계는 기존 키 범위로 인해 사용하지 못할 수 있습니다.

Key Visualizer 인터페이스

Google Cloud Console에서 Key Visualizer 도구에 액세스합니다.

Key Visualizer에 액세스하려면 다음 안내를 따르세요.

  1. Cloud Console의 Spanner 페이지에서 인스턴스를 선택합니다.

  2. 조사할 데이터베이스를 선택합니다.

  3. 왼쪽 탐색 메뉴의 Monitoring에서 Key Visualizer를 선택합니다.

Key Visualizer 사용 중지

Key Visualizer 사용 설정은 enable_key_visualizer 데이터베이스 옵션으로 제어됩니다. 기본값은 true입니다.

Key Visualizer를 중지하려면 enable_key_visualizer 데이터베이스 옵션 값을 false로 설정합니다. Key Visualizer를 사용 중지하는 DDL 구문은 다음과 같습니다.

ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)

데이터베이스 ID에 문자, 숫자 또는 밑줄 이외의 문자가 포함된 경우에는 ID를 백틱(``)으로 묶어야 합니다.

gcloud 명령어를 사용하거나 UpdateDatabaseDdl gRPC/REST 요청에서 문을 보낼 수 있습니다. 예를 들면 다음과 같습니다.

gcloud spanner databases ddl update database_id --instance=instance_id \
    --ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'

enable_key_visualizer 값을 명시적으로 설정한 후에는 개요 페이지에서 동등한 DDL 표시를 클릭하거나 ddl describe gcloud 명령어를 사용하여 값을 확인할 수 있습니다.

gcloud spanner databases ddl describe `database_id` --instance=instance_id

Key Visualizer 다시 사용 설정

Key Visualizer를 다시 사용 설정하려면 Key Visualizer 사용 중지의 안내에 따라 enable_key_visualizer 데이터베이스 옵션 값을 true로 설정합니다.

데이터베이스에 처음으로 다시 사용 설정하면 Key Visualizer 히트맵은 처음 몇 분 동안에는 비어 있지만 Cloud Spanner는 측정항목을 수집합니다.

다음 단계