Mithilfe der Error Reporting-Bibliothek für Ruby können Sie Fehlerberichte von Ruby-Anwendungen an Error Reporting senden. Verwenden Sie die Error Reporting-Bibliothek für Ruby zum Erstellen von Fehlergruppen in den folgenden Fällen:
- Ihr Log-Bucket hat vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK).
- Ihre Log-Buckets befinden sich nicht in der Region
global
. - Sie möchten benutzerdefinierte Fehlerereignisse melden.
Error Reporting ist in einige Google Cloud-Dienste wie 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 auf dieser Seite unter In Google Cloud ausführen.
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.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
- Installieren Sie Ruby 2.2+ oder höher.
Clientbibliothek installieren
Mit der Error Reporting-Bibliothek für Ruby können Sie die von Ruby-Anwendungen gemeldeten Fehler im Blick behalten und ansehen. Dabei ist es in den meisten Fällen unerheblich, wo die Anwendungen ausgeführt werden.
-
Fügen Sie Ihrem Gemfile das Gem
google-cloud-error_reporting
hinzu:gem "google-cloud-error_reporting"
-
Installieren Sie das Gem mit Bundler:
bundle install
Bibliothek aktivieren
Wenn Sie Ruby on Rails verwenden, wird die Bibliothek beim Start Ihrer Anwendung automatisch von Bundler geladen.
Andere rackbasierte Anwendungen können die Rack-Middleware aus der Bibliothek verwenden:
Weitere Informationen zur Installation finden Sie in der Dokumentation der Error Reporting-Bibliothek für Ruby. Probleme können Sie über die Problemverfolgung melden.
Clientbibliothek konfigurieren
Das Verhalten der Error Reporting-Bibliothek für Ruby kann angepasst werden. Die Konfiguration der Bibliothek enthält eine Liste der Konfigurationsoptionen.
Anwendungen in Google Cloud ausführen
Wenn Sie Fehlergruppen mit projects.events.report
erstellen möchten, benötigt Ihr Dienstkonto die Rolle Error Reporting-Autor (roles/errorreporting.writer
).
Einige Google Cloud-Dienste gewähren dem entsprechenden Dienstkonto automatisch die Rolle „Error Reporting-Autor“ (roles/errorreporting.writer
). Bei einigen Diensten müssen Sie diese Rolle jedoch dem entsprechenden Dienstkonto zuweisen.
Flexible App Engine-Umgebung
App Engine weist Ihrem Standarddienstkonto automatisch die Rolle Error Reporting-Autor (roles/errorreporting.writer
) zu.
Die Error Reporting-Bibliothek für Ruby kann verwendet werden, ohne dass Anmeldedaten explizit angegeben werden müssen.
Error Reporting wird für Anwendungen in flexiblen App Engine-Umgebungen automatisch aktiviert. Es ist keine zusätzliche Einrichtung erforderlich.Google Kubernetes Engine
So verwenden Sie Error Reporting mit Google Kubernetes Engine:
Achten Sie darauf, dass dem Dienstkonto, das von Ihrem Container verwendet werden soll, die Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
) gewährt wurde.Sie können entweder das Compute Engine-Standarddienstkonto oder ein benutzerdefiniertes Dienstkonto verwenden.
Informationen zum Gewähren von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Erstellen Sie den Cluster und gewähren Sie ihm den Zugriffsbereich
cloud-platform
.Mit dem folgenden Befehl zum Erstellen werden beispielsweise der Zugriffsbereich
cloud-platform
und ein Dienstkonto angegeben:gcloud container clusters create CLUSTER_NAME --service-account SERVICE_ACCT_NAME --scopes=cloud-platform
Compute Engine
So verwenden Sie Error Reporting mit Compute Engine-VM-Instanzen:
Achten Sie darauf, dass dem Dienstkonto, das von Ihrer VM-Instanz verwendet werden soll, die Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
) zugewiesen wurde.Sie können entweder das Compute Engine-Standarddienstkonto oder ein benutzerdefiniertes Dienstkonto verwenden.
Informationen zum Gewähren von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
-
Wählen Sie in der Google Cloud Console Compute Engine und dann VM-Instanzen aus oder klicken Sie auf die folgende Schaltfläche:
Wählen Sie die VM-Instanz aus, die den Zugriffsbereich
cloud-platform
erhalten soll.Klicken Sie auf Beenden und dann auf Bearbeiten.
Wählen Sie im Abschnitt Identität und API-Zugriff ein Dienstkonto mit der Rolle „Error Reporting-Autor“ (
roles/errorreporting.writer
) aus.Wählen Sie im Abschnitt Zugriffsbereiche die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus und speichern Sie die Änderungen.
Klicken Sie auf Starten/Fortsetzen.
Konfigurationsoberfläche von Ruby on Rails verwenden
Wenn Sie die Error Reporting-Bibliothek für Ruby mit dem Ruby on Rails-Framework verwenden möchten, geben Sie die Parameter über die Konfigurationsoberfläche von Ruby on Rails an:
Wenn Sie Folgendes eingeben, können Sie eine gemeinsame Konfiguration für alle Stackdriver-Gems festlegen:
Error Reporting ist standardmäßig aktiviert, wenn Rails im Produktionsmodus ausgeführt wird. Fügen Sie Folgendes hinzu, um Error Reporting im Entwicklungsmodus zu aktivieren:
Konfigurationsschnittstelle für Instrumentierung verwenden
Wenn Sie die Error Reporting-Bibliothek für Ruby in anderen rackbasierten Anwendungen verwenden möchten, geben Sie die Parameter über die Konfigurationsoberfläche an:
Sie können eine gemeinsame Konfiguration für alle Operations Suite-Gems von Google Cloud festlegen, wenn Sie Folgendes eingeben:
Beispiel
Fehler in rackbasierten Frameworks melden
Mit der Error Reporting-Bibliothek für Ruby lässt sich Error Reporting problemlos in gängige rackbasierte Ruby-Web-Frameworks wie Ruby on Rails und Sinatra einbinden: Wenn die Bibliothek aktiviert ist, werden die im Rackstack der Anwendung erfassten Ausnahmen automatisch gemeldet.
Fehler manuell melden
Sie können einen Fehler auch manuell melden. Dazu rufen Sie die Methodereport
wie im folgenden Beispiel gezeigt auf:
Anwendungen in einer lokalen Entwicklungsumgebung ausführen
Wenn Sie die Error Reporting-Bibliothek für Ruby in einer lokalen Entwicklungsumgebung verwenden möchten, z. B. zum Ausführen der Bibliothek auf Ihrer eigenen Workstation, müssen Sie für die Error Reporting-Bibliothek für Ruby die Standardanmeldedaten der lokalen Anwendung angeben. Weitere Informationen finden Sie unter Bei Error Reporting authentifizieren.
Wenn Sie die Ruby-Beispiele auf dieser Seite aus einer lokalen Entwicklungsumgebung heraus verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
Erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Google-Konto:
gcloud auth application-default login
Weitere Informationen: Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
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:
Erstellen eines API-Schlüssels in der Dokumentation zur Google Cloud-Authentifizierung.
Konfigurationsoberfläche von Ruby on Rails verwenden
Wenn Sie die Error Reporting-Bibliothek für Ruby mit dem Ruby on Rails-Framework verwenden möchten, geben Sie die Parameter über die Konfigurationsoberfläche von Ruby on Rails an:
Wenn Sie Folgendes eingeben, können Sie eine gemeinsame Konfiguration für alle Stackdriver-Gems festlegen:
Error Reporting ist standardmäßig aktiviert, wenn Rails im Produktionsmodus ausgeführt wird. Fügen Sie Folgendes hinzu, um Error Reporting im Entwicklungsmodus zu aktivieren:
Konfigurationsschnittstelle für Instrumentierung verwenden
Wenn Sie die Error Reporting-Bibliothek für Ruby in anderen rackbasierten Anwendungen verwenden möchten, geben Sie die Parameter über die Konfigurationsoberfläche an:
Sie können eine gemeinsame Konfiguration für alle Operations Suite-Gems von Google Cloud festlegen, wenn Sie Folgendes eingeben:
Fehlerberichte ansehen
Wählen Sie in der Google Cloud Console Error Reporting aus oder klicken Sie auf die folgende Schaltfläche und wählen Sie ein Projekt aus:
Weitere Informationen finden Sie unter Fehler anzeigen.