Prečo chýbajú denníky informácií o funkciách Azure v pracovnom priestore denníkov?

Riešenie problémov s chýbajúcimi protokolmi funkcií Azure v Application Insights

Práca s Azure Functions sa často javí ako budovanie dobre naolejovaného automatizačného motora. Čo sa však stane, keď z vášho pracovného priestoru Application Insights zmiznú niektoré dôležité protokoly? 🤔 Je to výzva, ktorej som nedávno čelil pri vývoji funkcie Timer Trigger Azure Function. Moje denníky na úrovni informácií, ktoré perfektne fungovali v konzole denníkov Azure Portal, záhadne chýbali v pracovnom priestore Denníky.

Najprv som predpokladal, že je všetko správne nakonfigurované. Koniec koncov, počas vytvárania aplikácie Function App som nastavil Application Insights a zdalo sa, že nastavenie telemetrie funguje okamžite. Ako vývojár nie je nič mätúcejšie, ako vidieť, že denníky Upozornenie a Chyby sa zobrazujú správne, zatiaľ čo denníky informácií nikde nenájdete. Kde sa skrývali?

Tento problém mi pripomenul podobný moment pri ladení webovej aplikácie. Protokoly chýb kričali „Opravte ma!“ zatiaľ čo subtílne denníky na informačnej úrovni skĺzli pod radar. Je to trochu ako hľadať chýbajúci kúsok skladačky – viete, že existuje, ale nevidíte ho v kope. 🧩 host.json a nastavenia telemetrie v Azure tu často zohrávajú úlohu.

V tomto článku rozoberiem hlavnú príčinu tohto problému a ako ho krok za krokom vyriešiť. Prevediem vás riešením od konfigurácií host.json až po overenie prahových hodnôt na úrovni denníka. Zabezpečme, aby si chýbajúce Informačné denníky našli cestu späť do vášho Pracovného priestoru Denníky.

Pochopenie chýbajúcich protokolov funkcií Azure a ako to vyriešiť

Skripty poskytnuté skôr majú za cieľ vyriešiť bežný problém, kde Denníky na informačnej úrovni generované funkciou Azure sa nezobrazujú v pracovnom priestore Denníky, aj keď sa zobrazujú v konzole denníka Azure Portal. Táto nezrovnalosť sa často vyskytuje v dôsledku nesprávnej konfigurácie v súbore host.json, nedostatočných nastavení telemetrie alebo problémov s integráciou Application Insights. Pomocou príkazov ako ConfigureFunctionsWorkerDefaults() a AddApplicationInsightsTelemetryWorkerService(), zabezpečujeme, že Application Insights zachytáva protokoly podľa očakávania. Tieto skripty vytvárajú pevný základ pre zhromažďovanie a správu telemetrických údajov.

Najprv `HostBuilder` v Program.cs nastaví pracovné prostredie Azure Function. Metóda ConfigureFunctionsWorkerDefaults() zaisťuje, že sa inicializuje všetok požadovaný middleware pre funkcie Azure. Umožňuje tiež vlastné protokolovanie a konfiguráciu vstrekovania závislostí. Ďalej explicitne registrujeme Application Insights pomocou AddApplicationInsightsTelemetryWorkerService(). Tento krok zaisťuje, že zhromažďovanie telemetrie je správne nakonfigurované pre funkcie Azure nespustené protokolom HTTP. Predstavte si napríklad ladenie Funkcie spúšťania časovača: Bez prehľadov aplikácií sa sledovanie výkonu a identifikácia problémov stáva manuálnym a časovo náročným procesom. 🔧

