Mengapa Log Maklumat Fungsi Azure Tiada dalam Ruang Kerja Log?

Menyelesaikan masalah Log Fungsi Azure yang Hilang dalam Cerapan Aplikasi

Bekerja dengan Azure Functions selalunya terasa seperti membina enjin automasi yang berminyak. Tetapi apakah yang berlaku apabila beberapa log penting hilang daripada ruang kerja Application Insights anda? 🤔 Ini adalah cabaran yang saya hadapi baru-baru ini semasa membangunkan Fungsi Azure Trigger Pemasa. Log peringkat Maklumat saya, yang berfungsi dengan sempurna dalam konsol log Portal Azure, secara misteri tiada dalam ruang kerja Log.

Pada mulanya, saya menganggap semuanya telah dikonfigurasikan dengan betul. Lagipun, saya telah menyediakan Cerapan Aplikasi semasa penciptaan Apl Fungsi saya, dan persediaan telemetri nampaknya berfungsi di luar kotak. Sebagai pembangun, tiada apa yang lebih membingungkan daripada melihat log Amaran dan Ralat muncul dengan betul manakala Log maklumat tiada di mana-mana. Di manakah mereka bersembunyi?

Isu ini mengingatkan saya pada detik yang sama semasa menyahpepijat aplikasi web. Log ralat menjerit "Betulkan saya!" manakala log peringkat Maklumat yang halus tergelincir di bawah radar. Ia agak seperti mencari kepingan teka-teki yang hilang—mengetahui ia wujud tetapi tidak dapat melihatnya dalam longgokan. 🧩 Tetapan host.json dan telemetri Azure sering memainkan peranan di sini.

Dalam artikel ini, saya akan memecahkan punca isu ini dan cara menyelesaikannya langkah demi langkah. Daripada host.json configurations hingga mengesahkan ambang tahap log, saya akan membimbing anda melalui penyelesaiannya. Mari pastikan mereka yang tiada Log maklumat menemui jalan kembali ke ruang kerja Log anda.

Memahami Log Fungsi Azure yang Hilang dan Cara Menyelesaikannya

Skrip yang disediakan sebelum ini bertujuan untuk menyelesaikan isu biasa di mana Log peringkat maklumat yang dijana oleh Fungsi Azure tidak muncul dalam ruang kerja Log, walaupun ia muncul dalam konsol log Portal Azure. Percanggahan ini sering berlaku disebabkan oleh konfigurasi yang tidak betul dalam fail host.json, tetapan telemetri tidak mencukupi atau isu dengan penyepaduan Application Insights. Dengan menggunakan arahan seperti ConfigureFunctionsWorkerDefaults() dan AddApplicationInsightsTelemetryWorkerService(), kami memastikan bahawa Application Insights menangkap log seperti yang diharapkan. Skrip ini mewujudkan asas yang kukuh untuk mengumpul dan mengurus data telemetri.

Mula-mula, `HostBuilder` dalam Program.cs menyediakan persekitaran pekerja Azure Function. Kaedahnya ConfigureFunctionsWorkerDefaults() memastikan bahawa semua perisian tengah yang diperlukan untuk Fungsi Azure dimulakan. Ia juga membenarkan pengelogan tersuai dan konfigurasi suntikan pergantungan. Seterusnya, kami secara eksplisit mendaftarkan Aplikasi Insights menggunakan AddApplicationInsightsTelemetryWorkerService(). Langkah ini memastikan pengumpulan telemetri dikonfigurasikan dengan betul untuk Fungsi Azure yang tidak dicetuskan HTTP. Sebagai contoh, bayangkan menyahpepijat Fungsi Pencetus Pemasa: Tanpa Cerapan Aplikasi, prestasi penjejakan dan mengenal pasti isu menjadi proses manual dan memakan masa. 🔧

