Kāpēc žurnālu darbvietā trūkst Azure funkciju informācijas žurnālu?

Trūkstošo Azure funkciju žurnālu problēmu novēršana programmā Application Insights

Darbs ar Azure Functions bieži vien šķiet kā labi ieeļļota automatizācijas dzinēja izveide. Bet kas notiek, ja daži būtiski žurnāli pazūd no jūsu Application Insights darbvietas? 🤔 Tas ir izaicinājums, ar kuru es nesen saskāros, izstrādājot Taimer Trigger Azure funkciju. Mani informācijas līmeņa žurnāli, kas nevainojami darbojās Azure Portal žurnālu konsolē, mistiskā veidā nebija pieejami darbvietā Žurnāli.

Sākumā es pieņēmu, ka viss ir pareizi konfigurēts. Galu galā es biju iestatījis Application Insights savas funkcijas lietotnes izveides laikā, un šķita, ka telemetrijas iestatīšana darbojās uzreiz. Kā izstrādātājam nav nekā mulsinošāka par to, ka Brīdinājums un Kļūdu žurnāli tiek parādīti pareizi, kamēr informācijas žurnāli nekur nav atrodami. Kur viņi slēpās?

Šī problēma man atgādināja līdzīgu brīdi tīmekļa lietojumprogrammas atkļūdošanas laikā. Kļūdu žurnāli kliedza “Labo mani!” kamēr smalkie Informācijas līmeņa žurnāli paslīdēja zem radara. Tas ir mazliet kā meklēt pazudušo puzles gabalu — zināt, ka tas pastāv, bet neredzēt to kaudzē. 🧩 Šeit bieži vien ir nozīme Azure host.json un telemetrijas iestatījumiem.

Šajā rakstā es aprakstīšu šīs problēmas galveno cēloni un to, kā soli pa solim to atrisināt. No host.json konfigurācijām līdz žurnāla līmeņa sliekšņu pārbaudei, es sniegšu jums norādījumus par risinājumu. Pārliecināsimies, ka trūkstošie Informācijas žurnāli atrod ceļu atpakaļ jūsu Žurnālu darbvietā.

Izpratne par trūkstošajiem Azure funkciju žurnāliem un to risināšana

Iepriekš sniegto skriptu mērķis ir atrisināt bieži sastopamu problēmu Informācijas līmeņa žurnāli ko ģenerējusi Azure funkcija, neparādās žurnālu darbvietā, lai gan tie tiek rādīti Azure portāla žurnālu konsolē. Šī neatbilstība bieži rodas nepareizas konfigurācijas dēļ failā host.json, nepietiekamiem telemetrijas iestatījumiem vai Application Insights integrācijas problēmām. Izmantojot tādas komandas kā ConfigureFunctionsWorkerDefaults() un AddApplicationInsightsTelemetryWorkerService(), mēs nodrošinām, ka Application Insights tver žurnālus, kā paredzēts. Šie skripti veido spēcīgu pamatu telemetrijas datu vākšanai un pārvaldībai.

Pirmkārt, `HostBuilder` Program.cs iestata Azure Function darbinieka vidi. Metode ConfigureFunctionsWorkerDefaults() nodrošina, ka tiek inicializēta visa vajadzīgā starpprogrammatūra Azure Functions. Tas arī ļauj pielāgot reģistrēšanu un atkarības injekcijas konfigurāciju. Pēc tam mēs īpaši reģistrējam Application Insights, izmantojot AddApplicationInsightsTelemetryWorkerService(). Šī darbība nodrošina, ka telemetrijas datu apkopošana ir pareizi konfigurēta Azure funkcijām, kuras nav aktivizētas ar HTTP. Piemēram, iedomājieties Taimera aktivizētāja funkcijas atkļūdošanu: bez lietojumprogrammas ieskatiem veiktspējas izsekošana un problēmu identificēšana kļūst par manuālu un laikietilpīgu procesu. 🔧

