대부분의 Key Visualizer 측정항목은 행당 수량을 나타냅니다. 예를 들어 Ops 측정항목은 1분 동안 진행된 행별 작업 수를 측정합니다.
Bigtable 테이블에는 몇 조 개의 행이 있을 수 있으므로 각 행에 대한 측정항목을 보고하는 것이 항상 실용적인 것은 아닙니다. 대신 Key Visualizer는 모든 row key를 1,000개의 연속 범위로 나누어 각 범위에 거의 같은 수의 row key가 포함되도록 합니다. 이러한 범위를 키 버킷이라고 합니다.
Key Visualizer는 대부분의 측정항목을 각 키 버킷의 평균 또는 각 키 버킷 내 최댓값으로 보고합니다. 경고 측정항목과 성능 측정항목의 경우 Key Visualizer는 개별 row key 또는 키 버킷 내 특정 키 범위에 대한 측정항목을 보고하여 정확도를 높입니다.
활동 카테고리에는 분당 행별 작업 수를 측정하는 Ops 측정항목이 포함됩니다. 이 측정항목은 총 읽기 및 쓰기 수와 거의 동일하며 특정 시점에 어떤 키가 요청을 더 많이 수신하는지 나타낼 수 있습니다. 색상은 관측된 모든 값에 상대적인 값을 나타내므로 노란색 또는 흰색이 핫스팟을 의미하지는 않습니다.
경고
경고 카테고리에는 테이블에 발생할 수 있는 성능 문제를 나타내는 측정항목이 포함됩니다.
이 카테고리에는 다음 측정항목이 포함됩니다.
Read pressure index: CPU 사용률 및 읽기 지연 시간을 포함하는 row key 또는 키 범위에 대한 불투명 복합 지수입니다.
이 지수는 15분의 간격 동안 관찰된 모든 값을 반영합니다. 값이 100 이상이면 일반적으로 키 범위의 성능이 좋지 않음을 나타냅니다. 단일 행 또는 작은 범위의 행에 자주 액세스하거나 행에 256MB 이상의 데이터가 포함된 경우 성능이 저하될 수 있습니다.
Write pressure index: CPU 사용률 및 쓰기 지연 시간을 포함하는 row key 또는 키 범위에 대한 불투명 복합 지수입니다.
이 지수는 15분의 간격 동안 관찰된 모든 값을 반영합니다. 값이 100 이상이면 일반적으로 키 범위의 성능이 좋지 않음을 나타냅니다. 단일 행 또는 작은 범위의 행에 자주 액세스하거나 행에 256MB가 넘는 데이터가 포함된 경우 성능이 저하될 수 있습니다.
큰 행: 각각 256MB가 넘는 데이터를 포함하는 행이나 행당 평균이 200MB를 넘는 키 범위에 저장되는 데이터 양입니다.
행당 256MB가 넘는 데이터를 저장하면 성능 문제와 읽기 오류가 발생할 수 있으므로 권장하지 않습니다.
이 측정항목의 경우 히트맵 위로 커서를 이동해도 Key Visualizer 프로그램은 키 버킷에 대한 집계 정보를 표시하지 않습니다. 대신 테이블의 특정 row key 또는 키 범위의 정보가 표시되므로 문제의 출처를 정확히 찾아낼 수 있습니다.
이러한 측정항목을 보고 조치하는 방법은 경고 측정항목 검토를 참조하세요.
읽기
읽기 카테고리에는 테이블에서 데이터를 읽는 것과 관련된 측정항목이 포함됩니다.
이 카테고리에는 다음 측정항목이 포함됩니다.
Read CPU: 행을 읽는 데 사용된 노드 수로 표시되는 평균 CPU 사용률입니다. 색상은 관측된 모든 값에 상대적인 값을 나타내므로 노란색 또는 흰색이 핫스팟을 의미하지는 않습니다.
Read bytes client: 클라이언트가 분당 각 행에서 읽은 바이트 수입니다. 색상은 관측된 모든 값에 상대적인 값을 나타내므로 노란색 또는 흰색이 핫스팟을 의미하지는 않습니다.
쓰기
쓰기 카테고리에는 테이블에서 데이터를 쓰는 것과 관련된 측정항목이 포함됩니다.
이 카테고리에는 다음 측정항목이 포함됩니다.
Write CPU: 행을 쓰는 데 사용된 노드의 수로 표시되는 평균 CPU 사용률입니다. 색상은 관측된 모든 값에 상대적인 값을 나타내므로 노란색 또는 흰색이 핫스팟을 의미하지는 않습니다.
Write bytes client: 클라이언트가 분당 각 행에서 쓴 바이트 수입니다. 색상은 관측된 모든 값에 상대적인 값을 나타내므로 노란색 또는 흰색이 핫스팟을 의미하지는 않습니다.
성능
성능 카테고리에는 지연 시간과 관련된 측정항목이 포함됩니다.
이 카테고리에는 다음 측정항목이 포함됩니다.
Latency: 읽기 및 쓰기 작업의 지연 시간입니다. 주황색으로 표시된 1초는 높은 것으로 간주될 수 있습니다.
Latency(max): 읽기 또는 쓰기의 최대 지연 시간입니다. 주황색으로 표시된 1초는 높은 것으로 간주될 수 있습니다.
이 측정항목의 경우 히트맵 위로 커서를 이동해도 Key Visualizer 프로그램은 키 버킷에 대한 집계 정보를 표시하지 않습니다. 대신 테이블의 특정 row key 또는 키 범위의 정보가 표시되므로 문제의 출처를 정확히 찾아낼 수 있습니다.
크기
Data stored: 행당 저장되는 데이터 양입니다.
이 측정항목은 데이터 저장 시 Bigtable의 데이터 압축을 반영합니다.
Rows: 각 키 버킷에 있는 대략적인 행 수입니다.
Rows 히트맵은 일반적으로 노란색으로 표시됩니다. 왼쪽에서 오른쪽으로 밝아지는(짙은 색에서 밝은 색으로 변함) 가로 줄무늬는 행 추가를 나타냅니다. 왼쪽에서 오른쪽으로 어두워지는 줄무늬는 행 삭제를 나타냅니다.
특정 키 프리픽스의 전체 행 수를 확인하려면 키 계층에서 프리픽스를 클릭한 후 하단에 있는 가로 막대 그래프 위에 표시된 도움말을 확인하세요.
[[["이해하기 쉬움","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-04(UTC)"],[[["\u003cp\u003eKey Visualizer divides row keys into 1,000 contiguous ranges called key buckets to report metrics, which are presented as averages or maximum values within each bucket.\u003c/p\u003e\n"],["\u003cp\u003eThe Activity metric, specifically the "Ops" metric, indicates the number of operations per row per minute, helping identify keys with higher request volumes.\u003c/p\u003e\n"],["\u003cp\u003eThe Warnings category includes metrics like "Read pressure index," "Write pressure index," and "Large rows" to highlight potential performance bottlenecks or data storage issues.\u003c/p\u003e\n"],["\u003cp\u003eReads and Writes categories provide metrics like "Read/Write CPU" and "Read/Write bytes client" to gauge resource utilization and data throughput per row.\u003c/p\u003e\n"],["\u003cp\u003eThe Performance category tracks latency for read and write operations with metrics like "Latency" and "Latency (max)" to evaluate operational speed, and the size category provides data on the amount of data stored and approximate number of rows in each key bucket.\u003c/p\u003e\n"]]],[],null,["Key Visualizer metrics\n\nThis page describes the metrics that you can view in Key Visualizer heatmaps.\n\nMost Key Visualizer metrics represent a quantity per row. For example, the\n**Ops** metric measures the number of operations per row per minute.\n\n\nA Bigtable table can have trillions of rows, so it's not always practical to report\nmetrics for each individual row. Instead, Key Visualizer divides all of the row keys into 1,000\ncontiguous ranges, with roughly the same number of row keys in each range. These ranges are known\nas *key buckets*.\n\n\nKey Visualizer reports most metrics as averages over each key bucket, or as maximum values within\neach key bucket. For [**Warnings** metrics](/bigtable/docs/keyvis-metrics#warnings)\nand [**Performance** metrics](/bigtable/docs/keyvis-metrics#performance), Key\nVisualizer provides higher precision by reporting metrics for individual row keys or for specific\nkey ranges within the key bucket.\n\n\u003cbr /\u003e\n\n\nBefore you read this page, you should be familiar with the\n[overview of Key Visualizer](/bigtable/docs/keyvis-overview).\n\nActivity\n\nThe Activity category includes the **Ops** metric, which measures the number of\noperations per row per minute. This metric is roughly equal to the combined\nnumber of reads and writes and can indicate which keys received more requests at\na given time. Color indicates values relative to all observed values; therefore,\nyellow or white do not necessarily imply a hotspot.\n\nWarnings\n\nThe Warnings category includes metrics that identify possible performance issues\nwith a table.\nThis category includes the following metrics:\n\n- **Read pressure index**: An opaque, composite index for a row key or key range\n that incorporates the CPU utilization and latency for reads.\n\n\n This index reflects all of the values that were observed during a 15-minute interval. A value of 100\n or greater generally indicates poor performance for a key range. Poor performance can occur when you\n access a single row or a small range of rows very frequently, or when a row contains more than\n 256 MB of data.\n- **Write pressure index**: An opaque, composite index for a row key or key\n range that incorporates the CPU utilization and latency for writes.\n\n\n This index reflects all of the values that were observed during a 15-minute interval. A value of 100\n or greater generally indicates poor performance for a key range. Poor performance can occur when you\n access a single row or a small range of rows very frequently, or when a row contains more than\n 256 MB of data.\n- **Large rows**: The amount of data stored in rows that each contain more than\n 256 MB of data, or in key ranges with an average of more than\n 200 MB per row.\n\n Storing more than 256 MB of data per row can cause\n performance issues and read errors, and is not recommended.\n\n\nFor these metrics, when you move your cursor over the heatmap, Key Visualizer does not display\naggregated information for a key bucket. Instead, it displays information about specific row keys or\nkey ranges in your table, so that you can pinpoint the source of the issue.\n\nSee [Reviewing\nwarning metrics](/bigtable/docs/keyvis-getting-started#reviewing-warning-metrics) to learn how to view and act on these metrics.\n\nReads\n\nThe Reads category includes metrics related to reading data from a table.\n\nThis category includes the following metrics:\n\n- **Read CPU**: The average CPU utilization, expressed as the number of nodes that were used to read a row. Color indicates values relative to all observed values; therefore, yellow or white do not necessarily imply a hotspot.\n- **Read bytes client**: The number of bytes read by the client per minute per row. Color indicates values relative to all observed values; therefore, yellow or white do not necessarily imply a hotspot.\n\nWrites\n\nThe Writes category includes metrics related to writing data to a table.\n\nThis category includes the following metrics:\n\n- **Write CPU**: The average CPU utilization, expressed as the number of nodes that were used to write a row. Color indicates values relative to all observed values; therefore, yellow or white do not necessarily imply a hotspot.\n- **Write bytes client**: The number of bytes written by the client per minute per row. Color indicates values relative to all observed values; therefore, yellow or white do not necessarily imply a hotspot.\n\nPerformance\n\nThe Performance category includes metrics related to latency.\n\nThis category includes the following metrics:\n\n- **Latency**: The latency for read and write operations. One second (shown as orange) can be considered high.\n- **Latency (max)**: The maximum latency for reads or writes. One second (shown as orange) can be considered high.\n\n\nFor these metrics, when you move your cursor over the heatmap, Key Visualizer does not display\naggregated information for a key bucket. Instead, it displays information about specific row keys or\nkey ranges in your table, so that you can pinpoint the source of the issue.\n\nSize\n\n- **Data stored:** The amount of data stored per row. This metric reflects the fact that Bigtable compresses your data when it is stored.\n- **Rows:** The approximate number of rows in each key bucket.\n\n The **Rows** heatmap typically appears mostly yellow. Horizontal stripes\n increasing in brightness from left to right, going from a darker color to\n a lighter color, indicate the addition of rows. Stripes that\n decrease in brightness from left to right indicate the deletion of rows.\n\n To see the total number of rows for a given key prefix, click on that\n prefix in the key hierarchy, then inspect the tooltips over the\n horizontal bar chart along the bottom.\n\nWhat's next\n\n- [Get started with Key Visualizer](/bigtable/docs/keyvis-getting-started).\n- Learn [how Key Visualizer displays data in heatmaps](/bigtable/docs/keyvis-overview#heatmaps).\n- Find out [how to explore Key Visualizer heatmaps](/bigtable/docs/keyvis-exploring-heatmaps)."]]
