次のどちらかの方法で、Google Kubernetes Engine アプリケーションから Error Reporting にエラーを送信できます。
Cloud Logging へのロギングによって。すでに Cloud Logging を使用している場合の追加の要件は、ログエントリを Error Reporting で認識可能にすることだけです。エラー形式の要件の詳細については、Cloud Logging のエラーの形式設定をご覧ください。
Error Reporting API を使用する。アプリケーションから、REST API を使用して HTTP リクエストを送信したり、試験運用版のライブラリを複数の言語で使用したりできます。
ロギングを使用してエラーを報告する
GKE のデフォルトの Logging エージェントによって、クラスタのログを Cloud Logging に送信するエージェントをデプロイして管理するためのマネージド ソリューションが提供されます。エージェントの構造は、クラスタのバージョンによって異なります。このエージェントの詳細については、GKE ログの管理をご覧ください。
Error Reporting では、例外またはスタック トレースが 1 つのログエントリに含まれる必要があります。ほとんどのロギング エージェントは、複数のログ行(新しい行にそれぞれ出力されるスタックフレーム)が 1 つのスタック トレースを表していることを認識でき、それを単一のログエントリとして Cloud Logging に送信します。エージェントが複数の行を 1 つのエラーに再構築できない場合は、projects.events.report
API エンドポイントを使用します。これにより、エラーの内容を制御できます。
Error Reporting API を使用してエラーを書き込む
Error Reporting API は、エラー情報をサービスに書き込むための report
エンドポイントを提供します。
Enable the Error Reporting API.
REST API またはクライアント ライブラリのいずれかを使用して、API にエラーを報告します。
サンプル
ASP.NET
ASP.NET NuGet パッケージにより、捕捉されなかった例外が ASP.NET ウェブ アプリケーションから Error Reporting に報告されます。
NuGet パッケージをインストールする
Stackdriver ASP.NET NuGet パッケージを Visual Studio にインストールするには:
- ソリューションを右クリックして、[ソリューションの NuGet パッケージの管理] を選択します。
- [プレリリースを含む] チェックボックスを選択します。
Google.Cloud.Diagnostics.AspNet
という名前のパッケージを検索してインストールします。
用途
Stackdriver ASP.NET NuGet パッケージをインストールしたら、次のステートメントをアプリケーション コードに追加して Stackdriver へのエラーの送信を開始します。
using Google.Cloud.Diagnostics.AspNet;
例外の報告を有効にするには、次の HttpConfiguration
コードを .NET ウェブアプリの Register
メソッドに追加します(your-project-id
は実際のプロジェクト ID に置き換えます)。
このメソッドを ASP.NET アプリケーションに追加すると、Google Cloud に報告される際に発生する捕捉されなかった例外を Google Cloud コンソールの Error Reporting セクションで確認することができます。
C#
次の例は、GoogleCloudPlatform/dotnet-docs-samples リポジトリにあります。これを使用するには、プロジェクトのビルド後に次のようにプロジェクト ID を指定します。
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
必ず、[YOUR_PROJECT_ID]
を Google Cloud コンソールからの正しい値に置き換えてください。
その後、次のようなコードで例外データを送信します。
Go
Go 用 Error Reporting の設定をご覧ください。
Java
Java 用 Error Reporting の設定をご覧ください。
Node.js
Node.js 用 Error Reporting の設定をご覧ください。
Ruby
Ruby 用 Error Reporting の設定をご覧ください。
Python
Python 用 Error Reporting の設定をご覧ください。
PHP
PHP 用 Error Reporting の設定をご覧ください。
エラーグループを表示する
Google Cloud コンソールで、[Error Reporting] ページに移動します。
このページは、検索バーを使用して見つけることもできます。