mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-19 02:34:37 -05:00
150 lines
5.9 KiB
Plaintext
150 lines
5.9 KiB
Plaintext
---
|
||
title: ロギング
|
||
---
|
||
|
||
import { Callout } from 'fumadocs-ui/components/callout'
|
||
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
|
||
import { Image } from '@/components/ui/image'
|
||
|
||
Simはすべてのワークフロー実行に対して包括的なロギングを提供し、ワークフローの実行方法、データの流れ、問題が発生する可能性のある場所について完全な可視性を提供します。
|
||
|
||
## ロギングシステム
|
||
|
||
Simは異なるワークフローとユースケースに対応する2つの補完的なロギングインターフェースを提供しています：
|
||
|
||
### リアルタイムコンソール
|
||
|
||
手動またはチャットワークフロー実行中、ログはワークフローエディタの右側にあるコンソールパネルにリアルタイムで表示されます：
|
||
|
||
<div className="flex justify-center">
|
||
<Image
|
||
src="/static/logs/console.png"
|
||
alt="リアルタイムコンソールパネル"
|
||
width={400}
|
||
height={300}
|
||
className="my-6"
|
||
/>
|
||
</div>
|
||
|
||
コンソールには以下が表示されます：
|
||
- アクティブなブロックのハイライト表示によるブロック実行の進行状況
|
||
- ブロックが完了するとリアルタイムで出力
|
||
- 各ブロックの実行時間
|
||
- 成功/エラーステータスインジケーター
|
||
|
||
### ログページ
|
||
|
||
手動、API、チャット、スケジュール、またはWebhookを介してトリガーされたすべてのワークフロー実行は、専用のログページに記録されます：
|
||
|
||
<div className="flex justify-center">
|
||
<Image
|
||
src="/static/logs/logs.png"
|
||
alt="ログページ"
|
||
width={600}
|
||
height={400}
|
||
className="my-6"
|
||
/>
|
||
</div>
|
||
|
||
ログページは以下を提供します：
|
||
- 時間範囲、ステータス、トリガータイプ、フォルダ、ワークフローによる包括的なフィルタリング
|
||
- すべてのログにわたる検索機能
|
||
- リアルタイム更新のためのライブモード
|
||
- 7日間のログ保持（長期保持にアップグレード可能）
|
||
|
||
## ログ詳細サイドバー
|
||
|
||
任意のログエントリをクリックすると、詳細なサイドバービューが開きます：
|
||
|
||
<div className="flex justify-center">
|
||
<Image
|
||
src="/static/logs/logs-sidebar.png"
|
||
alt="ログサイドバーの詳細"
|
||
width={600}
|
||
height={400}
|
||
className="my-6"
|
||
/>
|
||
</div>
|
||
|
||
### ブロック入力/出力
|
||
|
||
各ブロックの完全なデータフローを表示し、タブを切り替えて：
|
||
|
||
<Tabs items={['Output', 'Input']}>
|
||
<Tab>
|
||
**出力タブ**はブロックの実行結果を表示します：
|
||
- JSON形式の構造化データ
|
||
- AI生成コンテンツのマークダウンレンダリング
|
||
- データ抽出が簡単なコピーボタン
|
||
</Tab>
|
||
|
||
<Tab>
|
||
**入力タブ**はブロックに渡されたものを表示します：
|
||
- 解決された変数値
|
||
- 他のブロックからの参照出力
|
||
- 使用された環境変数
|
||
- セキュリティのためにAPIキーは自動的に編集されます
|
||
</Tab>
|
||
</Tabs>
|
||
|
||
### 実行タイムライン
|
||
|
||
ワークフローレベルのログでは、詳細な実行メトリクスを確認できます：
|
||
- 開始および終了タイムスタンプ
|
||
- ワークフロー全体の所要時間
|
||
- 個々のブロックの実行時間
|
||
- パフォーマンスのボトルネック特定
|
||
|
||
## ワークフロースナップショット
|
||
|
||
ログに記録された任意の実行について、「スナップショットを表示」をクリックすると、実行時のワークフローの正確な状態を確認できます：
|
||
|
||
<div className="flex justify-center">
|
||
<Image
|
||
src="/static/logs/logs-frozen-canvas.png"
|
||
alt="ワークフロースナップショット"
|
||
width={600}
|
||
height={400}
|
||
className="my-6"
|
||
/>
|
||
</div>
|
||
|
||
スナップショットでは以下を提供します：
|
||
- ワークフロー構造を示す凍結されたキャンバス
|
||
- 実行中のブロックの状態と接続
|
||
- 任意のブロックをクリックして入力と出力を確認
|
||
- その後変更されたワークフローのデバッグに役立つ
|
||
|
||
<Callout type="info">
|
||
ワークフロースナップショットは、拡張ログシステム導入後の実行でのみ利用可能です。古い移行されたログでは「ログ状態が見つかりません」というメッセージが表示されます。
|
||
</Callout>
|
||
|
||
## ログ保持期間
|
||
|
||
- **無料プラン**：7日間のログ保持
|
||
- **プロプラン**：30日間のログ保持
|
||
- **チームプラン**：90日間のログ保持
|
||
- **エンタープライズプラン**：カスタム保持期間が利用可能
|
||
|
||
## ベストプラクティス
|
||
|
||
### 開発向け
|
||
- テスト中の即時フィードバックにはリアルタイムコンソールを使用
|
||
- データフローを確認するためにブロックの入力と出力をチェック
|
||
- 正常動作版と問題のある版を比較するためにワークフロースナップショットを使用
|
||
|
||
### 本番環境向け
|
||
- エラーやパフォーマンスの問題を定期的にログページで監視
|
||
- 特定のワークフローや期間に焦点を当てるためのフィルターを設定
|
||
- 重要なデプロイメント中はライブモードを使用してリアルタイムで実行を監視
|
||
|
||
### デバッグ向け
|
||
- 遅いブロックを特定するために常に実行タイムラインを確認
|
||
- 正常動作する実行と失敗する実行の間の入力を比較
|
||
- 問題が発生した時の正確な状態を確認するためにワークフロースナップショットを使用
|
||
|
||
## 次のステップ
|
||
|
||
- ワークフローの価格設定を理解するための[コスト計算](/execution/costs)について学ぶ
|
||
- プログラムによるログアクセスのための[外部API](/execution/api)を探索する
|
||
- webhook、メール、またはSlackによるリアルタイムアラートのための[通知](/execution/api#notifications)を設定する |