Cloud Logging für PHP einrichten

Sie können Logs aus PHP-Anwendungen in Cloud Logging schreiben, wenn Sie die Cloud Logging-Bibliothek für PHP direkt verwenden.

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Konto haben Google Cloud, erstellen Sie ein Konto, um die Leistung 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.

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 Cloud Logging API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Cloud Logging API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Cloud Logging-Bibliothek für PHP installieren

Mit der Cloud Logging-Bibliothek für PHP lässt sich der PSR-3 Logger für PHP-Web-Frameworks einfach implementieren.

Sie können Logs aus Ihrer Anwendung heraus verfassen, wenn Sie die Cloud Logging-Bibliothek für PHP zu Ihrer composer.json hinzufügen:

composer require google/cloud-logging

PSR-3-Logger erstellen

Mit diesem Code können Sie einen PSR-3-Logger erstellen:

use Google\Cloud\Logging\LoggingClient;

$logging = new LoggingClient([
    'projectId' => $projectId
]);
$logger = $logging->psrLogger('app');

Stapelverarbeitungsoption aktivieren

Hinweis: Dieser Schritt ist optional.

Der PSR-3 Logger sendet die Logs synchron. Das bedeutet, dass jedes Mal, wenn Sie ein Log ausgeben, die RPC-Latenz der Nutzeranfrage erhöht wird. Besonders wenn Sie mehrere Logs in einer einzelnen Anfrage ausgeben, erhöht sich die Latenz erheblich. Das wollen Sie wahrscheinlich vermeiden.

Mit diesem Code erstellen Sie einen PSR-3-Logger, der mehrere Logs zu einem einzigen RPC-Aufruf zusammenfasst:

$logger = LoggingClient::psrBatchLogger('app');

Standardmäßig fasst dieser Logger die Logs in einem einzigen Vorgang zusammen. In der flexiblen App Engine-Umgebung können Sie die Cloud Logging-Bibliothek für PHP so konfigurieren, dass der Durchsatz weiter erhöht und die Latenz minimiert wird. Weitere Informationen finden Sie unter Log-Daemon konfigurieren.

Cloud Logging-Bibliothek für PHP konfigurieren

Sie können das Verhalten der Cloud Logging-Bibliothek für PHP anpassen. Eine Liste der möglichen Konfigurationsoptionen finden Sie im Konfigurationsdokument.

PSR-3-Logger verwenden

Sobald der Logger erstellt wurde, können Sie ihn in Ihrer Anwendung verwenden:

$logger->info('Hello World');
$logger->error('Oh no');

Weitere Informationen zur Installation finden Sie in der Dokumentation zur Cloud Logging-Bibliothek für PHP. Probleme können Sie über die Problemverfolgung melden.

Logs mit der Cloud Logging-Clientbibliothek schreiben

Informationen zur direkten Verwendung der Cloud Logging-Clientbibliothek für PHP finden Sie unter Cloud Logging-Clientbibliotheken.

Ausführen auf Google Cloud

Damit eine Anwendung Logs mit der Cloud Logging-Bibliothek für PHP schreiben kann, muss das Dienstkonto für die zugrunde liegende Ressource die IAM-Rolle „Logautor“ (roles/logging.logWriter) haben. In den meisten Google Cloud Umgebungen wird das Standard dienstkonto automatisch so konfiguriert, dass es diese Rolle hat.

App Engine

Cloud Logging ist für App Engine automatisch aktiviert und das Standarddienstkonto Ihrer Anwendung hat standardmäßig die IAM-Berechtigungen zum Schreiben von Logeinträgen.

Weitere Informationen finden Sie unter Logs schreiben und ansehen.

Es empfiehlt sich jedoch, den PSR-3-Logger zu verwenden. Dieser ergänzt Ihre Logs automatisch um Metadaten, sodass Ihre Anwendungslogs den Anfragelogs zugeordnet werden können.

Daemon für die flexible App Engine-Umgebung konfigurieren

In der flexiblen App Engine-Umgebung können Sie die Cloud Logging-Bibliothek für PHP zur Verwendung eines externen Daemon-Programms konfigurieren, um den Logdurchsatz zu maximieren und die Latenz der Anwendung zu minimieren. Fügen Sie die folgende Zeile in den Abschnitt runtime_config in app.yaml ein, um diese Funktion zu aktivieren:

enable_stackdriver_integration: true

Google Kubernetes Engine (GKE)

