Cloud Trace für C# ASP.NET Core einrichten

Sie können Trace für ASP.NET Core-Anwendungen mithilfe der Google.Cloud.Diagnostics-Bibliotheken für .NET aktivieren.

  • Verwenden Sie für Anwendungen, die auf ASP.NET Core 3 oder höher ausgerichtet sind, die Bibliothek Google.Cloud.Diagnostics.AspNetCore3. Beispiele zum Konfigurieren und Verwenden dieser Bibliothek finden Sie in der Dokumentation zu Google.Cloud.Diagnostics.AspNetCore3.
  • Verwenden Sie für Anwendungen, die auf ältere Versionen von ASP.NET Core abzielen, die Google.Cloud.Diagnostics.AspNetCore-Bibliothek. Beispiele zum Konfigurieren und Verwenden dieser Bibliothek finden Sie in der Dokumentation zu Google.Cloud.Diagnostics.AspNetCore.

Plattform konfigurieren

Sie können Cloud Trace in Google Cloud und auf anderen Plattformen verwenden.

In Google Cloud ausführen

Wenn Ihre Anwendung in Google Cloud ausgeführt wird, müssen Sie für die Clientbibliothek keine Anmeldedaten zur Authentifizierung in der Clientbibliothek angeben. Sie müssen jedoch sicherstellen, dass Ihre Google Cloud Platform Zugriffsbereich der Cloud Trace API aktiviert.

Eine Liste der unterstützten Google Cloud-Umgebungen finden Sie unter Umgebungsunterstützung.

Für die folgenden Konfigurationen wird die Cloud Trace API über die Standardeinstellungen für den Zugriffsbereich aktiviert:

Wenn Sie benutzerdefinierte Zugriffsbereiche verwenden, Zugriffsbereich der Cloud Trace API aktiviert ist:

  • Informationen zur Konfiguration des Zugriffsbereiche für Ihre Umgebung mithilfe der Google Cloud Console erstellen, finden Sie unter Google Cloud-Projekt konfigurieren

  • Geben Sie für gcloud-Nutzer mithilfe des Flags --scopes Zugriffsbereiche an und beziehen Sie den Zugriffsbereich der Cloud Trace API trace.append ein. So erstellen Sie beispielsweise einen GKE-Cluster, für den nur die Cloud Trace API aktiviert ist:

    gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append

Lokal und extern ausführen

Wenn Ihre Anwendung außerhalb von Google Cloud ausgeführt wird, müssen Sie Anmeldedaten zur Authentifizierung in Form eines Dienstkontos für die Clientbibliothek angeben. Das Dienstkonto muss die Rolle "Cloud Trace-Agent" enthalten. Informationen dazu finden Sie unter Dienstkonto erstellen.

Google Cloud-Clientbibliotheken verwenden Standardanmeldedaten für Anwendungen für die Suche nach den Anmeldedaten Ihrer Anwendung.

Sie haben drei Möglichkeiten, diese Anmeldedaten anzugeben:

  • Führen Sie gcloud auth application-default login aus

  • Platzieren Sie das Dienstkonto in einem Standardpfad für Ihr Betriebssystem. Im Folgenden sind die Standardpfade für Windows und Linux aufgeführt:

    • Windows: %APPDATA%/gcloud/application_default_credentials.json

    • Linux: $HOME/.config/gcloud/application_default_credentials.json

  • Legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf den Pfad zu Ihrem Dienstkonto fest:

Linux/macOS

    export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key

Windows

    set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key

PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"

Traces ansehen

Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:

Zum Trace Explorer

Sie können diese Seite auch über die Suchleiste finden.

Fehlerbehebung

Informationen zur Fehlerbehebung bei Cloud Trace finden Sie auf der Seite Fehlerbehebung.

Ressourcen