Cloud Logging für Ruby einrichten

Sie können Logs von Ruby-Anwendungen mithilfe der Cloud Logging-Bibliothek für Ruby nach Cloud Logging schreiben. Dies ist auch direkt über die Cloud Logging-Cloud-Clientbibliothek für Ruby möglich.

Der Cloud Logging-Agent muss nicht installiert sein, um die Cloud Logging-Bibliothek für Ruby auf einer Compute Engine-VM-Instanz auszuführen.

Hinweise

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

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

  2. Wählen Sie in der Cloud Console auf der Seite für die Projektauswahl ein Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Cloud Logging API.

    Aktivieren Sie die API

  5. Installieren Sie Ruby 2.2 oder höher.

Bibliothek installieren

Wir stellen eine Cloud Logging-Bibliothek für Ruby zur Verfügung, die eine benutzerfreundliche Logger-Implementierung für rackbasierte Ruby-Web-Frameworks bietet:

  1. Fügen Sie das Operations Suite-Gem von Google Cloud in Ihr Gemfile ein:

    gem "stackdriver"
  2. Installieren Sie das Gem mit Bundler:

    bundle install
    

Bibliothek aktivieren

Wenn Sie Ruby on Rails verwenden, lädt Bundler die Bibliothek beim Anwendungsstart automatisch in Ihre Anwendung, wodurch der Standard-Rails.logger auf eine Instanz des Cloud Logging-Loggers festgelegt wird.

Andere rackbasierte Anwendungen können den Rack-Logger mithilfe der bereitgestellten Rack-Middleware durch den Cloud Logging-Logger ersetzen, wenn Ihr Web-Framework den Rack-Logger unterstützt:

require "google/cloud/logging"

use Google::Cloud::Logging::Middleware

Bibliothek konfigurieren

Sie können das Verhalten der Cloud Logging-Bibliothek für Ruby anpassen. Eine Liste der möglichen Konfigurationsoptionen finden Sie in der Konfiguration der Bibliothek.

Cloud Logging-Logger verwenden

Wenn die Cloud Logging-Bibliothek für Ruby aktiviert ist, können Sie den Logger 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 Ruby. Probleme können Sie über die Problemverfolgung melden.

Cloud-Clientbibliothek direkt verwenden

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

In Google Cloud ausführen

Zur Verwendung der Cloud Logging-Bibliothek für Ruby ist auf Google Cloud die IAM-Rolle Logautor erforderlich. In den meisten Google Cloud-Umgebungen ist diese Rolle standardmäßig vorhanden.

App Engine

In App Engine wird die Rolle "Logautor" standardmäßig zugewiesen.

Die Cloud Logging-Bibliothek für Ruby kann verwendet werden, ohne dass Anmeldedaten explizit angegeben werden müssen.

Cloud Logging ist für App Engine-Anwendungen automatisch aktiviert. Es ist keine zusätzliche Einrichtung erforderlich.

Google Kubernetes Engine

In Google Kubernetes Engine müssen Sie beim Erstellen des Clusters den Zugriffsbereich logging.write festlegen:

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

Compute Engine

Wenn Sie Compute Engine-VM-Instanzen verwenden, fügen Sie der jeweiligen Instanz den Zugriffsbereich für cloud-platform 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 Dienstkonto im Abschnitt IAM & Verwaltung der Cloud Console die Rolle "Logautor" zugewiesen ist.

Lokal und extern ausführen

Wenn Sie die Cloud Logging-Bibliothek für Ruby außerhalb von Google Cloud verwenden möchten, beispielsweise auf Ihrer eigenen Workstation, auf den Computern Ihres Rechenzentrums oder auf den VM-Instanzen eines anderen Cloud-Anbieters, müssen Sie Ihre Google Cloud-Projekt-ID und die entsprechenden Dienstkonto-Anmeldedaten direkt in der Cloud Logging-Bibliothek für Ruby angeben.

Sie können Anmeldeinformationen für Dienstkonten manuell erstellen und abrufen. Verwenden Sie beim Angeben des Felds Rolle die Rolle "Logautor". Weitere Informationen zu den IAM-Rollen finden Sie in der Anleitung zur Zugriffssteuerung.

Konfigurationsoberfläche von Ruby on Rails verwenden:

Geben Sie die Parameter in der Konfigurationsoberfläche von Ruby on Rails an, wenn Sie das Framework von Ruby on Rails verwenden:

# Add this to config/environments/*.rb
Rails.application.configure do |config|
  # Stackdriver Logging specific parameters
  config.google_cloud.logging.project_id = "YOUR-PROJECT-ID"
  config.google_cloud.logging.keyfile    = "/path/to/service-account.json"
end

Sie können eine gemeinsame Konfiguration für alle Operations Suite-Gems von Google Cloud festlegen, wenn Sie Folgendes eingeben:

# Add this to config/environments/*.rb
Rails.application.configure do |config|
  # Stackdriver Shared parameters
  config.google_cloud.project_id = "YOUR-PROJECT-ID"
  config.google_cloud.keyfile    = "/path/to/service-account.json"
end

Logging ist standardmäßig aktiviert, wenn Rails im Produktionsmodus ausgeführt wird. Zur Aktivierung von Logging im Entwicklungsmodus fügen Sie Folgendes hinzu:

# Add this to config/environments/development.rb
Rails.application.configure do |config|
  config.google_cloud.use_logging = true
end

Konfigurationsoberfläche für Instrumentierung verwenden

Geben Sie die Parameter über die Konfigurationsoberfläche an, wenn sie in anderen rackbasierten Anwendungen verwendet werden:

require "google/cloud/logging"

Google::Cloud.configure do |config|
  # Stackdriver Logging specific parameters
  config.logging.project_id = "YOUR-PROJECT-ID"
  config.logging.keyfile    = "/path/to/service-account.json"
end

Sie können eine gemeinsame Konfiguration für alle Operations Suite-Gems von Google Cloud festlegen, wenn Sie Folgendes eingeben:

require "stackdriver"

Google::Cloud.configure do |config|
  # Stackdriver Shared parameters
  config.project_id = "YOUR-PROJECT-ID"
  config.keyfile    = "/path/to/service-account.json"
end

Logs ansehen

Nach der Bereitstellung können Sie die Logs in der Loganzeige der Cloud Console ansehen.

Zur Loganzeige

In der Loganzeige 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 Logging-Konfiguration Ihres Clusters bestimmt. Weitere Informationen zur Legacy-Operations-Suite von Google Cloud und zu den Kubernetes Monitoring-Lösungen der Operations-Suite von Google Cloud 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 individuell festlegen oder eine Standardressource verwenden.

  • Wenn in der Loganzeige 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 in der Loganzeige auf 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 Logs ansehen und Erweiterte Logabfragen.