مراقبة تطبيقات الويب وحمايتها

بعد نشر تطبيقاتك، عليك مراقبتها وتأمينها:

• إذا كنت تنشر المحتوى باستخدام "Firebase Hosting"، يمكنك ربط مشروعك على Firebase بـ "Cloud Logging" لتتبُّع الاستخدام والوصول إلى سجلّات طلبات الويب. يمكنك الاطّلاع على مزيد من المعلومات في مقالة عرض سجلّات طلبات الويب والبحث فيها وفلترتها باستخدام Cloud Logging.

• إذا كنت تستخدم App Prototyping agent للنشر باستخدام Firebase App Hosting، يمكنك استخدام ميزات إمكانية تتبّع البيانات لتتبُّع أداء موقعك الإلكتروني. يمكنك أيضًا كتابة السجلّات في Cloud Logging وعرض السجلّات والمقاييس في وحدة تحكّم Firebase.

• إذا كنت تستخدم الذكاء الاصطناعي في تطبيقك من خلال Genkit، يمكنك مراقبة كيفية تشغيل ميزات مستندة إلى الذكاء الاصطناعي التوليدي في مرحلة الإنتاج.

• إذا كان تطبيقك يتضمّن خدمات Firebase، يمكنك تأمينها باستخدام Firebase App Check.

تتبُّع أداء موقعك الإلكتروني باستخدام ميزة إمكانية تتبّع البيانات في App Hosting

تقدّم لوحة نظرة عامة على التطبيق في Firebase Studio مقاييس ومعلومات رئيسية حول تطبيقك، ما يتيح لك رصد أداء تطبيق الويب باستخدام أدوات إمكانية تتبّع البيانات المضمّنة في App Hosting. بعد طرح موقعك الإلكتروني، يمكنك الوصول إلى النظرة العامة من خلال النقر على نشر. من هذه اللوحة، يمكنك:

• انقر على نشر لإصدار نسخة جديدة من تطبيقك.
• شارِك رابط تطبيقك أو افتحه مباشرةً في الانتقال إلى تطبيقك.
• يمكنك مراجعة ملخّص لأداء تطبيقك خلال آخر 7 أيام، بما في ذلك إجمالي عدد الطلبات وحالة آخر عملية طرح. انقر على عرض التفاصيل للاطّلاع على مزيد من المعلومات في وحدة تحكّم Firebase.
• يمكنك الاطّلاع على رسم بياني لعدد الطلبات التي تلقّاها تطبيقك خلال آخر 24 ساعة، مقسَّمة حسب رمز حالة HTTP.
• يمكنك الاطّلاع على حالة تفعيل خدمات Firebase، مثل Firebase Authentication وCloud Firestore.

إذا أغلقت لوحة "نظرة عامة على التطبيق"، يمكنك إعادة فتحها في أي وقت من خلال النقر على نشر.

يمكنك الاطّلاع على مزيد من المعلومات حول إدارة عمليات طرح "App Hosting" ومراقبتها في مقالة إدارة عمليات الطرح والإصدارات.

Genkit مراقبة للميزات المنشورة

يمكنك تتبُّع خطوات ميزة "Genkit" ومدخلاتها ومخرجاتها من خلال تفعيل القياس عن بُعد في رمز AI Flow. تتيح لك ميزة القياس عن بُعد في "Genkit" مراقبة أداء واستخدام تدفقات الذكاء الاصطناعي. يمكن أن تساعدك هذه البيانات في تحديد الجوانب التي تحتاج إلى تحسُّن، وتحديد المشاكل وحلّها، وتحسين طلباتك ومساراتك لتحقيق أداء أفضل وكفاءة في التكلفة، وتتبُّع استخدام مساراتك بمرور الوقت.

لإعداد المراقبة في "Genkit"، عليك إضافة بيانات القياس عن بُعد إلى مسارات الذكاء الاصطناعي في "Genkit"، ثم الاطّلاع على النتائج في وحدة تحكّم "Firebase".

ملاحظة مهمة: تعتمد مراقبة Genkit على بيانات القياس عن بُعد المكتوبة في Google Cloud Logging وMetrics وTrace، وهي خدمات مدفوعة. يمكنك الاطّلاع على صفحة أسعار Google Cloud Observability لمعرفة تفاصيل الأسعار وحدود الفئة المجانية.

الخطوة 1: إضافة بيانات القياس عن بُعد إلى رمز تدفق Genkit في Firebase Studio

لإعداد المراقبة في الرمز البرمجي:

1. إذا لم تكن في عرض Code، انقر على التبديل إلى الرمز لفتحه.

2. يُرجى التحقّق من package.json للتأكّد من إصدار Genkit المثبَّت.

3. افتح الوحدة الطرفية (Ctrl-Shift-C أو Cmd-Shift-C في نظام التشغيل MacOS).

