پایش هزینه‌ها، میزان استفاده، و سنجه‌های دیگر

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

این صفحه برخی‌از گزینه‌های توصیه‌شده برای نظارت بر هزینه‌ها، استفاده، و سنجه‌های دیگر را در هر دو کنسول Firebase و کنسول Google Cloud شرح می‌دهد.

نظارت بر هزینه‌ها

در داشبورد استفاده و صورت‌حساب کنسول Firebase، می‌توانید هزینه‌های پروژه خود را برای تماس با Agent Platform Gemini API (formerly Vertex AI) و Gemini Developer API (وقتی در طرح قیمت‌گذاری Blaze هستید) مشاهده کنید.

هزینه‌های نمایش‌داده‌شده در داشبورد لزوماً مختص تماس‌های استفاده‌کننده از Firebase AI Logic کیت‌های توسعه نرم‌افزار مشتری نیست. هزینه‌های نمایش‌داده‌شده با هر تماسی با آن «میاناهای برنامه‌سازی کاربردی Gemini» مرتبط است، خواه از کیت‌های توسعه نرم‌افزار مشتری Firebase AI Logic، کیت‌های توسعه نرم‌افزار سرور Google GenAI،‏ Genkit،‏ Firebase Extensions برای Gemini API، تماس‌های REST، یکی از AI Studios، یا دیگر مشتریان API استفاده شود.

درباره قیمت‌گذاری محصولات مرتبط با استفاده شما از Firebase AI Logic بیشتر بدانید.

راه‌اندازی هشدارهای بودجه و سقف هزینه

وقتی در طرح قیمت‌گذاری Blaze هستید، با تنظیم هشدارهای بودجه و سقف‌های هزینه از صورت‌حساب‌های غیرمنتظره جلوگیری کنید.

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

نظارت بر استفاده از ویژگی‌های هوشواره‌ای در کنسول Firebase

می‌توانید پایش هوش مصنوعی را در صفحه Firebase AI Logic کنسول Firebase فعال کنید تا بتوانید سنجه‌های سطح برنامه و استفاده‌های مختلف را مشاهده کنید و دید جامعی از درخواست‌هایتان از کیت‌های توسعه نرم‌افزار مشتری Firebase AI Logic به‌دست آورید. این داشبوردها نسبت‌به تعداد نشانه‌های پایه‌ای که از فراخوانی میانای برنامه‌سازی کاربردی شمارش نشانه‌ها دریافت می‌کنید، جزئیات بیشتری دارند.

قابلیت‌های کلیدی پایش هوش مصنوعی در کنسول Firebase شامل موارد زیر است:

  • مشاهده سنجه‌های کمی مثل حجم درخواست، تأخیر، خطاها، و استفاده از کد براساس روش برای هریک از برنامه‌هایتان.

  • بازرسی ردپاها برای دیدن ویژگی‌ها، ورودی‌ها، و بروندادهای درخواست‌هایتان که می‌تواند به اشکال‌زدایی و بهبود کیفیت کمک کند.

  • برش دادن داده‌ها براساس ابعادی مثل وضعیت درخواست، حداقل تأخیر، نام مدل، و موارد دیگر.

همه این ویژگی‌ها بااستفاده از Google Cloud Observability Suite ساخته شده‌اند (به اطلاعات دقیق محصول در زیر مراجعه کنید).

فعال کردن پایش هوش مصنوعی

در اینجا روش‌هایی که می‌توانید پایش هوش مصنوعی را در کنسول Firebase فعال کنید آورده شده است:

شرایط لازم برای فعال کردن و استفاده از پایش هوش مصنوعی:

  • باید «مالک»، «ویرایشگر»، یا «سرپرست Firebase Vertex AI» پروژه باشید.

  • برنامه شما باید حداقل از این نسخه‌های کتابخانه Firebase استفاده کند:
    iOS+: v11.13.0+ | Android: v16.0.0+ (BoM: v33.14.0+) | Web: v11.8.0+ | Flutter: v2.0.0+ (BoM: v3.11.0+) | Unity: v12.9.0+

  • برنامه شما باید گردآوری داده‌های موافقت کاربر را فعال داشته باشد (این ویژگی به‌طور پیش‌فرض فعال است).

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

استفاده پیشرفته

