Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visão geral das métricas do lado do cliente
O Bigtable oferece métricas do lado do cliente que podem ser usadas em conjunto
com as métricas do lado do servidor para otimizar o desempenho e resolver problemas,
se ocorrerem.
As métricas do lado do cliente são medidas desde o momento em que uma solicitação sai do aplicativo até o momento em que a resposta é recebida por ele. Por outro lado, as métricas do servidor são medidas a partir do momento em que o Bigtable recebe uma solicitação até que o último byte de dados é enviado ao cliente.
As métricas do lado do cliente estão disponíveis para usuários das bibliotecas de cliente a seguir:
Recomendamos que você atualize todos os aplicativos integrados às
estatísticas do OpenCensus
para usar as métricas do lado do cliente do Bigtable.
As métricas do lado do cliente do Bigtable melhoram a integração do OpenCensus e, ao contrário das estatísticas do OpenCensus, você não terá nenhum custo adicional para publicar as métricas.
Quando usar métricas do lado do cliente
Recomendamos que você sempre use métricas do lado do cliente em conjunto
com as métricas do lado do servidor para ter uma visão completa e acionável do
desempenho do Bigtable. O acesso de métricas do lado do cliente e
do servidor é especialmente útil quando você está otimizando problemas de
desempenho ou
solucionando problemas e precisa determinar em qual segmento do
ciclo de vida da solicitação um problema está ocorrendo.
O uso dos dois tipos de métricas é especialmente valioso para os seguintes tipos de
cargas de trabalho:
Exibir leituras de caminhos em aplicativos comerciais e voltados ao usuário
Serviços de back-end críticos
Pipelines de dados em grande escala com vários consumidores
As métricas do lado do cliente fornecem insights sobre qual parte do ciclo de vida da solicitação
pode estar causando a latência:
Comportamentos esperados
Os seguintes comportamentos são normais e esperados:
Tempo de inicialização de um minuto: depois de ativar as métricas do lado do cliente, deixe o aplicativo ser executado por pelo menos um minuto antes de verificar se há métricas publicadas.
Pequenas diferenças entre latências de servidor e latências de tentativa do cliente:
depois de ativar as métricas do lado do cliente, talvez você note uma diferença
de um dígito entre as bigtable.googleapis.com/server/latencies e
bigtable.googleapis.com/client/attempt_latencies métricas que você
não conhecia. Por exemplo, se o aplicativo usar uma VM do Compute Engine e o Bigtable na mesma região, a diferença entre as latências de tentativa do cliente e as latências do servidor mostrará as latências de rede. Para 350 consultas por segundo (QPS) e tamanho de payload de 5 KB, a latência da rede é de cerca de 4 ms.
Essa latência é esperada.
Custos
Não há custo para acessar as métricas do lado do cliente no Cloud Monitoring. Se você
usar a API Cloud Monitoring, poderão ser aplicadas taxas de uso. Consulte os
preços do Google Cloud Observability
para mais detalhes.
Limitações
As métricas do lado do cliente não são compatíveis com aplicativos que integram bibliotecas de cliente do Dataflow ou Apache Beam ao cliente HBase do Bigtable para Java.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-27 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)"]]