المصادقة والترخيص

يتطلّب المكوّن الإضافي لقياس أداء Firebase رقم تعريف مشروع على Google Cloud أو Firebase ومعلومات اعتماد التطبيق.

إذا لم يكن لديك مشروع وحساب على Google Cloud، يمكنك إعدادهما في وحدة تحكّم Firebase أو في وحدة تحكّم Google Cloud. جميع أرقام تعريف مشاريع Firebase هي أرقام تعريف مشاريع Google Cloud.

تفعيل واجهات برمجة التطبيقات

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

يجب أن تكون واجهات برمجة التطبيقات هذه مُدرَجة في لوحة بيانات واجهة برمجة التطبيقات لمشروعك. انقر للاطّلاع على مزيد من المعلومات حول كيفية تفعيل واجهات برمجة التطبيقات وإيقافها.

مصادقة المستخدم

لتصدير بيانات القياس من بيئة التطوير المحلية إلى Firebase Genkit Monitoring، عليك مصادقة حسابك باستخدام Google Cloud.

إنّ أسهل طريقة للمصادقة بصفتك أنت هو استخدام gcloud CLI، ما سيؤدي إلى إتاحة بيانات الاعتماد تلقائيًا للإطار من خلال بيانات الاعتماد التلقائية للتطبيق (ADC).

إذا لم يكن لديك gcloud CLI مثبّتًا، اتّبِع أولاً تعليمات التثبيت.

  1. يمكنك المصادقة باستخدام gcloud CLI:

    gcloud auth application-default login

  2. ضبط رقم تعريف المشروع

    gcloud config set project PROJECT_ID

النشر على Google Cloud

في حال نشر الرمز البرمجي في بيئة Google Cloud أو Firebase (Cloud Functions وCloud Run وApp Hosting وما إلى ذلك)، سيتم تلقائيًا اكتشاف رقم تعريف المشروع وبيانات الاعتماد باستخدام بيانات الاعتماد التلقائية للتطبيق.

ستحتاج إلى تطبيق الأدوار التالية على حساب الخدمة الذي يشغّل الرمز البرمجي (أي "حساب الخدمة المرفق") باستخدام وحدة تحكّم إدارة الهوية وإمكانية الوصول:

  • roles/monitoring.metricWriter
  • roles/cloudtrace.agent
  • roles/logging.logWriter

هل أنت غير متأكّد من حساب الخدمة الصحيح؟ راجِع القسم العثور على حساب الخدمة أو إنشاؤه.

النشر خارج Google Cloud (مع ADC)

استخدِم بيانات الاعتماد التلقائية للتطبيق إن أمكن لتوفير بيانات الاعتماد للإضافة.

يتضمن ذلك عادةً إنشاء مفتاح حساب خدمة ونشر بيانات الاعتماد هذه في بيئة الإنتاج.

  1. اتّبِع التعليمات لإعداد مفتاح حساب الخدمة.

  2. تأكَّد من أنّ حساب الخدمة يتضمّن الأدوار التالية:

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. نشر ملف بيانات الاعتماد في قناة الإصدار العلني (لا تُدرِجه في رمز المصدر)

  4. اضبط متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS على أنّه مسارملف بيانات الاعتماد.

    GOOGLE_APPLICATION_CREDENTIALS = "path/to/your/key/file"

هل أنت غير متأكّد من حساب الخدمة الصحيح؟ راجِع القسم العثور على حساب الخدمة أو إنشاؤه.

النشر خارج Google Cloud (بدون أداة إدارة الخدمات)

في بعض البيئات التي لا تتضمّن خادمًا، قد لا تتمكّن من نشر ملف اعتماد.

  1. اتّبِع التعليمات لإعداد مفتاح حساب الخدمة.

  2. تأكَّد من أنّ حساب الخدمة يتضمّن الأدوار التالية:

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. نزِّل ملف بيانات الاعتماد.

  4. عيِّن محتوى ملف بيانات الاعتماد لمتغيّر البيئة GCLOUD_SERVICE_ACCOUNT_CREDS على النحو التالي:

GCLOUD_SERVICE_ACCOUNT_CREDS='{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "your-cert-url"
}'

هل أنت غير متأكّد من حساب الخدمة الصحيح؟ راجِع القسم العثور على حساب الخدمة أو إنشاؤه.

العثور على حساب الخدمة أو إنشاؤه

للعثور على حساب الخدمة المناسب:

  1. انتقِل إلى صفحة حسابات الخدمة في Google Cloud Console.
  2. اختيار مشروعك
  3. ابحث عن حساب الخدمة المناسب. في ما يلي حسابات الخدمة التلقائية الشائعة:

  • وظائف Firebase وCloud Run

    PROJECT ID-compute@developer.gserviceaccount.com

  • App Engine

    PROJECT ID@appspot.gserviceaccount.com

  • App Hosting

    firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com

إذا كنت بصدد النشر خارج منظومة Google المتكاملة أو لا تريد استخدام حساب خدمة أساسي، يمكنك إنشاء حساب خدمة في وحدة تحكّم Google Cloud.