این بخش پیکربندی نرخ نمونه‌گیری و همچنین گزینه‌های مختلف برای مشاهده و کار با داده‌هایتان را شرح می‌دهد.

بسامد نمونه

اگر تعداد زیادی درخواست ارسال می‌کنید، توصیه می‌کنیم از پیکربندی نرخ نمونه‌برداری استفاده کنید. نرخ نمونه‌برداری نشان‌دهنده نسبت درخواست‌هایی است که برای آن‌ها جزئیات ردگیری واقعاً جمع‌آوری می‌شود.

در برگه تنظیمات سرویس‌های هوش مصنوعی > منطق هوش مصنوعی > کنسول Firebase، می‌توانید نرخ نمونه‌برداری را برای پروژه‌تان روی مقداری از ۱ تا ۱۰۰٪ پیکربندی کنید، که در آن ۱۰۰٪ یعنی پایش هوش مصنوعی ردپاهای همه ترافیک شما را جمع‌آوری خواهد کرد. پیش‌فرض ۱۰۰٪ است. جمع‌آوری ردهای کمتر هزینه‌هایتان را کاهش می‌دهد، اما تعداد ردهایی را که می‌توانید پایش کنید نیز کاهش می‌دهد. توجه داشته باشید که صرف‌نظر از نرخ نمونه‌برداری شما، نمودارهای نشان‌داده‌شده در داشبورد پایش همیشه حجم واقعی ترافیک را منعکس می‌کنند.

گزینه‌های اضافی خارج از کنسول Firebase

علاوه‌بر پایش هوش مصنوعی دردسترس در کنسول Firebase، این گزینه‌ها را درنظر بگیرید:

  • Vertex AI Model Garden را کاوش کنید.
    این داشبوردها اطلاعات آماری بیشتری درباره روند تأخیر و توان عملیاتی برای مدل‌های مدیریت‌شده ارائه می‌دهند و اطلاعات آماری شما را از پایش هوش مصنوعی در کنسول Firebase تکمیل می‌کنند.

  • با Google Cloud Observability Suite
    داده‌هایتان را کاوش و استفاده کنید ازآنجایی‌که داده‌های تله‌متری برای پایش هوش مصنوعی در Google Cloud Observability Suite مرتبط با پروژه شما ذخیره می‌شود، می‌توانید داده‌هایتان را در داشبوردهای آن کاوش کنید، ازجمله Trace Explorer و Logs Explorer، که به زمان بازرسی ردهای منفرد در کنسول Firebase پیوند داده شده‌اند. همچنین می‌توانید از داده‌هایتان برای ساختن داشبوردهای سفارشی، تنظیم هشدارها، و غیره استفاده کنید.

اطلاعات دقیق درباره محصولات مورداستفاده برای پایش هوش مصنوعی

«پایش هوش مصنوعی» داده‌های تله‌متری شما را در محصولات مختلف موجود در Google Cloud Observability Suite ذخیره می‌کند، ازجمله Cloud Monitoring، Cloud Trace، و Cloud Logging.

  • Cloud Monitoring: سنجه‌ها، ازجمله تعداد درخواست‌ها، نرخ موفقیت، و تأخیر درخواست را ذخیره می‌کند.

  • Cloud Trace: ردپای هریک از درخواست‌هایتان را ذخیره می‌کند تا بتوانید جزئیات را به‌صورت جداگانه، به‌جای تجمیعی، مشاهده کنید. ردیابی معمولاً با گزارش‌ها مرتبط است تا بتوانید محتوا و زمان‌بندی هر تعامل را بررسی کنید.

  • Cloud Logging: فراداده‌های ورودی، خروجی، و پیکربندی را ضبط می‌کند تا جزئیات غنی درباره هر بخش از درخواست هوش مصنوعی شما ارائه دهد.

ازآنجایی‌که داده‌های دورسنجی شما در این محصولات ذخیره می‌شود، می‌توانید تنظیمات دسترسی و نگهداری را مستقیماً در هر محصول مشخص کنید (در مستندات Cloud Monitoring، Cloud Trace ، و Cloud Logging بیشتر بدانید).

توجه داشته باشید که پایش هوش مصنوعی پیام‌واره‌های واقعی و برونداد تولیدشده از هر درخواست نمونه‌برداری‌شده را در Cloud Logging ذخیره می‌کند تا این داده‌ها در کنسول Firebase دردسترس باشد. می‌توانید به‌صورت اختیاری ذخیره پیام‌واره‌ها و پاسخ‌ها را غیرفعال کنید.

