Rust 用 Cloud クライアント ライブラリのトラブルシューティング

このドキュメントでは、デバッグログの有効化、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 アカウントに関連付けられているメールアドレスに通知します。