المكوّن الإضافي للتسجيل والقياس عن بُعد في Google Cloud

يصدِّر المكوّن الإضافي Google Cloud بيانات القياس عن بُعد وبيانات التسجيل الخاصة بمنصة Firebase Genkit إلى حزمة عمليات Google Cloud.

المتطلّبات الأساسية

إذا كنت تريد تنفيذ التدفقات التي تستخدِم هذا المكوّن الإضافي على الجهاز، عليك تثبيت أداة Google Cloud CLI.

إعداد حساب Google Cloud

يتطلب هذا المكوّن الإضافي حسابًا على Google Cloud (اشترِك إذا لم يكن لديك حساب) ومشروع على Google Cloud.

قبل إضافة المكون الإضافي، تأكد من تمكين واجهات برمجة التطبيقات التالية لمشروعك:

يجب إدراج واجهات برمجة التطبيقات هذه في لوحة بيانات واجهة برمجة التطبيقات لمشروعك.

انقر هنا لمزيد من المعلومات حول تفعيل واجهات برمجة التطبيقات وإيقافها.

الإعداد

لتفعيل التصدير إلى Google Cloud Tracing وLog وMonitor، عليك استيراد حزمة "googlecloud" وتشغيل Init(). بعد طلب الرقم Init()، يتم تصدير بيانات القياس عن بُعد تلقائيًا.

import "github.com/firebase/genkit/go/plugins/googlecloud"

if err := googlecloud.Init(
	ctx,
	googlecloud.Config{ProjectID: "your-google-cloud-project"},
); err != nil {
	return err
}

عليك تحديد مشروع Google Cloud الذي تريد تصدير بيانات القياس عن بُعد إليه. هناك أيضًا بعض المَعلمات الاختيارية:

  • ForceExport: تصدير بيانات القياس عن بُعد حتى عند التشغيل في بيئة تطوير البرامج (مثلاً عند استخدام genkit start أو genkit flow:run). هذه طريقة سريعة لاختبار التكامل وإرسال أحداثك الأولى للمراقبة في Google Cloud.

    إذا استخدمت هذا الخيار، ستحتاج أيضًا إلى إتاحة بيانات اعتماد Cloud محليًا على:

    gcloud auth application-default login

  • MetricInterval: الفاصل الزمني، بالثواني، الذي يتم فيه تصدير معلومات القياس عن بُعد. وتبلغ المدة التلقائية 60 ثانية (60e9 نانو ثانية).

  • LogLevel: الحد الأدنى لمستوى خطورة إدخالات السجلّ المراد تصديرها. slog.LevelInfo تلقائيًا.

يتطلب المكوّن الإضافي بيانات اعتماد مشروعك على Google Cloud. في حال تشغيل المسارات من بيئة Google Cloud (Cloud Run، وما إلى ذلك)، سيتم ضبط بيانات الاعتماد تلقائيًا. يتطلب التشغيل في بيئات أخرى إعداد بيانات الاعتماد التلقائية للتطبيق.

مراقبة عمليات الإنتاج عبر مجموعة عمليات Google Cloud

بعد نشر التدفق، انتقِل إلى مجموعة عمليات Google Cloud واختَر مشروعك.

السجلّات وعمليات الآثار

من القائمة الجانبية، ابحث عن "التسجيل" وانقر على "مستكشف السجلات".

ستظهر لك جميع السجلّات المرتبطة بمسار عملية النشر، بما في ذلك console.log(). إنّ أي سجلّ يتضمّن البادئة [genkit] هو سجلّ Genkit-داخلي يحتوي على معلومات قد تكون مهمة لأغراض تصحيح الأخطاء. على سبيل المثال، تحتوي سجلات Genkit بالتنسيق Config[...] على بيانات وصفية، مثل درجة الحرارة وقيم أعلى كيلبونات لاستنتاجات معيّنة من النماذج اللغوية الكبيرة. تحتوي السجلّات ذات التنسيق Output[...] على ردود "النموذج اللغوي الكبير" (LLM) بينما تحتوي سجلّات Input[...] على الطلبات. يشتمل التسجيل في السحابة الإلكترونية على قوائم قوية للتحكم في الوصول تتيح التحكم الدقيق في السجلات الحساسة.

بالنسبة إلى أسطر معيّنة في السجلّ، من الممكن الانتقال إلى بيانات آثار الأنشطة المرتبطة بها من خلال النقر على رمز القائمة الموسّعة واختيار "عرض في تفاصيل التتبُّع".

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

