拡張機能をインストールまたは管理するには、所有者、編集者、またはFirebase 管理者 のいずれかの役割が割り当てられている必要があります。
インストールされている拡張インスタンスの詳細と構成を表示する
Firebase コンソールでFirebase Extensions ダッシュボードに移動します。
インストールされた拡張機能インスタンスのカードで、[管理] をクリックします。
インストールされた拡張インスタンスを監視する
Firebase コンソールでは、正常性、使用状況、ログのチェックなど、インストールされた拡張機能のアクティビティを監視できます。
予算アラートを設定する
一般に、予算アラートを設定することは良い方法ですが、別のパーティのコードがプロジェクトで実行されることを信頼している場合は、アラートが特に重要になる場合があります。
Firebase プロジェクトの予算アラートを設定していることを確認してください。
拡張機能によって作成されたビュー関数
Firebase コンソールのFunctions ダッシュボードに移動します。
[ダッシュボード] タブでは、Firebase Extensions の関数を (プロジェクトにデプロイした他の関数と共に) 表示できます。
拡張機能によって作成された関数には、
ext- extension-instance-id - functionName
の形式の名前があります。例:
ext-awesome-task-simplifier-onUserCreate
拡張機能によって作成された Cloud Scheduler ジョブを表示する
Google Cloud Console でプロジェクトのCloud Schedulerページを開きます。
[ジョブ] リストでは、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 Task キューセクションに 1 つ以上のエントリが表示されます。
管理するキューの[キューを表示]をクリックします。これにより、Google Cloud Console の [キューの詳細] ページが開きます。ここから、キューに入れられたタスクを表示したり、キューを一時停止したり、キューからタスクを削除したりできます。 Cloud Tasks ドキュメントのキューとタスクの管理をご覧ください。
- 拡張機能の新しいインスタンスをインストールします。
- 新しいインスタンスをインストールした後でのみ、古いインスタンスをアンインストールします。
拡張機能によって作成された Cloud Secret Manager シークレットを表示する
Google Cloud Console でプロジェクトのSecret Managerページを開きます。
シークレット リストでは、Firebase 拡張機能用に作成されたシークレットを (プロジェクト用に作成した他のシークレットと一緒に) 表示できます。
拡張機能によって作成されたシークレットには、次の形式の名前があります:
ext- extension-instance-id - paramnName
例:
ext-awesome-task-simplifier-API_KEY
シークレットはキー
firebase-extensions-managed
でラベル付けされます。 Firebase によるシークレットの管理を停止する場合を除き、このラベルを削除しないでください。
インストールされた拡張機能が正常かどうかを確認する
コンソールで関数 (Firebase Extensions によって作成されたものを含む) からのすべてのエラーを確認できます。
Functions ダッシュボードの [ Health ] タブでは、プロジェクト内のすべての関数のエラーの概要とパフォーマンス情報を表示できます。
特定の拡張機能の情報を表示するには、ページ上部のフィルターを使用して特定の機能を選択します。
インストールされた拡張機能が実行されている頻度を確認する
Functions ダッシュボード の [ダッシュボード] タブで、確認する Firebase 拡張機能の特定の関数を見つけます。
エントリの右端にある [
] (オーバーフロー メニュー) をクリックし、[詳細な使用統計] を選択します。表示された Google Cloud Console では、関数のさまざまな呼び出しにドリルダウンし、そのソース コードを調べることさえできます。
拡張機能のログを表示する
プロジェクトをデバッグしようとしている場合、または Firebase にバグ レポートを送信しようとしている場合は、プロジェクトで実行されている関数のログを表示すると便利です。
関数ダッシュボードの [ログ] タブで、ページの上部にあるフィルターを使用して、拡張機能によって作成された関数を選択します。
インストールされている拡張インスタンスを最新バージョンに更新する
拡張機能のインストール済みインスタンスを最新リリース バージョンに更新できます。インスタンスが既にアクティブに実行されているか、テスト、プロジェクト、またはアプリのワークフローでセットアップされているため、インストール済みのインスタンスを更新する必要がある場合があります。
インスタンスを更新すると、インスタンスのすべての拡張機能固有のリソースとロジックが上書きされ、新しいバージョンのソース コードとファイルが使用されます。拡張機能のインスタンス ID とサービス アカウントは変更されません。
更新プロセス中に、新しいバージョンの変更が通知され、新しいパラメーターの値を指定できるようになります。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードで [管理] をクリックします。
右上隅にある [拡張機能を更新] をクリックします。
拡張機能に利用可能な新しいバージョンがない場合、詳細ページには更新ボタンが表示されません。
更新の新機能を確認し、拡張機能を構成します (必要な場合)。
[拡張機能を更新] をクリックします。
インストールされた拡張インスタンスを再構成する
インストールされた拡張インスタンスのユーザー構成パラメーターの値を変更できます。これらの新しい値は、インスタンスの将来のトリガーで使用されますが、拡張機能によって作成された以前のアーティファクトまたは構造要素 (保存された画像や既存のストレージ バケットなど) はすべて変更されません。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードで [管理] をクリックします。
右上隅にある [拡張機能の再構成] をクリックします。
画面の指示に従って、拡張機能のパラメーター値を再構成します。
[保存]をクリックします。
拡張インスタンスをアンインストールする
Firebase プロジェクトから拡張機能のインスタンスをアンインストールできます。このアクションにより、Firebase がその拡張機能のインスタンス専用に作成したサービス アカウントとすべてのリソース(一連の関数など) が削除されます。ただし、次のものは削除されません。
拡張機能によって作成されたアーティファクト (保存された画像など)。
データベース インスタンスや Cloud Storage バケットなど、プロジェクト内のその他のリソース。拡張機能がこれらの他のリソースとやり取りした場合でも、それらは拡張機能固有のものではないため、拡張機能がアンインストールされても削除されません。
拡張機能をアンインストールする方法は次のとおりです。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードで [管理] をクリックします。
画面の下部にある [拡張機能のアンインストール] をクリックします。
削除される内容を確認し、[拡張機能のアンインストール] をクリックして削除を確認します。