GKE gewährt dem Standarddienstkonto automatisch die IAM-Rolle „Logautor (roles/logging.logWriter)“. Wenn Sie die Workload Identity Federation für GKE mit diesem Standarddienstkonto verwenden, damit Arbeitslasten auf bestimmte Google Cloud APIs zugreifen können, ist keine zusätzliche Konfiguration erforderlich. Wenn Sie die Workload Identity Federation für GKE jedoch mit einem benutzerdefinierten IAM-Dienstkonto verwenden, muss das benutzerdefinierte Dienstkonto die Rolle „Logautor“ (roles/logging.logWriter) haben.

Bei Bedarf können Sie auch den folgenden Befehl verwenden, um beim Erstellen des Clusters den Zugriffsbereich logging.write hinzuzufügen:

gcloud container clusters create example-cluster-name \
    --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

Hinweis: Zur Verwendung der Cloud Logging-Bibliothek für PHP auf einer Compute Engine-VM-Instanz muss der Cloud Logging-Agent nicht installiert werden.

Wenn Sie Compute Engine-VM-Instanzen verwenden, fügen Sie der jeweiligen Instanz den cloud-platform Zugriffsbereich hinzu. In der Google Cloud Console können Sie das beim Erstellen einer neuen Instanz im Bereich Instanz erstellen im Abschnitt Identität und API-Zugriff erledigen. Verwenden Sie das Compute Engine-Standarddienstkonto oder ein anderes Dienstkonto und wählen Sie im Abschnitt Identität und API-Zugriff die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus. Achten Sie darauf, dass jedem ausgewählten Dienst konto im Abschnitt IAM & Verwaltung der Google Cloud Console die Rolle Logautor zugewiesen ist.

Lokal und extern ausführen

Wenn Sie die Cloud Logging-Bibliothek für PHP außerhalb von Google Cloudverwenden möchten, einschließlich der Ausführung der Bibliothek auf Ihrer eigenen Workstation, auf den Computern Ihrer Rechenzentren oder auf den VM-Instanzen eines anderen Cloudanbieters, müssen Sie in Ihrer lokalen Umgebung Standardanmeldedaten für Anwendungen (ADC) einrichten, um sich bei der Cloud Logging-Bibliothek für PHP zu authentifizieren.

Weitere Informationen finden Sie unter ADC für lokale Umgebungen oder andere Cloud-Anbieter einrichten.

Logs ansehen

Rufen Sie in der Google Cloud Console das Segment und die Seite Segment Log-Explorer auf:

Zum Log-Explorer

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

Im Log-Explorer müssen Sie eine oder mehrere Ressourcen angeben. Die Auswahl der Ressourcen ist jedoch möglicherweise nicht offensichtlich. Hier sind ein paar Tipps für den Einstieg.

• Wenn Sie Ihre Anwendung für App Engine bereitstellen oder die App Engine-spezifischen Bibliotheken verwenden, setzen Sie die Ressource auf GAE-Anwendung.

• Wenn Sie Ihre Anwendung auf der Compute Engine bereitstellen, setzen Sie die Ressource auf GCE-VM-Instanz.

• Wenn Sie Ihre Anwendung in Google Kubernetes Engine bereitstellen, wird der Ressourcentyp der Logeinträge von der Loggingkonfiguration des Clusters bestimmt. Weitere Informationen zur Legacy-Operations-Suite von Google Cloud und zu den Operations-Suite von Google Cloud Kubernetes Monitoring-Lösungen sowie zu deren Auswirkungen auf den Ressourcentyp finden Sie unter Zu Kubernetes Engine Monitoring migrieren.

• Wenn Ihre Anwendung die Cloud Logging API direkt nutzt, ist die Ressource von der API und Ihrer Konfiguration abhängig. Sie können in Ihrer Anwendung zum Beispiel eine Ressource angeben oder eine Standardressource verwenden.

• Wenn im Log-Explorer keine Logs zu sehen sind, wechseln Sie zum erweiterten Abfragemodus und verwenden Sie eine leere Abfrage, um alle Logeinträge zu sehen.

  1. Klicken Sie oben im Log-Explorer auf das Dreipunkt-Menü (▾) und wählen Sie In erweiterten Filter umwandeln aus, um zum erweiterten Abfragemodus zu wechseln.
  2. Löschen Sie den Inhalt, der im Filterfeld angezeigt wird.
  3. Klicken Sie auf Filter senden.

  Sie können die einzelnen Einträge prüfen, um Ihre Ressourcen zu identifizieren.

Weitere Informationen finden Sie unter Log-Explorer verwenden.