Dlaczego w obszarze roboczym dzienników brakuje dzienników informacji o funkcjach platformy Azure?

Rozwiązywanie problemów z brakującymi dziennikami funkcji platformy Azure w Application Insights

Praca z Azure Functions często przypomina budowanie dobrze naoliwionego silnika automatyzacji. Ale co się stanie, gdy z obszaru roboczego Application Insights znikną niektóre istotne dzienniki? 🤔 To wyzwanie, przed którym ostatnio stanąłem, opracowując funkcję Azure z wyzwalaczem czasowym. Moje dzienniki na poziomie informacji, które doskonale działały w konsoli dzienników Azure Portal, w tajemniczy sposób zniknęły w obszarze roboczym Dzienniki.

Na początku zakładałem, że wszystko zostało poprawnie skonfigurowane. Przecież skonfigurowałem usługę Application Insights podczas tworzenia aplikacji funkcji, a konfiguracja telemetrii wydawała się działać od razu po wyjęciu z pudełka. Dla programisty nie ma nic bardziej zagadkowego niż to, że dzienniki Ostrzeżeń i Błędów pojawiają się poprawnie, podczas gdy nigdzie nie można znaleźć dzienników informacyjnych. Gdzie się ukrywali?

Ten problem przypomniał mi podobny moment podczas debugowania aplikacji internetowej. Dzienniki błędów krzyczały: „Napraw mnie!” podczas gdy subtelne dzienniki na poziomie informacyjnym prześlizgnęły się poza radar. To trochę jak szukanie brakującego elementu układanki – wiedzieć, że istnieje, ale nie do końca widzieć go na stosie. 🧩 Ustawienia host.json i telemetrii platformy Azure często odgrywają tutaj rolę.

W tym artykule omówię pierwotną przyczynę tego problemu i krok po kroku opiszę, jak go rozwiązać. Od konfiguracji hosta.json po weryfikację progów poziomu dziennika – poprowadzę Cię przez rozwiązanie. Zadbajmy o to, aby brakujące dzienniki informacji trafiły z powrotem do Twojego obszaru roboczego dzienników.

Zrozumienie brakujących dzienników funkcji platformy Azure i sposobów ich rozwiązania

Skrypty dostarczone wcześniej mają na celu rozwiązanie typowego problemu polegającego na tym, że Dzienniki na poziomie informacyjnym wygenerowane przez funkcję platformy Azure nie pojawiają się w obszarze roboczym Dzienniki, mimo że są wyświetlane w konsoli dzienników Azure Portal. Ta rozbieżność często występuje z powodu nieprawidłowej konfiguracji w pliku host.json, niewystarczających ustawień telemetrii lub problemów z integracją Application Insights. Używając poleceń takich jak SkonfigurujFunctionsWorkerDefaults() I AddApplicationInsightsTelemetryWorkerService(), zapewniamy, że usługa Application Insights przechwytuje dzienniki zgodnie z oczekiwaniami. Skrypty te stanowią solidną podstawę do gromadzenia danych telemetrycznych i zarządzania nimi.

Najpierw element „HostBuilder” w Program.cs konfiguruje środowisko robocze funkcji platformy Azure. Metoda SkonfigurujFunctionsWorkerDefaults() gwarantuje, że całe wymagane oprogramowanie pośredniczące dla Azure Functions zostało zainicjowane. Umożliwia także niestandardowe konfigurowanie rejestrowania i wstrzykiwania zależności. Następnie jawnie rejestrujemy Application Insights przy użyciu AddApplicationInsightsTelemetryWorkerService(). Ten krok zapewnia, że ​​zbieranie danych telemetrycznych jest poprawnie skonfigurowane dla Azure Functions niewyzwalanego przez protokół HTTP. Wyobraź sobie na przykład debugowanie funkcji wyzwalania timera: bez Application Insights śledzenie wydajności i identyfikowanie problemów staje się procesem ręcznym i czasochłonnym. 🔧

