.NET-Logging-Frameworks verwenden oder die API aufrufen

Es gibt mehrere Möglichkeiten, Cloud Logging über Ihre .NET-Anwendung zu verwenden:

Google Logging-Anbieter für das Standard-Logging-Framework von .NET verwenden

Sie können Cloud Logging für .NET-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. Weitere Informationen und Beispiele 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. Weitere Informationen finden Sie in der Google.Cloud.Diagnostics.AspNetCore Dokumentation finden Sie weitere Informationen und Beispiele.
  • Verwenden Sie für Anwendungen, die nicht auf ASP.NET Core-Plattformen abzielen, die Google.Cloud.Diagnostics.Common-Bibliothek. Weitere Informationen finden Sie in der Google.Cloud.Diagnostics.Common Dokumentation finden Sie weitere Informationen und Beispiele.

Google Log4Net-Anbieter verwenden

Die Google.Cloud.Logging.Log4Net implementiert einen Log4Net-Anbieter für Cloud Logging: Beispiele zum Konfigurieren und Verwenden dieser Bibliothek finden Sie in der Dokumentation zu Google.Cloud.Logging.Log4Net.

Google.Cloud.Logging.V2 verwenden, um die Logging API direkt aufzurufen

Sie können Logs auch schreiben, indem Sie die Cloud Logging API mit die Google.Cloud.Logging.V2 Clientbibliothek. Sie können diese Bibliothek über NuGet installieren.

Nachdem die Google.Cloud.Logging.V2-Clientbibliothek installiert ist, können Sie die Protokolle Ihrer Anwendung an Cloud Logging senden. Zum Beispiel haben Sie die folgende Methode anpassen und zu Ihrem Anwendungscode hinzufügen. Wenn Sie sich das vollständige Beispiel ansehen möchten, klicken Sie auf  Mehr und wählen Sie dann Auf GitHub ansehen aus.

private void WriteLogEntry(string logId)
{
    var client = LoggingServiceV2Client.Create();
    LogName logName = new LogName(s_projectId, logId);
    var jsonPayload = new Struct()
    {
        Fields =
        {
            { "name", Value.ForString("King Arthur") },
            { "quest", Value.ForString("Find the Holy Grail") },
            { "favorite_color", Value.ForString("Blue") }
        }
    };
    LogEntry logEntry = new LogEntry
    {
        LogNameAsLogName = logName,
        Severity = LogSeverity.Info,
        JsonPayload = jsonPayload
    };
    MonitoredResource resource = new MonitoredResource { Type = "global" };
    IDictionary<string, string> entryLabels = new Dictionary<string, string>
    {
        { "size", "large" },
        { "color", "blue" }
    };
    client.WriteLogEntries(logName, resource, entryLabels,
        new[] { logEntry }, _retryAWhile);
    Console.WriteLine($"Created log entry in log-id: {logId}.");
}

Schreiben Sie Logging-Code, der WriteLogEntry() aufruft. Der resultierende Logeintrag ist im Log-Explorer unter der Ressource Global zu sehen.

Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

Zum Log-Explorer

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

Ressourcen