Pourquoi les journaux d’informations sur les fonctions Azure sont-ils manquants dans l’espace de travail des journaux ?

Dépannage des journaux de fonctions Azure manquants dans Application Insights

Travailler avec Azure Functions revient souvent à créer un moteur d’automatisation bien huilé. Mais que se passe-t-il lorsque certains journaux cruciaux disparaissent de votre espace de travail Application Insights ? 🤔 C'est un défi auquel j'ai récemment été confronté en développant une fonction Azure Trigger Timer. Mes journaux au niveau des informations, qui fonctionnaient parfaitement dans la console de journaux du portail Azure, étaient mystérieusement absents de l'espace de travail Journaux.

Au début, je pensais que tout était configuré correctement. Après tout, j'avais configuré Application Insights lors de la création de mon application de fonction, et la configuration de la télémétrie semblait fonctionner immédiatement. En tant que développeur, il n'y a rien de plus déroutant que de voir les journaux Avertissement et Erreur apparaître correctement alors que les journaux d'informations sont introuvables. Où se cachaient-ils ?

Ce problème m'a rappelé un moment similaire lors du débogage d'une application Web. Les journaux d'erreurs criaient « Réparez-moi ! » tandis que les subtils journaux de niveau d’information ont glissé sous le radar. C’est un peu comme chercher une pièce manquante dans un puzzle : savoir qu’elle existe mais ne pas la voir dans la pile. 🧩 Les paramètres host.json et de télémétrie d'Azure jouent souvent un rôle ici.

Dans cet article, je vais détailler la cause première de ce problème et comment le résoudre étape par étape. Des configurations host.json à la vérification des seuils de niveau de journalisation, je vous guiderai à travers la solution. Assurons-nous que les journaux d'informations manquants retrouvent leur chemin dans votre espace de travail Journaux.

Comprendre les journaux de fonctions Azure manquants et comment les résoudre

Les scripts fournis précédemment visent à résoudre un problème courant où Journaux au niveau des informations générés par une fonction Azure n'apparaissent pas dans l'espace de travail Journaux, même s'ils apparaissent dans la console de journal du portail Azure. Cet écart se produit souvent en raison d'une configuration incorrecte dans le fichier host.json, de paramètres de télémétrie insuffisants ou de problèmes d'intégration d'Application Insights. En utilisant des commandes comme ConfigureFunctionsWorkerDefaults() et AddApplicationInsightsTelemetryWorkerService(), nous nous assurons qu'Application Insights capture les journaux comme prévu. Ces scripts établissent une base solide pour la collecte et la gestion des données de télémétrie.

Tout d'abord, le « HostBuilder » dans Program.cs configure l'environnement de travail Azure Function. La méthode ConfigureFunctionsWorkerDefaults() garantit que tous les middlewares requis pour Azure Functions sont initialisés. Il permet également une configuration personnalisée de la journalisation et de l’injection de dépendances. Ensuite, nous enregistrons explicitement Application Insights à l’aide de AddApplicationInsightsTelemetryWorkerService(). Cette étape garantit que la collecte de télémétrie est correctement configurée pour Azure Functions non déclenchées par HTTP. Par exemple, imaginez déboguer une fonction de déclenchement de minuterie : sans Application Insights, le suivi des performances et l'identification des problèmes deviennent un processus manuel et chronophage. 🔧