4. انقر داخل الوحدة الطرفية وثبِّت المكوّن الإضافي Firebase باستخدام الإصدار الذي يتطابق مع ملف package.json. على سبيل المثال، إذا كانت حزم Genkit في package.json بالإصدار 1.0.4، عليك تنفيذ الأمر التالي لتثبيت المكوّن الإضافي:

   npm i --save @genkit-ai/firebase@1.0.4

5. من المستكشف، وسِّع src > ai > flows. يظهر ملف TypeScript واحد أو أكثر يحتوي على مسارات Genkit في المجلد flows.

6. انقر على أحد المسارات لفتحه.

   ملاحظة: يُرجى الانتباه إلى قسم prompt في الملف: يمكنك تعديل هذا القسم يدويًا لتحسين ردود "Gemini".

7. في أسفل قسم عمليات الاستيراد في الملف، أضِف ما يلي لاستيراد FirebaseTelemetry وتفعيله:

   import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
   
   enableFirebaseTelemetry();
   

   ملاحظة: لمزيد من المعلومات حول خيارات القياس عن بُعد المتقدّمة في Genkit، يُرجى الاطّلاع على الإعدادات المتقدّمة.

الخطوة 2: إعداد الأذونات

فعَّلت منصة Firebase Studio واجهات برمجة التطبيقات المطلوبة لك عند إعداد مشروعك على Firebase، ولكن عليك أيضًا منح أذونات لحساب خدمة App Hosting.

لإعداد الأذونات، يُرجى اتّباع الخطوات التالية:

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الهوية وإمكانية الوصول واختَر مشروعك على Firebase.

2. امنح الأدوار التالية لحساب خدمة App Hosting:

   • كاتب مقاييس المراقبة (roles/monitoring.metricWriter)
   • Cloud Trace Agent (roles/cloudtrace.agent)
   • كاتب السجلّات (roles/logging.logWriter)

3. أعِد نشر تطبيقك على App Hosting.

4. عند اكتمال النشر، حمِّل تطبيقك وابدأ استخدامه. بعد خمس دقائق، من المفترض أن يبدأ تطبيقك في تسجيل بيانات القياس عن بُعد.

الخطوة 3: مراقبة الميزات المستندة إلى الذكاء الاصطناعي التوليدي في وحدة تحكّم "Firebase"

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

لمراقبة ميزات تستخدم الذكاء الاصطناعي التي تم تنفيذها باستخدام Genkit:

1. بعد خمس دقائق، انتقِل إلى خدمات الذكاء الاصطناعي > Genkit في وحدة تحكّم Firebase لمراجعة الطلبات والردود من Genkit.

2. يمكنك مراجعة مقاييس الثبات التالية التي جمعتها أداة Genkit:

   • إجمالي الطلبات: إجمالي عدد الطلبات التي تلقّاها المسار.
   • معدّل النجاح: النسبة المئوية للطلبات التي تمت معالجتها بنجاح
   • وقت الاستجابة في الشريحة المئوية الـ 95: وقت الاستجابة في الشريحة المئوية الـ 95 لتدفقك، وهو الوقت الذي تستغرقه معالجة %95 من الطلبات.

   • استخدام الرموز المميّزة:

     • الرموز المميّزة للإدخال: عدد الرموز المميّزة التي تم إرسالها إلى النموذج في الطلب
     • الرموز المميّزة الناتجة: عدد الرموز المميّزة التي ينشئها النموذج في الردّ

   • استخدام الصور:

     • الصور المُدخلة: عدد الصور المُرسَلة إلى النموذج في الطلب.
     • الصور الناتجة: عدد الصور التي أنشأها النموذج في الردّ

3. يمكنك توسيع مقاييس الثبات لعرض الرسوم البيانية التفصيلية التالية:

   • حجم الطلبات بمرور الوقت
   • معدّل النجاح بمرور الوقت
   • رموز الإدخال والإخراج المميّزة بمرور الوقت
   • وقت الاستجابة (الشريحة المئوية الـ 95 والـ 50) بمرور الوقت

يمكنك الاطّلاع على مزيد من المعلومات حول "Genkit" في مستنداتهم.

حماية تطبيقك باستخدام "Firebase App Check"

إذا كنت قد دمجت خدمات Firebase أو Google Cloud في تطبيقك، تساعدك ميزة "Firebase App Check" في حماية الواجهات الخلفية لتطبيقك من إساءة الاستخدام من خلال منع العملاء غير المصرّح لهم من الوصول إلى موارد Firebase. وتعمل هذه الخدمة مع كل من خدمات Google (بما في ذلك Firebase وGoogle Cloud) والواجهات الخلفية المخصّصة للحفاظ على أمان مواردك.

ننصحك بإضافة App Check إلى أي تطبيق تنشره بشكل علني لحماية موارد الخلفية من إساءة الاستخدام.

يقدّم لك هذا القسم إرشادات حول إعداد ميزة App Check ضمن Firebase Studio باستخدام reCAPTCHA Enterprise لتطبيق ويب تم إنشاؤه بواسطة App Prototyping agent، ولكن يمكنك إعداد ميزة App Check ضمن أي تطبيق يستخدم خدمات Firebase ويمكنه استخدام مقدّمي خدمات مخصّصين. يمكنك الاطّلاع على مزيد من المعلومات على Firebase App Check.

