Zakaj v delovnem prostoru dnevnikov manjkajo dnevniki informacij o funkcijah Azure?

Odpravljanje težav z manjkajočimi dnevniki funkcij Azure v Application Insights

Delo s funkcijami Azure se pogosto zdi kot izgradnja dobro naoljenega mehanizma za avtomatizacijo. Toda kaj se zgodi, ko nekateri ključni dnevniki izginejo iz vašega delovnega prostora Application Insights? 🤔 To je izziv, s katerim sem se nedavno soočil, ko sem razvijal Timer Trigger Azure Function. Moji dnevniki na ravni informacij, ki so odlično delovali v konzoli dnevnika portala Azure, so bili skrivnostno odsotni v delovnem prostoru dnevnikov.

Sprva sem domneval, da je vse pravilno konfigurirano. Konec koncev sem med ustvarjanjem svoje funkcije Function App nastavil Application Insights in zdelo se je, da nastavitev telemetrije deluje takoj. Kot razvijalec ni nič bolj begajočega kot videti, da sta dnevnika Opozorilo in Napaka prikazana pravilno, medtem ko dnevnikov informacij ni nikjer. Kje so se skrivali?

Ta težava me je spomnila na podoben trenutek pri odpravljanju napak v spletni aplikaciji. Dnevniki napak so kričali "Popravi me!" medtem ko so subtilni dnevniki na ravni informacij zdrsnili izpod radarja. To je podobno iskanju manjkajočega koščka sestavljanke – veste, da obstaja, vendar ga ne vidite na kupu. 🧩 host.json in nastavitve telemetrije Azure pogosto igrajo pomembno vlogo.

V tem članku bom razčlenil glavni vzrok te težave in korak za korakom, kako jo odpraviti. Vodil vas bom skozi rešitev, od konfiguracije host.json do preverjanja pragov na ravni dnevnika. Poskrbimo, da bodo manjkajoči dnevniki informacij našli pot nazaj v vaš delovni prostor dnevnikov.

Razumevanje manjkajočih dnevnikov funkcij Azure in kako to rešiti

Prej navedeni skripti so namenjeni reševanju pogoste težave, kjer Dnevniki na ravni informacij ki jih ustvari funkcija Azure, se ne prikažejo v delovnem prostoru Dnevniki, čeprav se prikažejo v konzoli dnevnika portala Azure. Do tega neskladja pogosto pride zaradi nepravilne konfiguracije v datoteki host.json, nezadostnih nastavitev telemetrije ali težav z integracijo Application Insights. Z uporabo ukazov, kot je ConfigureFunctionsWorkerDefaults() in AddApplicationInsightsTelemetryWorkerService(), zagotovimo, da Application Insights zajame dnevnike po pričakovanjih. Ti skripti vzpostavljajo trdne temelje za zbiranje in upravljanje telemetričnih podatkov.

Najprej `HostBuilder` v Program.cs nastavi delovno okolje Azure Function. Metoda ConfigureFunctionsWorkerDefaults() zagotavlja, da je vsa potrebna vmesna programska oprema za funkcije Azure inicializirana. Omogoča tudi beleženje po meri in konfiguracijo vbrizgavanja odvisnosti. Nato izrecno registriramo Application Insights z uporabo AddApplicationInsightsTelemetryWorkerService(). Ta korak zagotavlja, da je zbiranje telemetrije pravilno konfigurirano za funkcije Azure, ki jih ne sproži HTTP. Predstavljajte si na primer razhroščevanje funkcije sprožilca časovnika: brez Application Insights sledenje učinkovitosti in prepoznavanje težav postane ročni in dolgotrajen postopek. 🔧

Datoteka host.json ima ključno vlogo pri nadzoru, katere ravni dnevnika so zajete. Z nastavitvijo `LogLevel` na Information tako v privzetem razdelku kot v razdelku Application Insights izrecno definiramo, da je treba obdelati dnevnike na ravni informacij. Vendar pa lahko lastnost samplingSettings včasih filtrira dnevnike, kar povzroči manjkajoče vnose v delovnem prostoru Dnevniki. Z onemogočanjem vzorčenja ("isEnabled": false`) zagotovimo, da so zajeti vsi telemetrični podatki, vključno z dnevniki informacij. To je še posebej pomembno pri odpravljanju težav s proizvodnjo, pri katerih lahko že manjše podrobnosti razkrijejo glavni vzrok. Nekoč sem se soočil s situacijo, ko je majhno sporočilo LogInformation pomagalo odkriti napačno konfiguriran razporejevalnik. 🎯

Nazadnje skript za testiranje enote preveri, ali so dnevniki na različnih ravneh – informacija, opozorilo in napaka – pravilno oddani in zajeti. Uporaba SetMinimumLevel(), zagotovimo, da zapisovalnik obdela vse dnevnike na ali nad želenim pragom. V našem primeru smo potrdili, da se dnevniki informacij prikažejo, ko so izrecno konfigurirani. Pisanje testov enote, kot je ta, zagotavlja, da je vedenje beleženja skladno v vseh okoljih, kar preprečuje presenečenja med uvajanjem. Ti skripti skupaj zagotavljajo celovito rešitev za odpravljanje težav z manjkajočimi dnevniki funkcij Azure in optimiziranje zbiranja telemetrije v vaših aplikacijah v oblaku.

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

Razreševanje manjkajočih dnevnikov funkcij Azure z raziskovanjem telemetričnih podatkov

Drugi kritični vidik dnevnikov funkcij Azure, ki se ne prikažejo v delovnem prostoru dnevnikov, vključuje konfiguracijo telemetričnega kanala, ki jo uporablja Application Insights. Funkcije Azure privzeto uporabljajo SDK Application Insights, ki shrani dnevnike v medpomnilnik, preden jih pošlje končni točki telemetrije. To medpomnjenje pa lahko zakasni ali izpusti določene vnose v dnevnik, kot so dnevniki na ravni informacij zaradi vzorčenja ali nepravilnega izpiranja telemetričnih podatkov. Zagotavljanje pravilnega vedenja telemetričnega kanala je ključnega pomena za vzdrževanje doslednih dnevnikov.

Eden pogosto spregledanih dejavnikov je samplingSettings konfiguracijo v host.json. Ko je vzorčenje omogočeno, se v Application Insights pošlje le del dnevnikov, da se zmanjša količina podatkov in stroški. Če pa so dnevniki informacij kritični za odpravljanje napak, morate popolnoma onemogočiti vzorčenje ("isEnabled": false`) ali prilagoditi logiko vzorčenja, da zagotovite zajem vseh potrebnih dnevnikov. Na primer, soočil sem se s težavo, pri kateri je omogočanje vzorčenja povzročilo naključne padce v dnevnikih nekritičnih informacij, kar je povzročilo frustracije med odpravljanjem napak v proizvodnji. 💻

Poleg tega z uporabo Izperite zagotavlja, da se vsa medpomnilniška telemetrija pošlje takoj, s čimer se prepreči izguba podatkov. V scenarijih, kjer se funkcije Azure izvajajo pod visoko obremenjenimi sprožilci, kot so zahteve HTTP ali sprožilci časovnika, se lahko medpomnjenje telemetrije hitro kopiči, kar povzroči zamude. Z izrecnim klicem TelemetryClient.Flush() ali preverjanjem povezljivosti končne točke telemetrije lahko razvijalci zmanjšajo nedoslednosti dnevnikov in vzdržujejo natančno okolje za spremljanje. Navsezadnje uravnoteženje vzorčenja, medpomnjenja in splakovanja omogoča optimalno vidljivost dnevnika ob zmanjšanju stroškov.

Zagotavljanje vidnosti dnevnika v dnevnikih funkcij Azure