Le fichier host.json joue un rôle clé dans le contrôle des niveaux de journaux capturés. En définissant « LogLevel » sur Information dans les sections par défaut et Application Insights, nous définissons explicitement que les journaux au niveau des informations doivent être traités. Cependant, la propriété samplingSettings peut parfois filtrer les journaux, entraînant des entrées manquantes dans l'espace de travail Journaux. En désactivant l'échantillonnage (""isEnabled": false`), nous garantissons que toutes les données de télémétrie, y compris les journaux d'informations, sont capturées. Ceci est particulièrement important lors du dépannage de problèmes de production où même des détails mineurs peuvent révéler la cause première. Une fois, j'ai été confronté à une situation dans laquelle un petit message LogInformation a permis de découvrir un planificateur mal configuré. 🎯

Enfin, le script de test unitaire vérifie que les journaux à différents niveaux (Informations, Avertissement et Erreur) sont correctement émis et capturés. En utilisant DéfinirMinimumLevel(), nous nous assurons que l'enregistreur traite tous les journaux au niveau ou au-dessus du seuil souhaité. Dans notre exemple, nous avons validé que les journaux d'informations apparaissent lorsqu'ils sont explicitement configurés. L'écriture de tests unitaires comme celui-ci garantit que le comportement de journalisation est cohérent dans tous les environnements, évitant ainsi les surprises lors du déploiement. Ensemble, ces scripts fournissent une solution complète pour dépanner les journaux Azure Function manquants et optimiser la collecte de télémétrie dans vos applications cloud.

// Solution 1: Proper Host Configuration and Log Filtering
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
public class Program
{
    public static void Main(string[] args)
    {
        var host = new HostBuilder()
            .ConfigureFunctionsWorkerDefaults()
            .ConfigureServices(services =>
            {
                services.AddApplicationInsightsTelemetryWorkerService();
                services.Configure<LoggerFilterOptions>(options =>
                {
                    options.MinLevel = LogLevel.Information;
                });
            })
            .Build();
        host.Run();
    }
}

// host.json Configuration
{
  "version": "2.0",
  "logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Function": "Information"
    },
    "applicationInsights": {
      "LogLevel": {
        "Default": "Information"
      },
      "samplingSettings": {
        "isEnabled": false
      }
    }
  }
}

using Microsoft.Extensions.Logging;
public class MyFunction
{
    private readonly ILogger _logger;
    public MyFunction(ILoggerFactory loggerFactory)
    {
        _logger = loggerFactory.CreateLogger<MyFunction>();
    }
    public void Run()
    {
        _logger.LogInformation("Executing Information level log.");
        _logger.LogWarning("This is a Warning level log.");
        _logger.LogError("This is an Error level log.");
    }
}

using Xunit;
using Microsoft.Extensions.Logging;
public class LogTests
{
    [Fact]
    public void VerifyInformationLogsAreCaptured()
    {
        var loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddConsole();
            builder.SetMinimumLevel(LogLevel.Information);
        });
        var logger = loggerFactory.CreateLogger("TestLogger");
        logger.LogInformation("This is a test Information log.");
        Assert.True(true, "Information log captured successfully.");
    }
}

Résoudre les journaux de fonctions Azure manquants en explorant les données de télémétrie

Un autre aspect critique des journaux Azure Function qui n'apparaissent pas dans l'espace de travail Journaux concerne la configuration du canal de télémétrie utilisée par Application Insights. Par défaut, Azure Functions utilise le SDK Application Insights, qui met les journaux en mémoire tampon avant de les envoyer au point de terminaison de télémétrie. Toutefois, cette mise en mémoire tampon peut retarder ou omettre certaines entrées de journal, telles que les journaux au niveau des informations, en raison d'un échantillonnage ou d'un vidage inapproprié des données de télémétrie. Garantir le bon comportement des canaux de télémétrie est crucial pour maintenir des journaux cohérents.

Un facteur souvent négligé est le Paramètres d'échantillonnage configuration dans host.json. Lorsque l'échantillonnage est activé, seule une fraction des journaux est envoyée à Application Insights pour réduire le volume de données et les coûts. Cependant, si les journaux d'informations sont critiques pour le débogage, vous devez soit désactiver complètement l'échantillonnage (""isEnabled": false`), soit ajuster la logique d'échantillonnage pour garantir que tous les journaux nécessaires sont capturés. Par exemple, j'ai été confronté à un problème où l'activation de l'échantillonnage provoquait des pertes aléatoires dans les journaux d'informations non critiques, entraînant une frustration lors du débogage de production. 💻

De plus, en utilisant Flush Les commandes garantissent que toutes les télémétries mises en mémoire tampon sont envoyées immédiatement, évitant ainsi la perte de données. Dans les scénarios où Azure Functions s’exécute sous des déclencheurs à charge élevée tels que des requêtes HTTP ou des déclencheurs Timer, la mise en mémoire tampon de télémétrie peut s’accumuler rapidement, entraînant des retards. En appelant explicitement TelemetryClient.Flush() ou en vérifiant la connectivité des points de terminaison de télémétrie, les développeurs peuvent réduire les incohérences des journaux et maintenir un environnement de surveillance précis. En fin de compte, l'équilibrage de l'échantillonnage, de la mise en mémoire tampon et du vidage permet une visibilité optimale des journaux tout en minimisant les coûts.

Assurer la visibilité des journaux dans les journaux de fonctions Azure