작업 목록에서 Firebase Extensions의 Cloud Scheduler 작업은 물론 프로젝트용으로 만든 다른 작업도 볼 수 있습니다.
확장 프로그램에서 생성한 작업에는 firebase-ext-extension-instance-id-functionName 형식의 이름이 지정됩니다.
예: firebase-ext-awesome-task-simplifier-doTask
확장 프로그램에서 큐에 추가된 Cloud Tasks 보기 및 관리
일부 확장 프로그램은 Cloud Tasks를 사용하여 장기 실행 태스크를 실행합니다. 일반적으로 확장 프로그램의 수명 주기 중 여러 단계(설치, 재구성, 업그레이드 후)에서 실행되는 태스크를 처리합니다.
일반적으로 이러한 태스크는 사용자 개입 없이 자동으로 실행 및 완료됩니다.
그러나 확장 프로그램의 큐에 추가된 태스크를 수동으로 관리해야 하는 경우(예: 큐를 일시중지하거나 아직 시작되지 않은 태스크를 큐에서 제거) 다음 단계를 따르세요.
Firebase 콘솔 확장 프로그램 섹션에서 확장 프로그램 인스턴스의 세부정보 페이지를 엽니다.
세부정보 페이지에서 API 및 리소스 섹션을 엽니다. 확장 프로그램에서 Cloud Tasks를 사용하는 경우 하나 이상의 항목이 포함된 Cloud 태스크 큐 섹션이 존재합니다.
관리할 큐의 큐 보기를 클릭합니다. 그러면 Google Cloud 콘솔에서 큐 세부정보 페이지가 열리며 이 페이지에서 큐에 추가된 태스크를 보고 큐를 일시중지하고 큐에서 태스크를 삭제하는 등의 작업을 수행할 수 있습니다. Cloud Tasks 문서의 큐 및 태스크 관리를 참조하세요.
[null,null,["최종 업데이트: 2025-08-14(UTC)"],[],[],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."]]
