このページでは、クライアントサイドの指標の表示と管理について説明します。クライアントサイドの指標は、Spanner に対するクライアントの RPC リクエストに関するレイテンシ情報を提供します。
Spanner では、クライアントサイドの指標をサーバーサイドの指標とともに使用することで、パフォーマンスを最適化し、パフォーマンスの問題が発生した場合にトラブルシューティングを行うことができます。
クライアントサイドの指標は、アプリケーションがリクエストを送信してからアプリケーションがレスポンスを受信するまでの時間で測定されます。一方、サーバーサイドの指標は、Spanner がリクエストを受け取ってからデータの最後のバイトがクライアントに送信されるまでの時間で測定されます。
始める前に
クライアントサイドの指標は、Cloud Monitoring API を有効にすると使用できます。
-
クライアントサイド指標にアクセスするために必要な権限を取得するには、プロジェクトに対するモニタリング指標書き込み （
roles/monitoring.metricWriter）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。この事前定義ロールには、クライアントサイドの指標にアクセスするために必要な
monitoring.timeSeries.create権限が含まれています。
クライアントサイドの指標にアクセスする
クライアントサイドの指標には、次のクライアント ライブラリを使用してアクセスできます。
Metrics Explorer でクライアントサイドの指標を表示する手順は次のとおりです。
Google Cloud コンソールで、[Metrics Explorer] ページに移動します。
プロジェクトを選択します。
[指標を選択] をクリックします。
spanner.googleapis.com/clientを検索します。指標を選択して、[適用] をクリックします。
指標のグループ化または集計の詳細については、メニューを使用してクエリを作成するをご覧ください。
公開された指標を表示するには、アプリケーションを 1 分以上実行する必要があります。
クライアントサイドの指標をオプトアウトする
OpenTelemetry を使用してカスタム クライアント指標をすでにキャプチャしている場合は、次のコードを使用して、クライアントサイドの指標の使用をオプトアウトできます。
Java
Spanner spanner =
SpannerOptions.newBuilder()
.setProjectId("test-project")
.setBuiltInMetricsEnabled(false)
.build()
.getService();
Go
client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
DisableNativeMetrics: true,
})
料金
Cloud Monitoring でクライアントサイドの指標を表示するのに料金はかかりません。Monitoring API を使用すると、料金が発生する場合があります。詳細については、Google Cloud Observability の料金をご覧ください。