Spanner Omni 콘솔 사용

Spanner Omni에는 배포의 상태 및 기타 중요한 정보를 표시하는 Spanner Omni 콘솔이 포함되어 있습니다.

Spanner Omni 콘솔은 Spanner Omni의 미리보기 버전을 실행하는 암호화되지 않은 배포를 지원합니다. TLS 암호화로 배포를 만들 수 있는 기능을 사용하려면 Google에 문의하여 Spanner Omni 정식 버전에 대한 사전 체험을 요청하세요. TLS 암호화를 사용하는 배포의 경우 Prometheus 알림Grafana 대시보드를 사용하여 배포를 모니터링합니다.

Spanner Omni 콘솔 시작

Spanner Omni 콘솔을 다운로드하여 전체 배포에 대해 단일 인스턴스를 실행합니다. 자세한 내용은 Spanner Omni 다운로드를 참고하세요.

단일 서버 배포에서 Spanner Omni 콘솔 사용

단일 서버 배포로 Spanner Omni 콘솔을 시작하려면 다음 단계를 따르세요.

  1. Spanner Omni 설정하기의 단계를 따릅니다.

  2. start-single-server 명령어를 실행하여 Spanner 서버를 시작합니다.

  3. Spanner Omni 콘솔을 시작합니다. 컨테이너를 사용하는 경우 다음 명령어를 실행합니다.

    docker exec -it spanneromni /app/bin/spanner-console
    
  4. 브라우저에서 http://localhost:15026로 이동하여 Spanner Omni 콘솔에 액세스합니다.

영역, 리전, 멀티 클러스터 배포와 함께 Spanner Omni 콘솔 사용

Kubernetes 기반 배포의 경우 배포를 만들 때 Spanner Omni 콘솔이 배포됩니다. Spanner Omni 콘솔에 액세스하려면 브라우저에서 http://HOST_ADDRESS:15026로 이동합니다.

HOST_ADDRESS을 다음 명령어의 출력에 있는 spanner-omni-consoleEXTERNAL_IP로 바꿉니다.

kubectl get svc -n spanner-ns

Spanner Omni 콘솔 기능

Spanner Omni 콘솔에는 배포에 관한 유용한 정보를 제공하는 여러 페이지가 포함되어 있습니다.

개요

개요 페이지는 Spanner Omni 배포의 중앙 대시보드입니다. Spanner 노드의 상태, 상태, 리소스 사용량에 관한 다음과 같은 개요 정보를 제공합니다.

배포 정보

이 섹션에는 배포의 주요 식별자가 나열되어 있습니다.

  • 배포 ID: 현재 Spanner Omni 배포의 고유 식별자입니다. 배포를 만들 때 이 ID를 지정합니다.

  • 데이터베이스 버전: 실행 중인 Spanner Omni 소프트웨어의 특정 버전입니다 (예: 2026.r1-beta).

배포 구성

  • CPU 사용률: 배포 전반의 처리 부하를 보여주는 실시간 차트입니다. 영역서버 간에 전환하여 사용률을 확인할 수 있습니다.

  • 리소스 표: 배포의 구성요소를 다음 정보와 함께 자세히 보여줍니다. 서버는 영역별로 그룹화됩니다.

    설명
    리소스 이름 영역 또는 특정 Spanner Omni 서버 노드의 이름입니다.
    유형
    • 영역: 영역 유형 (예: 읽기-쓰기, 읽기 전용 또는 증인)을 표시합니다.
    • Spanner Omni 서버: Spanner Omni 서비스를 실행하는 개별 노드입니다. Spanner Omni 콘솔은 루트 서버를 구체적으로 식별합니다.
    상태 리소스가 정상인지 여부를 나타냅니다 (예: Ready).
    위치 영역을 호스팅하는 실제 또는 논리적 리전입니다 (예: us-central1).
    vCPU, 메모리, 사용된 스토리지 각 노드와 영역의 현재 리소스 할당 및 사용률입니다.

데이터베이스

데이터베이스 페이지에서는 Spanner Omni 배포의 모든 데이터베이스를 중앙에서 확인할 수 있습니다. 이 페이지의 표에는 다음 정보가 포함되어 있습니다.