Failam host.json ir galvenā loma, kontrolējot, kādi žurnāla līmeņi tiek tverti. Iestatot `LogLevel` uz Information gan noklusējuma, gan Application Insights sadaļā, mēs skaidri definējam, ka ir jāapstrādā informācijas līmeņa žurnāli. Tomēr rekvizīts samplingSettings dažkārt var filtrēt žurnālus, kā rezultātā žurnāli darbvietā trūkst ierakstu. Atspējojot iztveršanu (“isEnabled”: false), mēs nodrošinām, ka tiek tverti visi telemetrijas dati, tostarp informācijas žurnāli. Tas ir īpaši svarīgi, novēršot ražošanas problēmas, kurās pat nelielas detaļas var atklāt galveno cēloni. Reiz es saskāros ar situāciju, kad neliels LogInformation ziņojums palīdzēja atklāt nepareizi konfigurētu plānotāju. 🎯

Visbeidzot, vienības pārbaudes skripts pārbauda, ​​vai žurnāli dažādos līmeņos — informācija, brīdinājums un kļūda — tiek pareizi izsūtīti un tverti. Izmantojot SetMinimumLevel(), mēs nodrošinām, ka reģistrētājs apstrādā visus žurnālus, kas atbilst vai pārsniedz vēlamo slieksni. Mūsu piemērā mēs apstiprinājām, ka informācijas žurnāli tiek parādīti, kad tie ir skaidri konfigurēti. Šādu vienību testu rakstīšana nodrošina konsekventu reģistrēšanas darbību dažādās vidēs, novēršot pārsteigumus izvietošanas laikā. Šie skripti kopā nodrošina visaptverošu risinājumu, lai novērstu trūkstošos Azure Function žurnālus un optimizētu telemetrijas datu apkopošanu jūsu mākoņa lietojumprogrammās.

// 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ūkstošo Azure funkciju žurnālu atrisināšana, izpētot telemetrijas datus

Vēl viens svarīgs Azure Function žurnālu aspekts, kas netiek rādīts darbvietā Žurnāli, ir telemetrijas kanāla konfigurācija, ko izmanto Application Insights. Pēc noklusējuma Azure Functions izmanto Application Insights SDK, kas buferē žurnālus pirms to nosūtīšanas uz telemetrijas galapunktu. Tomēr šī buferizācija var aizkavēt vai izlaist noteiktus žurnāla ierakstus, piemēram, Informācijas līmeņa žurnālus paraugu ņemšanas vai nepareizas telemetrijas datu skalošanas dēļ. Pareizas telemetrijas kanāla darbības nodrošināšana ir ļoti svarīga konsekventu žurnālu uzturēšanai.

Viens bieži aizmirsts faktors ir paraugu ņemšanas iestatījumi konfigurācija host.json. Ja paraugu ņemšana ir iespējota, tikai daļa žurnālu tiek nosūtīta uz Application Insights, lai samazinātu datu apjomu un izmaksas. Tomēr, ja informācijas žurnāli ir ļoti svarīgi atkļūdošanai, jums ir pilnībā jāatspējo iztveršana ("isEnabled": false) vai jāpielāgo izlases loģika, lai nodrošinātu visu nepieciešamo žurnālu tveršanu. Piemēram, es saskāros ar problēmu, ka iztveršanas iespējošana izraisīja nejaušu nekritisku informācijas žurnālu kritumu, izraisot neapmierinātību ražošanas atkļūdošanas laikā. 💻

Turklāt, izmantojot Flush komandas nodrošina, ka visa buferizētā telemetrija tiek nosūtīta nekavējoties, izvairoties no datu zuduma. Gadījumos, kad Azure Functions darbojas ar lielas slodzes aktivizētājiem, piemēram, HTTP pieprasījumiem vai taimera aktivizētājiem, telemetrijas buferis var ātri uzkrāties, radot aizkavi. Tieši izsaucot TelemetryClient.Flush() vai pārbaudot telemetrijas galapunkta savienojamību, izstrādātāji var samazināt žurnālu nekonsekvenci un uzturēt precīzu uzraudzības vidi. Galu galā paraugu ņemšanas, buferizācijas un skalošanas līdzsvarošana nodrošina optimālu žurnāla redzamību, vienlaikus samazinot izmaksas.

Žurnāla redzamības nodrošināšana Azure funkciju žurnālos