Bigtable 클라이언트 측 측정항목을 대신 사용하려면 OpenCensus 통계와 통합된 모든 애플리케이션을 업데이트하는 것이 좋습니다.
Bigtable 클라이언트 측 측정항목은 OpenCensus 통합을 개선하고 OpenCensus 통계와 달리 측정항목을 게시하는 데 추가 비용이 발생하지 않습니다.
클라이언트 측 측정항목을 사용해야 하는 경우
항상 클라이언트 측 측정항목을 서버 측 측정항목과 함께 사용하여 Bigtable 성능에 대한 실행 가능한 완전한 뷰를 얻는 것이 좋습니다. 클라이언트 측과 서버 측의 측정항목을 모두 보면 특히 성능을 최적화하거나 문제를 해결할 때 유용하며 요청 수명 주기의 어떤 세그먼트에서 문제가 발생하는지 확인해야 합니다.
두 가지 유형의 측정항목을 모두 사용하면 특히 다음 유형의 워크로드에 유용합니다.
사용자 대상 및 상용 애플리케이션에서 경로 읽기 제공
중요 백엔드 서비스
여러 소비자가 있는 대규모 데이터 파이프라인
클라이언트 측 측정항목은 요청 수명 주기에서 지연 시간을 일으킬 수 있는 부분에 대한 유용한 정보를 제공합니다.
예상 동작
다음은 정상적이며 예상된 동작입니다.
1분 시작 시간: 클라이언트 측 측정항목을 사용 설정한 후에는 게시된 측정항목이 확인되기 전에 최소 1분 이상 애플리케이션이 실행되도록 하세요.
서버 지연 시간과 클라이언트 시도 지연 시간 간의 사소한 차이: 클라이언트 측 측정항목을 사용 설정한 후에는 bigtable.googleapis.com/server/latencies 및 bigtable.googleapis.com/client/attempt_latencies 측정항목 사이에 이전에 알지 못했던 에 한 자릿수의 차이를 알게 될 수 있습니다. 예를 들어 애플리케이션이 동일한 리전에서 Compute Engine VM과 Bigtable을 사용하는 경우 클라이언트 시도 지연 시간과 서버 지연 시간의 차이는 네트워크 지연 시간을 보여줍니다. 350초당 쿼리 수(QPS) 및 페이로드 크기 5KB의 경우 네트워크 지연 시간은 약 4ms입니다.
비용
Cloud Monitoring에서 클라이언트 측 측정항목 보기는 무료입니다. Cloud Monitoring API를 사용하는 경우 사용량 요금이 청구될 수 있습니다. 자세한 내용은 Google Cloud Observability 가격 책정을 참조하세요.
제한사항
Dataflow 또는 Apache Beam 클라이언트 라이브러리를 Java용 Bigtable HBase 클라이언트와 통합하는 애플리케이션에는 클라이언트 측 측정항목이 지원되지 않습니다.
[[["이해하기 쉬움","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\u003eBigtable provides client-side metrics to complement server-side metrics for optimizing performance and troubleshooting issues.\u003c/p\u003e\n"],["\u003cp\u003eClient-side metrics measure the time from when a request leaves the application to when the response is received, differing from server-side metrics.\u003c/p\u003e\n"],["\u003cp\u003eThese metrics are accessible via Cloud Monitoring, its API, and Bigtable monitoring, and are available for Java and Go client libraries.\u003c/p\u003e\n"],["\u003cp\u003eUsing both client-side and server-side metrics together gives a comprehensive view of Bigtable performance, particularly useful for user-facing apps, critical backend services, and large data pipelines.\u003c/p\u003e\n"],["\u003cp\u003eThere are no additional costs to view these metrics in Cloud Monitoring, although Cloud Monitoring API usage may have associated fees.\u003c/p\u003e\n"]]],[],null,["# Client-side metrics overview\n============================\n\nBigtable provides client-side metrics that you can use together\nwith server-side metrics to optimize performance and troubleshoot performance\nissues if they occur.\n\nThis page provides an overview of Bigtable client-side metrics and\ndiscusses when to use them. For setup and configuration instructions, see [Set\nup client-side metrics](/bigtable/docs/client-side-metrics-setup). For a\ndetailed list of the metrics, see [Client-side metrics\ndescriptions](/bigtable/docs/client-side-metrics-descriptions).\n\n*Client-side metrics* are measured from the time a request leaves your\napplication to the time the response is received by your application. In\ncontrast, *server-side metrics* are measured from the time\nBigtable receives a request until the last byte of data is sent to\nthe client.\n\nClient-side metrics are available for users of the following client libraries:\n\n- [Bigtable client library for C++](/cpp/docs/reference/bigtable/latest)\n- [Bigtable client library for Java](/java/docs/reference/google-cloud-bigtable/latest/overview)\n- [Bigtable HBase client for Java](https://github.com/googleapis/java-bigtable-hbase)\n- [Bigtable client library for Go](https://pkg.go.dev/cloud.google.com/go/bigtable)\n- [Bigtable client library for Node.js](/nodejs/docs/reference/bigtable/latest)\n\nYou can access client-side metrics in one of the following ways:\n\n- [Cloud Monitoring](/monitoring/docs/monitoring-overview), under **Metrics Explorer**\n\n- [Cloud Monitoring API](/monitoring/api/v3)\n\n- [Bigtable system insights](/bigtable/docs/monitoring-instance)\n\nWhen to upgrade\n---------------\n\nWe recommend that you update all applications integrated with\n[OpenCensus Stats](https://www.google.com/url?sa=D&q=https%3A%2F%2Fgithub.com%2Fgoogleapis%2Fjava-bigtable%2Ftree%2Fv2.15.0%23enabling-cloud-bigtable-metrics-opencensus-stats)\nto use Bigtable client-side metrics instead.\nBigtable client-side metrics improve on the OpenCensus integration\nand, unlike with OpenCensus Stats, you incur no additional cost for publishing\nthe metrics.\n\nWhen to use client-side metrics\n-------------------------------\n\nWe recommend that you always use client-side metrics in conjunction with\nserver-side metrics to get a complete, actionable view of your\nBigtable performance. Viewing metrics from both the client and\nserver sides is especially useful when you are optimizing performance or\ntroubleshooting issues, and you need to determine in which segment of the\nrequest lifecycle a problem is occurring.\n\nUsing both types of metrics is especially valuable for the following types of\nworkloads:\n\n- Serving path reads in user-facing and commercial applications\n- Critical backend services\n- Large-scale data pipelines with multiple consumers\n\nClient-side metrics give you insight into which portion of the request lifecycle\nmight be causing latency:\n\nExpected behaviors\n------------------\n\nThe following behaviors are normal and expected:\n\n- **One-minute startup time**: After you enable client-side metrics, let\n your application run for at least a minute before you check for any\n published metrics.\n\n- **Minor differences between server latencies and client attempt latencies** :\n After enabling client-side metrics, you might notice a single-digit\n difference between the `bigtable.googleapis.com/server/latencies` and\n `bigtable.googleapis.com/client/attempt_latencies` metrics that you were\n previously not aware of. For example, if your application uses a\n Compute Engine VM and Bigtable in the same region, the\n difference between client attempt latencies and server latencies shows the network\n latencies. For 350 queries per second (QPS) and payload size 5 KB, the network latency is around 4 ms.\n This latency is expected.\n\nCosts\n-----\n\nThere is no charge to view client-side metrics in Cloud Monitoring. If you\nuse the Cloud Monitoring API, usage fees might apply. See\n[Google Cloud Observability pricing](/stackdriver/pricing)\nfor details.\n\nLimitations\n-----------\n\nClient-side metrics are not supported for applications that integrate\nDataflow or Apache Beam client libraries with the Bigtable\nHBase client for Java.\n\nWhat's next\n-----------\n\n- [Install and configure client-side metrics.](/bigtable/docs/client-side-metrics-setup)\n- [View the complete list of client-side metrics.](/bigtable/docs/client-side-metrics-descriptions)"]]