설명
데이터베이스 이름 데이터베이스의 고유 식별자입니다 (예: retail, ycsbdb).
언어 데이터베이스에서 지원하는 SQL 언어입니다.
  • GOOGLE_STANDARD_SQL: 기본 언어로, Spanner 기능을 완전히 지원합니다.
  • POSTGRESQL: PostgreSQL 호환 인터페이스입니다.
CPU 사용률 데이터베이스가 사용하는 CPU 리소스의 비율입니다. 이를 통해 부하가 높은 데이터베이스를 식별할 수 있습니다.
테이블 데이터베이스의 총 사용자 정의 테이블 수입니다.
버전 보관 기간 Spanner Omni가 특정 시점 복구를 위해 이전 데이터를 보관하는 기간입니다 (예: 1h).

백업

백업 페이지에서는 Spanner Omni 배포와 연결된 모든 백업을 포괄적으로 확인할 수 있습니다. 백업은 Spanner Omni가 외부 스토리지 솔루션에 저장하는 데이터베이스의 트랜잭션별 및 외적 일관성 스냅샷입니다.

자세한 내용은 Spanner Omni 백업을 참고하세요.

총 백업 스토리지

총 백업 스토리지 섹션에는 외부 스토리지 (예: Amazon Simple Storage Service (Amazon S3), Cloud Storage 또는 Amazon S3 호환 로컬 스토리지)에 저장된 모든 백업의 누적 크기가 표시됩니다.

백업 테이블

백업 테이블에는 각 백업에 대한 다음 정보가 표시됩니다.

설명
백업 이름 백업의 고유 식별자입니다.
소스 데이터베이스 Spanner Omni 콘솔에서 백업을 생성한 데이터베이스의 이름입니다.
상태 백업의 현재 상태입니다. 일반적인 상태는 다음과 같습니다.
  • 준비됨: 백업이 완료되었으며 복원할 수 있습니다.
  • 생성 중: 백업이 진행 중입니다.
  • 만료 임박: 백업이 사용자 지정 만료일에 가까워지고 있습니다.
백업 크기 스토리지의 백업 데이터 크기입니다.
생성 시간 Spanner Omni 서버가 백업 프로세스를 시작한 시점의 타임스탬프입니다.
스냅샷 시간 (또는 버전 시간) 백업이 나타내는 시점입니다. 백업의 모든 데이터는 이 시점의 데이터베이스에 대한 일관된 스냅샷입니다.
만료 시간 Spanner Omni가 백업을 삭제하는 날짜와 시간입니다.

시스템 통계

시스템 통계 페이지는 Spanner Omni 배포에 대한 세부적인 관측 가능성을 제공하므로 시스템 상태를 모니터링하고, 성능을 분석하고, 문제를 디버깅할 수 있습니다.

다음 필터를 사용하여 대시보드에 표시되는 데이터를 맞춤설정할 수 있습니다.

  • 영역: 특정 배포 영역의 측정항목을 필터링합니다.

  • 서버: 개별 서버 노드로 드릴다운합니다.

  • 데이터베이스: 특정 데이터베이스 또는 전체 배포의 측정항목을 확인합니다.

  • 기간: 1시간에서 최대 7일의 전환 확인 기간을 선택합니다.

CPU 사용률

이 섹션에서는 배포 전반의 처리 부하를 모니터링합니다. 다음을 기준으로 이 측정항목을 그룹화할 수 있습니다.

  • 영역: 물리적 위치 간의 부하 불균형을 파악합니다.

  • 우선순위: 리소스가 우선순위가 높음, 중간, 낮음인 작업 간에 어떻게 분할되는지 확인합니다.

  • 작업 유형: 읽기, 쓰기, 커밋 등 사용자가 시작한 작업별로 사용량을 분류합니다.

지연 시간

이 섹션에서는 작업 속도를 추적합니다.

  • 요청 지연 시간: 개별 API 요청에 걸리는 시간입니다.

  • 트랜잭션 지연 시간: 데이터베이스 트랜잭션을 완료하는 데 걸리는 총시간입니다.

  • 백분위수: 예를 들어 중간 실적의 경우 50번째 백분위수 (P50)에서 이를 확인합니다. 하지만 문제 해결을 위해서는 P90 또는 P99를 확인해야 하는 경우가 많습니다.

처리량 및 작업

