কেন Azure ফাংশন তথ্য লগ লগ কর্মক্ষেত্রে অনুপস্থিত?

অ্যাপ্লিকেশন অন্তর্দৃষ্টিতে Azure ফাংশন লগ অনুপস্থিত সমস্যা সমাধান করা

Azure ফাংশনগুলির সাথে কাজ করা প্রায়শই একটি ভাল তেলযুক্ত অটোমেশন ইঞ্জিন তৈরির মতো মনে হয়। কিন্তু কী হবে যখন কিছু গুরুত্বপূর্ণ লগ আপনার অ্যাপ্লিকেশন ইনসাইট ওয়ার্কস্পেস থেকে অদৃশ্য হয়ে যায়? 🤔 এটি একটি চ্যালেঞ্জ যা আমি সম্প্রতি একটি টাইমার ট্রিগার Azure ফাংশন তৈরি করার সময় সম্মুখীন হয়েছি। আমার তথ্য-স্তরের লগগুলি, যেগুলি Azure পোর্টাল লগ কনসোলে নিখুঁতভাবে কাজ করেছিল, রহস্যজনকভাবে লগস ওয়ার্কস্পেস-এ অনুপস্থিত ছিল।

প্রথমে, আমি অনুমান করেছি যে সবকিছু সঠিকভাবে কনফিগার করা হয়েছে। সর্বোপরি, আমি আমার ফাংশন অ্যাপ তৈরির সময় অ্যাপ্লিকেশন অন্তর্দৃষ্টি সেট আপ করেছি এবং টেলিমেট্রি সেটআপটি বাক্সের বাইরে কাজ করছে বলে মনে হচ্ছে। একজন বিকাশকারী হিসাবে, তথ্য লগগুলি কোথাও খুঁজে পাওয়া না যাওয়ার সময় সতর্কতা এবং ত্রুটি লগগুলি সঠিকভাবে প্রদর্শিত হওয়ার চেয়ে বেশি বিভ্রান্তিকর কিছু নেই৷ তারা কোথায় লুকিয়ে ছিল?

একটি ওয়েব অ্যাপ্লিকেশন ডিবাগ করার সময় এই সমস্যাটি আমাকে একই মুহুর্তের কথা মনে করিয়ে দেয়। ত্রুটির লগগুলি চিৎকার করে "আমাকে ঠিক করুন!" যখন সূক্ষ্ম তথ্য-স্তরের লগগুলি রাডারের নীচে পড়ে যায়। এটা অনেকটা অনুপস্থিত ধাঁধাঁর টুকরো খোঁজার মতো—এটি বিদ্যমান আছে তা জেনে কিন্তু এটিকে স্তূপে দেখা যাচ্ছে না। 🧩 Azure এর host.json এবং টেলিমেট্রি সেটিংস প্রায়শই এখানে একটি ভূমিকা পালন করে।

এই নিবন্ধে, আমি এই সমস্যার মূল কারণ এবং ধাপে ধাপে কীভাবে এটি সমাধান করব তা ভেঙে দেব। host.json কনফিগারেশন থেকে লগ লেভেল থ্রেশহোল্ড যাচাই করা পর্যন্ত, আমি আপনাকে সমাধানের মাধ্যমে গাইড করব। আসুন নিশ্চিত করি যে তথ্য লগ হারিয়েছে তারা আপনার লগ ওয়ার্কস্পেস-এ ফিরে এসেছে।

মিসিং অ্যাজুর ফাংশন লগ বোঝা এবং এটি কীভাবে সমাধান করা যায়

পূর্বে প্রদত্ত স্ক্রিপ্টগুলি যেখানে একটি সাধারণ সমস্যা সমাধানের লক্ষ্য রাখে তথ্য-স্তরের লগ Azure ফাংশন দ্বারা উত্পন্ন লগস ওয়ার্কস্পেসে উপস্থিত হয় না, যদিও তারা Azure পোর্টাল লগ কনসোলে প্রদর্শিত হয়। host.json ফাইলে অনুপযুক্ত কনফিগারেশন, অপর্যাপ্ত টেলিমেট্রি সেটিংস বা অ্যাপ্লিকেশন ইনসাইটস ইন্টিগ্রেশনের সমস্যাগুলির কারণে প্রায়শই এই অসঙ্গতি ঘটে। মত কমান্ড ব্যবহার করে ফাংশন ওয়ার্কার ডিফল্টস() কনফিগার করুন এবং অ্যাপ্লিকেশন ইনসাইটস টেলিমেট্রি ওয়ার্কার সার্ভিস() যোগ করুন, আমরা নিশ্চিত করি যে অ্যাপ্লিকেশন অন্তর্দৃষ্টিগুলি প্রত্যাশিতভাবে লগগুলি ক্যাপচার করে৷ এই স্ক্রিপ্টগুলি টেলিমেট্রি ডেটা সংগ্রহ ও পরিচালনার জন্য একটি শক্তিশালী ভিত্তি স্থাপন করে।

