مراقبة التكاليف ومعدل الاستخدام والمقاييس الأخرى

تُعد مراقبة التكاليف والاستخدام والمقاييس الأخرى لميزات الذكاء الاصطناعي جزءًا مهمًا من تشغيل تطبيق متاح للجميع، إذ يجب معرفة أنماط الاستخدام العادية لتطبيقك والتأكّد من البقاء ضمن الحدود التي تهمّك.

توضّح هذه الصفحة بعض الخيارات المقترَحة لمراقبة التكاليف والاستخدام والمقاييس الأخرى في كلّ من وحدة تحكّم Firebase ووحدة تحكّم Google Cloud.

مراقبة التكاليف

في لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase، يمكنك الاطّلاع على تكاليف مشروعك المتعلقة بطلب Vertex AI Gemini API وGemini Developer API (عند استخدام خطة Blaze المَرِنة).

إنّ التكاليف المعروضة في لوحة البيانات ليست بالضرورة خاصة بالمكالمات التي تتم باستخدام Firebase AI Logic حِزم تطوير البرامج (SDK) الخاصة بالعميل. تكون التكاليف المعروضة مرتبطة بأي طلبات يتم إرسالها إلى واجهات Gemini API هذه، سواء كانت تستخدم حِزم تطوير البرامج (SDK) الخاصة ببرنامج Firebase AI Logic، أو حِزم تطوير البرامج (SDK) الخاصة بخادم Google GenAI، أو Genkit، أو Firebase Extensions الخاصة بـ Gemini API، أو طلبات REST، أو إحدى أدوات AI Studio، أو برامج أخرى خاصة بواجهات برمجة التطبيقات.

مزيد من المعلومات حول الأسعار الخاصة بالمنتجات المرتبطة باستخدامك Firebase AI Logic

إعداد التنبيهات

لتجنُّب الفواتير المفاجئة، احرص على إعداد تنبيهات بشأن الميزانية عند استخدام خطة Blaze المَرِنة.

يُرجى العِلم أنّ تنبيهات الميزانية ليست حدودًا قصوى للميزانية. سيرسل إليك التنبيه رسائل عندما تقترب من الحدّ الذي تم ضبطه أو تتجاوزه، حتى تتمكّن من اتّخاذ إجراء في تطبيقك أو مشروعك.

مراقبة استخدام ميزات الذكاء الاصطناعي في Firebase

يمكنك تفعيل ميزة تتبّع استخدام الذكاء الاصطناعي في صفحة Firebase AI Logic في وحدة تحكّم Firebase، ما يتيح لك مراقبة مقاييس مختلفة على مستوى التطبيق والاستخدام، وذلك للحصول على إحصاءات شاملة حول طلباتك من حِزم تطوير البرامج (SDK) الخاصة ببرنامج Firebase AI Logic. تكون لوحات البيانات هذه أكثر تفصيلاً من عدد الرموز الأساسي الذي تحصل عليه من طلب إلى Count Tokens API.

تشمل الإمكانات الرئيسية لتتبّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase ما يلي:

  • عرض مقاييس كمية، مثل عدد الطلبات ووقت الاستجابة والأخطاء واستخدام الرموز المميزة لكل وضع من أوضاع تطبيقاتك

  • فحص عمليات التتبُّع للاطّلاع على سمات الطلبات ومدخلاتها ومخرجاتها، ما يساعد في تصحيح الأخطاء وتحسين الجودة

  • تقسيم البيانات حسب السمات، مثل حالة الطلب والحد الأدنى لوقت الاستجابة واسم النموذج وغير ذلك

تم إنشاء كل هذه الميزات باستخدام Google Cloud Observability Suite (يمكنك الاطّلاع على معلومات مفصّلة عن المنتج أدناه).

تتبّع استخدام الذكاء الاصطناعي

في ما يلي الطرق التي يمكنك من خلالها تفعيل ميزة تتبّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase:

متطلبات تفعيل ميزة تتبّع استخدام الذكاء الاصطناعي واستخدامها:

  • يجب أن تكون مالك مشروع أو محرِّرًا أو مشرفًا على 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 أو إصدار أحدث

  • يجب أن يكون خيار الموافقة على جمع البيانات مفعَّلاً في تطبيقك (يكون هذا الخيار مفعَّلاً تلقائيًا).

بعد أن يستوفي تطبيقك هذه المتطلبات وتفعِّل ميزة "تتبّع استخدام الذكاء الاصطناعي" في وحدة التحكّم، لن تحتاج إلى اتّخاذ أي إجراء آخر في تطبيقك أو وحدة التحكّم لبدء ظهور البيانات في لوحات البيانات ضمن علامة التبويب Firebase AI Logic تتبّع استخدام الذكاء الاصطناعي. قد يحدث تأخير بسيط (يصل أحيانًا إلى 5 دقائق) قبل أن تتوفّر بيانات القياس عن بُعد من أحد الطلبات في وحدة تحكّم Firebase.

الاستخدام المتقدّم

يوضّح هذا القسم إعدادات معدّل أخذ العيّنات، بالإضافة إلى الخيارات المختلفة لعرض بياناتك والتعامل معها.

