ダッシュボードの起動
ローカルダッシュボードの起動
以下を実行してダッシュボードを起動できます:
trackio show
import trackio
trackio.show()特定のプロジェクトの読み込み
オプションのproject名を引数として指定することで、特定のプロジェクトを直接読み込むこともできます:
trackio show --project "my-project"import trackio
trackio.show(project="my-project")カスタムフロントエンドの使用
バンドルされたダッシュボードを、独自の静的フロントエンドディレクトリに置き換えることができます。ディレクトリにはindex.htmlファイルのみが必要です。フロントエンドから/api/*配下の既存のTrackio APIを呼び出すことができます。
意図されたワークフローは以下の通りです:
trackio show --frontend ./my-trackio-frontendを実行します。- そのディレクトリ内のファイルを編集するように、LLMに指示してください。
- これらのファイルが変更されると、Trackioがフロントエンドをライブリロードするため、ブラウザを開いたままにしてください。
--frontend に渡されたディレクトリが存在しない場合、または存在するが空の場合、Trackio は自動的にスターターフロントエンドをコピーし、その旨を出力してから、そのディレクトリを配信します。スターターは完全なプレーンな HTML/CSS/JS テンプレートです。Trackio API を呼び出し、プロジェクトとランを読み込み、メトリックの値を取得し、独自の UI に置き換え可能なシンプルなチャートを描画します。
現在利用可能なHTTPエンドポイントは以下の通りです:
POST /api/get_run_mutation_statusPOST /api/upload_db_to_spacePOST /api/bulk_upload_mediaPOST /api/logPOST /api/bulk_logPOST /api/bulk_log_systemPOST /api/bulk_alertPOST /api/get_alertsPOST /api/get_metric_valuesPOST /api/get_runs_for_projectPOST /api/get_metrics_for_runPOST /api/get_all_projectsPOST /api/get_project_summaryPOST /api/get_run_summaryPOST /api/get_system_metrics_for_runPOST /api/get_system_logsPOST /api/get_system_logs_batchPOST /api/get_snapshotPOST /api/get_logsPOST /api/get_logs_batchPOST /api/get_tracesPOST /api/query_projectPOST /api/get_settingsPOST /api/get_project_filesPOST /api/delete_runPOST /api/rename_runPOST /api/force_sync- メディアおよびファイル関連のフローで使用されるマルチパートファイルアップロード用の
POST /api/upload
APIから返される保存済みファイルの読み取りには、TrackioはGET /file?path=...も提供しています。
trackio show --frontend ./my-trackio-frontend
import trackio
trackio.show(frontend_dir="./my-trackio-frontend")提供されたフロントエンドディレクトリが空でなく無効な場合、Trackioは同梱されているスターターテンプレートにフォールバックします。
永続的なデフォルトフロントエンドの設定
trackio show、trackio sync、およびデプロイフローで、デフォルトとして同じカスタムフロントエンドを使用するようにするには、Trackioの永続設定に保存してください。
trackio config set frontend ./my-trackio-frontend以下でリセットします:
trackio config unset frontendプロット色のカスタマイズ
プロットラインに使用されるカラーパレットは、color_palette引数を指定することでカスタマイズできます。組織のブランディングに合わせる場合や、特定のカラー設定がある場合に便利です。
trackio show --color-palette "#FF0000,#00FF00,#0000FF"import trackio
trackio.show(color_palette=["#FF0000", "#00FF00", "#0000FF"])複数のランを表示する際、色はサイクルで切り替わります。色は任意の数を指定できます。
リモートアクセスの有効化
デフォルトでは、ダッシュボードは127.0.0.1(localhost)にバインドされるため、同じマシンからのみアクセスできます。ネットワーク上の他のマシンからのリモートアクセスを許可するには、--hostオプションを使用します:
trackio show --host 0.0.0.0
import trackio
trackio.show(host="0.0.0.0")これは、リモートサーバー上でTrackioを実行する場合や、別のマシンからダッシュボードにアクセスする必要があるコンテナ化環境で特に役立ちます。
Jupyter Notebookでダッシュボードを起動する
Jupyter Notebook内でダッシュボードを直接起動することもできます。上記と同じコマンドを使用してください:
import trackio
trackio.show()デモノートブックを確認してください。
Update on GitHub