Mithilfe der Error Reporting-Bibliothek für PHP können Sie Fehlerberichte von PHP-Anwendungen an Error Reporting senden. Verwenden Sie die Error Reporting-Bibliothek für PHP zum Erstellen von Fehlergruppen für die folgenden Fälle:
- Ein Log-Bucket, der Ihre Logeinträge enthält, hat eine vom Kunden verwaltete Verschlüsselung Schlüssel (CMEK).
- Der Log-Bucket erfüllt eine der folgenden Anforderungen:
<ph type="x-smartling-placeholder">
- </ph>
- Der Log-Bucket wird in dem Projekt gespeichert, in dem sich auch die Logeinträge befinden entstand.
- Die Logeinträge wurden an ein Projekt weitergeleitet, das dann in diesem Projekt gespeichert wurde in einem Log-Bucket, der ihm gehört.
- Sie möchten benutzerdefinierte Fehlerereignisse melden.
Error Reporting ist in einige Google Cloud-Dienste wie Cloud Functions, App Engine, Compute Engine und Google Kubernetes Engine eingebunden. In Error Reporting sehen Sie die in Cloud Logging protokollierten Fehler der auf diesen Diensten ausgeführten Anwendungen. Weitere Informationen finden Sie unter In Google Cloud ausführen Seite.
Sie können Fehlerdaten auch mithilfe von Logging an Error Reporting senden. Informationen zu den Datenformatierungsanforderungen finden Sie unter Fehlermeldungen in Logging formatieren.
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
Clientbibliothek installieren
Mit der Error Reporting-Bibliothek für PHP können Sie die von PHP-Anwendungen, die nahezu überall ausgeführt werden können
Weitere Informationen zur Installation finden Sie in der Dokumentation der Error Reporting-Bibliothek für PHP. Probleme können Sie über die Problemverfolgung melden.
Clientbibliothek konfigurieren
Das Verhalten der Error Reporting-Bibliothek für PHP kann angepasst werden. Die Konfiguration der Bibliothek enthält eine Liste der Konfigurationsoptionen.
Anwendungen in Google Cloud ausführen
Um Fehlergruppen mithilfe von
projects.events.report
, Ihr Dienstkonto benötigt die
Rolle „Error Reporting-Autor“ (roles/errorreporting.writer
):
Einige Google Cloud-Dienste gewähren automatisch
Rolle „Error Reporting-Autor“ (roles/errorreporting.writer
) der entsprechenden
Dienstkonto. Sie müssen diese Rolle jedoch dem entsprechenden Dienst
für einige Dienste.
Flexible App Engine-Umgebung
App Engine gewährt den
Rolle „Error Reporting-Autor“ (roles/errorreporting.writer
)
automatisch mit Ihrem Standarddienstkonto verknüpft.
Die Error Reporting-Bibliothek für PHP kann verwendet werden, ohne dass Anmeldedaten explizit angegeben werden müssen.
Gehen Sie zum Aktivieren von Error Reporting in der flexiblen App Engine-Umgebung so vor:
Installieren Sie die erforderlichen Bibliotheken mit dem folgenden Befehl:
$ composer require google/cloud-error-reporting
Fügen Sie die folgende Zeile in den Abschnitt
runtime_config
inapp.yaml
ein:
Danach erfasst die Bibliothek automatisch alle Fehler und nicht abgefangenen Ausnahmen und sendet sie an Error Reporting. Wenn Sie ein Web-Framework verwenden, das seine eigenen Ausnahme-Handler installiert, finden Sie unter Framework-Integrationen weitere Informationen.
Google Kubernetes Engine
Um Error Reporting mit Google Kubernetes Engine zu verwenden, Gehen Sie so vor:
Prüfen Sie, ob das von Ihrem Container zu verwendende Dienstkonto gewährte Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
):Sie können dazu entweder das Compute Engine-Standarddienstkonto verwenden. oder ein benutzerdefiniertes Dienstkonto.
Informationen zum Gewähren von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten
Cluster erstellen und dem Cluster die
cloud-platform
Zugriffsbereich.Der folgende Befehl zum Erstellen gibt beispielsweise die
cloud-platform
an. Zugriffsbereich und ein Dienstkonto:gcloud container clusters create CLUSTER_NAME --service-account SERVICE_ACCT_NAME --scopes=cloud-platform
Compute Engine
Um Error Reporting mit Compute Engine-VM-Instanzen zu verwenden, Gehen Sie so vor:
Prüfen Sie, ob das von Ihrer VM-Instanz zu verwendende Dienstkonto gewährte Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
):Sie können dazu entweder das Compute Engine-Standarddienstkonto verwenden. oder ein benutzerdefiniertes Dienstkonto.
Informationen zum Gewähren von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten
-
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:
Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.
Wählen Sie die VM-Instanz aus, die Sie erhalten möchten.
cloud-platform
Zugriffsbereich.Klicken Sie auf Beenden und dann auf Bearbeiten.
Wählen Sie im Abschnitt Identität und API-Zugriff ein Dienstkonto aus, das hat die Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
).Gehen Sie im Abschnitt Zugriffsbereiche so vor: Wählen Sie Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus und speichern Sie Ihre Änderungen.
Klicken Sie auf Starten/Fortsetzen.
Cloud Functions
Cloud Run-Funktionen gewähren die
Rolle „Error Reporting-Autor“ (roles/errorreporting.writer
)
automatisch mit Ihrem Standarddienstkonto verknüpft.
Die Error Reporting-Bibliothek für PHP kann verwendet werden, ohne dass Anmeldedaten explizit angegeben werden müssen.
Cloud Run-Funktionen sind für die Verwendung von Error Reporting konfiguriert automatisch. Unverarbeitet JavaScript-Ausnahmen werden in Logging angezeigt und von Error Reporting erstellen können, ohne den Error Reporting-Bibliothek für PHP
Beispiel
1. Installieren Sie die Cloudbibliotheken mit dem folgenden Befehl:
$ composer require google/cloud-error-reporting
php.ini
die folgende Zeile hinzu, wobei WORKSPACE
ist der absolute Pfad zum Stammverzeichnis Ihres Arbeitsbereichs:
auto_prepend_file='/WORKSPACE/vendor/google/cloud-error-reporting/src/prepend.php'
Diese vorangestellte Datei installiert einen Ausnahme-Handler und einen Fehler-Handler, die automatisch Fehler an Error Reporting senden.
Wenn Sie die flexible App Engine-Umgebung verwenden, lesen Sie den Abschnitt Flexible App Engine-Umgebung auf dieser Seite.
Anwendungen in einer lokalen Entwicklungsumgebung ausführen
So verwenden Sie die Error Reporting-Bibliothek für PHP in einer lokalen Entwicklungsumgebung: wie das Ausführen der Bibliothek auf Ihrer eigenen Workstation, müssen Sie Error Reporting-Bibliothek für PHP mit den Standardanmeldedaten für lokale Anwendungen. Weitere Informationen finden Sie unter Bei Error Reporting authentifizieren.
Wenn Sie die PHP Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
Weitere Informationen unter Set up authentication for a local development environment.
Die projects.events.report
-Methode unterstützt auch API-Schlüssel.
Wenn Sie API-Schlüssel für die Authentifizierung verwenden möchten, müssen Sie keine lokale Datei mit den Standardanmeldedaten für Anwendungen einrichten.
Weitere Informationen unter
Erstellen eines API-Schlüssels in der Dokumentation zur Google Cloud-Authentifizierung.
Fehlerberichte ansehen
Rufen Sie in der Google Cloud Console die Seite Error Reporting auf:
Sie können diese Seite auch über die Suchleiste finden.
Weitere Informationen finden Sie unter Fehler anzeigen.
Framework-Integrationen
Einige Web-Frameworks überschreiben den Ausnahme-Handler. Im Folgenden finden Sie Beispiele zur Verwendung von Error Reporting mit Laravel und Symfony. Für andere Frameworks können Sie Google\Cloud\ErrorReporting\Bootstrap::exceptionHandler
als Ausnahme-Handler verwenden.
Laravel
Bearbeiten Sie die Funktion report
in der Datei app/Exceptions/Handler.php
so:
Außerdem müssen Sie am Anfang der Datei eine einzeilige use
-Anweisung einfügen:
use Google\Cloud\ErrorReporting\Bootstrap;
Symfony
Erstellen Sie eine neue Datei vom Typ src/AppBundle/EventSubscriber/ExceptionSubscriber.php
mit folgendem Inhalt: