مجموعه تله متری

پلاگین تله متری Firebase ترکیبی از معیارها، ردیابی ها و گزارش ها را به Google Cloud Observability صادر می کند. این سند جزئیات معیارها، ویژگی‌های ردیابی و گزارش‌ها را جمع‌آوری می‌کند و از نظر تأخیر، سهمیه‌ها و هزینه‌ها چه انتظاری دارید.

تاخیر در تله متری

ممکن است قبل از اینکه تله متری از فراخوانی داده شده در Firebase در دسترس باشد، کمی تأخیر وجود داشته باشد. این بستگی به فاصله زمانی صادرات شما دارد (به طور پیش فرض 5 دقیقه).

سهمیه ها و محدودیت ها

چند سهمیه وجود دارد که باید در نظر داشت:

• سهمیه های Cloud Trace
• سهمیه های ثبت ابر
• سهمیه مانیتورینگ ابری

هزینه

Cloud Logging، Cloud Trace و Cloud Monitoring دارای سطوح سخاوتمندانه رایگان هستند. قیمت های ویژه را می توانید در لینک های زیر مشاهده کنید:

• قیمت گذاری Cloud Logging
• قیمت گذاری Cloud Trace
• قیمت گذاری مانیتورینگ ابری

معیارها

پلاگین تله متری Firebase تعدادی معیار مختلف را برای پشتیبانی از انواع مختلف کنش Genkit که در بخش‌های زیر توضیح داده شده است، جمع‌آوری می‌کند.

معیارهای ویژگی

ویژگی ها نقطه ورود سطح بالایی به کد Genkit شما هستند. در بیشتر موارد، این یک جریان خواهد بود. در غیر این صورت، این بالاترین فاصله در یک ردیابی خواهد بود.

نام	تایپ کنید	توضیحات
genkit/ویژگی/درخواست‌ها	شمارنده	تعداد درخواست ها
genkit/ویژگی/تأخیر	هیستوگرام	تأخیر اجرا در ms

هر معیار ویژگی شامل ابعاد زیر است:

نام	توضیحات
نام	نام ویژگی. در بیشتر موارد، این جریان Genkit در سطح بالا است
وضعیت	"موفقیت" یا "شکست" بسته به اینکه آیا درخواست ویژگی موفق بوده است یا خیر
خطا	تنظیم فقط زمانی که status=failure . حاوی نوع خطایی است که باعث خرابی شده است
منبع	زبان مبدأ Genkit. به عنوان مثال 'ts'
منبع نسخه	نسخه فریمورک Genkit

معیارهای اقدام

اقدامات نشان دهنده یک مرحله کلی از اجرا در Genkit است. هر یک از این مراحل معیارهای زیر را ردیابی خواهند کرد:

نام	تایپ کنید	توضیحات
جنکیت/عمل/درخواست	شمارنده	تعداد دفعاتی که این عمل اجرا شده است
genkit/action/latency	هیستوگرام	تأخیر اجرا در ms

هر معیار کنش شامل ابعاد زیر است:

نام	توضیحات
نام	نام عمل
نام ویژگی	نام ویژگی والد در حال اجرا
مسیر	مسیر اجرا از ریشه ویژگی تا این اکشن. به عنوان مثال '/myFeature/parentAction/thisAction'
وضعیت	"موفقیت" یا "شکست" بسته به اینکه آیا عمل موفق بوده است یا خیر
خطا	تنظیم فقط زمانی که status=failure . حاوی نوع خطایی است که باعث خرابی شده است
منبع	زبان مبدأ Genkit. به عنوان مثال 'ts'
منبع نسخه	نسخه فریمورک Genkit

معیارها را تولید کنید

اینها معیارهای اقدام ویژه مربوط به اقداماتی هستند که با یک مدل تعامل دارند. علاوه بر درخواست‌ها و تأخیر، ورودی و خروجی نیز با ابعاد خاص مدل ردیابی می‌شوند که اشکال‌زدایی و تنظیم پیکربندی را آسان‌تر می‌کند.

نام	تایپ کنید	توضیحات
genkit/ai/generate/درخواست	شمارنده	تعداد دفعاتی که این مدل فراخوانی شده است
genkit/ai/generate/latency	هیستوگرام	تأخیر اجرا در ms
genkit/ai/generate/input/tokens	شمارنده	توکن های ورودی
genkit/ai/generate/output/tokens	شمارنده	توکن های خروجی
genkit/ai/generate/input/character	شمارنده	کاراکترهای ورودی
genkit/ai/generate/output/character	شمارنده	کاراکترهای خروجی
genkit/ai/generate/input/images	شمارنده	تصاویر ورودی
genkit/ai/generate/output/images	شمارنده	خروجی تصاویر
genkit/ai/generate/input/audio	شمارنده	فایل های صوتی را وارد کنید
genkit/ai/generate/output/audio	شمارنده	خروجی فایل های صوتی

هر معیار تولید شامل ابعاد زیر است:

نام	توضیحات
نام مدل	نام مدل
نام ویژگی	نام ویژگی والد در حال اجرا
مسیر	مسیر اجرا از ریشه ویژگی تا این اکشن. به عنوان مثال '/myFeature/parentAction/thisAction'
تاخیر خانم ها	زمان پاسخگویی که توسط مدل گرفته شده است
وضعیت	"موفقیت" یا "شکست" بسته به اینکه آیا درخواست ویژگی موفق بوده است یا خیر
خطا	تنظیم فقط زمانی که status=failure . حاوی نوع خطایی است که باعث خرابی شده است
منبع	زبان مبدأ Genkit. به عنوان مثال 'ts'
منبع نسخه	نسخه فریمورک Genkit

آثار

تمام اقدامات Genkit به طور خودکار برای ارائه ردیابی های دقیق برای ویژگی های AI شما تنظیم می شوند. به صورت محلی، ردپاها در رابط کاربری توسعه‌دهنده قابل مشاهده هستند. برای برنامه‌های مستقر، Firebase Genkit Monitoring را فعال کنید تا سطح دید یکسانی داشته باشد.

بخش‌های زیر توضیح می‌دهند که چه ویژگی‌های ردیابی را می‌توانید بر اساس نوع عملکرد Genkit برای یک بازه خاص در ردیابی انتظار داشته باشید.

دهانه ریشه

دهانه ریشه دارای ویژگی های ویژه ای است که به رفع ابهام از ویژگی های حالت برای کل ردیابی در مقابل یک دهانه فردی کمک می کند.

نام صفت	توضیحات
genkit/ویژگی	نام ویژگی والد در حال اجرا
genkit/isRoot	اگر این دهانه دهانه ریشه باشد، درست علامت گذاری می شود
genkit/rootState	وضعیت اجرای کلی به عنوان success یا error . این نشان نمی دهد که این مرحله به طور خاص شکست خورده است.

جریان

نام صفت	توضیحات
genkit/input	ورودی به جریان. به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / فراداده / زیرنوع	نوع عمل Genkit. برای جریان ها flow خواهد بود.
genkit/نام	نام این اقدام Genkit. در این مورد نام جریان
genkit/خروجی	خروجی تولید شده در جریان. به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / مسیر	مسیر اجرای کاملا واجد شرایط که منجر به این مرحله در ردیابی می شود، شامل اطلاعات نوع.
جنکیت / حالت	وضعیت اجرای این بازه به عنوان success یا error .
جنکیت/نوع	نوع Genkit اولیه که مربوط به این دهانه است. برای جریان ها، این action خواهد بود.

Util

نام صفت	توضیحات
genkit/input	ورودی به ابزار. به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit/نام	نام این اقدام Genkit. در این مورد نام جریان
genkit/خروجی	خروجی تولید شده در ابزار. به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / مسیر	مسیر اجرای کاملا واجد شرایط که منجر به این مرحله در ردیابی می شود، شامل اطلاعات نوع.
جنکیت / حالت	وضعیت اجرای این بازه به عنوان success یا error .
جنکیت/نوع	نوع Genkit اولیه که مربوط به این دهانه است. برای جریان ها، این util خواهد بود.

