প্রকল্প সম্পর্কে

OpenTelemetry JavaScript হল OpenTelemetry-এর JavaScript বাস্তবায়ন, যা অ্যাপ্লিকেশন থেকে ট্রেস, মেট্রিক্স এবং লগ সংগ্রহ করার জন্য একটি ভেন্ডর-নিরপেক্ষ ফ্রেমওয়ার্ক। এটি Node.js এবং ওয়েব ব্রাউজারকে লক্ষ্য করে এবং @opentelemetry স্কোপের অধীনে npm প্যাকেজের একটি সেট হিসাবে প্রকাশিত হয়। প্রকল্পটি উদ্বেগগুলিকে একটি API স্তর এবং SDK বাস্তবায়নে পৃথক করে। API প্যাকেজটি মূল ট্রেস এবং মেট্রিক্স মডেলের জন্য TypeScript ইন্টারফেস, এনাম এবং নো-অপ বাস্তবায়ন সরবরাহ করে, যাতে লাইব্রেরি লেখকরা একটি নির্দিষ্ট SDK টেনে না এনে কেবল পাবলিক API-এর উপর নির্ভর করতে পারেন। কোর প্যাকেজটি ডিফল্ট এবং নো-অপ বাস্তবায়ন সরবরাহ করে। SDK পাশে, sdk-trace ডিফল্টরূপে async_hooks বা ইনস্ট্রুমেন্টেশন লোড না করে ইনস্ট্রুমেন্টেশন এবং স্প্যান তৈরি নিয়ন্ত্রণ প্রদান করে, যখন sdk-metrics সময়-সিরিজ ডেটা রিপোর্ট করার জন্য যন্ত্র এবং মিটার সরবরাহ করে। শুরু করার জন্য সাধারণত @opentelemetry/api, @opentelemetry/sdk-node এবং auto-instrumentations-node মেটা প্যাকেজ ইনস্টল করা হয়, তারপর একটি ট্রেসিং সেটআপ ফাইল তৈরি করা হয় যা একটি রিসোর্স, ConsoleSpanExporter-এর মতো একটি এক্সপোর্টার এবং অটো-ইনস্ট্রুমেন্টেশন সহ একটি NodeSDK কনফিগার করে। অ্যাপ্লিকেশনটি তারপর ট্রেসিং ফাইলটি প্রিলোড করে শুরু করা হয়। টেলিমেট্রি একটি সংগ্রহকারীর কাছে না পৌঁছালে ডিবাগ করার জন্য API-এর মাধ্যমে একটি ডায়াগনস্টিক লগার সক্ষম করা যেতে পারে। ফিচার স্ট্যাটাস প্রতি সিগন্যালে নথিভুক্ত করা হয়: ট্রেসিং এবং মেট্রিক্স API এবং SDK উভয় ক্ষেত্রেই স্থিতিশীল, যখন লগ এখনও উন্নয়নাধীন। README স্থিতিশীল প্যাকেজ সংস্করণগুলিকে পরীক্ষামূলক প্যাকেজ সংস্করণগুলির সাথে যুক্ত একটি সামঞ্জস্য ম্যাট্রিক্সও প্রকাশ করে এবং উল্লেখ করে যে স্থিতিশীল প্যাকেজগুলি একটি সংস্করণ লাইন ভাগ করে যখন পরীক্ষামূলক প্যাকেজগুলি অন্যটি ভাগ করে। সমর্থিত রানটাইমগুলির মধ্যে বর্তমান Node.js LTS রিলিজ অন্তর্ভুক্ত, ব্রাউজার ইনস্ট্রুমেন্টেশন পরীক্ষামূলক এবং মূলত অনির্দিষ্ট হিসাবে বর্ণিত; ন্যূনতম ভাষা ফিচার বেসলাইন হল ECMAScript 2022। TypeScript সমর্থন একটি দুই বছরের সমর্থন উইন্ডো অনুসরণ করে। এক্সপোর্টাররা ভেন্ডর-নিরপেক্ষ, এবং একটি রেজিস্ট্রি উপলব্ধ এক্সপোর্টার বাস্তবায়ন তালিকাভুক্ত করে, যখন ব্যবহারকারীরা তাদের নিজস্বও লিখতে পারেন। স্বয়ংক্রিয় ট্রেসিং ইনস্ট্রুমেন্টেশনের মাধ্যমে উপলব্ধ, gRPC এবং HTTP-এর জন্য কোর Node ইনস্ট্রুমেন্টেশন, XMLHttpRequest এবং fetch-এর জন্য কোর ওয়েব ইনস্ট্রুমেন্টেশন এবং একটি পৃথক রিপোজিটরিতে হোস্ট করা অতিরিক্ত কন্ট্রিব ইনস্ট্রুমেন্টেশন সহ। প্রকল্পটি Apache-2.0 লাইসেন্সযুক্ত এবং up-for-grabs এবং good-first-issue ট্যাগের মাধ্যমে অবদানকে স্বাগত জানায়, সাপ্তাহিক SIG মিটিং সহ।