Per què falten els registres d'informació de les funcions d'Azure a l'espai de treball de registres?

Resolució de problemes que falten registres de funcions d'Azure a Application Insights

Treballar amb Azure Functions sovint sembla construir un motor d'automatització ben oli. Però, què passa quan alguns registres crucials desapareixen del vostre espai de treball Application Insights? 🤔 És un repte que m'he enfrontat recentment mentre desenvolupava una Funció Azure Trigger Timer. Els meus registres de nivell d'informació, que funcionaven perfectament a la consola de registres de l'Azure Portal, eren misteriosament absents a l'espai de treball Registres.

Al principi, vaig suposar que tot estava configurat correctament. Després de tot, havia configurat Application Insights durant la creació de la meva aplicació Function, i la configuració de telemetria semblava que funcionava de manera immediata. Com a desenvolupador, no hi ha res més desconcertant que veure que els registres d'Advertència i Error apareixen correctament mentre que els registres d'informació no es troben enlloc. On s'amagaven?

Aquest problema em va recordar un moment similar en depurar una aplicació web. Els registres d'error cridaven "Arregla'm!" mentre que els registres subtils de nivell d'informació van passar per sota del radar. És una mica com buscar una peça del trencaclosques que falta: saber que existeix però no veure-la a la pila. 🧩 La configuració de telemetria i host.json d'Azure sovint hi juga un paper.

En aquest article, explicaré la causa principal d'aquest problema i com resoldre'l pas a pas. Des de les configuracions de host.json fins a verificar els llindars de nivell de registre, us guiaré a través de la solució. Assegurem-nos que els registres d'informació que falten tornen al vostre espai de treball Registres.

Entendre els registres de funcions d'Azure que falten i com resoldre'ls

Els scripts proporcionats anteriorment tenen com a objectiu resoldre un problema comú on Registres a nivell d'informació generats per una funció d'Azure no apareixen a l'espai de treball Registres, tot i que es mostren a la consola de registre de l'Azure Portal. Aquesta discrepància es produeix sovint a causa d'una configuració incorrecta del fitxer host.json, d'una configuració de telemetria insuficient o de problemes amb la integració d'Application Insights. Mitjançant ordres com ConfigureFunctionsWorkerDefaults() i AfegeixApplicationInsightsTelemetryWorkerService(), ens assegurem que Application Insights captura els registres com s'esperava. Aquests scripts estableixen una base sòlida per recopilar i gestionar dades de telemetria.

Primer, el "HostBuilder" a Program.cs configura l'entorn de treball de la funció Azure. El mètode ConfigureFunctionsWorkerDefaults() assegura que tot el programari intermedi necessari per a Azure Functions estigui inicialitzat. També permet el registre personalitzat i la configuració d'injecció de dependències. A continuació, registrem explícitament Application Insights mitjançant AddApplicationInsightsTelemetryWorkerService(). Aquest pas garanteix que la col·lecció de telemetria estigui configurada correctament per a les funcions d'Azure no activades per HTTP. Per exemple, imagineu-vos depurar una Funció d'activació del temporitzador: sense les estadístiques de l'aplicació, el seguiment del rendiment i la identificació de problemes esdevenen un procés manual i que requereix molt de temps. 🔧

El fitxer host.json té un paper clau a l'hora de controlar quins nivells de registre es capturen. En establir `LogLevel` a Informació tant a la secció predeterminada com a Application Insights, definim explícitament que els registres de nivell d'informació s'han de processar. Tanmateix, la propietat samplingSettings de vegades pot filtrar els registres, provocant que faltin entrades a l'espai de treball Registres. En desactivar el mostreig ("isEnabled": false), ens assegurem que es capturen totes les dades de telemetria, inclosos els registres d'informació. Això és especialment important quan es resolen problemes de producció on fins i tot detalls menors poden revelar la causa principal. Una vegada em vaig enfrontar a una situació en què un petit missatge LogInformation va ajudar a descobrir un programador mal configurat. 🎯

Finalment, l'script de prova d'unitat verifica que els registres a diferents nivells (informació, advertència i error) s'emeten i es capturen correctament. Utilitzant SetMinimumLevel(), ens assegurem que el registrador processi tots els registres al llindar desitjat o per sobre. Al nostre exemple, vam validar que els registres d'informació apareixen quan es configuren explícitament. L'escriptura de proves unitàries com aquesta garanteix que el comportament de registre sigui coherent en tots els entorns, evitant sorpreses durant el desplegament. En conjunt, aquests scripts proporcionen una solució completa per solucionar els problemes dels registres d'Azure Function que falten i optimitzar la recollida de telemetria a les vostres aplicacions al núvol.

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

Resolució dels registres de funcions d'Azure que falten explorant dades de telemetria

Un altre aspecte crític dels registres d'Azure Function que no apareixen a l'espai de treball Registres inclou la configuració del canal de telemetria que utilitza Application Insights. De manera predeterminada, Azure Functions utilitza l'SDK d'Application Insights, que guarda els registres abans d'enviar-los al punt final de telemetria. Tanmateix, aquest emmagatzematge en memòria intermèdia pot retardar o ometre determinades entrades de registre, com ara Registres a nivell d'informació, a causa del mostreig o l'eliminació inadequada de les dades de telemetria. Assegurar un comportament adequat del canal de telemetria és crucial per mantenir els registres coherents.

Un factor que sovint es passa per alt és el SamplingSettings configuració a host.json. Quan el mostreig està activat, només s'envia una part dels registres a Application Insights per reduir el volum de dades i els costos. Tanmateix, si els registres d'informació són crítics per a la depuració, heu de desactivar completament el mostreig ("isEnabled": false) o ajustar la lògica de mostreig per assegurar-vos que es capturen tots els registres necessaris. Per exemple, em vaig enfrontar a un problema en què l'habilitació del mostreig va provocar caigudes aleatòries en els registres d'informació no crítics, cosa que va provocar frustració durant la depuració de la producció. 💻

A més, utilitzant Flux ordres garanteix que tota la telemetria de memòria intermèdia s'enviï immediatament, evitant la pèrdua de dades. En els escenaris en què Azure Functions s'executen amb activadors de càrrega elevada, com ara sol·licituds HTTP o activadors del temporitzador, la memòria intermèdia de telemetria es pot acumular ràpidament, provocant retards. Mitjançant una trucada explícita a TelemetryClient.Flush() o verificant la connectivitat del punt final de telemetria, els desenvolupadors poden reduir les incoherències del registre i mantenir un entorn de supervisió precís. En última instància, equilibrar el mostreig, l'emmagatzematge en memòria intermèdia i el rentat permet una visibilitat òptima del registre alhora que minimitza els costos.

Garantir la visibilitat del registre als registres de funcions d'Azure