ফায়ারবেস টেলিমেট্রি প্লাগইন Google ক্লাউড অবজারভেবিলিটিতে মেট্রিক্স, ট্রেস এবং লগের সংমিশ্রণ রপ্তানি করে। এই নথিতে কোন মেট্রিক্স, ট্রেস অ্যাট্রিবিউট এবং লগ সংগ্রহ করা হবে এবং আপনি লেটেন্সি, কোটা এবং খরচের ক্ষেত্রে কী আশা করতে পারেন তার বিবরণ দেয়।
টেলিমেট্রি বিলম্ব
Firebase-এ প্রদত্ত আমন্ত্রণ থেকে টেলিমেট্রি উপলব্ধ হওয়ার আগে সামান্য বিলম্ব হতে পারে। এটি আপনার রপ্তানি ব্যবধানের উপর নির্ভর করে (ডিফল্টরূপে 5 মিনিট)।
কোটা এবং সীমা
বেশ কয়েকটি কোটা রয়েছে যা মনে রাখা গুরুত্বপূর্ণ:
খরচ
ক্লাউড লগিং, ক্লাউড ট্রেস এবং ক্লাউড মনিটরিংয়ের উদার বিনামূল্যের স্তর রয়েছে। নির্দিষ্ট মূল্য নিম্নলিখিত লিঙ্কে পাওয়া যাবে:
মেট্রিক্স
Firebase টেলিমেট্রি প্লাগইন নিম্নলিখিত বিভাগে বিস্তারিত বিভিন্ন জেনকিট অ্যাকশনের ধরনকে সমর্থন করার জন্য বিভিন্ন মেট্রিক সংগ্রহ করে।
ফিচার মেট্রিক্স
বৈশিষ্ট্যগুলি হল আপনার জেনকিট কোডের শীর্ষ-স্তরের এন্ট্রি-পয়েন্ট। বেশিরভাগ ক্ষেত্রে, এটি একটি প্রবাহ হবে। অন্যথায়, এটি একটি ট্রেস মধ্যে শীর্ষ-সবচেয়ে স্প্যান হবে.
| নাম | টাইপ | বর্ণনা |
|---|---|---|
| জেনকিট/বৈশিষ্ট্য/অনুরোধ | কাউন্টার | অনুরোধের সংখ্যা |
| জেনকিট/বৈশিষ্ট্য/ বিলম্ব | হিস্টোগ্রাম | ms-এ এক্সিকিউশন লেটেন্সি |
প্রতিটি বৈশিষ্ট্য মেট্রিকে নিম্নলিখিত মাত্রা রয়েছে:
| নাম | বর্ণনা |
|---|---|
| নাম | বৈশিষ্ট্যের নাম। বেশিরভাগ ক্ষেত্রে, এটি শীর্ষ-স্তরের জেনকিট প্রবাহ |
| অবস্থা | 'সফল' বা 'ব্যর্থতা' বৈশিষ্ট্য অনুরোধ সফল হয়েছে কিনা তার উপর নির্ভর করে |
| ত্রুটি | status=failure হলেই সেট করুন। ব্যর্থতার কারণ ত্রুটির ধরন রয়েছে৷ |
| উৎস | Genkit উৎস ভাষা. যেমন 'ts' |
| উৎস সংস্করণ | জেনকিট ফ্রেমওয়ার্ক সংস্করণ |
অ্যাকশন মেট্রিক্স
ক্রিয়াগুলি জেনকিটের মধ্যে কার্যকর করার একটি সাধারণ পদক্ষেপের প্রতিনিধিত্ব করে। এই ধাপগুলির প্রতিটিতে নিম্নলিখিত মেট্রিক্স ট্র্যাক করা হবে:
| নাম | টাইপ | বর্ণনা |
|---|---|---|
| জেনকিট/অ্যাকশন/অনুরোধ | কাউন্টার | এই ক্রিয়াটি কতবার সম্পাদিত হয়েছে |
| জেনকিট/অ্যাকশন/লেটেন্সি | হিস্টোগ্রাম | ms-এ এক্সিকিউশন লেটেন্সি |
প্রতিটি অ্যাকশন মেট্রিকে নিম্নলিখিত মাত্রা থাকে:
| নাম | বর্ণনা |
|---|---|
| নাম | কর্মের নাম |
| বৈশিষ্ট্যের নাম | অভিভাবক বৈশিষ্ট্যটির নাম কার্যকর করা হচ্ছে৷ |
| পথ | বৈশিষ্ট্য রুট থেকে এই কর্ম সম্পাদনের পথ। যেমন '/myFeature/parentAction/thisAction' |
| অবস্থা | 'সাফল্য' বা 'ব্যর্থতা' কর্মটি সফল হয়েছে কিনা তার উপর নির্ভর করে |
| ত্রুটি | status=failure হলেই সেট করুন। ব্যর্থতার কারণ ত্রুটির ধরন রয়েছে৷ |
| উৎস | Genkit উৎস ভাষা. যেমন 'ts' |
| উৎস সংস্করণ | জেনকিট ফ্রেমওয়ার্ক সংস্করণ |
মেট্রিক্স তৈরি করুন
এগুলি একটি মডেলের সাথে ইন্টারঅ্যাক্ট করে এমন ক্রিয়াগুলির সাথে সম্পর্কিত বিশেষ অ্যাকশন মেট্রিক। অনুরোধ এবং লেটেন্সি ছাড়াও, ইনপুট এবং আউটপুটও ট্র্যাক করা হয়, মডেল নির্দিষ্ট মাত্রা সহ যা ডিবাগিং এবং কনফিগারেশন টিউনিংকে সহজ করে তোলে।
| নাম | টাইপ | বর্ণনা |
|---|---|---|
| জেনকিট/এআই/জেনারেট/অনুরোধ | কাউন্টার | এই মডেলটি কতবার কল করা হয়েছে |
| জেনকিট/এআই/জেনারেট/লেটেন্সি | হিস্টোগ্রাম | ms-এ এক্সিকিউশন লেটেন্সি |
| জেনকিট/এআই/জেনারেট/ইনপুট/টোকেন | কাউন্টার | ইনপুট টোকেন |
| জেনকিট/এআই/জেনারেট/আউটপুট/টোকেন | কাউন্টার | আউটপুট টোকেন |
| জেনকিট/এআই/জেনারেট/ইনপুট/অক্ষর | কাউন্টার | অক্ষর ইনপুট করুন |
| জেনকিট/এআই/জেনারেট/আউটপুট/অক্ষর | কাউন্টার | আউটপুট অক্ষর |
| জেনকিট/এআই/জেনারেট/ইনপুট/ছবি | কাউন্টার | ইনপুট ইমেজ |
| জেনকিট/এআই/জেনারেট/আউটপুট/ছবি | কাউন্টার | আউটপুট ইমেজ |
| জেনকিট/এআই/জেনারেট/ইনপুট/অডিও | কাউন্টার | অডিও ফাইল ইনপুট করুন |
| জেনকিট/এআই/জেনারেট/আউটপুট/অডিও | কাউন্টার | আউটপুট অডিও ফাইল |
প্রতিটি জেনারেট মেট্রিকে নিম্নলিখিত মাত্রা রয়েছে:
| নাম | বর্ণনা |
|---|---|
| মডেলের নাম | মডেলের নাম |
| বৈশিষ্ট্যের নাম | অভিভাবক বৈশিষ্ট্যটির নাম কার্যকর করা হচ্ছে৷ |
| পথ | বৈশিষ্ট্য রুট থেকে এই কর্ম সম্পাদনের পথ। যেমন '/myFeature/parentAction/thisAction' |
| বিলম্ব | মডেল দ্বারা নেওয়া প্রতিক্রিয়া সময় |
| অবস্থা | 'সফল' বা 'ব্যর্থতা' বৈশিষ্ট্য অনুরোধ সফল হয়েছে কিনা তার উপর নির্ভর করে |
| ত্রুটি | status=failure হলেই সেট করুন। ব্যর্থতার কারণ ত্রুটির ধরন রয়েছে৷ |
| উৎস | Genkit উৎস ভাষা. যেমন 'ts' |
| উৎস সংস্করণ | জেনকিট ফ্রেমওয়ার্ক সংস্করণ |
ট্রেস
সমস্ত জেনকিট অ্যাকশন স্বয়ংক্রিয়ভাবে আপনার AI বৈশিষ্ট্যগুলির জন্য বিশদ ট্রেস প্রদানের জন্য ব্যবহৃত হয়। স্থানীয়ভাবে, বিকাশকারী UI-তে ট্রেসগুলি দৃশ্যমান। স্থাপন করা অ্যাপগুলির জন্য একই স্তরের দৃশ্যমানতা পেতে Firebase Genkit Monitoring সক্ষম করুন৷
নিচের বিভাগগুলি বর্ণনা করে যে আপনি ট্রেসের একটি নির্দিষ্ট স্প্যানের জন্য Genkit অ্যাকশন টাইপের উপর ভিত্তি করে কোন ট্রেস বৈশিষ্ট্যগুলি আশা করতে পারেন৷
রুট স্প্যান
রুট স্প্যানগুলির বিশেষ বৈশিষ্ট্য রয়েছে যা সম্পূর্ণ ট্রেস বনাম একটি পৃথক স্প্যানের জন্য রাষ্ট্রের বৈশিষ্ট্যগুলিকে দ্ব্যর্থিত করতে সহায়তা করে।
| বৈশিষ্ট্যের নাম | বর্ণনা |
|---|---|
| জেনকিট/বৈশিষ্ট্য | অভিভাবক বৈশিষ্ট্যটির নাম কার্যকর করা হচ্ছে৷ |
| genkit/isRoot | এই স্প্যানটি রুট স্প্যান হলে সত্য চিহ্নিত করা হয়েছে |
| genkit/rootState | success বা error হিসাবে সামগ্রিক মৃত্যুদন্ডের অবস্থা। এটি নির্দেশ করে না যে এই পদক্ষেপটি বিশেষভাবে ব্যর্থ হয়েছে। |
প্রবাহ
| বৈশিষ্ট্যের নাম | বর্ণনা |
|---|---|
| জেনকিট/ইনপুট | প্রবাহে ইনপুট। ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/মেটাডেটা/সাবটাইপ | জেনকিট অ্যাকশনের ধরন। প্রবাহের জন্য এটি flow হবে। |
| জেনকিট/নাম | এই জেনকিট অ্যাকশনের নাম। এক্ষেত্রে প্রবাহের নাম |
| জেনকিট/আউটপুট | প্রবাহে উৎপন্ন আউটপুট। ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/পথ | টাইপ ইনফরমেশন সহ ট্রেসে এই ধাপে নিয়ে যাওয়া সম্পূর্ণরূপে যোগ্য এক্সিকিউশন পাথ। |
| genkit/state | success বা error হিসাবে এই স্প্যানটির সম্পাদনের অবস্থা। |
| জেনকিট/টাইপ | Genkit আদিম প্রকার যা এই স্প্যানের সাথে মিলে যায়। প্রবাহের জন্য, এটি action হবে। |
ইউটিল
| বৈশিষ্ট্যের নাম | বর্ণনা |
|---|---|
| জেনকিট/ইনপুট | ইউটিলে ইনপুট। ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/নাম | এই জেনকিট অ্যাকশনের নাম। এক্ষেত্রে প্রবাহের নাম |
| জেনকিট/আউটপুট | ইউটিলে উৎপন্ন আউটপুট। ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/পথ | টাইপ ইনফরমেশন সহ ট্রেসে এই ধাপে নিয়ে যাওয়া সম্পূর্ণরূপে যোগ্য এক্সিকিউশন পাথ। |
| genkit/state | success বা error হিসাবে এই স্প্যানটির সম্পাদনের অবস্থা। |
| জেনকিট/টাইপ | Genkit আদিম প্রকার যা এই স্প্যানের সাথে মিলে যায়। প্রবাহের জন্য, এটি util হবে। |
মডেল
| বৈশিষ্ট্যের নাম | বর্ণনা |
|---|---|
| জেনকিট/ইনপুট | মডেল ইনপুট. ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/মেটাডেটা/সাবটাইপ | জেনকিট অ্যাকশনের ধরন। মডেলদের জন্য এটি model হবে। |
| জেনকিট/মডেল | মডেলের নাম। |
| জেনকিট/নাম | এই জেনকিট অ্যাকশনের নাম। এক্ষেত্রে মডেলের নাম ড. |
| জেনকিট/আউটপুট | মডেল দ্বারা উত্পন্ন আউটপুট. ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/পথ | টাইপ ইনফরমেশন সহ ট্রেসে এই ধাপে নিয়ে যাওয়া সম্পূর্ণরূপে যোগ্য এক্সিকিউশন পাথ। |
| genkit/state | success বা error হিসাবে এই স্প্যানটির সম্পাদনের অবস্থা। |
| জেনকিট/টাইপ | Genkit আদিম প্রকার যা এই স্প্যানের সাথে মিলে যায়। প্রবাহের জন্য, এটি action হবে। |
টুল
| বৈশিষ্ট্যের নাম | বর্ণনা |
|---|---|
| জেনকিট/ইনপুট | মডেল ইনপুট. ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/মেটাডেটা/সাবটাইপ | জেনকিট অ্যাকশনের ধরন। টুলের জন্য এটা tool হবে। |
| জেনকিট/নাম | এই জেনকিট অ্যাকশনের নাম। এক্ষেত্রে মডেলের নাম ড. |
| জেনকিট/আউটপুট | মডেল দ্বারা উত্পন্ন আউটপুট. ট্রেস অ্যাট্রিবিউটের আকারের সীমার কারণে এটি সর্বদা <redacted> হবে। |
| জেনকিট/পথ | টাইপ ইনফরমেশন সহ ট্রেসে এই ধাপে নিয়ে যাওয়া সম্পূর্ণরূপে যোগ্য এক্সিকিউশন পাথ। |
| genkit/state | success বা error হিসাবে এই স্প্যানটির সম্পাদনের অবস্থা। |
| জেনকিট/টাইপ | Genkit আদিম প্রকার যা এই স্প্যানের সাথে মিলে যায়। প্রবাহের জন্য, এটি action হবে। |
লগ
ফায়ারবেস জেনকিট মনিটরিংয়ের সাথে স্থাপন করা অ্যাপগুলির জন্য, ইনপুট, আউটপুট এবং কনফিগারেশন মেটাডেটা ক্যাপচার করতে লগগুলি ব্যবহার করা হয় যা আপনার AI বৈশিষ্ট্যের প্রতিটি ধাপ সম্পর্কে সমৃদ্ধ বিশদ প্রদান করে।
সমস্ত লগ নিম্নলিখিত ভাগ করা মেটাডেটা ক্ষেত্র অন্তর্ভুক্ত করবে:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| সন্নিবেশ আইডি | লগ এন্ট্রির জন্য অনন্য আইডি |
| jsonPayload | পরিবর্তনশীল তথ্যের জন্য ধারক যা প্রতিটি লগ প্রকারের জন্য অনন্য |
| লেবেল | {module: genkit} |
| লগনেম | projects/weather-gen-test-next/logs/genkit_log |
| টাইমস্ট্যাম্প পেয়েছে | লগ ক্লাউড দ্বারা গৃহীত সময় |
| সম্পদ | স্থাপনার তথ্য অঞ্চল এবং প্রজেক্টআইডি সহ লগের উত্স সম্পর্কে তথ্য |
| তীব্রতা | লগ লেভেল লেখা। Cloud এর LogSeverity দেখুন |
| স্প্যানআইডি | এই লগটি যে স্প্যানটি তৈরি করেছে তার শনাক্তকারী৷ |
| টাইমস্ট্যাম্প | ক্লায়েন্ট একটি বার্তা লগ করার সময় |
| ট্রেস | বিন্যাস projects/<project-id>/traces/<trace-id> |
| ট্রেস নমুনা | ট্রেস নমুনা করা হয়েছে কিনা তা বুলিয়ান প্রতিনিধিত্ব করে। লগ নমুনা করা হয় না. |
প্রতিটি লগ টাইপের প্রতিটি বিভাগে বর্ণিত একটি আলাদা json পেলোড থাকবে।
ইনপুট
JSON পেলোড:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বার্তা | [genkit] Input[<path>, <featureName>] সহ (message X of N) বহু-অংশের বার্তাগুলির জন্য |
| মেটাডেটা | অ্যাকশনে পাঠানো ইনপুট বার্তা সহ অতিরিক্ত প্রসঙ্গ |
মেটাডেটা:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বিষয়বস্তু | এই Genkit অ্যাকশনে পাঠানো ইনপুট বার্তা সামগ্রী |
| বৈশিষ্ট্যের নাম | Genkit প্রবাহ, কর্ম, টুল, util, বা সাহায্যকারীর নাম। |
| বার্তা সূচক * | একাধিক বার্তা রয়েছে এমন ইনপুটগুলির জন্য বার্তাগুলির ক্রম নির্দেশ করে সূচক৷ একক বার্তার জন্য, এটি সর্বদা 0 হবে। |
| মডেল * | মডেলের নাম। |
| পথ | এক্সিকিউশন পাথ যা step1 > step2 > step3 ফর্ম্যাটের এই লগ তৈরি করেছে |
| partIndex* | বহু-অংশের বার্তাগুলির জন্য একটি বার্তার মধ্যে অংশগুলির ক্রম নির্দেশ করে সূচক৷ একটি একক ইনপুটে পাঠ্য এবং চিত্রগুলিকে একত্রিত করার সময় এটি সাধারণ। |
| যোগ্য পথ | বিন্যাসের টাইপ তথ্য সহ এই লগ জেনারেট করা এক্সিকিউশন পাথ: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model |
| মোট বার্তা * | এই ইনপুটের জন্য মোট বার্তার সংখ্যা। একক বার্তার জন্য, এটি সর্বদা 1 হবে। |
| মোট অংশ * | এই বার্তার জন্য মোট অংশ সংখ্যা. একক অংশের বার্তাগুলির জন্য, এটি সর্বদা 1 হবে৷ |
(*) তারকাচিহ্নিত আইটেমগুলি শুধুমাত্র মডেল ইন্টারঅ্যাকশনের জন্য ইনপুট লগগুলিতে উপস্থিত থাকে৷
আউটপুট
JSON পেলোড:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বার্তা | [genkit] Output[<path>, <featureName>] সহ (message X of N) বহু-অংশের বার্তাগুলির জন্য |
| মেটাডেটা | অ্যাকশনে পাঠানো ইনপুট বার্তা সহ অতিরিক্ত প্রসঙ্গ |
মেটাডেটা:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| প্রার্থী সূচক * (বঞ্চিত) | একাধিক প্রার্থী রয়েছে এমন আউটপুটগুলির জন্য প্রার্থীদের ক্রম নির্দেশ করে সূচক। একক প্রার্থীর লগের জন্য, এটি সর্বদা 0 হবে। |
| বিষয়বস্তু | Genkit ক্রিয়া দ্বারা উত্পন্ন আউটপুট বার্তা |
| বৈশিষ্ট্যের নাম | Genkit প্রবাহ, কর্ম, টুল, util, বা সাহায্যকারীর নাম। |
| বার্তা সূচক * | একাধিক বার্তা রয়েছে এমন ইনপুটগুলির জন্য বার্তাগুলির ক্রম নির্দেশ করে সূচক৷ একক বার্তার জন্য, এটি সর্বদা 0 হবে। |
| মডেল * | মডেলের নাম। |
| পথ | এক্সিকিউশন পাথ যা `step1 > step2 > step3 ফর্ম্যাটের এই লগ তৈরি করেছে |
| partIndex* | বহু-অংশের বার্তাগুলির জন্য একটি বার্তার মধ্যে অংশগুলির ক্রম নির্দেশ করে সূচক৷ একক আউটপুটে পাঠ্য এবং চিত্রগুলিকে একত্রিত করার সময় এটি সাধারণ। |
| যোগ্য পথ | বিন্যাসের টাইপ তথ্য সহ এই লগ জেনারেট করা এক্সিকিউশন পাথ: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model |
| মোট প্রার্থী * (বঞ্চিত) | আউটপুট হিসাবে উত্পন্ন প্রার্থীর মোট সংখ্যা। একক-প্রার্থী বার্তাগুলির জন্য, এটি সর্বদা 1 হবে। |
| মোট অংশ * | এই বার্তার জন্য মোট অংশ সংখ্যা. একক অংশের বার্তাগুলির জন্য, এটি সর্বদা 1 হবে৷ |
(*) তারকাচিহ্নিত আইটেমগুলি শুধুমাত্র মডেল ইন্টারঅ্যাকশনের জন্য আউটপুট লগগুলিতে উপস্থিত থাকে৷
কনফিগার
JSON পেলোড:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বার্তা | [genkit] Config[<path>, <featureName>] |
| মেটাডেটা | অ্যাকশনে পাঠানো ইনপুট বার্তা সহ অতিরিক্ত প্রসঙ্গ |
মেটাডেটা:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বৈশিষ্ট্যের নাম | Genkit প্রবাহ, কর্ম, টুল, util, বা সাহায্যকারীর নাম। |
| মডেল | মডেলের নাম। |
| পথ | এক্সিকিউশন পাথ যা `step1 > step2 > step3 ফর্ম্যাটের এই লগ তৈরি করেছে |
| যোগ্য পথ | বিন্যাসের টাইপ তথ্য সহ এই লগ জেনারেট করা এক্সিকিউশন পাথ: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model |
| উৎস | Genkit লাইব্রেরি ভাষা ব্যবহার করা হয়. এটি সর্বদা 'ts' তে সেট করা হবে কারণ এটি একমাত্র সমর্থিত ভাষা। |
| উৎস সংস্করণ | জেনকিট লাইব্রেরি সংস্করণ। |
| তাপমাত্রা | মডেল তাপমাত্রা ব্যবহৃত. |
পথ
JSON পেলোড:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| বার্তা | [genkit] Paths[<path>, <featureName>] |
| মেটাডেটা | অ্যাকশনে পাঠানো ইনপুট বার্তা সহ অতিরিক্ত প্রসঙ্গ |
মেটাডেটা:
| ক্ষেত্রের নাম | বর্ণনা |
|---|---|
| প্রবাহের নাম | Genkit প্রবাহ, কর্ম, টুল, util, বা সাহায্যকারীর নাম। |
| পথ | সংগৃহীত স্প্যানগুলির জন্য সমস্ত নির্বাহের পথ সমন্বিত একটি অ্যারে৷ |