Panelアプリの使用

公開済みのアプリはすべてマイPanelアプリ画面に表示され、ランタイム、ステータス、スラッグ、タイムスタンプを確認できます。左端の列からアプリを開きます。残りの行アイコンでは、誤った変更を防ぐためのアプリのロック、編集、削除ができます。サーバーアプリでは、再ビルド、ログの表示、使用状況メトリックの表示も行えます。開くアイコンはアプリのランタイムに応じて変わるため、WASMアプリとサーバーアプリを一目で見分けられます。

ビルドステータス（サーバーアプリ）

サーバーアプリのステータス列にはビルドの状況が表示され、ビルドの進行中は一覧が自動的に更新されます。

• ビルド中… — PlaidCloudがリポジトリをコンテナーにビルドしています。アプリのURLはまだありません。
• 準備完了 — ビルドが成功しました。アプリのURLが有効になり、その行に開くアイコンが表示されます。
• 失敗 — ビルドが完了しませんでした。エントリポイントとブランチを確認し、アプリを編集して再公開してください。

WASMアプリにはビルド手順がなく、公開するとすぐに利用できます。

サーバーアプリの再ビルド

サーバーアプリの行にある再ビルドアイコンをクリックすると、設定を変更せずに再ビルドして再デプロイします。PlaidCloudが同じブランチとエントリポイントをもう一度ビルドする間、アプリのステータスはビルド中… に戻り、新しいビルドが有効になると準備完了に戻ります。

依存関係の変更、ベースイメージの更新、一時的なビルドの失敗の後には再ビルドを使用します。サーバーアプリを編集して保存した場合も再ビルドされますが、再ビルドでは編集フォームを開く必要はありません。

App Runnerアプリ（変換されたAlteryxアプリ用に生成される入力フォーム）では、再ビルドと編集の保存のどちらでも、まず生成ファイルを現在のApp Runnerバージョンに更新してからビルドします。PlaidCloud自体が更新されるときにも、ロックされていないすべてのApp Runnerアプリに対して同じ処理が行われます。ロックされているアプリは、ロックを解除した後に再ビルドが必要です。

アプリのロック

アプリの行にあるロックアイコンをクリックすると、誤った変更からアプリを保護できます。アプリがロックされている間は、次のようになります。

• 編集、削除、再ビルドは実行されず、アプリがロックされていることが通知されます。
• サーバーアプリのブランチへのプッシュでは再ビルドされません。ロックを解除するまで自動再ビルドはスキップされます。スキップされたプッシュに対してビルドは実行されないため、アプリのビルドログには何も追加されません。ロックを解除した後に、もう一度プッシュするか再ビルドを使用して変更を反映してください。
• アプリを開く、ログを表示する、使用状況メトリックを表示するといった操作は引き続き行えます。ロックが止めるのは変更だけで、閲覧は止めません。

もう一度アイコンをクリックするとロックが解除されます。アイコンはアプリの現在の状態を示し、ロック中は閉じた状態、ロックされていないときは開いた状態で表示されます。

ロックは、ワークフローやワークフローのステップのロックと同様、誤編集、意図しない削除、デモ中のアプリへのGitプッシュといった事故を防ぐためのものです。セキュリティ制御ではありません。Panelアプリを編集できるユーザーであれば、ロックを解除することもできます。

ロックの対象外となるものが2つあります。ロックした時点ですでに進行中のビルドは最後まで完了して有効になります。また、WASMアプリのファイルはそのドキュメントアカウントにあるため、それらのファイルを置き換えると、ロックされたレコードには触れずに実行中のアプリが変更されます。

アプリを開く

準備完了のアプリの行の先頭にある開くアイコンをクリックすると、新しいタブでアプリが起動します。

• サーバーアプリは https://<your-tenant-host>/serve/<slug>/ で提供されます。
• 開くアイコンは、サーバーアプリが準備完了になってから表示されます。

サーバーアプリはアイドル時にリソースを節約するためゼロにスケールダウンするため、アイドル状態が続いた後の最初のアクセスでは起動が必要です。その間は、空白のタブではなく、アプリ名、進行状況インジケーター、ワークスペースの詳細を表示するPlaidCloudの読み込み画面が表示されます。アプリの準備ができると自動的に表示され（通常は数秒、コールドスタート時は最大1分程度）、次にアイドル状態になるまで通常どおり応答します。

アプリを起動できない場合、読み込み画面は延々と回り続ける代わりに、再試行ボタン付きの 「このアプリは起動しませんでした」 というメッセージに切り替わります。これが続く場合は、アプリを編集してエントリポイントとブランチを確認し、再公開するか、PlaidCloud管理者に連絡してください。

