مراقبة Genkit: تحديد المشاكل وحلّها

توضّح الأقسام التالية بالتفصيل حلول المشاكل الشائعة التي يواجهها المطوّرون عند استخدام ميزة "مراقبة Genkit في Firebase".

لا يمكنني الاطّلاع على عمليات التتبّع أو المقاييس في مراقبة Firebase Genkit

  1. تأكَّد من تفعيل واجهات برمجة التطبيقات التالية لمشروعك الأساسي على Google Cloud:
  2. تأكَّد من تطبيق الأدوار التالية على حساب الخدمة الذي يشغّل الرمز البرمجي (أو حساب الخدمة الذي تم إعداده كجزء من خيارات المكوّن الإضافي) في Cloud IAM.
    • Monitoring Metric Writer (roles/monitoring.metricWriter)
    • Cloud Trace Agent (roles/cloudtrace.agent)
    • كاتب السجلّات (roles/logging.logWriter)

  3. راجِع سجلّات التطبيق بحثًا عن أخطاء في الكتابة إلى "تسجيلات Cloud" و"تتبُّع Cloud" و"مراقبة Cloud". في بنية Google Cloud الأساسية، مثل Firebase Functions وCloud Run، حتى في حال ضبط إعدادات القياس بشكلٍ خاطئ، ينقل "وكيل تسجيلات السحابة الإلكترونية" تلقائيًا السجلّات إلى stdout/stderr، ما يتيح لك تشخيص المشاكل في وحدة تحكّم تسجيلات السحابة الإلكترونية.

  4. تصحيح الأخطاء محليًا:

    تفعيل ميزة التصدير للمطوّرين:

    enableFirebaseTelemetry({
  forceDevExport: true
});

    للاختبار باستخدام بيانات اعتماد المستخدم الشخصية، استخدِم gcloud CLI للمصادقة مع Google Cloud. يمكن أن يساعد ذلك في تشخيص واجهات برمجة التطبيقات المفعَّلة أو المتوقفة، ولكنّه لا يختبر تسجيل الدخول التلقائي لتطبيق gcloud auth.

    بدلاً من ذلك، يتيح لك انتحال هوية حساب الخدمة اختبار إذن وصول مشابه لتلك الممنوحة في مرحلة الإنتاج. يجب أن يكون لديك roles/iam. serviceAccountTokenCreator دور إدارة الهوية وإمكانية الوصول (IAM) مفعّلاً في حساب المستخدم لنتحلّي هوية حسابات الخدمة:

    gcloud auth application-default login --impersonate-service-account <SERVICE_ACCT_EMAIL>

    اطّلِع على مستندات ADC لمزيد من المعلومات.

موثوقية تحميل بيانات القياس في Firebase Functions أو Cloud Run

عند استضافة Genkit في Google Cloud Run (بما في ذلك "وظائف السحابة الإلكترونية لبرنامج Firebase")، قد يكون تحميل بيانات القياس أقل موثوقية عندما تنتقل الحاوية إلى حالة دورة الحياة "غير نشط". إذا كان مستوى أعلى من الموثوقية مهمًا بالنسبة إليك، ننصحك بتغيير تخصيص وحدة المعالجة المركزية إلى مخصّصة دائمًا في Google Cloud Console.