Recomendador e insights de notificações do Error Reporting

O recomendador do Error Reporting procura falhas recentes no projeto do Google Cloud e fornece recomendações se você não tiver configurado as notificações do Error Reporting. Quando as notificações estão configuradas, nenhuma recomendação é feita.

Este documento descreve como ativar e visualizar recomendações e insights.

Antes de começar

Antes de visualizar as recomendações e os insights do Error Reporting, faça o seguinte:

  1. Ative a API Recommender conforme descrito em Ativar a API.

  2. Verifique se você tem permissão suficiente. Você precisa ter um dos seguintes papéis, que concedem as permissões necessárias:

    Descrição da tarefa Papel
    Ver recomendações/insights roles/recommender.errorReportingViewer
    Ver e atualizar (dispensar) recomendações/insights roles/recommender.errorReportingAdmin
    Desativar recomendações/insights na Central de transparência e controle. Para mais informações, consulte Como desativar. roles/dataprocessing.admin

    Esses papéis do recomendador fornecem as seguintes permissões de API:

    Papel Permissões incluídas
    roles/recommender.errorReportingViewer recommender.errorReportingInsights.get
    recommender.errorReportingInsights.list
    recommender.errorReportingRecommendations.get
    recommender.errorReportingRecommendations.list
    roles/recommender.errorReportingAdmin roles/recommender.errorReportingViewer permissões, mais
    recommender.errorReportingInsights.update
    recommender.errorReportingRecommendations.update

    Para mais informações sobre papéis e como conceder acesso, consulte:

Ver recomendações

O recomendador exibe recomendações no Console do Google Cloud. Também é possível listar recomendações usando a CLI do Google Cloud ou a API Recommender.

Console do Google Cloud

Para ver suas recomendações, faça o seguinte:

  1. Acesse o console do Google Cloud ou use o seguinte botão:

    Acessar o Console do Google Cloud

  2. Selecione a guia Recomendações.

CLI gcloud

Para listar as recomendações do Error Reporting usando a CLI do gcloud, execute o seguinte comando:

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

Substitua PROJECT_ID pelo identificador do seu projeto do Google Cloud.

Para mais informações sobre esse comando, incluindo opções para o formato de saída, consulte gcloud recommender recommendations list.

API Recommender

Para listar suas recomendações do Error Reporting usando a API Recommender, execute o seguinte comando:

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

Substitua PROJECT_ID pelo identificador do seu projeto do Google Cloud.

Para mais informações, consulte Como usar a API - Recomendações.

Ver insights

O recomendador do Error Reporting gera recomendações com base em insights. É possível recuperar esses insights usando a CLI do Google Cloud ou a API Recommender.

CLI gcloud

Para listar os insights do Error Reporting usando a CLI do gcloud, execute o seguinte comando:

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

Substitua PROJECT_ID pelo identificador do seu projeto do Google Cloud.

Para mais informações sobre esse comando, incluindo opções para o formato de saída, consulte gcloud recommender insights list.

API Recommender

Para listar os insights do Error Reporting usando a API Recommender, execute o seguinte comando:

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

Substitua PROJECT_ID pelo identificador do seu projeto do Google Cloud.

Para mais informações, consulte Como usar a API - Insights.

Preços

As recomendações e os insights do Error Reporting estão disponíveis gratuitamente. Para informações sobre outros níveis de preço, consulte Preços de recomendações.