エラーの管理

このページでは、Error Reporting でエラーを管理する方法について説明します。

エラーを表示するには、Cloud Console で [Error Reporting] ページを開きます。最近発生したエラーグループが、発生頻度の順に一覧表示されます。

エラーリストが表示されているユーザー インターフェース。

ヒント: これは、メールの受信トレイと同じように扱ってください。根本的な問題を解決し、予測されるエラーや再発するエラーを非表示にして整理整頓してください。

Error Reporting リストの表示とフィルタの詳細は、エラーの表示をご覧ください。

エラーを管理するために必要な権限については、アクセス制御ガイドをご覧ください。

エラーサンプル

通常、グループ化されたエラーは非常によく似ています。このため、Error Reporting では 1,000 回分の発生情報のみがサンプルとして保持され、それ以外の発生情報はそのサンプルを基に推定されます。あるエラーを発生するたびに保持するには、ログを BigQuery にエクスポートしてください。その後も、そのエラーの発生情報がすべて保持されます。

各サンプルに関してアプリケーションから Error Reporting に送信されるデータが UI に表示されます。たとえば、App Engine スタンダード環境では、ユーザー エージェントやエラーの原因となったリクエストの URL などの有用なメタデータが提供されます。ログエントリとして独自のエラーレポートを送信する場合は、使用可能なフィールドのリストを確認してください。Error Reporting API を使用する場合は、ReportedErrorEvent オブジェクトをご覧ください。

詳細は、エラーのグループ化方法をご覧ください。

解決ステータスの変更

ワークフローを管理するには、以下の操作を行い、エラーグループの解決ステータスを変更します。

  1. Cloud Console で [オペレーション] > [Error Reporting] ページを開きます。

    [Error Reporting] ページに移動

  2. エラーグループごとに [解決ステータス] が表示されます。

    エラー解決ステータスが示されているユーザー インターフェース。

  3. 前のパネルで、[解決ステータス] 列を展開して、エラーグループのステータスを変更します。可能なステータス値は次のとおりです。

    • オープン: すべてのエラーグループのデフォルトの初期状態。他の状態は手動で設定します。エラーグループのステータスは、いつでも [オープン] に戻すことができます。
    • 確認済み: エラーグループのトリアージ ステータス。
    • 解決済み: エラーグループが修正され、今後発生しないことを示すための状態。[解決済み] とマークされたエラーグループで問題が再発した場合、Error Reporting は解決ステータスを [オープン] に戻します。
    • ミュート: リストからエラーグループを選択できません。詳細は、エラーのミュートをご覧ください。

エラーのミュート

Error Reporting リストでエラーグループを非表示にするには、解決ステータスを [ミュート中] に変更します。ミュートされたエラーは、再発してもリストには表示されなくなります。

ミュートされたエラーグループを表示する(必要に応じてミュートを解除する)には、次の操作を行います。

  1. [ミュートされたエラーを管理] をクリックします。

    ミュートされたエラーメニューが表示されているユーザー インターフェース。

  2. [ミュートされたエラー] ページが表示されます。上のナビゲーション バーで、[解決ステータス] パネルを展開します。リストに表示しないエラーグループの解決ステータス タイプを選択します。

    解決ステータスのミュート オプションが示されているユーザー インターフェース。

エラーグループのミュートを解除するには、同じ [解像度ステータス] パネルから解決ステータス タイプの選択を解除します。

ミュートされたエラーが再発した場合、Error Reporting から通知は送信されません。

問題とのリンク

エラーグループを問題にリンクできます。

エラーグループに関連付けられている問題を表示または変更するには、リストの各行の横にあるバグレポートのアイコン をクリックします。

バグアイコンが示されているユーザー インターフェース。

エラーグループがまだ問題の URL に関連付けられていない場合は、バグレポートのアイコン をクリックすると、[問題の URL をこのエラーにリンク] パネルが開きます。このパネルに適切な URL を入力します。

エラーグループがすでに Issue Tracker システムの URL に関連付けられている場合は、バグレポートのアイコン をクリックすると、新しいブラウザタブでそのリンクが開きます。

通知

新しいエラーの発生時や、解決済みのエラーが再発した場合に通知するように Error Reporting を設定できます。詳細は、通知をご覧ください。

エラーの削除

保存されている特定のプロジェクトのエラーイベントをすべて削除し、エラー数をゼロにリセットするには、gcloud ツールまたは REST API を使用します。

gcloud

すべてのエラーイベントを削除するには、次のコマンドを使用します。

gcloud beta error-reporting events delete

REST API

すべてのエラーイベントを削除するには、REST API の projects.deleteEvents メソッドを使用します。