外観

サーバーPanelアプリは、デフォルトでPlaidCloudの新しいFASTデザインを使用します。既存のCSSが依存している場合は、アプリのデザイン設定でPanelのデフォルトスタイルに戻すことができます。テーマ（ライト、ダーク、または閲覧者が切り替えられるライト/ダーク切り替え）は、アプリのテンプレートで設定します。パターンについては、作成ガイドのテーマの設定を参照してください。アプリのテーブルやカスタムスタイルが明るい背景を前提に作られている場合は、ライトに固定してください。

ログの表示（サーバーアプリ）

サーバーアプリの行にあるログを表示アイコンをクリックすると、ログビューアーが開きます。（WASMアプリはブラウザー内だけで動作しサーバーログがないため、このアイコンはサーバーアプリの行にのみ表示されます。）

ビューアーには2つのタブがあります。

• ランタイム（最初に表示）— 実行中のアプリ自身の出力です。アプリがログに記録した内容、出力した内容、捕捉されなかったエラーが含まれます。アプリがゼロにスケールダウンした後も保持されるため、以前のセッションで何が起きたかを確認できます。
• ビルド — アプリのコンテナーをビルドしたときの出力です。ビルドが失敗と表示される理由（たとえば、インストールできなかった依存関係）を確認するのに使用します。

各タブには、情報 / 警告 / エラーフィルター、ログの開始時点の時間範囲（直近1時間から30日、またはすべて）、更新ボタン、新しいエントリをポーリングする自動更新があります。稼働中のアプリや進行中のビルドを見守るときに便利です。最新のエントリが先頭に表示されます。

ビルド出力を取得できなかった場合、ビルドタブは空のまま表示されるのではなく、その理由を説明する短いメモを表示します。

ログメッセージ全文の確認

ログテーブルでは、一覧を読みやすくするため長い行が省略されます。ログの行を選択すると、テーブルの横に詳細ペインが開き、そのエントリのメッセージ全文が表示されます。長いエラーメッセージや完全なスタックトレースなど、テーブルに収まらない内容も、途中で切れることなく簡単に読めます。

ログ行のコピー

複数のログ行を同時に選択し、コピーをクリックしてクリップボードに入れることができます。アプリのデバッグ中にAIアシスタントとのチャットへログを貼り付けたり、チームやPlaidCloudサポートへのメッセージに貼り付けたりするときに便利です。

ログ行の発生元ユーザー

アプリが閲覧者のサインインを行う場合、各ログ行にはそのセッションで発生したユーザーのタグが付くため、どの閲覧者が特定のエラーや警告に遭遇したかを確認できます。タグ付けはベストエフォートです。フレームワークや起動時の行など、閲覧者が関与する前に実行されるものにはユーザーが表示されないことがあります。

使用状況メトリック（サーバーアプリ）

サーバーアプリの行にある使用状況メトリックアイコン（ログを表示の隣）をクリックすると、アプリの利用状況を確認できます。ビューには次の内容がまとめて表示されます。

• ユニークユーザー — アプリを開いた個別のユーザー数。
• セッション — アプリが開かれた回数。
• 平均セッション時間と中央値のセッション時間 — 1回の訪問がおおよそどのくらい続くか。
• 最終使用 — アプリが最後に開かれた日時。

サマリーの下にはユーザー別と日別の内訳が表示され、誰がアプリを使っているか、利用状況が時間とともにどう推移しているかを確認できます。

時間はおおよその値です。サーバーアプリは誰も使っていないとアイドル状態になってスケールダウンするため、セッションの正確な終了時刻が必ずしも観測されるとは限りません。時間の数値は正確な計測値ではなく、目安としてお読みください。

アプリの編集

アプリの行にある鉛筆アイコンをクリックして編集します。編集フォームはアプリのランタイムに合わせたものになります。

サーバーアプリでは、名前、スラッグ、ブランチ、エントリポイント、CPU、メモリ、デザイン、アイドル時間、公開フラグ、埋め込み提供用のドメイン、メモを変更できます。Git接続はアプリの作成後は固定され、読み取り専用で表示されます。保存するとアプリが再ビルドされ、新しいビルドの準備ができるまでステータスはビルド中… に戻ります。

アプリの削除

アプリの行にあるマイナスアイコンをクリックして確認します。アプリの削除や非公開は、必ず先に確認が求められます。サーバーアプリを削除すると、そのビルドとデプロイが解体されます。WASMアプリを削除すると、静的ファイルが非公開になります。アプリのURLはただちに無効になります。

MCPツール panel_deployment_manage では、非公開の操作は提供されなくなりました。アプリを削除するには、この一覧から削除してください。