이 섹션에서는 다음 정보를 보여줍니다.

  • 처리량: 시스템이 배포에서 읽거나 배포에 쓰는 데이터의 양 (초당 바이트 단위로 측정)입니다.

  • 초당 작업 수: 시스템에서 처리하는 총 API 호출 수입니다.

잠금 대기 시간

이 측정항목은 트랜잭션이 잠금을 기다리는 데 소요된 누적 시간을 측정합니다. 이 측정항목의 급증은 특히 높은 지연 시간과 정상적인 CPU 사용량과 함께 나타나는 경우 잠금 경합을 나타내는 경우가 많습니다.

스토리지 측정항목

  • 스토리지 용량: 기본 파일 시스템의 총 스토리지 공간과 사용 가능한 스토리지 공간입니다. Spanner Omni 콘솔은 이를 영역별로 그룹화합니다.

  • 스토리지 사용률: 데이터베이스에서 사용하는 바이트 수입니다. Spanner Omni 데이터 압축 프로세스로 인해 이러한 수치가 일시적으로 변동될 수 있습니다.

파일 시스템 성능

이 섹션에서는 기본 스토리지 레이어 (SpanhostFS)의 성능에 관한 유용한 정보를 제공합니다.

  • 파일 시스템 지연 시간: 하위 수준 I/O 작업 (읽기, 쓰기, 플러시)에 걸리는 시간입니다.

  • 파일 시스템 처리량: 파일 시스템 수준에서의 데이터 전송 속도입니다.

쿼리 통계

쿼리 통계 페이지를 사용하면 SQL 쿼리 및 DML (INSERT, UPDATE, DELETE) 문의 성능 문제를 감지하고 진단할 수 있습니다. 쿼리 통계를 사용하여 높은 CPU 사용률을 초래할 수 있는 비효율적인 쿼리를 식별합니다.

  • 감지: 쿼리가 배포의 CPU 부하의 기본 원인인지 확인합니다.

  • 식별: 리소스 사용량이 가장 많은 특정 쿼리 또는 애플리케이션 요청 태그를 파악합니다.

  • 분석: 지연 시간, 행 수와 같은 세부 측정항목을 사용하여 쿼리가 느린 이유를 파악합니다.

실행 시간별 데이터베이스 로드 (모든 쿼리)

실행 시간별 데이터베이스 로드는 시간 경과에 따른 모든 쿼리의 집계 CPU 사용량을 표시합니다. 특정 데이터베이스의 로드를 표시하려면 데이터베이스 필터를 사용합니다.

상위 N개 쿼리 및 태그

이 섹션에서는 선택한 기간 내에 데이터베이스 부하가 가장 많이 발생하는 쿼리 또는 태그의 시계열 보기를 제공합니다.

상위 쿼리 및 태그 표

표에 가장 많이 사용하는 쿼리 및 태그가 나열됩니다. 이를 사용하여 쿼리 워크로드에서 리소스 집약적인 쿼리를 식별할 수 있습니다.

설명
디지털 지문 특정 쿼리 '모양'의 고유 식별자입니다.
쿼리 또는 요청 태그 정규화된 쿼리의 SQL 텍스트입니다. 애플리케이션이 쿼리 옵션에 요청 태그를 제공하는 경우 Spanner Omni 콘솔에 해당 태그가 대신 표시되므로 관련 쿼리를 그룹화할 수 있습니다 (예: checkout_process).
쿼리 유형 작업 유형입니다 (예: QUERY).
CPU(%) 이 쿼리가 간격 동안 소비하는 총 데이터베이스 CPU 리소스의 비율입니다.
실행 횟수 Spanner Omni 콘솔에서 쿼리를 실행한 총 횟수입니다.
평균 지연 시간(밀리초) 서버 간 네트워크 시간을 포함하여 쿼리를 완료하는 데 걸리는 평균 시간입니다.
스캔된 행의 평균 개수 쿼리를 처리하기 위해 Spanner Omni가 읽는 평균 행 수입니다. 스캔된 항목과 반환된 항목의 비율이 높으면 누락되거나 비효율적인 색인이 있는 경우가 많습니다.
반환된 평균 행 수 Spanner Omni 콘솔이 애플리케이션에 다시 전송하는 평균 행 수입니다.
반환된 바이트 실행당 Spanner Omni 콘솔에서 반환하는 평균 데이터 양입니다.