مدل

نام صفت	توضیحات
genkit/input	ورودی مدل به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / فراداده / زیرنوع	نوع عمل Genkit. برای مدل ها model خواهد بود.
جنکیت/مدل	نام مدل.
genkit/نام	نام این اقدام Genkit. در این مورد نام مدل.
genkit/خروجی	خروجی تولید شده توسط مدل به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / مسیر	مسیر اجرای کاملا واجد شرایط که منجر به این مرحله در ردیابی می شود، شامل اطلاعات نوع.
جنکیت / حالت	وضعیت اجرای این بازه به عنوان success یا error .
جنکیت/نوع	نوع Genkit اولیه که مربوط به این دهانه است. برای جریان ها، این action خواهد بود.

ابزار

نام صفت	توضیحات
genkit/input	ورودی مدل به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / فراداده / زیرنوع	نوع عمل Genkit. برای ابزارها tool خواهد بود.
genkit/نام	نام این اقدام Genkit. در این مورد نام مدل.
genkit/خروجی	خروجی تولید شده توسط مدل به دلیل محدودیت اندازه ویژگی ردیابی، همیشه <redacted> خواهد بود.
genkit / مسیر	مسیر اجرای کاملا واجد شرایط که منجر به این مرحله در ردیابی می شود، شامل اطلاعات نوع.
جنکیت / حالت	وضعیت اجرای این بازه به عنوان success یا error .
جنکیت/نوع	نوع Genkit اولیه که مربوط به این دهانه است. برای جریان ها، این action خواهد بود.

سیاههها

برای برنامه‌های مستقر شده با Firebase Genkit Monitoring، از گزارش‌ها برای ضبط فراداده‌های ورودی، خروجی و پیکربندی استفاده می‌شود که جزئیات کاملی در مورد هر مرحله از ویژگی هوش مصنوعی شما ارائه می‌دهد.

همه گزارش‌ها شامل فیلدهای فراداده مشترک زیر می‌شوند:

نام فیلد	توضیحات
درج شناسه	شناسه منحصر به فرد برای ورود به گزارش
jsonPayload	ظرفی برای اطلاعات متغیری که برای هر نوع گزارش منحصر به فرد است
برچسب ها	{module: genkit}
logname	projects/weather-gen-test-next/logs/genkit_log
دریافت زمان مهر	زمان دریافت گزارش توسط Cloud
منبع	اطلاعات مربوط به منبع گزارش شامل منطقه اطلاعات استقرار و projectId
شدت	سطح گزارش نوشته شده است. به Cloud's LogSeverity مراجعه کنید
spanId	شناسه دامنه ای که این گزارش را ایجاد کرده است
مهر زمانی	زمانی که مشتری پیامی را ثبت کرد
ردیابی	شناسه برای ردیابی projects/<project-id>/traces/<trace-id>
traceSampled	Boolean نشان می دهد که آیا ردیابی نمونه برداری شده است یا خیر. لاگ ها نمونه برداری نمی شوند.

هر نوع لاگ دارای بار json متفاوتی است که در هر بخش توضیح داده شده است.

ورودی

محموله JSON:

نام فیلد	توضیحات
پیام	[genkit] Input[<path>, <featureName>] شامل (message X of N) برای پیام‌های چند قسمتی
فراداده	زمینه اضافی شامل پیام ورودی ارسال شده به اقدام

فراداده:

نام فیلد	توضیحات
محتوا	محتوای پیام ورودی ارسال شده به این کنش Genkit
نام ویژگی	نام جریان، عمل، ابزار، ابزار یا کمک Genkit.
messageIndex *	فهرستی که ترتیب پیام‌ها را برای ورودی‌هایی که حاوی چندین پیام هستند نشان می‌دهد. برای پیام های تک، این همیشه 0 خواهد بود.
مدل *	نام مدل
مسیر	مسیر اجرایی که این گزارش را با فرمت step1 > step2 > step3 ایجاد کرد
partIndex *	نمایه ای که ترتیب قسمت های یک پیام را برای پیام های چند قسمتی نشان می دهد. این امر در هنگام ترکیب متن و تصاویر در یک ورودی معمولی است.
qualifiedPath	مسیر اجرایی که این گزارش را ایجاد کرد، شامل اطلاعات نوع قالب: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model
کل پیام ها *	تعداد کل پیام‌ها برای این ورودی. برای پیام های تک، این همیشه 1 خواهد بود.
کل قطعات *	تعداد کل قطعات این پیام برای پیام های تک قسمتی، این همیشه 1 خواهد بود.