প্রথমত, Program.cs-এ `HostBuilder` Azure ফাংশন কর্মী পরিবেশ সেট আপ করে। পদ্ধতি ফাংশন ওয়ার্কার ডিফল্টস() কনফিগার করুন নিশ্চিত করে যে Azure ফাংশনের জন্য সমস্ত প্রয়োজনীয় মিডলওয়্যার শুরু হয়েছে। এটি কাস্টম লগিং এবং নির্ভরতা ইনজেকশন কনফিগারেশনের অনুমতি দেয়। এরপর, আমরা স্পষ্টভাবে AddApplicationInsightsTelemetryWorkerService() ব্যবহার করে অ্যাপ্লিকেশন অন্তর্দৃষ্টি নিবন্ধন করি। এই ধাপটি নিশ্চিত করে যে টেলিমেট্রি সংগ্রহটি নন-HTTP-ট্রিগার করা Azure ফাংশনের জন্য সঠিকভাবে কনফিগার করা হয়েছে। উদাহরণস্বরূপ, একটি টাইমার ট্রিগার ফাংশন ডিবাগ করার কল্পনা করুন: অ্যাপ্লিকেশন অন্তর্দৃষ্টি ছাড়া, কর্মক্ষমতা ট্র্যাক করা এবং সমস্যা চিহ্নিত করা একটি ম্যানুয়াল এবং সময়সাপেক্ষ প্রক্রিয়া হয়ে ওঠে। 🔧

host.json ফাইলটি কী লগ লেভেল ক্যাপচার করা হয় তা নিয়ন্ত্রণে গুরুত্বপূর্ণ ভূমিকা পালন করে। ডিফল্ট এবং অ্যাপ্লিকেশন অন্তর্দৃষ্টি উভয় বিভাগেই `লগলেভেল` তথ্য সেট করে, আমরা স্পষ্টভাবে সংজ্ঞায়িত করি যে তথ্য-স্তরের লগগুলি অবশ্যই প্রক্রিয়া করা উচিত। যাইহোক, samplingSettings প্রপার্টি কখনো কখনো লগ ফিল্টার করতে পারে, যার ফলে লগ ওয়ার্কস্পেসে অনুপস্থিত এন্ট্রি হতে পারে। স্যাম্পলিং অক্ষম করে (`"isEnabled": false`), আমরা নিশ্চিত করি তথ্য লগ সহ সমস্ত টেলিমেট্রি ডেটা ক্যাপচার করা হয়েছে। এটি বিশেষভাবে গুরুত্বপূর্ণ যখন উত্পাদন সমস্যাগুলির সমস্যা সমাধান করা হয় যেখানে এমনকি ছোটখাটো বিবরণ মূল কারণটি প্রকাশ করতে পারে। আমি একবার এমন পরিস্থিতির মুখোমুখি হয়েছিলাম যেখানে একটি ছোট লগইনফরমেশন বার্তা একটি ভুল কনফিগার করা সময়সূচীকে উন্মোচন করতে সাহায্য করেছিল। 🎯

অবশেষে, ইউনিট পরীক্ষার স্ক্রিপ্ট যাচাই করে যে লগগুলি বিভিন্ন স্তরে—তথ্য, সতর্কতা, এবং ত্রুটি—সঠিকভাবে নির্গত এবং ক্যাপচার করা হয়েছে৷ ব্যবহার করে মিনিমাম লেভেল() সেট করুন, আমরা নিশ্চিত করি যে লগার কাঙ্ক্ষিত থ্রেশহোল্ডে বা তার উপরে সমস্ত লগ প্রক্রিয়া করে। আমাদের উদাহরণে, আমরা যাচাই করেছি যে তথ্য লগগুলি স্পষ্টভাবে কনফিগার করা হলে উপস্থিত হয়৷ এই ধরনের ইউনিট পরীক্ষা লেখা নিশ্চিত করে যে লগিং আচরণ পরিবেশ জুড়ে সামঞ্জস্যপূর্ণ, স্থাপনার সময় বিস্ময় রোধ করে। একসাথে, এই স্ক্রিপ্টগুলি অনুপস্থিত Azure ফাংশন লগগুলির সমস্যা সমাধানের জন্য একটি ব্যাপক সমাধান প্রদান করে এবং আপনার ক্লাউড অ্যাপ্লিকেশনগুলিতে টেলিমেট্রি সংগ্রহকে অপ্টিমাইজ করে৷

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

