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

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

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

إذا كنت ترغب في تشغيل التدفقات التي تستخدم هذا المكون الإضافي محليًا، فأنت بحاجة إلى تم تثبيت أداة Google Cloud CLI.

إعداد حساب Google Cloud

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

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

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

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

الإعداد

لتفعيل التصدير إلى Google Cloud التتبع والتسجيل والمراقبة، عليك استيراد حزمة 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 السحابة الإلكترونية

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

    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. وفي معظم الحالات، يكون هذا التأخير أقل من دقيقة واحدة.

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

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

التكلفة

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