Key Visualizer 시작하기

개요

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

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

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

시작하기 전에

Key Visualizer를 보려면 다음이 필요합니다.

  • 세분화된 액세스 제어 사용자는 spanner_sys_reader 시스템 역할 또는 구성원 역할 중 하나에 대한 액세스 권한을 부여받아야 합니다.

  • 세분화된 액세스 제어 사용자가 아닌 경우 다음 Identity and Access Management(IAM) 권한이 필요합니다.

    • spanner.databases.read

자세한 내용은 세분화된 액세스 제어 정보 및 세분화된 액세스 제어 시스템 역할을 참조하세요.

Key Visualizer 인터페이스

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

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

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

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

  3. 세분화된 액세스 제어 사용자만 해당: 데이터베이스 개요 페이지의 현재 역할 필드에서 spanner_sys_reader 시스템 역할 또는 spanner_sys_reader의 구성원(또는 구성원의 하위 요소)인 역할을 지정합니다.

    자세한 내용은 세분화된 액세스 제어 정보 및 세분화된 액세스 제어 시스템 역할을 참조하세요.

  4. 왼쪽 탐색 메뉴의 관측 가능성에서 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 히트맵은 처음 몇 분 동안에는 비어 있지만 Spanner는 측정항목을 수집합니다.

다음 단계