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

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

مراقبة أداء موقعك الإلكتروني باستخدام ميزة 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 IAM console واختَر مشروعك، ثم امنح الأدوار التالية لحساب خدمة App Hosting:

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

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

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

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

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

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

  1. بعد خمس دقائق، افتح Genkit في Firebase وحدة التحكّم وراجِع طلبات Genkit' وردوده.

    Genkit تجمِّع Genkit مقاييس الثبات التالية:

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

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

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

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

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

    إذا وسّعت مقاييس الثبات، ستتوفّر رسومات بيانية مفصّلة:

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

مزيد من المعلومات حول Genkit في 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 مع موفّر تصحيح الأخطاء في تطبيقات الويب.

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