Go アプリケーションから Error Reporting にエラーレポートを送信するには、Go 用 Error Reporting パッケージを使用します。
Error Reporting は、App Engine、Compute Engine、Google Kubernetes Engine などの一部の Google Cloud サービスに統合されています。Error Reporting は、こうしたサービスで実行されるアプリケーションによって Cloud Logging に記録されたエラーを表示します。詳細については、このページの Google Cloud Platform での実行をご覧ください。
Logging を使用して、エラーデータを Error Reporting に送信することもできます。データ形式の要件については、Logging のエラー メッセージの形式設定をご覧ください。
始める前に
- Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
-
Error Reporting API を有効にします。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
-
Error Reporting API を有効にします。
クライアント ライブラリのインストール
Go 用 Error Reporting パッケージを使用すると、ほぼすべての場所で動作している Go アプリケーションから報告されるエラーをモニタリングして表示できます。
-
go get
を使用してパッケージをインストールします。go get cloud.google.com/go/errorreporting
インストールの詳細については、Go 用 Error Reporting パッケージのドキュメントをご覧ください。Issue Tracker を使用して問題を報告することもできます。
クライアント ライブラリの構成
Go 用 Error Reporting パッケージの動作をカスタマイズできます。godoc をご覧ください。
エラーの報告
パニックやエラーの報告方法のその他の例については、godoc をご覧ください。
Google Cloud での実行
Go 用 Error Reporting パッケージを使用するには、Identity and Access Management Error Reporting Writer ロールが必要です。ほとんどの Google Cloud コンピューティング プラットフォームでは、デフォルトでこの役割が付与されます。
Go 用 Error Reporting は、次の Google Cloud 環境に対して構成できます。
App Engine フレキシブル環境
App Engine は、デフォルトで Error Reporting Writer 役割を付与します。
Go 用 Error Reporting パッケージは、明示的に認証情報を提示しなくても使用できます。
App Engine のフレキシブル環境のアプリケーションでは、Error Reporting が自動的に有効になります。特別な設定は必要ありません。Google Kubernetes Engine
GKE では、次のサンプル コマンドのように、クラスタの作成時に cloud-platform
アクセス スコープを追加する必要があります。
gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform
Compute Engine
Compute Engine VM インスタンスを使用する場合は、各インスタンスに cloud-platform
アクセス スコープを追加します。Google Cloud Console から新しいインスタンスを作成する場合は、[インスタンスの作成] パネルの [ID と API へのアクセス] のセクションで行います。Compute Engine のデフォルト サービス アカウントまたは別のサービス アカウントを使用し、[ID と API へのアクセス] セクションの [すべての Cloud API に完全アクセス権を許可] を選択します。どのサービス アカウントを選択する場合でも、Google Cloud コンソールの IAM と管理 セクションで、そのアカウントに Error Reporting 書き込み役割が付与されていることを確認してください。
ローカルやその他の場所での実行
自分のワークステーション、データセンターのコンピュータ、別のクラウド プロバイダの VM インスタンスでライブラリを実行するなど、Google Cloud の外部で Go 用 Error Reporting パッケージを使用するには、Google Cloud プロジェクト ID と適切なサービス アカウント認証情報を Go 用 Error Reporting パッケージに直接提供する必要があります。
サービス アカウントの認証情報は手動で作成して取得できます。[ロール] フィールドを指定する場合は、Error Reporting Writer ロールを使用します。Identity and Access Management のロールの詳細については、アクセス制御ガイドをご覧ください。
エラーレポートの表示
デプロイ後は、Google Cloud コンソール Error Reporting ダッシュボードでエラーレポートを表示できます。
詳細については、エラーの表示をご覧ください。