Fail host.json memainkan peranan penting dalam mengawal tahap log yang ditangkap. Dengan menetapkan `LogLevel` kepada Maklumat dalam kedua-dua bahagian lalai dan Application Insights, kami mentakrifkan secara eksplisit bahawa Log peringkat Maklumat mesti diproses. Walau bagaimanapun, sifat samplingSettings kadangkala boleh menapis log, menyebabkan entri hilang dalam ruang kerja Log. Dengan melumpuhkan pensampelan (`"isEnabled": false`), kami memastikan semua data telemetri, termasuk Log Maklumat, ditangkap. Ini amat penting apabila menyelesaikan masalah pengeluaran yang walaupun butiran kecil mungkin mendedahkan punca utama. Saya pernah menghadapi situasi di mana mesej LogInformation kecil membantu mendedahkan penjadual yang salah konfigurasi. 🎯

Akhir sekali, skrip ujian unit mengesahkan bahawa log pada tahap yang berbeza—Maklumat, Amaran dan Ralat—dipancarkan dan ditangkap dengan betul. menggunakan SetMinimumLevel(), kami memastikan pembalak memproses semua log pada atau melebihi ambang yang dikehendaki. Dalam contoh kami, kami mengesahkan bahawa log Maklumat muncul apabila dikonfigurasikan secara eksplisit. Menulis ujian unit seperti ini memastikan bahawa kelakuan pengelogan adalah konsisten merentas persekitaran, menghalang kejutan semasa penggunaan. Bersama-sama, skrip ini menyediakan penyelesaian yang komprehensif untuk menyelesaikan masalah log Fungsi Azure yang hilang dan mengoptimumkan pengumpulan telemetri dalam aplikasi awan anda.

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

Menyelesaikan Log Fungsi Azure yang Hilang dengan Meneroka Data Telemetri

Satu lagi aspek kritikal log Azure Function yang tidak muncul dalam ruang kerja Log melibatkan konfigurasi saluran telemetri yang digunakan oleh Application Insights. Secara lalai, Azure Functions menggunakan Application Insights SDK, yang menampan log sebelum menghantarnya ke titik akhir telemetri. Penimbalan ini, walau bagaimanapun, boleh menangguhkan atau meninggalkan entri log tertentu seperti Log peringkat maklumat disebabkan pensampelan atau pembilasan data telemetri yang tidak betul. Memastikan tingkah laku saluran telemetri yang betul adalah penting untuk mengekalkan log yang konsisten.

Satu faktor yang sering diabaikan ialah samplingSettings konfigurasi dalam host.json. Apabila pensampelan didayakan, hanya sebahagian kecil daripada log dihantar ke Application Insights untuk mengurangkan volum dan kos data. Walau bagaimanapun, jika Log Maklumat penting untuk penyahpepijatan, anda mesti sama ada melumpuhkan pensampelan sepenuhnya (`"isEnabled": false`) atau melaraskan logik pensampelan untuk memastikan semua log yang diperlukan ditangkap. Sebagai contoh, saya menghadapi isu di mana mendayakan pensampelan menyebabkan kejatuhan rawak dalam log Maklumat tidak kritikal, yang membawa kepada kekecewaan semasa penyahpepijatan pengeluaran. 💻

Selain itu, menggunakan Siram arahan memastikan bahawa semua telemetri buffer dihantar dengan segera, mengelakkan kehilangan data. Dalam senario di mana Azure Functions dijalankan di bawah pencetus beban tinggi seperti permintaan HTTP atau pencetus Pemasa, penimbalan telemetri boleh terkumpul dengan cepat, menyebabkan kelewatan. Dengan memanggil TelemetryClient.Flush() secara eksplisit atau mengesahkan sambungan titik akhir telemetri, pembangun boleh mengurangkan ketidakkonsistenan log dan mengekalkan persekitaran pemantauan yang tepat. Akhirnya, pengimbangan pensampelan, penimbalan dan pembilasan membolehkan keterlihatan log yang optimum sambil meminimumkan kos.

Memastikan Keterlihatan Log dalam Log Fungsi Azure