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

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

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

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

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

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

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

Genkit رصد للميزات التي تم تفعيلها

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

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

الخطوة 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. انقر على أحد سير العمل لفتحه.

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

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

enableFirebaseTelemetry();

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

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

لإعداد الأذونات:

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

  2. امنح الأدوار التالية إلى حساب خدمة استضافة التطبيقات:

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

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

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

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

عند ضبط بيانات القياس عن بُعد، Genkit يسجِّل عدد الطلبات، النجاح، والمدة الزمنية المستغرَقة لجميع سير عملك، وبالنسبة إلى كل سير عمل محدّد، Genkit يجمع مقاييس الثبات ويعرض رسومًا بيانية مفصّلة ويسجِّل عمليات التتبُّع التي تم رصدها.

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

  1. بعد خمس دقائق، انتقِل في Firebase إلى خدمات الذكاء الاصطناعي > Genkit لمراجعة الطلبات والردود من 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وحدة التحكّم، افتح إعدادات المشروع وابحث عنها في القسم الذي يتوافق مع تطبيقك.

    • من المحطة الطرفية في 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 console من خلال فتح Build > App Check.

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

  8. كرِّر عملية التحقّق والفرض لـ Firebase Authentication.

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

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