Stackdriver Error Reporting für Python einrichten

Mit der Stackdriver Error Reporting-Bibliothek für Python können Sie Fehlerberichte von Python-Anwendungen an Stackdriver Error Reporting senden.

Stackdriver Error Reporting ist in verschiedene Produkte wie etwa die App Engine integriert. In Stackdriver Error Reporting sehen Sie die in Stackdriver Logging protokollierten Fehler der auf diesen Produkten ausgeführten Anwendungen. Weitere Informationen erhalten Sie im Abschnitt In Google Cloud Platform ausführen.

Vorbereitung

  1. Melden Sie sich in Ihrem Google-Konto an.

    Wenn Sie noch kein Konto haben, registrieren Sie sich hier für ein neues Konto.

  2. Wählen Sie ein GCP-Projekt aus oder erstellen Sie eines.

    Zur Seite "Ressourcen verwalten"

  3. Die Abrechnung für Ihr Projekt muss aktiviert sein.

    Informationen zum Aktivieren von Abrechnungen

  4. Aktivieren Sie die Stackdriver Error Reporting API.

    Aktivieren Sie die API

  5. Bereiten Sie Ihre Umgebung für die Python-Entwicklung vor.

    Weiter zum Einrichtungsleitfaden für Python

Clientbibliothek installieren

Mit der Stackdriver Error Reporting-Bibliothek für Python haben Sie die Möglichkeit, die von Python-Anwendungen gemeldeten Fehler zu überwachen und aufzurufen. Dabei ist es in den meisten Fällen unerheblich, wo die Anwendungen ausgeführt werden.

  1. Instanziieren Sie eine virtuelle Umgebung und installieren Sie das Paket mit pip:

    pip install google-cloud-error-reporting --upgrade
    
  2. Importieren Sie die Bibliothek und instanziieren Sie einen Client, um mit der Meldung von Fehlern zu starten:

    Python

    def simulate_error():
        from google.cloud import error_reporting
    
        client = error_reporting.Client()
        try:
            # simulate calling a method that's not defined
            raise NameError
        except Exception:
            client.report_exception()

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

Clientbibliothek konfigurieren

Sie können das Verhalten der Stackdriver Error Reporting-Bibliothek für Python anpassen. Konfigurationsbeispiele finden Sie in der Dokumentation zur Clientbibliothek.

Fehler melden

Sie können einen Fehler manuell durch Aufruf der Methode report melden, wie im folgenden Beispiel gezeigt:

Python

def report_manual_error():
    from google.cloud import error_reporting

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

if __name__ == '__main__':
    simulate_error()
    report_manual_error()

In der Google Cloud Platform ausführen

Zur Verwendung der Stackdriver Error Reporting-Bibliothek für Python ist die Cloud IAM-Rolle Error Reporting-Autor erforderlich. Die meisten Compute-Plattformen von Google Cloud Platform stellen diese Rolle standardmäßig zur Verfügung

Flexible App Engine-Umgebung

In Google App Engine wird die Rolle "Error Reporting-Autor" standardmäßig zugewiesen.

Die Stackdriver Error Reporting-Bibliothek für Python kann verwendet werden, ohne dass Anmeldeinformationen explizit angegeben werden müssen.

Für Anwendungen in der App Engine-Umgebung wird Stackdriver Error Reporting automatisch aktiviert. Es ist keine zusätzliche Einrichtung erforderlich.

Kubernetes Engine

In Google Kubernetes Engine müssen Sie beim Erstellen des Clusters den Zugriffsbereich cloud-platform wie im folgenden Beispielbefehl einrichten:

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform

Compute Engine

Fügen Sie bei der Verwendung von VM-Instanzen der Google Compute Engine jeder Instanz den Zugriffsbereich cloud-platform hinzu. Neue Instanzen können Sie über die Google Cloud Platform Console im Feld Instanz erstellen unter Identität und API-Zugriff erstellen. 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 bei jedem ausgewählten Dienstkonto darauf, dass diesem im Abschnitt IAM & Verwaltung der GCP Console die Rolle "Error Reporting-Autor" zugewiesen ist.

Lokal und extern ausführen

Wenn Sie die Stackdriver Error Reporting-Bibliothek für Python außerhalb der Google Cloud Platform ausführen möchten, übergeben Sie Ihre GCP-Projekt-ID und die entsprechenden Dienstkonto-Anmeldedaten direkt an die Stackdriver Error Reporting-Bibliothek für Python. Dies gilt für die Ausführung der Bibliothek auf Ihrer eigenen Workstation, auf den Computern Ihres Rechenzentrums oder auf den VM-Instanzen eines anderen Cloudanbieters. Weitere Informationen finden Sie unter Dienstkonto-Anmeldedaten manuell abrufen und bereitstellen.

Fehlerberichte ansehen

Nach der Bereitstellung können Sie Fehlerberichte im Error Reporting-Dashboard der Cloud Platform Console ansehen.

Error Reporting-Dashboard aufrufen

Weitere Informationen finden Sie unter Fehler anzeigen.

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Stackdriver Error Reporting