Utiliser des frameworks de journalisation .NET ou appeler l'API

Il existe plusieurs façons d'utiliser Cloud Logging à partir de votre application .NET :

Utiliser un fournisseur de journalisation Google pour le framework de journalisation standard .NET

Vous pouvez activer Cloud Logging pour les applications .NET en utilisant les bibliothèques Google.Cloud.Diagnostics pour .NET.

  • Pour les applications qui ciblent ASP.NET Core 3 ou une version ultérieure, utilisez la bibliothèque Google.Cloud.Diagnostics.AspNetCore3. Consultez le Google.Cloud.Diagnostics.AspNetCore3 documentation pour obtenir plus d'informations et d'exemples.
  • Pour les applications qui ciblent des versions antérieures d'ASP.NET Core, utilisez la bibliothèque Google.Cloud.Diagnostics.AspNetCore. Consultez le Google.Cloud.Diagnostics.AspNetCore documentation pour obtenir plus d'informations et d'exemples.
  • Pour les applications qui ciblent des frameworks autres que ASP.NET Core, utilisez la bibliothèque Google.Cloud.Diagnostics.Common. Consultez le Google.Cloud.Diagnostics.Common documentation pour obtenir plus d'informations et d'exemples.

Utiliser un fournisseur Google Log4Net

La Google.Cloud.Logging.Log4Net implémente un fournisseur Log4Net pour Cloud Logging. Pour obtenir des exemples montrant comment configurer et utiliser cette bibliothèque, consultez la documentation de Google.Cloud.Logging.Log4Net.

Utilisez Google.Cloud.Logging.V2 pour appeler directement l'API Logging

Vous pouvez également écrire des journaux en appelant l'API Cloud Logging via la Google.Cloud.Logging.V2 bibliothèque cliente. Vous pouvez installer cette bibliothèque à partir de NuGet.

Après le Google.Cloud.Logging.V2 bibliothèque cliente est installée, vous pouvez commencez à envoyer les journaux de votre application à Cloud Logging. Par exemple : peut personnaliser la méthode suivante et l'ajouter au code de votre application. Pour afficher l'exemple complet, cliquez sur  Plus, puis sélectionnez Afficher sur GitHub.

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}.");
}

Écrivez un code de journalisation qui appelle WriteLogEntry(). L'entrée de journal résultante se trouve dans l'explorateur de journaux, sous la ressource Global.

Dans la console Google Cloud, accédez à la page Explorateur de journaux.

Accéder à l'explorateur de journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

Ressources