در تب داشبورد ، می‌توانید توابع Firebase Extensions را مشاهده کنید (در کنار سایر عملکردهایی که برای پروژه خود به کار گرفته‌اید).
توابع ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند: ext-extension-instance-id-functionName
به عنوان مثال: ext-awesome-task-simplifier-onUserCreate
مشاهده مشاغل Cloud Scheduler ایجاد شده توسط برنامه های افزودنی
صفحه Cloud Scheduler پروژه خود را در کنسول Google Cloud باز کنید.
در لیست مشاغل، می توانید کارهای Cloud Scheduler را از Firebase Extensions (در کنار هر شغل دیگری که برای پروژه خود ایجاد کرده اید) مشاهده کنید.
مشاغل ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند: firebase-ext-extension-instance-id-functionName
به عنوان مثال: firebase-ext-awesome-task-simplifier-doTask
مشاهده و مدیریت وظایف Cloud که توسط برنامه‌های افزودنی در صف قرار گرفته‌اند
برخی از برنامه‌های افزودنی از Cloud Tasks برای اجرای کارهای طولانی‌تر استفاده می‌کنند: معمولاً پردازش وظایفی که در نقاط مختلف چرخه عمر برنامه‌های افزودنی اجرا می‌شوند - نصب، پیکربندی مجدد و پس از ارتقا.
به طور معمول، این وظایف بدون دخالت شما به طور خودکار اجرا و تکمیل می شوند. با این حال، اگر زمانی نیاز به مدیریت دستی وظایف در صف یک برنامه افزودنی داشتید - برای مثال، برای توقف صف یا حذف کاری که هنوز شروع نشده است از صف، مراحل زیر را دنبال کنید:
در بخش افزونه‌های کنسول Firebase ، صفحه جزئیات نمونه برنامه افزودنی را باز کنید.
در صفحه جزئیات، بخش API ها و منابع را باز کنید. اگر برنامه افزودنی از Cloud Tasks استفاده کند، یک بخش Cloud Task queues با یک یا چند ورودی وجود خواهد داشت.
برای صفی که می‌خواهید مدیریت کنید، روی View queue کلیک کنید. با این کار صفحه Queue Details در کنسول Google Cloud باز می شود که می توانید وظایف در صف را مشاهده کنید، صف را متوقف کنید، وظایف را از صف حذف کنید و غیره. به مدیریت صف‌ها و وظایف در اسناد Cloud Tasks مراجعه کنید.
یک نمونه جدید از برنامه افزودنی نصب کنید.
فقط پس از نصب نمونه جدید، نمونه قدیمی را حذف نصب کنید.
مشاهده اسرار Cloud Secret Manager ایجاد شده توسط برنامه های افزودنی
صفحه مدیر مخفی پروژه خود را در کنسول Google Cloud باز کنید.
در لیست Secrets، می توانید اسرار ایجاد شده برای Firebase Extensions را مشاهده کنید (در کنار هر اسرار دیگری که برای پروژه خود ایجاد کرده اید).
اسرار ایجاد شده توسط برنامه های افزودنی دارای نام هایی با فرمت هستند: ext-extension-instance-id-paramnName
به عنوان مثال: ext-awesome-task-simplifier-API_KEY
اسرار با کلید firebase-extensions-managed برچسب گذاری می شوند. این برچسب را حذف نکنید مگر اینکه بخواهید Firebase را از مدیریت راز منع کنید.
بررسی کنید که آیا افزونه نصب شده سالم است یا خیر
می‌توانید تمام خطاهای توابع (از جمله موارد ایجاد شده توسط Firebase Extensions ) را در کنسول بررسی کنید.
در برگه سلامتداشبورد توابع خود، می‌توانید یک نمای کلی از خطاها و اطلاعات عملکرد برای همه عملکردهای پروژه خود را مشاهده کنید.
برای مشاهده اطلاعات یک برنامه افزودنی خاص، از فیلتر بالای صفحه برای انتخاب یک عملکرد خاص استفاده کنید.
بررسی کنید که یک برنامه افزودنی نصب شده چند بار در حال اجرا است
در برگه داشبورد داشبوردتوابع ، تابع خاصی را برای Firebase Extension که می‌خواهید بررسی کنید، پیدا کنید.
روی more_vert (منوی سرریز) در سمت راست انتهای ورودی کلیک کنید، سپس آمار استفاده دقیق را انتخاب کنید.
در کنسول Google Cloud نمایش داده شده، می توانید فراخوانی های مختلف یک تابع را بررسی کنید و حتی کد منبع آن را بررسی کنید.
گزارش‌های یک برنامه افزودنی را مشاهده کنید
اگر می‌خواهید پروژه خود را اشکال‌زدایی کنید، یا یک گزارش اشکال را به Firebase ارسال کنید، مشاهده گزارش‌های عملکردهای در حال اجرا در پروژه شما مفید است.
در برگه گزارشهایداشبورد توابع ، از فیلتر بالای صفحه برای انتخاب عملکردهای ایجاد شده توسط برنامه افزودنی خود استفاده کنید.
یک نمونه برنامه افزودنی نصب شده را به آخرین نسخه به روز کنید
می توانید یک نمونه نصب شده از یک برنامه افزودنی را به آخرین نسخه منتشر شده آن به روز کنید. ممکن است بخواهید یک نمونه نصب شده را به روز کنید زیرا نمونه قبلاً به طور فعال در جریان آزمایش، پروژه یا برنامه شما در حال اجرا یا تنظیم است.
هنگامی که یک نمونه را به روز می کنید، تمام منابع و منطق برنامه افزودنی خاص برای استفاده از کد منبع و فایل های نسخه جدید بازنویسی می شود. شناسه نمونه برنامه افزودنی و حساب سرویس تغییر نخواهد کرد.
در طول فرآیند به‌روزرسانی، هر گونه تغییر در نسخه جدید به شما اطلاع داده می‌شود و می‌توانید مقادیری را برای هر پارامتر جدید مشخص کنید.
در گوشه بالا سمت راست، روی به‌روزرسانی افزونه کلیک کنید.
اگر برنامه افزودنی نسخه جدید موجود نداشته باشد، صفحه جزئیات دکمه به‌روزرسانی نخواهد داشت.
موارد جدید در به روز رسانی را مرور کنید و برنامه افزودنی را (در صورت نیاز) پیکربندی کنید.
روی Update extension کلیک کنید.
یک نمونه برنامه افزودنی نصب شده را دوباره پیکربندی کنید
می توانید مقادیر پارامترهای پیکربندی شده توسط کاربر را برای یک نمونه برنامه افزودنی نصب شده تغییر دهید. این مقادیر جدید در هر محرک بعدی نمونه استفاده خواهد شد، اما تمام مصنوعات قبلی یا عناصر ساختاری ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده یا سطل های ذخیره سازی موجود) تغییر نخواهند کرد.
در گوشه بالا سمت راست، روی پیکربندی مجدد افزونه کلیک کنید.
دستورالعمل های روی صفحه را برای پیکربندی مجدد مقادیر پارامتر برای برنامه افزودنی خود دنبال کنید.
روی ذخیره کلیک کنید.
یک نمونه برنامه افزودنی را حذف نصب کنید
می توانید نمونه ای از یک برنامه افزودنی را از پروژه Firebase خود حذف نصب کنید. این اقدام حساب سرویس و همه منابع (مانند مجموعه ای از توابع) را که Firebase به طور خاص برای آن نمونه از برنامه افزودنی ایجاد کرده است، حذف می کند. اما موارد زیر حذف نمی شوند:
هر مصنوع ایجاد شده توسط افزونه (مانند تصاویر ذخیره شده).
هر منبع دیگری در پروژه شما، مانند نمونه پایگاه داده یا سطل Cloud Storage . حتی اگر برنامه افزودنی با این منابع دیگر تعامل داشته باشد، آنها خاص برنامه افزودنی نیستند، بنابراین اگر برنامه افزودنی حذف نصب شود، حذف نمی شوند.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\nTo install or manage extensions, you must be assigned one of these roles:\n[Owner or Editor](/docs/projects/iam/roles-basic) or\n[Firebase Admin](/docs/projects/iam/roles-predefined-all-products). \nFirebase console Firebase CLI Autogenerated SDK \n\n\u003cbr /\u003e\n\nList a project's installed extension instances\n\nYou can list every instance of the extensions you installed.\n\nRun the extensions-list command: \n\n```\nfirebase ext:list --project=projectId-or-alias\n```\n\nView details and configuration of an installed extension instance\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/) in the Firebase console.\n\n2. On the installed extension instance's card, click **Manage**.\n\nMonitor an installed extension instance\n\nIn the Firebase console, you can monitor the activity of an installed\nextension, including checks on its health, usage, and logs.\n\nSet budget alerts\n\nSetting budget alerts is a good practice in general, but alerts may be\nespecially important when you're trusting another party's code to run in your\nproject.\n\nMake sure that you set up\n[budget alerts](/docs/projects/billing/avoid-surprise-bills#set-up-budget-alert-emails)\nfor your Firebase project.\n\nView functions created by extensions\n\n1. Go to your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list) of the Firebase console.\n\n2. In the *Dashboard* tab, you can view the functions from\n Firebase Extensions (alongside any other functions that you've deployed\n for your project).\n\n Functions created by extensions have names, in the format:\n **ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003efunctionName\u003c/var\u003e\n\n For example: `ext-awesome-task-simplifier-onUserCreate`\n\nView Cloud Scheduler jobs created by extensions\n\n1. Open your project's [Cloud Scheduler](https://console.cloud.google.com/cloudscheduler?project=_) page\n in the Google Cloud console.\n\n2. In the Jobs list, you can view the Cloud Scheduler jobs from\n Firebase Extensions (alongside any other jobs you've created for your\n project).\n\n Jobs created by extensions have names in the format:\n **firebase-ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003efunctionName\u003c/var\u003e\n\n For example: `firebase-ext-awesome-task-simplifier-doTask`\n\nView and manage Cloud Tasks enqueued by extensions\n\nSome extensions use [Cloud Tasks](https://cloud.google.com/tasks/docs/)\nto run longer-running tasks: most commonly, processing tasks that run at various\npoints in an extension's lifecycle---installation, reconfiguration, and\nafter upgrades.\n\nNormally, these tasks run and complete automatically, without your intervention.\nHowever, if you ever need to manually manage an extension's queued\ntasks---for example, to pause the queue or remove from the queue a task that\nhasn't started yet---follow these steps:\n\n1. In the Firebase console [Extensions](//console.firebase.google.com/project/_/extensions)\n section, open the extension instance's details page.\n\n2. On the details page, open the **APIs and resources** section. If the\n extension uses Cloud Tasks, there will be a **Cloud Task queues** section\n with one or more entries.\n\n3. Click **View queue** for the queue you want to manage. This will open the\n Queue Details page in the Google Cloud console, from which you can view\n queued tasks, pause the queue, remove tasks from the queue, and so on. See\n [Manage queues and tasks](https://cloud.google.com/tasks/docs/deleting-appengine-queues-and-tasks)\n in the Cloud Tasks documentation.\n\n | **Note:** You can pause a queue, but if you leave it paused for too long, tasks might fail with authentication errors when you resume the queue. (Task authentication expires an hour after it joins the queue.)\n\n \u003cbr /\u003e\n\n | **Warning:** Don't delete the queue; the extension needs it to operate. If you accidentally delete the queue, you'll have to do the following:\n |\n | \u003cbr /\u003e\n |\n | 1. Install a new instance of the extension.\n | 2. Only after installing the new instance, uninstall the old instance.\n\nView Cloud Secret Manager secrets created by extensions\n\n1. Open your project's [Secret Manager](https://console.cloud.google.com/security/secret-manager?project=_) page\n in the Google Cloud console.\n\n2. In the Secrets list, you can view the secrets created for\n Firebase Extensions (alongside any other secrets you've created for your\n project).\n\n Secrets created by extensions have names in the format:\n **ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003eparamnName\u003c/var\u003e\n\n For example: `ext-awesome-task-simplifier-API_KEY`\n\n Secrets are labeled with the key `firebase-extensions-managed`. Don't remove\n this label unless you want to stop Firebase from managing the secret.\n\nCheck if an installed extension is healthy\n\nYou can review all the errors from functions (including those created by\nFirebase Extensions) in the console.\n\n1. In the *Health* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list), you can\n view an overview of errors and performance information for all functions in\n your project.\n\n2. To view information for a specific extension, use the filter at the top of\n the page to select a specific function.\n\nCheck how often an installed extension is running\n\n1. In the *Dashboard* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list),\n locate the specific function for the Firebase Extension that\n you want to check.\n\n2. Click more_vert (the overflow menu) on\n the far right-side of the entry, then select **Detailed usage stats**.\n\n3. In the displayed Google Cloud console, you can drill down into various\n invocations of a function and even inspect its source code.\n\nView the logs for an extension\n\nIf you're trying to debug your project, or submit a bug report to Firebase, it's\nuseful to view logs of the functions running in your project.\n\nIn the *Logs* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list), use the filter at the\ntop of the page to select the functions created by your extension.\n\nUpdate an installed extension instance to the latest version\n\nYou can update an installed instance of an extension to its latest released\nversion. You might want to update an installed instance because the instance is\nalready actively running or set up in your testing, project, or app workflow.\n| **Note:** If you installed an extension using an auto-generated SDK, use the same method to upgrade it, and not the console or CLI.\n\nWhen you update an instance, all the instance's extension-specific resources and\nlogic is overwritten to use the new version's source code and files. The\nextension's instance ID and service account will not change.\n\nDuring the update process, you'll be notified of any changes for the new\nversion, and you'll be able to specify values for any new parameters.\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed\n extension instance's card, click **Manage**.\n\n2. In the upper-right corner, click **Update extension**.\n\n If the extension doesn't have an available new version, the details page\n won't have an update button.\n3. Review what's new in the update and configure the extension (if needed).\n\n4. Click **Update extension**.\n\nReconfigure an installed extension instance\n\nYou can change the values of the user-configured parameters for an installed\nextension instance. These new values will be used in any *future* triggers of the\ninstance, but all previous artifacts or structural elements created by the\nextension (like stored images or existing storage buckets) will not be changed.\n| **Note:** If you installed an extension using an auto-generated SDK, use the same method to reconfigure it, and not the console or CLI.\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed extension\n instance's card, click **Manage**.\n\n2. In the upper-right corner, click **Reconfigure extension**.\n\n3. Follow the on-screen instructions to reconfigure the parameter values\n for your extension.\n\n4. Click **Save**.\n\n| **Note:** Saving changes for an extension may take the system 3-5 minutes.\n\nUninstall an extension instance\n\nYou can uninstall an instance of an extension from your Firebase project. This action deletes\nthe\n[service account](/docs/extensions/permissions-granted-to-extension#uninstall-extension)\nand all the [resources](/docs/extensions/overview-use-extensions#resources)\n(like a set of functions) that Firebase created specifically for that instance\nof the extension. However, the following are ***not*** deleted:\n\n- Any artifacts created by the extension (like stored images).\n\n- Any other resources in your project, like a database instance or Cloud Storage\n bucket. Even if the extension interacted with these other resources, they\n are not *extension-specific*, so they aren't deleted if the extension is\n uninstalled.\n\nHere's how to uninstall an extension:\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed extension\n instance's card, click **Manage**.\n\n2. At the bottom of the screen, click **Uninstall extension**.\n\n3. Review what will be deleted, then click **Uninstall extension** to confirm\n the deletion.\n\n| **Note:** If you installed the extension using the autogenerated SDK, be sure to also remove the instance configuration from your Cloud Functions code."]]
