في علامة التبويب لوحة البيانات، يمكنك الاطّلاع على الدوال من
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 Tasks التي أضافتها الإضافات إلى قائمة الانتظار
تستخدم بعض الإضافات مهام السحابة الإلكترونية لتنفيذ مهام تستغرق وقتًا أطول، وأكثرها شيوعًا هي مهام المعالجة التي يتم تنفيذها في نقاط مختلفة من دورة حياة الإضافة، مثل التثبيت وإعادة الضبط وبعد عمليات الترقية.
عادةً، يتم تنفيذ هذه المهام وإكمالها تلقائيًا بدون تدخّلك.
ومع ذلك، إذا احتجت في أي وقت إلى إدارة المهام المدرَجة في قائمة الانتظار لإحدى الإضافات يدويًا، مثلاً لإيقاف قائمة الانتظار مؤقتًا أو إزالة مهمة لم تبدأ بعد من قائمة الانتظار، اتّبِع الخطوات التالية:
في قسم Firebase console الإضافات، افتح صفحة تفاصيل مثيل الإضافة.
في صفحة التفاصيل، افتح قسم واجهات برمجة التطبيقات والمراجع. إذا كان الامتداد يستخدم Cloud Tasks، سيظهر قسم قوائم انتظار Cloud Tasks يتضمّن إدخالاً واحدًا أو أكثر.
انقر على عرض قائمة الانتظار لقائمة الانتظار التي تريد إدارتها. سيؤدي ذلك إلى فتح صفحة "تفاصيل قائمة الانتظار" في وحدة تحكّم Google Cloud، حيث يمكنك عرض المهام في قائمة الانتظار وإيقافها مؤقتًا وإزالة المهام منها وغير ذلك. راجِع مقالة
إدارة قوائم الانتظار والمهام
في مستندات Cloud Tasks.
عرض أسرار Cloud Secret Manager التي أنشأتها الإضافات
افتح صفحة Secret Manager الخاصة بمشروعك
في وحدة تحكّم Google Cloud.
في قائمة "البيانات السرية"، يمكنك الاطّلاع على البيانات السرية التي تم إنشاؤها لـ 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، من المفيد عرض سجلّات الدوال التي يتم تنفيذها في مشروعك.
في علامة التبويب السجلات ضمن لوحة بيانات الدوال، استخدِم الفلتر في أعلى الصفحة لاختيار الدوال التي أنشأتها الإضافة.
تحديث نسخة مثبَّتة من إضافة إلى أحدث إصدار
يمكنك تحديث نسخة مثبَّتة من إضافة إلى أحدث إصدار تم طرحه. قد تحتاج إلى تعديل نسخة مثبَّتة لأنّها قيد التشغيل حاليًا أو تم إعدادها في سير عمل الاختبار أو المشروع أو التطبيق.
عند تعديل إحدى الآلات الافتراضية، تتم الكتابة فوق جميع الموارد والمنطق الخاصين بالإضافة في الآلة الافتراضية لاستخدام رمز المصدر والملفات الخاصة بالإصدار الجديد. لن يتغيّر رقم تعريف النسخة الافتراضية لحساب الخدمة الخاص بالإضافة.
أثناء عملية التعديل، سيتم إعلامك بأي تغييرات في الإصدار الجديد، وستتمكّن من تحديد قيم لأي معلّمات جديدة.
إذا لم يتوفّر إصدار جديد من الإضافة، لن يتضمّن صفحة التفاصيل زر تحديث.
راجِع الميزات الجديدة في التحديث واضبط إعدادات الإضافة (إذا لزم الأمر).
انقر على تعديل الإضافة.
إعادة ضبط إعدادات مثيل إضافة مثبَّتة
يمكنك تغيير قيم المَعلمات التي يضبطها المستخدم لنسخة مثبَّتة من الإضافة. سيتم استخدام هذه القيم الجديدة في أي مشغّلات مستقبلية للنسخة، ولكن لن يتم تغيير أي عناصر سابقة أو عناصر هيكلية أنشأتها الإضافة (مثل الصور المخزّنة أو حِزم التخزين الحالية).
في أعلى يسار الصفحة، انقر على إعادة ضبط إعدادات الإضافة.
اتّبِع التعليمات الظاهرة على الشاشة لإعادة ضبط قيم المَعلمات الخاصة بالإضافة.
انقر على حفظ.
إلغاء تثبيت مثيل إضافة
يمكنك إلغاء تثبيت نسخة من إضافة من مشروعك على 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."]]
