このドキュメントでは、デバッグログの有効化、gRPC トランスポート呼び出しのトレース、プロキシの問題の診断、問題の報告など、Rust 用 Cloud クライアント ライブラリの問題をトラブルシューティングする方法について説明します。
デバッグ ロギング
リクエストとレスポンスの問題を診断するには、クライアント ライブラリのロギングを有効にします。詳細については、ロギングを有効にするをご覧ください。
gRPC の問題をトレースする
gRPC を使用するクライアントは、基盤となるトランスポートに tonic を使用します。Rust で gRPC 呼び出しをデバッグするには、tracing サブスクライバー フィルタを使用して、特定の gRPC クレートと HTTP/2 クレートを検査します。
たとえば、RUST_LOG 環境変数を設定して tonic=debug または h2=debug を含め、gRPC と HTTP/2 トランスポートの詳細を検査します。
RUST_LOG=tonic=debug,h2=debug cargo run --example EXAMPLE_NAME
<var>EXAMPLE_NAME</var> は、Cargo の例の名前に置き換えます。
プロキシの問題を診断する
HTTP プロキシの構成については、プロキシを構成するをご覧ください。
問題を報告
それでも問題が解決しない場合は、次のいずれかの方法でサポートを受けてください。
- Google Cloud サポート契約を締結している場合: GitHub で問題を報告するのではなく、Google Cloud サポートからケースを作成します。サポートケースを作成すると、迅速な対応が可能です。
- サポート契約がない場合: GitHub の
google-cloud-rustリポジトリで問題を報告します。Google Cloud クライアント ライブラリは複数の GitHub リポジトリを使用しますが、問題が別の場所にあることが確実でない限り、google-cloud-rustで Rust の問題を報告してください。メンテナーは、必要に応じて問題を別のリポジトリに移動することがあります。GitHub は、GitHub アカウントに関連付けられているメールアドレスに通知します。