Error Reporting 用の Python アプリのインストルメント化

Python アプリケーションから Error Reporting にエラーイベントを送信するには、 Python 用 Error Reporting ライブラリを使用します。 次の場合は、Python 用 Error Reporting ライブラリを使用してエラーグループを作成します。

• ログエントリを含むログバケットに、顧客管理の暗号鍵(CMEK)がある。
• ログバケットが次のいずれかを満たしている。
  • ログバケットがログエントリの元のプロジェクトに保存されている。
  • ログエントリがプロジェクトに転送され、そのプロジェクトがそれらのログエントリを、所有するログバケットに保存した。
• カスタム エラーイベントを報告する場合。

Error Reporting は、Cloud Run functions 、App Engine、Compute Engine、 Google Kubernetes Engine などの 一部の Google Cloud サービスに統合されています。Error Reporting は、こうしたサービスで実行されるアプリケーションによって Cloud Logging に記録されたエラーイベントを表示します。 詳細については、このページの での実行 Google Cloudをご覧ください。

Logging を使用して、エラーイベントを Error Reporting に送信することもできます。データ形式の 要件については、 ログエントリの形式を設定してエラーイベントを報告するをご覧ください。

始める前に

アカウントに Google Cloud ログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Error Reporting API .

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Error Reporting API .

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Python 開発用に環境を準備します。

   Python 設定ガイドに移動

クライアント ライブラリをインストールする

Python 用 Error Reporting ライブラリを使用すると、ほぼすべての場所で動作している Python アプリケーションから報告されるエラーイベントをモニタリングして表示できます。

1. 仮想環境をインスタンス化し、pip を使用してパッケージをインストールします。

   pip install google-cloud-error-reporting --upgrade
   

2. エラーの報告を開始するために、ライブラリをインポートしてクライアントをインスタンス化します。

   Python

   Error Reporting に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証の設定をご覧ください。

   #!/usr/bin/env python
   #
   # Copyright 2022 Google, Inc.
   #
   # Licensed under the Apache License, Version 2.0 (the "License");
   # you may not use this file except in compliance with the License.
   # You may obtain a copy of the License at
   #
   #    http://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS,
   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   # See the License for the specific language governing permissions and
   # limitations under the License.
   
   
   def report_exception():
       from google.cloud import error_reporting
   
       client = error_reporting.Client()
       try:
           raise Exception("Something went wrong")
       except Exception:
           client.report_exception()
   
   
   
   
   def report_manual_error():
       from google.cloud import error_reporting
   
       client = error_reporting.Client()
       client.report("An error has occurred.")
   
   
   
   
   if __name__ == "__main__":
       report_exception()
       report_manual_error()
   

インストールの詳細については、Python 用 Error Reporting ライブラリのドキュメントをご覧ください。公開バグトラッカーを使用して問題を報告することもできます。

クライアント ライブラリを設定する

Python 用 Error Reporting ライブラリの動作をカスタマイズできます。構成例については、 クライアント ライブラリのドキュメント をご覧ください。

でアプリを実行する Google Cloud

projects.events.report を使用してエラーグループを作成するには、サービス アカウントに Error Reporting 書き込みロール（roles/errorreporting.writer）が必要です。

一部の Google Cloud サービスでは、 Error Reporting 書き込みロール（roles/errorreporting.writer）が適切な サービス アカウントに自動的に付与されます。ただし、一部のサービスでは、このロールを適切なサービス アカウントに付与する必要があります。

Cloud Run と Cloud Run functions

Cloud Run で使用されるデフォルトのサービス アカウントには、 Error Reporting 書き込みロール（roles/errorreporting.writer）の権限があります。

Python 用 Error Reporting ライブラリは、明示的に認証情報を提示しなくても使用できます。

Cloud Run は、自動的に Error Reporting を使用するように構成されています。JavaScript の未処理の例外は、Logging に表示され、Python 用 Error Reporting ライブラリを使用しなくても、Error Reporting によって処理されます。

注: ログエントリにスタック トレースが含まれていて、ログエントリの重大度レベルが設定されていないか、ERROR 以上の重大度レベルに設定されている場合、Error Reporting は自動的にエラーイベントを作成します。

App Engine フレキシブル環境

App Engine では、デフォルトのサービス アカウントに Error Reporting 書き込みロール（roles/errorreporting.writer）が自動的に付与されます。

Python 用 Error Reporting ライブラリは、明示的に認証情報を提示しなくても使用できます。

App Engine フレキシブル環境のアプリケーションでは、Error Reporting が自動的に有効になります。特別な設定は必要ありません。