(*) موارد ستاره‌دار فقط در گزارش‌های ورودی برای تعاملات مدل وجود دارند.

خروجی

محموله JSON:

نام فیلد	توضیحات
پیام	[genkit] Output[<path>, <featureName>] شامل (message X of N) برای پیام‌های چند قسمتی
فراداده	زمینه اضافی شامل پیام ورودی ارسال شده به اقدام

فراداده:

نام فیلد	توضیحات
kandidatIndex * (منسوخ شده)	شاخصی که ترتیب نامزدها را برای خروجی هایی که دارای چندین نامزد هستند نشان می دهد. برای لاگ هایی با نامزدهای تک، این همیشه 0 خواهد بود.
محتوا	پیام خروجی تولید شده توسط اکشن Genkit
نام ویژگی	نام جریان، عمل، ابزار، ابزار یا کمک Genkit.
messageIndex *	فهرستی که ترتیب پیام‌ها را برای ورودی‌هایی که حاوی چندین پیام هستند نشان می‌دهد. برای پیام های تک، این همیشه 0 خواهد بود.
مدل *	نام مدل
مسیر	مسیر اجرایی که این گزارش را با فرمت `step1 > step2 > step3 ایجاد کرد
partIndex *	نمایه ای که ترتیب قسمت های یک پیام را برای پیام های چند قسمتی نشان می دهد. این امر در هنگام ترکیب متن و تصاویر در یک خروجی معمولی است.
qualifiedPath	مسیر اجرایی که این گزارش را ایجاد کرد، شامل اطلاعات نوع قالب: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model
totalCandidates * (منسوخ شده)	تعداد کل نامزدهای تولید شده به عنوان خروجی. برای پیام های تک نامزدی، این همیشه 1 خواهد بود.
کل قطعات *	تعداد کل قطعات این پیام برای پیام های تک قسمتی، این همیشه 1 خواهد بود.

(*) موارد ستاره‌دار فقط در گزارش‌های خروجی برای تعاملات مدل وجود دارند.

پیکربندی

محموله JSON:

نام فیلد	توضیحات
پیام	[genkit] Config[<path>, <featureName>]
فراداده	زمینه اضافی شامل پیام ورودی ارسال شده به اقدام

فراداده:

نام فیلد	توضیحات
نام ویژگی	نام جریان، عمل، ابزار، ابزار یا کمک Genkit.
مدل	نام مدل
مسیر	مسیر اجرایی که این گزارش را با فرمت `step1 > step2 > step3 ایجاد کرد
qualifiedPath	مسیر اجرایی که این گزارش را ایجاد کرد، شامل اطلاعات نوع قالب: /{flow1,t:flow}/{generate,t:util}/{modelProvider/model,t:action,s:model
منبع	زبان کتابخانه Genkit استفاده شده است. این همیشه روی 'ts' تنظیم می شود زیرا تنها زبان پشتیبانی شده است.
منبع نسخه	نسخه کتابخانه Genkit.
دما	دمای مدل استفاده شده

مسیرها

محموله JSON:

نام فیلد	توضیحات
پیام	[genkit] Paths[<path>, <featureName>]
فراداده	زمینه اضافی شامل پیام ورودی ارسال شده به اقدام

فراداده:

نام فیلد	توضیحات
نام جریان	نام جریان، عمل، ابزار، ابزار یا کمک Genkit.
مسیرها	آرایه ای که شامل تمام مسیرهای اجرا برای دهانه های جمع آوری شده است.