Plik host.json odgrywa kluczową rolę w kontrolowaniu przechwytywanych poziomów dzienników. Ustawiając „LogLevel” na Information zarówno w sekcji domyślnej, jak i w sekcji Application Insights, jawnie definiujemy, że muszą być przetwarzane dzienniki na poziomie informacyjnym. Jednak właściwość samplingSettings może czasami odfiltrować dzienniki, co prowadzi do brakujących wpisów w obszarze roboczym Logs. Wyłączając próbkowanie („isEnabled”: false), zapewniamy przechwytywanie wszystkich danych telemetrycznych, w tym dzienników informacyjnych. Jest to szczególnie ważne podczas rozwiązywania problemów produkcyjnych, gdzie nawet drobne szczegóły mogą ujawnić pierwotną przyczynę. Kiedyś spotkałem się z sytuacją, w której mały komunikat LogInformation pomógł odkryć źle skonfigurowany harmonogram. 🎯

Na koniec skrypt testu jednostkowego sprawdza, czy dzienniki na różnych poziomach — informacja, ostrzeżenie i błąd — są poprawnie emitowane i przechwytywane. Używanie Ustaw poziom minimalny(), zapewniamy, że rejestrator przetworzy wszystkie dzienniki na poziomie lub powyżej żądanego progu. W naszym przykładzie sprawdziliśmy, czy dzienniki informacyjne pojawiają się po jawnej konfiguracji. Pisanie takich testów jednostkowych gwarantuje, że zachowanie rejestrowania jest spójne w różnych środowiskach, co zapobiega niespodziankom podczas wdrażania. Razem te skrypty zapewniają kompleksowe rozwiązanie umożliwiające rozwiązywanie problemów z brakującymi dziennikami funkcji platformy Azure i optymalizację gromadzenia danych telemetrycznych w aplikacjach w chmurze.

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

Rozwiązywanie brakujących dzienników funkcji platformy Azure poprzez eksplorowanie danych telemetrycznych

Inny krytyczny aspekt dzienników funkcji platformy Azure, które nie są wyświetlane w obszarze roboczym dzienników, dotyczy konfiguracji kanału telemetrycznego używanego przez usługę Application Insights. Domyślnie Azure Functions korzysta z zestawu SDK Application Insights, który buforuje dzienniki przed wysłaniem ich do punktu końcowego telemetrii. To buforowanie może jednak opóźnić lub pominąć niektóre wpisy dziennika, takie jak dzienniki na poziomie informacyjnym z powodu próbkowania lub nieprawidłowego opróżniania danych telemetrycznych. Zapewnienie prawidłowego zachowania kanału telemetrycznego ma kluczowe znaczenie dla utrzymania spójnych dzienników.

Często pomijanym czynnikiem jest Ustawienia pobierania próbek konfiguracja w host.json. Gdy próbkowanie jest włączone, do Application Insights jest wysyłana tylko część dzienników, aby zmniejszyć ilość danych i koszty. Jeśli jednak dzienniki informacyjne są krytyczne dla debugowania, należy albo całkowicie wyłączyć próbkowanie („isEnabled”: false`), albo dostosować logikę próbkowania, aby zapewnić przechwycenie wszystkich niezbędnych dzienników. Na przykład napotkałem problem polegający na tym, że włączenie próbkowania powodowało przypadkowe spadki w niekrytycznych dziennikach informacyjnych, co prowadziło do frustracji podczas debugowania produkcyjnego. 💻

Dodatkowo za pomocą Spłukać polecenia zapewniają natychmiastowe wysłanie całej buforowanej telemetrii, co pozwala uniknąć utraty danych. W scenariuszach, w których Azure Functions działają w ramach wyzwalaczy o dużym obciążeniu, takich jak żądania HTTP lub wyzwalacze czasomierza, buforowanie telemetrii może szybko się kumulować, powodując opóźnienia. Wywołując jawnie funkcję TelemetryClient.Flush() lub weryfikując łączność z punktem końcowym telemetrii, programiści mogą ograniczyć niespójności dzienników i zachować dokładne środowisko monitorowania. Ostatecznie zrównoważenie próbkowania, buforowania i płukania pozwala na optymalną widoczność dziennika przy jednoczesnej minimalizacji kosztów.

Zapewnienie widoczności dzienników w dziennikach funkcji platformy Azure