برنامه های وب را نظارت و محافظت کنید

پس از انتشار برنامه های خود، باید آنها را کنترل و ایمن کنید:

عملکرد سایت خود را با قابلیت مشاهده App Hosting نظارت کنید

پانل نمای کلی برنامه در Firebase Studio معیارها و اطلاعات کلیدی را در مورد برنامه شما ارائه می دهد و به شما امکان می دهد با استفاده از ابزارهای مشاهده داخلی App Hosting عملکرد برنامه وب خود را کنترل کنید. پس از انتشار سایت شما، می توانید با کلیک روی انتشار به نمای کلی دسترسی پیدا کنید. از این پنل می توانید:

  • برای انتشار نسخه جدیدی از برنامه خود، روی انتشار کلیک کنید.
  • پیوند برنامه خود را به اشتراک بگذارید یا برنامه خود را مستقیماً در Visit your app باز کنید.
  • خلاصه‌ای از عملکرد برنامه‌تان در ۷ روز گذشته، شامل تعداد کل درخواست‌ها و وضعیت آخرین عرضه‌تان را مرور کنید. برای دسترسی به اطلاعات بیشتر در کنسول Firebase ، روی مشاهده جزئیات کلیک کنید.
  • نموداری از تعداد درخواست‌هایی که برنامه شما در 24 ساعت گذشته دریافت کرده است، به تفکیک کد وضعیت HTTP مشاهده کنید.

اگر پانل نمای کلی برنامه را ببندید، می‌توانید هر زمان که بخواهید با کلیک روی انتشار دوباره آن را باز کنید.

درباره مدیریت و نظارت بر عرضه App Hosting در مدیریت عرضه و انتشار بیشتر بیاموزید.

مانیتورینگ Genkit برای ویژگی های مستقر شما

می‌توانید مراحل، ورودی‌ها و خروجی‌های ویژگی Genkit خود را با فعال کردن تله‌متری در کد جریان AI خود نظارت کنید. ویژگی تله متری Genkit به شما امکان می دهد عملکرد و استفاده از جریان های هوش مصنوعی خود را نظارت کنید. این داده‌ها می‌توانند به شما کمک کنند تا زمینه‌های بهبود را شناسایی کنید، مشکلات را عیب‌یابی کنید، درخواست‌ها و جریان‌های خود را برای عملکرد بهتر و کارآمدی هزینه بهینه کنید، و میزان استفاده از جریان‌های خود را در طول زمان پیگیری کنید.

برای تنظیم نظارت در Genkit ، تله متری را به جریان های هوش مصنوعی Genkit اضافه می کنید و سپس نتایج را در کنسول Firebase مشاهده می کنید.

مرحله 1: تله متری را به کد جریان Genkit خود در Firebase Studio اضافه کنید

برای تنظیم نظارت در کد خود:

  1. اگر قبلاً در نمای Code نیستید، کلیک کنید سوئیچ کد نماد برای باز کردن آن به کد بروید .

  2. برای تأیید نسخه Genkit که نصب شده است، package.json بررسی کنید.

  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. از Explorer ، src > ai > flows گسترش دهید. یک یا چند فایل TypeScript که حاوی جریان های Genkit شما هستند در پوشه flows ظاهر می شوند.

  6. روی یکی از جریان ها کلیک کنید تا باز شود.

  7. در پایین بخش imports فایل، موارد زیر را برای وارد کردن و فعال کردن FirebaseTelemetry اضافه کنید:

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

enableFirebaseTelemetry();

مرحله 2: مجوزها را تنظیم کنید

Firebase Studio هنگام راه‌اندازی پروژه Firebase ، APIهای مورد نیاز را برای شما فعال کرده است، اما شما همچنین باید مجوزهایی را برای حساب سرویس App Hosting ارائه دهید.

برای تنظیم مجوزها:

  1. کنسول Google Cloud IAM را باز کنید، پروژه خود را انتخاب کنید، سپس نقش‌های زیر را به حساب سرویس میزبانی برنامه اختصاص دهید:

    • مانیتورینگ متریک رایتر ( roles/monitoring.metricWriter )
    • Cloud Trace Agent ( roles/cloudtrace.agent )
    • Logs Writer ( roles/logging.logWriter )

  2. برنامه خود را مجدداً در App Hosting منتشر کنید.

  3. وقتی انتشار کامل شد، برنامه خود را بارگیری کنید و شروع به استفاده از آن کنید. پس از پنج دقیقه، برنامه شما باید شروع به ثبت اطلاعات تله متری کند.

مرحله 3: ویژگی های هوش مصنوعی تولیدی خود را در کنسول Firebase نظارت کنید