注: stderr に書き込まれたエラー・ログエントリは、 Error Reporting ライブラリを直接使用しなくても、 Error Reporting によって自動的に処理されます。

Google Kubernetes Engine

Google Kubernetes Engine で Error Reporting を使用するには、次の操作を行います。

1. コンテナが使用するサービス アカウントに、Error Reporting 書き込みロール（roles/errorreporting.writer）が付与されていることを確認します。

   Compute Engine のデフォルトのサービス アカウント またはカスタム サービス アカウントを使用できます。

   ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

2. クラスタを作成し、クラスタに cloud-platform アクセス スコープを付与します。

   たとえば、次の create コマンドは、cloud-platform アクセス スコープとサービス アカウントを指定します。

   gcloud container clusters create CLUSTER_NAME --service-account  SERVICE_ACCT_NAME --scopes=cloud-platform
   

注: クラスタを作成した後は、サービス アカウントを変更できません。

Compute Engine

Compute Engine VM インスタンスで Error Reporting を使用するには、次の操作を行います。

1. VM インスタンスが使用するサービス アカウントに、Error Reporting 書き込みロール（roles/errorreporting.writer）が付与されていることを確認します。

   Compute Engine のデフォルトのサービス アカウント またはカスタム サービス アカウントを使用できます。

   ロールの付与については、 プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

2. コンソール Google Cloud で [**VM インスタンス**] ページに移動します。

   [VM インスタンス] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] である結果を選択します。

3. cloud-platform アクセス スコープを適用する VM インスタンスを選択します。

4. [停止] をクリックし、[編集] をクリックします。

5. [ID と API へのアクセス] セクションで、Error Reporting 書き込みロール（roles/errorreporting.writer）を持つサービス アカウントを選択します。

6. [**アクセス スコープ**] セクションで、 [**すべての Cloud API に完全アクセス権を許可**] を選択し、変更を保存します。

7. [開始 / 再開] をクリックします。

例

次の例に示すように、report メソッドを呼び出すと、手動でエラーを報告できます。

Python

Error Reporting に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、認証を設定するをご覧ください。

#!/usr/bin/env python
#
# Copyright 2022 Google, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.


def report_exception():
    from google.cloud import error_reporting

    client = error_reporting.Client()
    try:
        raise Exception("Something went wrong")
    except Exception:
        client.report_exception()




def report_manual_error():
    from google.cloud import error_reporting

    client = error_reporting.Client()
    client.report("An error has occurred.")




if __name__ == "__main__":
    report_exception()
    report_manual_error()

ローカル開発環境でアプリを実行する

自分のワークステーションでライブラリを実行するなど、ローカル開発環境で Python 用 Error Reporting ライブラリを使用するには、ローカル アプリケーションのデフォルト認証情報を使用して、Python 用 Error Reporting ライブラリを指定する必要があります。 詳細については、Error Reporting に対する認証をご覧ください。

ローカル開発環境でこのページの Python サンプルを使用するには、gcloud CLI をインストールして 初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。

1. Google Cloud CLI をインストールします。

2. 外部 ID プロバイダ（IdP）を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。

3. ローカルシェルを使用している場合は、ユーザー アカウントのローカル認証情報を作成します。

   gcloud auth application-default login

   Cloud Shell を使用している場合は、この操作を行う必要はありません。

   注: 使用しているアカウントに serviceusage.services.use 権限がないという警告が gcloud CLI で表示される場合は、一部の gcloud CLI コマンドとクライアント ライブラリが動作しない可能性があります。管理者に Service Usage コンシューマー IAM ロール（roles/serviceusage.serviceUsageConsumer）を付与してもらってから、次のコマンドを実行してください。

   gcloud auth application-default set-quota-project PROJECT_ID

   認証エラーが返され、外部 ID プロバイダ （IdP）を使用している場合は、 連携 ID を使用して gcloud CLI にログインしていることを確認します。

詳細については、 ローカル開発環境の認証を設定するをご覧ください。

The projects.events.report method also supports API keys. 認証に API キーを使用する場合、ローカルのアプリケーションのデフォルト認証情報ファイルを設定する必要はありません。 詳細については、 API キーを作成する 認証ドキュメントの Google Cloud をご覧ください。

エラーグループを表示する

コンソール Google Cloud で [Error Reporting] ページに移動します。

Error Reporting に移動

このページは、検索バーを使用して見つけることもできます。

詳細については、 エラーグループを表示してフィルタするをご覧ください。