Kodėl žurnalų darbo srityje trūksta „Azure“ funkcijų informacijos žurnalų?

Trūkstamų „Azure“ funkcijų žurnalų trikčių šalinimas programoje „Application Insights“.

Darbas su „Azure Functions“ dažnai atrodo lyg kurtumėte gerai suteptą automatikos variklį. Bet kas nutinka, kai kai kurie svarbūs žurnalai dingsta iš jūsų Application Insights darbo srities? 🤔 Tai iššūkis, su kuriuo neseniai susidūriau kurdamas Timer Trigger Azure Function. Mano informacijos lygio žurnalų, kurie puikiai veikė „Azure Portal“ žurnalų pulte, paslaptingai nebuvo Žurnalų darbo srityje.

Iš pradžių maniau, kad viskas sukonfigūruota teisingai. Galų gale, kurdamas savo funkcijų programą, buvau nustatęs „Application Insights“ ir atrodė, kad telemetrijos sąranka veikė iš karto. Kaip kūrėjas, nėra nieko labiau glumina, kaip matyti Įspėjimo ir Klaidų žurnalus, rodomus teisingai, o informacijos žurnalų niekur nerasta. Kur jie slėpėsi?

Ši problema man priminė panašų momentą derinant žiniatinklio programą. Klaidų žurnalai šaukė „Pataisyk mane! o subtilūs Informacijos lygio žurnalai paslydo po radaru. Tai panašu į dingusios dėlionės dalies paiešką – žinant, kad ji egzistuoja, bet ne visai jos matyti krūvoje. 🧩 Čia dažnai vaidina „Azure“ host.json ir telemetrijos nustatymai.

Šiame straipsnyje paaiškinsiu pagrindinę šios problemos priežastį ir žingsnis po žingsnio, kaip ją išspręsti. Nuo host.json konfigūracijų iki žurnalo lygio slenksčių patvirtinimo padėsiu išspręsti problemą. Pasirūpinkime, kad trūkstami Informacijos žurnalai sugrįžtų į Žurnalų darbo sritį.

Trūkstamų Azure funkcijų žurnalų supratimas ir kaip tai išspręsti

Anksčiau pateikti scenarijai skirti išspręsti dažną problemą, kur Informacijos lygio žurnalai sugeneruoti „Azure“ funkcijos, nerodomi žurnalų darbo srityje, net jei jie rodomi „Azure Portal“ žurnalo konsolėje. Šis neatitikimas dažnai atsiranda dėl netinkamos konfigūracijos host.json faile, nepakankamų telemetrijos nustatymų arba dėl Application Insights integravimo problemų. Naudodami tokias komandas kaip ConfigureFunctionsWorkerDefaults() ir AddApplicationInsightsTelemetryWorkerService(), užtikriname, kad „Application Insights“ užfiksuotų žurnalus, kaip tikėtasi. Šie scenarijai sukuria tvirtą pagrindą telemetrijos duomenims rinkti ir tvarkyti.

Pirma, „HostBuilder“ Program.cs nustato „Azure Function“ darbuotojo aplinką. Metodas ConfigureFunctionsWorkerDefaults() užtikrina, kad būtų inicijuota visa reikalinga „Azure Functions“ tarpinė programinė įranga. Tai taip pat leidžia tinkinti registravimą ir priklausomybės įpurškimo konfigūraciją. Tada mes aiškiai užregistruojame Application Insights naudodami AddApplicationInsightsTelemetryWorkerService(). Šis veiksmas užtikrina, kad telemetrijos rinkinys būtų tinkamai sukonfigūruotas ne HTTP suaktyvintoms Azure funkcijoms. Pavyzdžiui, įsivaizduokite Laikmačio paleidimo funkcijos derinimą: be Application Insights našumo stebėjimas ir problemų nustatymas tampa rankiniu ir daug laiko reikalaujančiu procesu. 🔧

Failas host.json atlieka pagrindinį vaidmenį valdant, kokie žurnalo lygiai fiksuojami. Numatytajame ir „Application Insights“ skiltyse nustatydami „LogLevel“ į Information, aiškiai apibrėžiame, kad informacijos lygio žurnalai turi būti apdorojami. Tačiau ypatybė samplingSettings kartais gali filtruoti žurnalus, todėl žurnalų darbo srityje trūksta įrašų. Išjungę atranką ("isEnabled": false'), užtikriname, kad bus užfiksuoti visi telemetrijos duomenys, įskaitant informacijos žurnalus. Tai ypač svarbu šalinant gamybos problemas, kai net nedidelė detalė gali atskleisti pagrindinę priežastį. Kartą susidūriau su situacija, kai mažas LogInformation pranešimas padėjo atskleisti netinkamai sukonfigūruotą planavimo priemonę. 🎯

Galiausiai, vieneto bandymo scenarijus patikrina, ar skirtingų lygių žurnalai – informacija, įspėjimas ir klaida – yra tinkamai išsiunčiami ir užfiksuoti. Naudojant SetMinimumLevel(), užtikriname, kad registratorius apdoros visus žurnalus, atitinkančius norimą slenkstį arba virš jo. Mūsų pavyzdyje patvirtinome, kad informacijos žurnalai rodomi, kai jie yra aiškiai sukonfigūruoti. Rašydami vienetų testus, kaip šis, užtikrinama, kad registravimo elgsena visose aplinkose būtų nuosekli ir išvengiama netikėtumų diegimo metu. Kartu šie scenarijai suteikia išsamų sprendimą, kaip pašalinti trūkstamus Azure Function žurnalus ir optimizuoti telemetrijos rinkimą debesies programose.

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

Trūkstamų Azure funkcijų žurnalų sprendimas tyrinėjant telemetrijos duomenis

Kitas svarbus „Azure Function“ žurnalų aspektas, nerodomas Žurnalų darbo srityje, yra telemetrijos kanalo konfigūracija, kurią naudoja „Application Insights“. Pagal numatytuosius nustatymus „Azure Functions“ naudoja „Application Insights“ SDK, kuris saugo žurnalus prieš siųsdamas juos į telemetrijos galutinį tašką. Tačiau šis buferis gali atidėti arba praleisti tam tikrus žurnalo įrašus, pvz., Informacijos lygio žurnalus dėl atrankos arba netinkamo telemetrijos duomenų plovimo. Tinkamo telemetrijos kanalo veikimo užtikrinimas yra labai svarbus norint išlaikyti nuoseklius žurnalus.

Vienas dažnai nepastebimas veiksnys yra atrankos nustatymai konfigūracija host.json. Kai atranka įgalinta, tik dalis žurnalų siunčiama į Application Insights, kad būtų sumažintas duomenų kiekis ir išlaidos. Tačiau jei informacijos žurnalai yra labai svarbūs derinant, turite visiškai išjungti atranką („isEnabled“: false) arba pakoreguoti atrankos logiką, kad būtų užfiksuoti visi reikalingi žurnalai. Pavyzdžiui, susidūriau su problema, kai įgalinus atranką atsitiktinai sumažėjo nekritinės informacijos žurnalai, o tai sukėlė nusivylimą derinant produkciją. 💻

Be to, naudojant Nuplaukite Komandos užtikrina, kad visa buferinė telemetrija būtų išsiųsta nedelsiant, išvengiant duomenų praradimo. Esant scenarijams, kai „Azure Functions“ veikia esant didelės apkrovos aktyvikliams, pvz., HTTP užklausoms arba laikmačio aktyvikliams, telemetrijos buferis gali greitai kauptis ir sukelti vėlavimą. Aiškiai iškvietę TelemetryClient.Flush() arba patikrinę telemetrijos galinio taško ryšį, kūrėjai gali sumažinti žurnalų neatitikimus ir palaikyti tikslią stebėjimo aplinką. Galiausiai mėginių ėmimo, buferio ir praplovimo subalansavimas užtikrina optimalų žurnalo matomumą ir sumažina išlaidas.

Žurnalo matomumo užtikrinimas „Azure“ funkcijų žurnaluose