وقتی تله‌متری پیکربندی می‌شود، Genkit تعداد درخواست‌ها، موفقیت و تأخیر را برای همه جریان‌های شما ثبت می‌کند، و برای هر جریان خاص، Genkit معیارهای پایداری را جمع‌آوری می‌کند، نمودارهای دقیق را نشان می‌دهد و ردیابی‌های ثبت شده را ثبت می‌کند.

برای نظارت بر ویژگی‌های هوش مصنوعی پیاده‌سازی شده با Genkit :

  1. پس از پنج دقیقه، Genkit در کنسول Firebase باز کنید و درخواست‌ها و پاسخ‌های Genkit را بررسی کنید.

    Genkit معیارهای پایداری زیر را جمع آوری می کند:

    • کل درخواست ها: تعداد کل درخواست های دریافت شده توسط جریان شما.
    • میزان موفقیت: درصد درخواست هایی که با موفقیت پردازش شدند.
    • تأخیر صدک 95: تأخیر صدک 95 جریان شما، که مدت زمانی است که طول می کشد تا 95 درصد درخواست ها پردازش شوند.

    • استفاده از توکن:

      • نشانه های ورودی: تعداد توکن هایی که در اعلان به مدل ارسال می شود.
      • نشانه های خروجی: تعداد نشانه های تولید شده توسط مدل در پاسخ.

    • استفاده از تصویر:

      • تصاویر ورودی: تعداد تصاویر ارسال شده به مدل در اعلان.
      • تصاویر خروجی: تعداد تصاویر تولید شده توسط مدل در پاسخ.

    اگر معیارهای ثبات را گسترش دهید، نمودارهای دقیق در دسترس هستند:

    • درخواست حجم در طول زمان.
    • میزان موفقیت در طول زمان
    • توکن های ورودی و خروجی در طول زمان
    • تأخیر (صدک 95 و 50) در طول زمان.

درباره 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 حداکثر 10000 ارزیابی را بدون هزینه ارائه می دهد.

مرحله 1: reCAPTCHA Enterprise را برای برنامه خود راه اندازی کنید

  1. بخش reCAPTCHA Enterprise کنسول Google Cloud را باز کنید.

  2. نام پروژه Firebase خود را از انتخابگر پروژه کنسول Google Cloud انتخاب کنید.

  3. اگر از شما خواسته شد که reCAPTCHA Enterprise API را فعال کنید، این کار را انجام دهید.

  4. روی شروع کلیک کنید و یک نام نمایشی برای کلید سایت reCAPTCHA خود اضافه کنید.

  5. کلید نوع پیش‌فرض Web Application را بپذیرید.

  6. روی افزودن دامنه کلیک کنید و دامنه اضافه کنید. می‌خواهید دامنه App Hosting خود (به عنوان مثال studio-- PROJECT_ID . REGION .hosted.app ) و هر دامنه سفارشی که با برنامه خود استفاده می‌کنید یا قصد استفاده از آن را دارید اضافه کنید.

  7. مرحله بعدی را کلیک کنید.

  8. ترک آیا از چالش ها استفاده می کنی؟ انتخاب نشده است.

  9. روی ایجاد کلید کلیک کنید.

  10. شناسه کلید خود را کپی و ذخیره کنید و به پیکربندی App Check بروید.

مرحله 2: App Check پیکربندی کنید

  1. کنسول Firebase را باز کنید و از منوی پیمایش روی Build > App Check کلیک کنید.

  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» را مشخص کنید و حتماً آن را دوباره بررسی کنید!)، یا مراحل Initialize App Check دنبال کنید.

  5. سایت خود را مجدداً در App Hosting منتشر کنید. سعی کنید ویژگی های Firebase خود را برای تولید برخی داده ها آزمایش کنید.

  6. با باز کردن Build > App Check App Check کنید که درخواست‌ها را در کنسول Firebase دریافت می‌کند.

  7. برای بررسی خدمات Firebase کلیک کنید. پس از تأیید دریافت درخواست‌ها، روی Enforce کلیک کنید تا App Check اجرا شود.

  8. برای Firebase Authentication تأیید و اجرای مجدد را تکرار کنید.

اگر بعد از اینکه برنامه خود را برای App Check ثبت کردید، می خواهید برنامه خود را در محیطی اجرا کنید که App Check معمولاً آن را به عنوان معتبر طبقه بندی نمی کند، مانند محلی در طول توسعه، یا از یک محیط یکپارچه سازی پیوسته (CI)، می توانید یک ساختار اشکال زدایی از برنامه خود ایجاد کنید که به جای ارائه دهنده گواهی واقعی از ارائه دهنده اشکال زدایی App Check استفاده می کند. در استفاده App Check با ارائه دهنده اشکال زدایی در برنامه های وب بیشتر بیاموزید.

مراحل بعدی