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

لا يمكنني الاطّلاع على عمليات التتبّع و/أو المقاييس في مراقبة 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 Platform، مثل Firebase Functions وCloud Run، حتى في حال ضبط إعدادات القياس بشكلٍ خاطئ، ينقل "وكيل تسجيلات السحابة الإلكترونية" تلقائيًا السجلّات إلى stdout/stderr، مما يتيح لك تشخيص المشاكل في وحدة تحكّم تسجيلات السحابة الإلكترونية.

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

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

    enableFirebaseTelemetry({
      forceDevExport: true
    });
    

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

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

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

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

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

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