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

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

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

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

Logging を使用して、エラーデータを Error Reporting に送信することもできます。データ形式の要件については、Logging のエラーメッセージの形式設定をご覧ください。

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Error Reporting API .

Enable the API

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Error Reporting API .

Enable the API

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

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

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

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

PHP 用 Error Reporting ライブラリの動作をカスタマイズできます。構成可能なオプションのリストについては、ライブラリの構成をご覧ください。

Google Cloud でアプリを実行する

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

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

App Engine フレキシブル環境

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

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

App Engine フレキシブル環境で Error Reporting を有効にするには、次の手順を実行します。

次のコマンドを使用して必要なライブラリをインストールします。
```
$ composer require google/cloud-error-reporting
```
次の行を app.yaml の runtime_config セクションに追加します。

enable_stackdriver_integration: true

その後、ライブラリが、自動的に、すべてのエラーと捕捉されなかった例外を Error Reporting に収集します。独自の例外ハンドラをインストールするウェブフレームワークを使用している場合は、フレームワークの統合のセクションをご覧ください。

Google Kubernetes Engine

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

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

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

ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
クラスタを作成し、クラスタに cloud-platform アクセススコープを付与します。

たとえば、次の作成コマンドは、cloud-platform アクセススコープとサービスアカウントを指定します。
```
gcloud container clusters create CLUSTER_NAME --service-account  SERVICE_ACCT_NAME --scopes=cloud-platform
```

Compute Engine

Compute Engine VM インスタンスで Error Reporting を使用する手順は次のとおりです。

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

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

ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
Google Cloud コンソールで、[VM インスタンス] ページに移動します。
[VM インスタンス] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Compute Engine] である結果を選択します。
cloud-platform アクセススコープを適用する VM インスタンスを選択します。
[停止]、[編集] の順にクリックします。
[ID と API へのアクセス] セクションで、Error Reporting 書き込みロール（roles/errorreporting.writer）を持つサービスアカウントを選択します。
[アクセススコープ] セクションで、[すべての Cloud API に完全アクセス権を許可] を選択し、変更を保存します。
[開始 / 再開] をクリックします。

Cloud Functions

Cloud Run 関数は、Error Reporting 書き込みロール（roles/errorreporting.writer）をデフォルトのサービスアカウントに自動的に付与します。

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

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

例

1. 次のコマンドを使用して、クラウドライブラリをインストールします。

$ composer require google/cloud-error-reporting

2. 次の行を php.ini に追加します。ここで、WORKSPACE はワークスペースのルートディレクトリの絶対パスです。

auto_prepend_file='/WORKSPACE/vendor/google/cloud-error-reporting/src/prepend.php'

このプリペンドファイルは、エラーを自動的に Error Reporting に送信する例外ハンドラとエラーハンドラをインストールします。

App Engine フレキシブル環境を使用している場合は、このページの App Engine フレキシブル環境をご覧ください。

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

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

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

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
If you're using a local shell, then create local authentication credentials for your user account:
```
gcloud auth application-default login
```
You don't need to do this if you're using Cloud Shell.
Note: If the gcloud CLI prints a warning that your account doesn't have the serviceusage.services.use permission, then some gcloud CLI commands and client libraries might not work. Ask an administrator to grant you the Service Usage Consumer IAM role (roles/serviceusage.serviceUsageConsumer), then run the following command:
```
gcloud auth application-default set-quota-project PROJECT_ID
```

詳細については Set up authentication for a local development environment をご覧ください。

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

エラーレポートの表示

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

Error Reporting に移動

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

詳細については、エラーの表示をご覧ください。

フレームワークの統合

一部のウェブフレームワークは例外ハンドラをオーバーライドします。Laravel と Symfony で Error Reporting を有効にする例を以下に示します。他のフレームワークでは、Google\Cloud\ErrorReporting\Bootstrap::exceptionHandler を例外ハンドラとして使用できます。

Laravel

次のように、ファイル app/Exceptions/Handler.php 内の report 関数を編集します。

public function report(Exception $exception)
{
    if (isset($_SERVER['GAE_SERVICE'])) {
        // Ensure Stackdriver is initialized and handle the exception
        Bootstrap::init();
        Bootstrap::exceptionHandler($exception);
    } else {
        parent::report($exception);
    }
}

また、ファイルの先頭に 1 行の use ステートメントを追加する必要もあります。

use Google\Cloud\ErrorReporting\Bootstrap;

Symfony

次の内容の新しいファイル src/AppBundle/EventSubscriber/ExceptionSubscriber.php を作成します。

// src/AppBundle/EventSubscriber/ExceptionSubscriber.php
namespace AppBundle\EventSubscriber;

use Google\Cloud\ErrorReporting\Bootstrap;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;
use Symfony\Component\HttpKernel\KernelEvents;

class ExceptionSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents()
    {
        // return the subscribed events, their methods and priorities
        return [KernelEvents::EXCEPTION => [
            ['logException', 0]
        ]];
    }

    public function logException(ExceptionEvent $event)
    {
        $exception = $event->getThrowable();
        Bootstrap::exceptionHandler($exception);
    }
}

Enabling the library

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

始める前に

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

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

Google Cloud でアプリを実行する

App Engine フレキシブル環境

Google Kubernetes Engine

Compute Engine

Cloud Functions

例

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

エラーレポートの表示

フレームワークの統合

Laravel

Symfony

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

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