وأبرز عنصر تنقُّل في Cloud Trace هو مخطط التبعثر. ويحتوي على كل آثار الأنشطة التي تم جمعها خلال فترة زمنية معيّنة.

يؤدي النقر فوق كل نقطة بيانات إلى إظهار تفاصيلها أسفل المخطط المبعثر.

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

وتتيح طريقة العرض الناتجة فحص السجلّات بشكل تفصيلي في سياق عملية التتبُّع، بما في ذلك الطلبات وردود النماذج اللغوية الكبيرة.

المقاييس

يمكنك الاطّلاع على جميع المقاييس التي تصدِّرها Genkit من خلال اختيار "تسجيل" من القائمة الجانبية والنقر على "إدارة المقاييس".

تحتوي وحدة تحكّم إدارة المقاييس على عرض جدولي لجميع المقاييس التي تم جمعها، بما في ذلك المقاييس التي تتعلق بتشغيل السحابة الإلكترونية والبيئة المحيطة بها. سيؤدي النقر على خيار "تحميل العمل" إلى ظهور قائمة تتضمّن المقاييس التي تم جمعها من خلال Genkit. ويشكّل أيّ مقياس يتضمّن البادئة genkit مقياسًا داخليًا من أدوات Genkit.

تجمع Genkit عدة فئات من المقاييس، بما في ذلك مقاييس على مستوى التدفق، وعلى مستوى الإجراء، وعلى مستوى الإنشاء. ولكل مقياس عدة سمات مفيدة تُسهل عملية الفلترة والتجميع الفعالة.

تشمل السمات الشائعة ما يلي:

  • flow_name - اسم المستوى الأعلى للمسار.
  • flow_path - سلسلة الامتداد وسلسلة امتداده الرئيسية حتى امتداد الجذر.
  • error_code: في حال حدوث خطأ، يتم استخدام رمز الخطأ المعني.
  • error_message: في حال حدوث خطأ، يتم عرض رسالة الخطأ المقابلة.
  • model - اسم النموذج.
  • temperature - قيمة درجة حرارة الاستنتاج.
  • topK - قيمة الاستنتاج الأعلى قيمة.
  • topP - قيمة الاستنتاج الأعلى.

المقاييس على مستوى التدفق

الاسم السمات
genkit/flow/requests Flow_name، error_code، error_message
genkit/flow/وقت الاستجابة اسم_التدفق

المقاييس على مستوى الإجراء

الاسم السمات
مجموعة أدوات/إجراءات/طلبات genkit Flow_name، error_code، error_message
genkit/action/وقت الاستجابة اسم_التدفق

إنشاء مقاييس على مستوى

الاسم السمات
genkit/ai/generate تدفق_مسار، نموذج، درجة حرارة، أعلى ك، أعلى جودة، رمز خطأ، خطأ_رسالة
genkit/ai/generate/input_tokens مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/output_tokens مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/input_characters مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/output_characters مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/input_images مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/output_images مسار_تدفق، نموذج، درجة حرارة، أعلى ك، أعلى الصفحة
genkit/ai/generate/وقت الاستجابة تدفق_مسار، نموذج، درجة حرارة، أعلى ك، أعلى جودة، رمز خطأ، خطأ_رسالة

يمكن إجراء عرض مرئي للمقاييس من خلال "مستكشف المقاييس". باستخدام القائمة الجانبية، اختَر "تسجيل" وانقر على "مستكشف المقاييس"

اختَر مقاييس بالنقر على القائمة المنسدلة "اختيار مقياس"، واختَر "عقدة عامة" و"Genkit" ومقياس.

يعتمد التمثيل البصري للمقياس على نوعه (العدّاد، المدرّج التكراري، إلخ). توفّر "أداة استكشاف المقاييس" مرافق فعّالة للتجميع والاستعلام للمساعدة في إنشاء رسم بياني للمقاييس حسب أبعادها المختلفة.

تأخير القياس عن بُعد

قد يحدث تأخير بسيط قبل عرض بيانات القياس عن بُعد لتنفيذ عملية معيّنة لتدفق في حزمة عمليات Google Cloud. وفي معظم الحالات، يكون هذا التأخير أقل من دقيقة واحدة.

الحصص والحدود

هناك العديد من الحصص التي يجب وضعها في الاعتبار:

التكلفة

تتوفّر فئات مجانية واسعة من ميزات "تسجيل الدخول إلى السحابة الإلكترونية" و"تتبّع السحابة الإلكترونية" و"مراقبة السحابة الإلكترونية". يمكنك الاطّلاع على الأسعار المحدّدة على الروابط التالية: