Key Visualizer는 사용 설정된 Spanner 데이터베이스의 성능과 리소스 사용량에 대한 측정항목을 자동으로 캡처하고 집계합니다. Key Visualizer의 모든 측정항목은 행 수로 정규화됩니다. 즉, 행 범위 내 측정항목 값은 집계된 개수를 범위 내 행 수로 나눈 값입니다.
측정항목
설명
CPU 초
행 범위에서 읽거나 쓰는데 소요된 초당(벽시계) CPU 초입니다.
저장된 논리적 바이트
행 범위에 데이터를 저장하는 데 사용되는 바이트입니다.
읽은 행 수
행 범위에서 읽은 초당 행 수입니다.
읽은 바이트 수
행 범위에서 읽은 초당 바이트 수(반환된 바이트 아님)입니다.
작성한 행 수
행 범위에서 삽입/업데이트된 초당 행 수입니다.
작성한 바이트 수
행 범위에서 삽입/업데이트된 초당 바이트 수입니다.
기간 세부사항
Spanner Key Visualizer는 시간 경과에 따라 여러 세부사항에서 측정항목을 집계합니다. 최신 데이터는 가장 세분화된 세부사항으로 집계되며 이전 데이터는 대략적으로 집계됩니다.
기간
세부사항
지난 6시간
1분
지난 4일
10분
지난 28일
1시간
데이터 보관 및 초기화
Spanner는 키 범위와 측정항목을 사용자 데이터베이스의 일부로 내부 메타데이터 테이블에 저장합니다. Spanner Key Visualizer 데이터 보관은 다음과 같습니다.
1분 간격으로 수집된 데이터는 6시간 후에 삭제됩니다.
10분 간격으로 수집된 데이터는 4일 후에 삭제됩니다.
1시간 간격으로 수집된 데이터는 28일 후에 삭제됩니다.
Key Visualizer는 메타데이터 테이블에 row key 데이터를 저장합니다. 데이터 보관 요구사항이 Key Visualizer 데이터 보관 일정과 호환되지 않으면 Key Visualizer를 중지할 수 있습니다.
제한사항
Key Visualizer에서는 새 데이터를 즉시 사용할 수 없는 몇 가지 경우가 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# Key Visualizer metrics\n\nThis page describes the metrics that you can view in Key Visualizer heatmaps.\n\nMetrics\n-------\n\nKey Visualizer automtically captures and aggregates metrics about performance\nand resource usage for Spanner databases that have enabled it. All\nmetrics in Key Visualizer are normalized by the number of rows. This means\nthat the metric value inside a row range is the aggregated count divided by the\nnumber of rows inside the range.\n\nTime window granularity\n-----------------------\n\nSpanner Key Visualizer aggregates metrics at several different\ngranularities over time. The most recent data is aggregated at the finest\ngranularity, while earlier data is aggregated more coarsely.\n\nData retention and wipeout\n--------------------------\n\nSpanner stores key ranges and metrics in an internal metadata table\nas part of the user's database. Spanner Key Visualizer data retention\nis as follows:\n\n- Data that is collected every minute will be deleted after six hours.\n- Data that is collected every ten minutes will be deleted after four days.\n- Data that is collected every hour will be deleted after 28 days.\n\nKey Visualizer stores row key data in the metadata table. If your data retention\nrequirements aren't compatible with Key Visualizer's data retention schedule,\nyou can\n[disable Key Visualizer](/spanner/docs/key-visualizer/getting-started#enabling_key_visualizer).\n\nLimitations\n-----------\n\nThere are some situations in which new data might not be immediately available in\nKey Visualizer.\n\n- Storage and traffic statistics for newly created databases might not be available immediately.\n- Traffic statistics for newly inserted rows might be attributed to existing key ranges.\n\nWhat's next\n-----------\n\n- [Get started with Key Visualizer](/spanner/docs/key-visualizer/getting-started).\n- Learn [how Key Visualizer displays data in heatmaps](/spanner/docs/key-visualizer/exploring-heatmaps#heatmaps).\n- Find out [how to explore Key Visualizer heatmaps](/spanner/docs/key-visualizer/exploring-heatmaps)."]]