قیمت‌گذاری

  • پروژه‌ها در طرح قیمت‌گذاری Spark بدون هزینه (فقط هنگام استفاده از Gemini Developer API دردسترس است): استفاده از سرویس‌های زیربنایی برای پایش هوش مصنوعی رایگان است.

  • پروژه‌های طرح قیمت‌گذاری Blaze با پرداخت براساس مصرف: هزینه استفاده از محصولات Google Cloud Observability Suite زیربنایی که پایش هوش مصنوعی استفاده می‌کند (صرف‌نظر از ارائه‌دهنده Gemini API انتخابی شما) از شما کسر خواهد شد. بااین‌حال، هر محصول Google Cloud Observability Suite دارای سطوح رایگان سخاوتمندانه است. در Google Cloud Observability Suite سند قیمت‌گذاری بیشتر بدانید.

(اختیاری) غیرفعال کردن ذخیره پیام‌واره‌ها و پاسخ‌ها

به‌طور پیش‌فرض، پایش هوش مصنوعی پیام‌واره‌های واقعی ارسال‌شده به مدل و پاسخ‌های تولیدشده توسط مدل، ازجمله هرگونه اطلاعات حساس (مثل «اطلاعات شناساننده شخصی» (PII)) در آن پیام‌واره‌ها و پاسخ‌ها را ضبط می‌کند. همه این داده‌ها در Cloud Logging ذخیره می‌شود تا در کنسول Firebase دردسترس باشد.

برای غیرفعال کردن ذخیره پیام‌واره‌ها و پاسخ‌ها، فیلتر استثنا زیر را به Cloud Logging سینک خود resource.type="firebasevertexai.googleapis.com/Model" اضافه کنید (معمولاً سینک _Default): resource.type="firebasevertexai.googleapis.com/Model".

مشاهده سنجه‌های API سطح پروژه در کنسول Google Cloud

برای هر API، می‌توانید سنجه‌های سطح پروژه، مانند استفاده، را در Google Cloud کنسول مشاهده کنید.

توجه داشته باشید که صفحات کنسول Google Cloud که در این بخش توضیح داده شده است شامل اطلاعاتی مانند محتوای درخواست و پاسخ و تعداد نشان‌ها نمی‌شود برای پایش کردن این نوع اطلاعات، از پایش هوش مصنوعی در کنسول Firebase (بخش قبلی را ببینید) استفاده کنید.

  1. در کنسول Google Cloud، به صفحه سنجه‌ها میانای برنامه‌سازی کاربردی موردنظر برای مشاهده بروید:

    • Agent Platform میانای برنامه‌سازی کاربردی: مشاهده استفاده مرتبط با هر درخواست به Agent Platform Gemini API (formerly Vertex AI).

      • شامل درخواست‌های استفاده از کیت‌های توسعه نرم‌افزار مشتری Firebase AI Logic، کیت‌های توسعه نرم‌افزار سرور Google GenAI،‏ Genkit،‏ Firebase Extensions برای Gemini API،‏ REST API،‏ Agent  Studio، و غیره می‌شود.

    • Gemini Developer API: مشاهده استفاده مرتبط با هر درخواست به Gemini Developer API.

      • شامل درخواست‌های استفاده از کیت‌های توسعه نرم‌افزار مشتری Firebase AI Logic، کیت‌های توسعه نرم‌افزار سرور Google GenAI،‏ Genkit،‏ Firebase Extensions برای Gemini API،‏ REST API،‏ Google AI Studio، و غیره می‌شود.
      • نام نمایشی این API در کنسول Google Cloud ‏«Generative Language API» است.

    اگر در «صفحه نمای کلی» برای API قرار دارید، روی مدیریت کلیک کنید، و سپس روی برگه سنجه‌ها کلیک کنید.

  2. از منوهای کرکره‌ای برای مشاهده سنجه‌های موردنظر، مانند ترافیک براساس کد پاسخ، خطاها براساس روش میانای برنامه‌سازی کاربردی، تأخیر کلی، و تأخیر براساس روش میانای برنامه‌سازی کاربردی استفاده کنید.