معدّل أخذ العيّنات

إذا كنت بصدد تقديم عدد كبير من الطلبات، ننصحك بالاستفادة من إعداد معدّل أخذ العيّنات. يشير معدّل أخذ العيّنات إلى نسبة الطلبات التي يتم جمع تفاصيل التتبُّع لها فعليًا.

في علامة التبويب Firebase AI Logic الإعدادات ضمن وحدة تحكّم Firebase، يمكنك ضبط معدّل أخذ العيّنات لمشروعك على قيمة تتراوح بين %1 و%100، حيث يعني %100 أنّ ميزة "تتبّع استخدام الذكاء الاصطناعي" ستجمع عمليات التتبُّع من كل زياراتك. القيمة التلقائية هي %100. سيؤدي جمع عدد أقل من عمليات التتبُّع إلى خفض التكاليف، ولكن سيؤدي أيضًا إلى تقليل عدد عمليات التتبُّع التي يمكنك مراقبتها. يُرجى العِلم أنّه بغض النظر عن معدّل أخذ العيّنات، ستعرض الرسومات البيانية الظاهرة في لوحة بيانات المراقبة دائمًا عدد الزيارات الفعلي.

خيارات إضافية خارج وحدة تحكّم Firebase

بالإضافة إلى ميزة تتبّع استخدام الذكاء الاصطناعي المتوفّرة في وحدة تحكّم Firebase، ننصحك بالاطّلاع على الخيارات التالية:

  • استكشِف مكتبة النماذج في Vertex AI.
    تقدّم لوحات البيانات هذه إحصاءات إضافية حول الاتجاهات في ما يتعلّق بوقت الاستجابة وسرعة معالجة البيانات للنماذج المُدارة، ما يكمّل الإحصاءات التي تحصل عليها من ميزة "تتبّع استخدام الذكاء الاصطناعي" في وحدة تحكّم 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 مستندات الأسعار.

(اختياري) إيقاف تخزين الطلبات والردود

بشكلٍ تلقائي، يسجّل تتبّع استخدام الذكاء الاصطناعي الطلبات الفعلية التي يتم إرسالها إلى النموذج والردود التي ينشئها النموذج، بما في ذلك أي معلومات حساسة (مثل معلومات تكشف الهوية الشخصية) في تلك الطلبات والردود. يتم تخزين كل هذه البيانات في Cloud Logging لتتمكّن من الوصول إليها في وحدة تحكّم Firebase.

لإيقاف تخزين الطلبات والاستجابات، أضِف فلتر الاستبعاد التالي إلى Cloud Logging مصدر البيانات (عادةً مصدر البيانات _Default): resource.type="firebasevertexai.googleapis.com/Model".

عرض مقاييس واجهة برمجة التطبيقات على مستوى المشروع في وحدة تحكّم Google Cloud

بالنسبة إلى كل واجهة برمجة تطبيقات، يمكنك الاطّلاع على مقاييس على مستوى المشروع، مثل الاستخدام، في Google Cloud console.

يُرجى العِلم أنّ صفحات Google Cloud في وحدة التحكّم الموضّحة في هذا القسم لا تتضمّن معلومات مثل محتوى الطلب والردّ وعدد الرموز المميزة. لمراقبة هذا النوع من المعلومات، ننصحك باستخدام ميزة تتبّع استخدام الذكاء الاصطناعي في Firebase (راجِع القسم السابق).

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة المقاييس الخاصة بواجهة برمجة التطبيقات التي تريد عرضها:

    • Vertex AI API: عرض الاستخدام المرتبط بأي طلب إلى Vertex AI Gemini API

      • تشمل الطلبات التي تستخدم حِزم تطوير البرامج (SDK) الخاصة بالعملاء Firebase AI Logic، وحِزم تطوير البرامج (SDK) الخاصة بخادم Google GenAI، وGenkit، وFirebase Extensions الخاصة بـ Gemini API، وREST API، وVertex AI Studio، وما إلى ذلك.
    • Gemini Developer API: عرض بيانات الاستخدام المرتبطة بأي طلب تم إرساله إلى Gemini Developer API

      • تشمل الطلبات التي تستخدم حِزم تطوير البرامج (SDK) الخاصة بالعملاء Firebase AI Logic، وحِزم تطوير البرامج (SDK) الخاصة بخادم GenAI من Google، وGenkit، وFirebase Extensions الخاصة بـ Gemini API، وREST API، وGoogle AI Studio، وما إلى ذلك.
      • اسم العرض لواجهة برمجة التطبيقات هذه في وحدة تحكّم Google Cloud هو "Generative Language API".

    إذا انتقلت إلى "صفحة نظرة عامة" خاصة بواجهة برمجة التطبيقات، انقر على إدارة، ثم انقر على علامة التبويب المقاييس.

  2. استخدِم القوائم المنسدلة لعرض المقاييس التي تهمّك، مثل عدد الزيارات حسب رمز الاستجابة والأخطاء حسب طريقة واجهة برمجة التطبيقات ووقت الاستجابة الإجمالي ووقت الاستجابة حسب طريقة واجهة برمجة التطبيقات.