توفّر خدمة reCAPTCHA Enterprise ما يصل إلى 10,000 تقييم بدون أي تكلفة.

الخطوة 1: إعداد reCAPTCHA Enterprise لتطبيقك

1. افتح قسم reCAPTCHA Enterprise في وحدة تحكّم Google Cloud.

2. اختَر اسم مشروعك على Firebase من أداة اختيار المشاريع في وحدة تحكّم Google Cloud.

3. إذا طُلب منك تفعيل reCAPTCHA Enterprise API، فعليك تفعيلها.

4. انقر على البدء، وأضِف اسمًا معروضًا لمفتاح الموقع الإلكتروني في reCAPTCHA.

5. اقبل مفتاح نوع التطبيق الويب التلقائي.

6. انقر على إضافة نطاق وأضِف نطاقًا. يجب إضافة نطاق App Hosting (على سبيل المثال، studio--PROJECT_ID.REGION.hosted.app) وأي نطاقات خاصة يتم استخدامها أو يُخطَّط لاستخدامها مع تطبيقك.

7. انقر على الخطوة التالية.

8. اترك الخيار هل ستستخدم التحديات؟ غير محدّد.

9. انقر على إنشاء مفتاح.

10. انسخ رقم تعريف المفتاح واحفظه، ثم انتقِل إلى ضبط App Check.

الخطوة 2: ضبط App Check

1. افتح وحدة تحكّم Firebase وانقر على إنشاء > فحص التطبيقات من قائمة التنقّل.

2. انقر على البدء، ثم على تسجيل بجانب تطبيقك.

3. انقر لتوسيع ReCAPTCHA والصِق معرّف المفتاح الذي أنشأته لـ reCAPTCHA Enterprise.

4. انقر على حفظ.

الخطوة 3: إضافة App Check إلى الرمز البرمجي

1. ارجع إلى Firebase Studio وفي طريقة عرض Code، أضِف مفتاح الموقع الإلكتروني الذي أنشأته إلى ملف .env:

   NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY
   

2. إذا لم يسبق لك حفظ إعدادات Firebase في .env، يمكنك الحصول عليها من خلال:

   • من وحدة تحكّم Firebase، افتح إعدادات المشروع وابحث عنه في القسم المتوافق مع تطبيقك.

   • من Terminal في عرض Code:

     1. سجِّل الدخول إلى Firebase: firebase auth login
     2. اختَر مشروعك: firebase use FIREBASE_PROJECT_ID
     3. الحصول على إعدادات Firebase: firebase apps:sdkconfig

3. أضِف الإعدادات إلى ملف .env بحيث تظهر على النحو التالي:

   NEXT_PUBLIC_FIREBASE_API_KEY=FIREBASE_API_KEY
   NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=FIREBASE_AUTH_DOMAIN
   NEXT_PUBLIC_FIREBASE_PROJECT_ID=FIREBASE_PROJECT_ID
   NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=FIREBASE_STORAGE_BUCKET
   NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=FIREBASE_MESSAGING_SENDER_ID
   NEXT_PUBLIC_FIREBASE_APP_ID=FIREBASE_APP_ID
   NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY
   

4. أضِف App Check إلى رمز تطبيقك. يمكنك أن تطلب من Gemini إضافة App Check مع reCAPTCHA Enterprise إلى تطبيقك (تأكَّد من تحديد "reCAPTCHA Enterprise" والتحقّق من ذلك)، أو اتّباع الخطوات الواردة في بدء App Check.

5. أعِد نشر موقعك الإلكتروني على App Hosting. جرِّب اختبار ميزات قاعدة البيانات والمصادقة لإنشاء بعض البيانات.

6. تأكَّد من أنّ App Check يتلقّى الطلبات في وحدة تحكّم Firebase من خلال فتح إنشاء > فحص التطبيقات.

7. انقر لفحص "Cloud Firestore". بعد التأكّد من وصول الطلبات، انقر على فرض لفرض App Check.

8. تكرار عملية التحقّق والتنفيذ لـ "Firebase Authentication"

إذا أردت تشغيل تطبيقك في بيئة لا يصنّفها App Check عادةً على أنّها صالحة، مثل تشغيله محليًا أثناء التطوير أو من بيئة دمج مستمر (CI)، وذلك بعد تسجيل تطبيقك في App Check، يمكنك إنشاء إصدار مخصّص لتصحيح الأخطاء من تطبيقك يستخدم مقدّم خدمة تصحيح الأخطاء في App Check بدلاً من مقدّم خدمة مصادقة حقيقي. يمكنك الاطّلاع على مزيد من المعلومات في مقالة استخدام App Check مع مقدّم خدمة تصحيح الأخطاء في تطبيقات الويب.

الخطوات التالية

• تخصيص مساحة عمل Firebase Studio

• طوِّر تطبيق ويب شاملاً وانشره وراقِبه باستخدام App Prototyping agent.