تتبُّع التكاليف والاستخدام والمقاييس الأخرى لميزات الذكاء الاصطناعي هو جزء مهم من تشغيل تطبيق إنتاج. عليك معرفة أنماط الاستخدام العادية لتطبيقك والتأكّد من أنّك لا تتجاوز الحدود التي تهمّك.
تصف هذه الصفحة بعض الخيارات المقترَحة لتتبُّع التكاليف والاستخدام، والمقاييس الأخرى في كلّ من Firebase console وGoogle Cloud console.
تتبُّع التكاليف
في لوحة بيانات الاستخدام والفوترة في Firebase console، يمكنك الاطّلاع على تكاليف مشروعك لطلب بيانات من Vertex AI Gemini API وGemini Developer API (عند استخدام خطة Blaze).
إنّ التكاليف المعروضة على لوحة البيانات ليست بالضرورة خاصة بالطلبات التي تستخدم حِزم SDK لعميل Firebase AI Logic. ترتبط التكاليف المعروضة بأي طلبات يتم إرسالها إلى "واجهات برمجة تطبيقات Gemini" هذه، سواء كانت تستخدم حِزم SDK لعميل Firebase AI Logic أو حِزم SDK لخادم Google GenAI أو Genkit أو Firebase Extensions لواجهة Gemini API أو طلبات REST أو إحدى منصات AI Studio أو غيرها من عملاء واجهة برمجة التطبيقات.
مزيد من المعلومات حول الأسعار للمنتجات المرتبطة باستخدامك لـ Firebase AI Logic.
إعداد التنبيهات
لتجنُّب الفواتير غير المتوقّعة، تأكَّد من إعداد تنبيهات الميزانية عند استخدام خطة Blaze.
يُرجى العِلم أنّ تنبيهات الميزانية ليست حدودًا قصوى للميزانية. سيتم إرسال إشعارات إليك عند الاقتراب من الحدّ الذي ضبطته أو تجاوزه، ما يتيح لك اتّخاذ إجراء في تطبيقك أو مشروعك.
مراقبة استخدام ميزات الذكاء الاصطناعي في الـ Firebase console
يمكنك تفعيل مراقبة الذكاء الاصطناعي في صفحة Firebase AI Logic في Firebase console لتتبُّع مقاييس واستخدامات مختلفة على مستوى التطبيق، ما يمنحك رؤية شاملة لطلباتك من Firebase AI Logic client SDKs. تكون لوحات البيانات هذه أكثر تفصيلاً من أعداد الرموز الأساسية التي تحصل عليها من طلب بيانات من Count Tokens API.
تشمل الإمكانات الرئيسية لمراقبة الذكاء الاصطناعي في Firebase console ما يلي:
عرض المقاييس الكمّية، مثل حجم الطلبات والمدة الزمنية المستغرَقة والأخطاء واستخدام الرموز المميّزة لكل وضع من أوضاع التطبيقات.
فحص التتبُّعات للاطّلاع على سمات طلباتك والمدخلات والمخرجات، ما يمكن أن يساعد في تصحيح الأخطاء وتحسين الجودة.
تقسيم البيانات حسب سمات مثل حالة الطلب والحد الأدنى للمدة الزمنية المستغرَقة واسم النموذج وغير ذلك.
تم إنشاء كل هذه الميزات باستخدام Google Cloud Observability Suite (اطّلِع على معلومات المنتج التفصيلية أدناه).
تفعيل مراقبة الذكاء الاصطناعي
في ما يلي الطرق التي يمكنك من خلالها تفعيل مراقبة الذكاء الاصطناعي في Firebase console:
عند اتّباع سير عمل الإعداد الأوّلي الموجَّه من صفحة خدمات الذكاء الاصطناعي > Firebase AI Logic
في أي وقت في علامة التبويب خدمات الذكاء الاصطناعي > AI Logic > الإعدادات
متطلبات تفعيل مراقبة الذكاء الاصطناعي واستخدامها:
يجب أن تكون مالك مشروع أو محرِّرًا أو مشرف Firebase Vertex AI.
يجب أن يستخدم تطبيقك على الأقل إصدارات مكتبة Firebase التالية:
iOS+: الإصدار 11.13.0 أو أحدث | Android: الإصدار 16.0.0 أو أحدث (قائمة إدارة الإصدارات: الإصدار 33.14.0 أو أحدث) | الويب: الإصدار 11.8.0 أو أحدث | Flutter: الإصدار 2.0.0 أو أحدث (قائمة إدارة الإصدارات: الإصدار 3.11.0 أو أحدث) | Unity: الإصدار 12.9.0 أو أحدثيجب أن يكون لديك مفعَّل جمع البيانات الذي يتطلب موافقة المستخدم (يكون هذا الخيار مفعَّلاً تلقائيًا).
بعد أن يستوفي تطبيقك هذه المتطلبات وتفعِّل مراقبة الذكاء الاصطناعي في الـ وحدة التحكّم، لن تحتاج إلى اتّخاذ أي إجراء آخر في تطبيقك أو وحدة التحكّم لبدء ظهور البيانات في لوحات البيانات ضمن خدمات الذكاء الاصطناعي > AI Logic > مراقبة الذكاء الاصطناعي tab. قد يحدث تأخير طفيف (يصل أحيانًا إلى 5 دقائق) قبل أن تصبح بيانات القياس عن بُعد من طلب معيّن متاحة في Firebase console.
الاستخدام المتقدّم
يصف هذا القسم إعداد معدّل أخذ العيّنات، بالإضافة إلى خيارات مختلفة لعرض بياناتك والتعامل معها.
معدّل أخذ العيّنات
إذا كنت ترسل عددًا كبيرًا من الطلبات، ننصحك بالاستفادة من إعداد معدّل أخذ العيّنات. يشير معدّل أخذ العيّنات إلى نسبة الطلبات التي يتم جمع تفاصيل التتبُّع لها فعليًا.
في علامة التبويب خدمات الذكاء الاصطناعي > AI Logic > الإعدادات في Firebase console، يمكنك ضبط معدّل أخذ العيّنات لمشروعك على قيمة تتراوح بين %1 و%100، حيث يعني %100 أنّ مراقبة الذكاء الاصطناعي ستجمع التتبُّعات من كل زياراتك. القيمة التلقائية هي %100. سيؤدي جمع عدد أقل من التتبُّعات إلى خفض تكاليفك، ولكن سيؤدي أيضًا إلى خفض عدد التتبُّعات التي يمكنك مراقبتها. يُرجى العِلم أنّه بغض النظر عن معدّل أخذ العيّنات، ستعرض الرسومات البيانية المعروضة في لوحة بيانات المراقبة دائمًا الحجم الفعلي للزيارات.
خيارات إضافية خارج Firebase console
بالإضافة إلى مراقبة الذكاء الاصطناعي المتاحة في الـ Firebase console، ننصحك بالاطّلاع على هذه الخيارات:
استكشاف Model Garden في Vertex AI
توفر لوحات البيانات هذه إحصاءات إضافية حول الاتجاهات في ما يتعلق بالمدة الزمنية المستغرَقة والإنتاجية للنماذج المُدارة، ما يكمّل الإحصاءات التي تحصل عليها من مراقبة الذكاء الاصطناعي في الـ Firebase console.استكشاف بياناتك واستخدامها باستخدام Google Cloud Observability Suite
بما أنّه يتم تخزين بيانات القياس عن بُعد لمراقبة الذكاء الاصطناعي في Google Cloud Observability Suite المرتبط بمشروعك، يمكنك استكشاف بياناتك في لوحات البيانات، بما في ذلك Trace Explorer وLogs Explorer، اللذين يتم ربطهما عند فحص التتبُّعات الفردية في Firebase console. يمكنك أيضًا استخدام بياناتك لإنشاء لوحات بيانات مخصّصة وإعداد التنبيهات وغير ذلك.
معلومات تفصيلية حول المنتجات المستخدَمة لمراقبة الذكاء الاصطناعي
تخزِّن مراقبة الذكاء الاصطناعي بيانات القياس عن بُعد في منتجات مختلفة متاحة في 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 console. يمكنك اختياريًا إيقاف تخزين الطلبات والردود.
الأسعار
المشاريع التي تستخدم خطة Spark المجانية (لا تتوفّر إلا عند استخدام Gemini Developer API): يكون استخدام الخدمات الأساسية لمراقبة الذكاء الاصطناعي مجانيًا.
المشاريع التي تستخدم خطة Blaze للدفع حسب الاستخدام: سيتم تحصيل رسوم منك مقابل استخدام المنتجات الأساسية Google Cloud Observability Suite التي تستخدمها مراقبة الذكاء الاصطناعي (بغض النظر عن مزوّد Gemini API الذي اخترته). ومع ذلك، يتضمّن كل منتج Google Cloud Observability Suite مستويات سخية مجانية. مزيد من المعلومات في مستندات أسعار Google Cloud Observability Suite.
(اختياري) إيقاف تخزين الطلبات والردود
تلقائيًا، تسجِّل مراقبة الذكاء الاصطناعي الطلبات الفعلية التي يتم إرسالها إلى النموذج والردود التي ينشئها النموذج، بما في ذلك أي معلومات حساسة (مثل المعلومات الشخصية) في هذه الطلبات والردود. يتم تخزين كل هذه البيانات في Cloud Logging، ما يتيح الوصول إليها في الـ Firebase console.
لإيقاف تخزين الطلبات والردود، أضِف
فلتر الاستبعاد التالي إلى
Cloud Logging المصدر
(عادةً المصدر _Default):
resource.type="firebasevertexai.googleapis.com/Model"
عرض مقاييس واجهة برمجة التطبيقات على مستوى المشروع في الـ Google Cloud console
لكل واجهة برمجة تطبيقات، يمكنك عرض المقاييس على مستوى المشروع، مثل الاستخدام، في الـ Google Cloud console.
يُرجى العِلم أنّ صفحات Google Cloud console الموضّحة في هذا القسم لا تتضمّن معلومات مثل محتوى الطلب والرد وعدد الرموز المميّزة. لمراقبة هذا النوع من المعلومات، ننصحك باستخدام مراقبة الذكاء الاصطناعي في Firebase console (اطّلِع على القسم السابق).
في Google Cloud console، انتقِل إلى صفحة المقاييس لواجهة برمجة التطبيقات التي تريد عرضها:
Vertex AI API: يمكنك عرض الاستخدام المرتبط بـ أي طلب يتم إرساله إلى Vertex AI Gemini API.
- يشمل ذلك الطلبات التي تستخدم Firebase AI Logic حِزم SDK للعميل، وحِزم SDK لخادم Google GenAI، Genkit، وFirebase Extensions لـ Gemini API، وREST API، وVertex AI Studio، وما إلى ذلك.
Gemini Developer API: يمكنك عرض الاستخدام المرتبط بـ أي طلب يتم إرساله إلى Gemini Developer API.
- يشمل ذلك الطلبات التي تستخدم حِزم SDK للعميل Firebase AI Logicوحِزم SDK لخادم Google GenAI وGenkitوFirebase Extensions لـ Gemini APIوREST API وGoogle AI Studioوما إلى ذلك.
- الاسم المعروض لواجهة برمجة التطبيقات هذه في Google Cloud console هو "Generative Language API".
إذا ظهرت لك "صفحة نظرة عامة" لواجهة برمجة التطبيقات، انقر على إدارة، ثم انقر على علامة التبويب المقاييس.
Firebase AI Logicاستخدِم القوائم المنسدلة لعرض المقاييس التي تهمّك، مثل الزيارات حسب رمز الرد والأخطاء حسب طريقة واجهة برمجة التطبيقات والمدة الزمنية المستغرَقة الإجمالية والمدة الزمنية المستغرَقة حسب طريقة واجهة برمجة التطبيقات.