Error Reporting 通知の Recommender と分析情報

Error Reporting Recommender は、Google Cloud プロジェクトで最近発生したクラッシュを探します。Error Reporting 通知が構成されていない場合は推奨事項を提供します。通知が構成されている場合、推奨事項は提供されません。

このドキュメントでは、推奨事項と分析情報を有効にして表示する方法について説明します。

始める前に

Error Reporting の推奨事項と分析情報を表示する前に、次の作業を行う必要があります。

  1. API を有効にするの説明に従って、Recommender API を有効にします。

  2. 十分な権限があることを確認します。必要な権限を持つ次のいずれかのロールが必要です。

    タスクの説明 ロール
    推奨事項 / 分析情報の表示 roles/recommender.errorReportingViewer
    推奨事項 / 分析情報の表示と更新（拒否） roles/recommender.errorReportingAdmin
    透明性とコントロール センターで推奨事項 / 分析情報をオプトアウトします。詳しくは、オプトアウトをご覧ください。 roles/dataprocessing.admin

    これらの Recommender に関するロールは、次の API 権限を提供します。

    ロール 含まれる権限
    roles/recommender.errorReportingViewer recommender.errorReportingInsights.get
    recommender.errorReportingInsights.list
    recommender.errorReportingRecommendations.get
    recommender.errorReportingRecommendations.list
    roles/recommender.errorReportingAdmin roles/recommender.errorReportingViewer 権限に加え
    recommender.errorReportingInsights.update
    recommender.errorReportingRecommendations.update

    ロールとアクセス権の付与の詳細については、以下をご覧ください。

推奨事項を表示する

Recommender は、Google Cloud Console に推奨事項を表示します。Google Cloud CLI または Recommender API を使用して推奨事項を一覧表示することもできます。

Google Cloud コンソール

推奨事項を表示するには、次の手順を行います。

  1. Google Cloud コンソールに移動するか、次のボタンを使用します。

    Google Cloud コンソールに移動

  2. [推奨事項] タブを選択します。

gcloud CLI

gcloud CLI を使用して Error Reporting の推奨事項を一覧表示するには、次のコマンドを実行します。

gcloud recommender recommendations list \
    --recommender=google.clouderrorreporting.Recommender \
    --project=PROJECT_ID \
    --location=global

PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

出力形式のオプションなど、このコマンドの詳細については、gcloud recommender recommendations list をご覧ください。

Recommender API

Recommender API を使用して Error Reporting の推奨事項を一覧表示するには、次のコマンドを実行します。

curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/recommenders/google.clouderrorreporting.Recommender/recommendations"

PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

詳細については、API の使用 - 推奨事項をご覧ください。

分析情報を表示する

Error Reporting Recommender は、分析情報に基づいて推奨事項を生成します。これらの分析情報は、Google Cloud CLI または Recommender API を使用して取得できます。

gcloud CLI

gcloud CLI を使用して Error Reporting の分析情報を一覧表示するには、次のコマンドを実行します。

gcloud recommender insights list \
    --insight-type=google.clouderrorreporting.Insight \
    --project=PROJECT_ID \
    --location=global

PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

出力形式のオプションなど、このコマンドの詳細については、gcloud recommender insights list をご覧ください。

Recommender API

Recommender API を使用して Error Reporting の分析情報を一覧表示するには、次のコマンドを実行します。

curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/recommenders/google.clouderrorreporting.Insight/insights"

PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

詳細については、API の使用 - 分析情報をご覧ください。

料金

Error Reporting の推奨事項と分析情報は無料で利用できます。他の料金ティアの詳細については、Recommender の料金をご覧ください。