Súbor host.json hrá kľúčovú úlohu pri riadení toho, aké úrovne protokolu sa zaznamenávajú. Nastavením `LogLevel` na Information v predvolenej sekcii aj sekcii Application Insights explicitne definujeme, že sa musia spracovávať denníky na úrovni informácií. Vlastnosť samplingSettings však môže niekedy odfiltrovať protokoly, čo vedie k chýbajúcim záznamom v pracovnom priestore Protokoly. Zakázaním vzorkovania ("isEnabled": false`) zabezpečíme, že sa zachytia všetky telemetrické údaje vrátane denníkov informácií. Toto je obzvlášť dôležité pri odstraňovaní problémov s výrobou, kde aj malé detaily môžu odhaliť hlavnú príčinu. Raz som čelil situácii, keď malá správa LogInformation pomohla odhaliť nesprávne nakonfigurovaný plánovač. 🎯

Nakoniec testovací skript jednotky overí, či sú protokoly na rôznych úrovniach – Informácie, Varovanie a Chyba – správne vydávané a zachytené. Používanie SetMinimumLevel(), zabezpečíme, aby zapisovač spracoval všetky protokoly na alebo nad požadovanou hranicou. V našom príklade sme overili, že denníky informácií sa zobrazujú, keď sú explicitne nakonfigurované. Písanie jednotkových testov, ako je tento, zaisťuje, že správanie protokolovania je konzistentné vo všetkých prostrediach a zabraňuje prekvapeniam počas nasadenia. Tieto skripty spolu poskytujú komplexné riešenie na riešenie problémov s chýbajúcimi protokolmi Azure Functions a optimalizáciu zhromažďovania telemetrie vo vašich cloudových aplikáciách.

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

Riešenie chýbajúcich protokolov funkcií Azure preskúmaním telemetrických údajov

Ďalší kritický aspekt denníkov funkcií Azure, ktoré sa nezobrazujú v pracovnom priestore denníkov, zahŕňa konfiguráciu telemetrického kanála, ktorú používa Application Insights. Funkcie Azure štandardne používajú súpravu Application Insights SDK, ktorá ukladá protokoly pred ich odoslaním do koncového bodu telemetrie. Toto ukladanie do vyrovnávacej pamäte však môže oneskoriť alebo vynechať určité položky denníka, ako sú Protokoly na úrovni informácií v dôsledku vzorkovania alebo nesprávneho vyprázdnenia telemetrických údajov. Zabezpečenie správneho správania telemetrického kanála je kľúčové pre udržiavanie konzistentných protokolov.

Jedným z často prehliadaných faktorov je Nastavenia odberu vzoriek konfigurácia v súbore host.json. Keď je povolené vzorkovanie, do Application Insights sa odošle len zlomok protokolov, aby sa znížil objem údajov a náklady. Ak sú však informačné protokoly kritické pre ladenie, musíte buď úplne zakázať vzorkovanie (`"isEnabled": false`), alebo upraviť logiku vzorkovania, aby ste zabezpečili zachytenie všetkých potrebných protokolov. Napríklad som čelil problému, keď povolenie vzorkovania spôsobilo náhodné poklesy v nekritických informačných protokoloch, čo viedlo k frustrácii počas ladenia produkcie. 💻

Okrem toho pomocou Splachovanie príkazy zaisťujú, že všetka telemetria vo vyrovnávacej pamäti sa odošle okamžite, čím sa zabráni strate údajov. V scenároch, kde sú funkcie Azure spustené pod spúšťačmi s vysokou záťažou, ako sú požiadavky HTTP alebo spúšťače časovača, sa ukladanie telemetrie môže rýchlo hromadiť, čo spôsobuje oneskorenia. Výslovným volaním TelemetryClient.Flush() alebo overením konektivity koncového bodu telemetrie môžu vývojári znížiť nekonzistentnosť protokolov a udržiavať presné monitorovacie prostredie. V konečnom dôsledku vyváženie vzorkovania, ukladania do vyrovnávacej pamäte a preplachovania umožňuje optimálnu viditeľnosť protokolu pri minimalizácii nákladov.

Zabezpečenie viditeľnosti denníkov v denníkoch funkcií Azure