コンテンツにスキップ

Panelアプリの使い方

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

ビルドステータス(サーバーアプリ)

Section titled “ビルドステータス(サーバーアプリ)”

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

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

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

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

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

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

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

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

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

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

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

準備完了のアプリの行の先頭にある開くアイコンをクリックすると、新しいタブでアプリが起動します。開くは、行の ⋯ メニューの最初の項目でもあります。行アクションメニューをご覧ください。

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

サーバーアプリはリソースを節約するため、アイドル時にゼロへスケールダウンします。そのため、アイドル期間の後の最初の起動では、アプリを立ち上げる必要があります。その間は空白のタブではなく PlaidCloud の読み込み画面が、ライトまたはダークのテーマで表示されます。この画面には、アプリ名、開始中、準備中、アプリを読み込み中という進行状況、ワークスペース ID が示されます。アプリは準備ができ次第自動的に表示され(通常は数秒、コールドスタートでは最大 1 分程度)、次にアイドル状態になるまで通常どおり応答します。

この読み込み画面は、アプリが起動している間、アドレスバーからコピーしたリンクや、アラートまたはダイジェストメッセージ内のリンクなど、アプリへのその他のリンクから開いた場合にも表示されます。サインアウトしていて、ブラウザーのタブで開いた場合は、先にサインインします。

アプリを起動できない場合、読み込み画面はいつまでも回り続けるのではなく、アプリが起動しなかったことと停止した段階を伝えるメッセージと再試行ボタンに切り替わります。それでも解決しない場合は、アプリを編集してエントリポイントとブランチを確認して再公開するか、PlaidCloud 管理者にお問い合わせください。

サーバー型の Panelアプリは、デフォルトで PlaidCloud のモダンな FAST デザインを使用しますが、既存の CSS がそれに依存している場合は、アプリのデザイン設定で Panel のデフォルトのスタイルに戻せます。テーマ(ライト、ダーク、または閲覧者が切り替えられるライト/ダーク切り替え)は、アプリのテンプレートで設定します。パターンについては、作成ガイドのテーマの設定をご覧ください。アプリのテーブルやカスタムスタイルが明るい背景向けに作られている場合は、ライトに固定してください。

ログの表示(サーバーアプリ)

Section titled “ログの表示(サーバーアプリ)”

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

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

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

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

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

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

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

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

使用状況メトリック(サーバーアプリ)

Section titled “使用状況メトリック(サーバーアプリ)”

サーバーアプリの行にある Usage Metrics アイコン(ログを表示の隣)をクリックすると、アプリの利用状況を確認できます。ビューには次の内容がまとめられます。

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

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

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

アプリの行にある鉛筆アイコンをクリックすると、アプリを編集できます。編集フォームはアプリのランタイムに応じたものになります。

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

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

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