با نظارت بر عملکرد برای وب شروع کنید

قبل از اینکه شروع کنی

اگر قبلاً این کار را نکرده‌اید، برای یادگیری نحوه‌ی افزودن Firebase به پروژه‌ی جاوا اسکریپت خود، به این لینک مراجعه کنید:

  • ایجاد یک پروژه فایربیس

  • برنامه وب خود را با Firebase ثبت کنید

توجه داشته باشید که وقتی Firebase را به برنامه خود اضافه می‌کنید، ممکن است برخی از مراحل شرح داده شده در ادامه این صفحه را انجام دهید (برای مثال، اضافه کردن SDK و مقداردهی اولیه Firebase).

مرحله ۱ : افزودن و مقداردهی اولیه Performance Monitoring

  1. اگر هنوز این کار را نکرده‌اید، Firebase JS SDK را نصب کنید و Firebase را مقداردهی اولیه کنید .

  2. SDK مربوط به Performance Monitoring JS را اضافه کنید و Performance Monitoring مقداردهی اولیه کنید:

Web

import { initializeApp } from "firebase/app";
import { getPerformance } from "firebase/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = getPerformance(app);

Web

import firebase from "firebase/compat/app";
import "firebase/compat/performance";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Performance Monitoring and get a reference to the service
const perf = firebase.performance();

مرحله ۲ : اولین کتابخانه چندپر کردن تأخیر ورودی را اضافه کنید

برای اندازه‌گیری اولین معیار تأخیر ورودی ، باید کتابخانه polyfill را برای این معیار اضافه کنید. برای دستورالعمل‌های نصب، به مستندات کتابخانه مراجعه کنید.

افزودن این کتابخانه‌ی چندپرشونده برای گزارش سایر معیارهای برنامه‌ی وب Performance Monitoring الزامی نیست.

مرحله ۳ : ایجاد رویدادهای عملکردی برای نمایش اولیه داده‌ها

فایربیس زمانی که SDK را با موفقیت به برنامه خود اضافه کنید، پردازش رویدادها را آغاز می‌کند. اگر هنوز در حال توسعه محلی هستید، با برنامه خود تعامل داشته باشید تا رویدادهایی را برای جمع‌آوری و پردازش اولیه داده‌ها ایجاد کنید.

  1. برنامه وب خود را در یک محیط محلی ارائه و مشاهده کنید.

  2. با بارگذاری زیرصفحات سایت خود، تعامل با برنامه خود و/یا ایجاد درخواست‌های شبکه، رویدادها را ایجاد کنید. مطمئن شوید که تب مرورگر را حداقل 10 ثانیه پس از بارگذاری صفحه باز نگه دارید.

  3. به داشبورد Performance کنسول Firebase بروید. باید نمایش اولیه داده‌های خود را ظرف چند دقیقه مشاهده کنید.

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

مرحله ۴ : (اختیاری) مشاهده پیام‌های گزارش رویدادهای عملکردی

  1. ابزارهای توسعه‌دهنده مرورگر خود را باز کنید (برای مثال، تب Network برای Chrome Dev Tools یا در Network Monitor برای Firefox ).

  2. برنامه وب خود را در مرورگر رفرش کنید.

  3. پیام‌های لاگ خود را برای هرگونه پیام خطا بررسی کنید.

  4. بعد از چند ثانیه، در ابزارهای توسعه‌دهندگان مرورگر خود، به دنبال فراخوانی شبکه‌ای به آدرس firebaselogging.googleapis.com بگردید. وجود این فراخوانی شبکه نشان می‌دهد که مرورگر در حال ارسال داده‌های عملکرد به Firebase است.

اگر برنامه شما رویدادهای عملکرد را ثبت نمی‌کند، نکات عیب‌یابی را مرور کنید.

مرحله ۵ : (اختیاری) افزودن مانیتورینگ سفارشی برای کد خاص

برای نظارت بر داده‌های عملکرد مرتبط با کد خاص در برنامه خود، می‌توانید ردیابی‌های کد سفارشی را ابزار دقیق کنید.

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

در کد خود، ابتدا و انتهای یک ردیابی کد سفارشی را تعریف می‌کنید (و هر معیار سفارشی دلخواه را اضافه می‌کنید) با استفاده از API ارائه شده توسط Performance Monitoring SDK.

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

مرحله ۶ : برنامه خود را مستقر کنید و سپس نتایج را بررسی کنید

پس از تأیید Performance Monitoring ، می‌توانید نسخه به‌روز شده برنامه خود را برای کاربرانتان مستقر کنید.

شما می‌توانید داده‌های عملکرد را در داشبورد Performance کنسول Firebase نظارت کنید.

مراحل بعدی