টেলিমেট্রি ডেটা অন্বেষণ করে হারিয়ে যাওয়া Azure ফাংশন লগগুলি সমাধান করা

Azure ফাংশন লগের আরেকটি গুরুত্বপূর্ণ দিক লগস ওয়ার্কস্পেস-এ প্রদর্শিত হচ্ছে না যা অ্যাপ্লিকেশন ইনসাইট দ্বারা ব্যবহৃত টেলিমেট্রি চ্যানেল কনফিগারেশন জড়িত। ডিফল্টরূপে, Azure ফাংশন অ্যাপ্লিকেশন ইনসাইটস SDK ব্যবহার করে, যা লগগুলিকে টেলিমেট্রি এন্ডপয়েন্টে পাঠানোর আগে বাফার করে। এই বাফারিং, তবে, নমুনা বা টেলিমেট্রি ডেটার অনুপযুক্ত ফ্লাশিংয়ের কারণে তথ্য-স্তরের লগ মত কিছু লগ এন্ট্রি বিলম্বিত বা বাদ দিতে পারে। সুসংগত লগ বজায় রাখার জন্য সঠিক টেলিমেট্রি চ্যানেল আচরণ নিশ্চিত করা অত্যন্ত গুরুত্বপূর্ণ।

একটি প্রায়ই উপেক্ষিত ফ্যাক্টর হল স্যাম্পলিং সেটিংস host.json-এ কনফিগারেশন। যখন নমুনা সক্ষম করা হয়, তখন ডেটা ভলিউম এবং খরচ কমাতে শুধুমাত্র লগের একটি ভগ্নাংশ অ্যাপ্লিকেশন অন্তর্দৃষ্টিতে পাঠানো হয়। যাইহোক, যদি তথ্য লগগুলি ডিবাগিংয়ের জন্য গুরুত্বপূর্ণ হয়, তবে আপনাকে অবশ্যই নমুনা সম্পূর্ণরূপে অক্ষম করতে হবে (`"isEnabled": false`) অথবা সমস্ত প্রয়োজনীয় লগ ক্যাপচার করা হয়েছে তা নিশ্চিত করতে নমুনা লজিক সামঞ্জস্য করতে হবে। উদাহরণস্বরূপ, আমি একটি সমস্যার সম্মুখীন হয়েছি যেখানে নমুনা সক্ষম করার ফলে অ-গুরুত্বপূর্ণ তথ্য লগগুলিতে এলোমেলো ড্রপ হয়েছে, যা উত্পাদন ডিবাগিংয়ের সময় হতাশার দিকে পরিচালিত করে। 💻

উপরন্তু, ব্যবহার করে ফ্লাশ কমান্ড নিশ্চিত করে যে সমস্ত বাফার করা টেলিমেট্রি অবিলম্বে পাঠানো হয়েছে, ডেটা ক্ষতি এড়ানো। এমন পরিস্থিতিতে যেখানে Azure ফাংশনগুলি হাই-লোড ট্রিগার যেমন HTTP অনুরোধ বা টাইমার ট্রিগারের অধীনে চলে, সেখানে টেলিমেট্রি বাফারিং দ্রুত জমা হতে পারে, যার ফলে বিলম্ব হয়। স্পষ্টভাবে TelemetryClient.Flush() কল করে বা টেলিমেট্রি এন্ডপয়েন্ট সংযোগ যাচাই করে, বিকাশকারীরা লগের অসঙ্গতি কমাতে পারে এবং একটি সঠিক পর্যবেক্ষণ পরিবেশ বজায় রাখতে পারে। শেষ পর্যন্ত, ভারসাম্য স্যাম্পলিং, বাফারিং এবং ফ্লাশিং খরচ কমিয়ে সর্বোত্তম লগ দৃশ্যমানতার জন্য অনুমতি দেয়।

Azure ফাংশন লগগুলিতে লগ দৃশ্যমানতা নিশ্চিত করা