メインコンテンツまでスキップ

建築および診断

操作を所有するコンポーネントによって失敗を割り当てます。 成功したモデル応答、成功した計算、および検証された保存されたアーティファクトは異なる観察です。 失敗したステージの証拠を収集します。

建築・所有権

flowchart LR
UI[Desktop or browser interface] --> MAIN[Application main process]
MAIN --> STORE[Settings, database and managed files]
MAIN --> AGENT[Agent framework and model provider]
MAIN --> NB[Notebook runtime]
MAIN --> SERVICES[Connectors and Compute Hosts]
AGENT --> EVENTS[Messages and tool events]
NB --> EVENTS
SERVICES --> EVENTS
EVENTS --> UI
MAIN --> ART[Artifact versions and provenance]
ART --> UI
コンポーネントオーナーズ検査する証拠
レンダリングとプレビュー表示状態、制御、レンダリングされたファイルの内容ページ、選択したプロジェクト/セッション、ファイル名、プレビューエラー
Mainプロセス持続的な操作、アプリケーションサービス、アクセス境界操作の間違いおよび関連の診断
エージェントフレームワーク/providerモデル接続、タスク実行プロトコル、応答ストリームフレームワーク/provider/modelの接続テスト、失敗する用具または回転
Notebook通訳、コード実行、出力、ライブ変数Runtime ID/version、フェイリングセル、stdout/stderr、実行レコード
コネクタ外部サービスリクエストConnector/tool名、サニタイズされた入力、サービスからのステータス/エラー
リモート・コンピューティングのホストSSHアクセスと直接/スケジュールされたジョブホスト/モード、プローブ結果、ジョブID、リモートログ
アーティファクトリポジトリ管理されたバージョン、チェックサム、およびキャプチャされた証拠ファイル/バージョンID、コンテンツステータス、コード/環境/レビュータブ

デスクトップパスは、プリロードAPI境界線を渡します。 ブラウザアクセスは、アプリケーションの保護されたローカルサービス輸送を使用します。 ヘッドレスサービスおよびブラウザアクセス を参照してください。 ブラウザは2番目の独立した研究データベースではありません。

証拠からコンテンツを区別する

状態またはメッセージ通訳・通訳次の検証
利用可能なアーティファクトコンテンツ選択したバージョンのバイトは読みやすく、該当する整合性チェックを渡す科学的結果が正しいかどうかを調べる
コンテンツが利用できなくなった: 欠落予想される内容が見つかりませんバージョン ID を保存し、ストレージの可用性を調べる
コンテンツ利用不可:チェックサム不一致コンテンツは記録された整合性値と一致しません診断の保持; 正式にバイトを交換し、同じバージョンを呼び出しません
部分環境の捕獲環境記録が不完全であるキャプチャの警告を読んで、通訳/パッケージの詳細を独立して保持します
曲げられた実行ログ公平な実行証拠のみが保持されました。警告ギャップと利用可能なライブNotebookを調べる
このバージョンのレビューはありません審査結果が添付されていないバージョンをレビューとして報告しないでください。

これらの状態は共存することができます。 コンテンツの完全性、実行証拠、レビュー状況を別々に点検します。

エラーの検索

失敗の表面キャニカルルックアップ
モデル/API、ConnectorまたはプロキシHTTP応答HTTPステータスコード
アプリはデータベースを開くことができませんデータベースの起動コード
Notebook のインポート、ファイルパス、権限エラーメッセージ
SSHトランスポート、リモートパス、ジョブステータスリモートエラー
課題の投稿とコミュニティの助けバグを報告するか、コミュニティに尋ねる

エラーのソースを識別子で保持します。 OS errno、Python 例外、リモートジョブエラーコード、プロバイダの HTTP ステータスは変更できません。 添付したメッセージをコピーし、利用可能なときにネストされた原因をコピーします。 1つの識別子は、いくつかの失敗パスをカバーすることができます。

有用な診断記録を維持して下さい

アプリのバージョン、オペレーティングシステム、影響を受けたプロジェクト/セッション、動作、期待される結果、正確なエラー、およびその直前に何が起こったのかを記録します。 計算が関与したときに実行時間と入力チェックサムを含める。 既存のアーティファクトバージョンやリモートジョブ ID を含む。

利用可能なDetails診断の細部、またはログビューを使用して、エラーの原因を保持します。 可能な限り公開または最小限の入力で再生成します。 アカウントトークン、ヘッダ、プライベートパス、およびリサーチコンテンツの共有の内容を調べます。

主工程のロガーは構造化されたJSONラインを書きます。 そのデフォルトは、5 MiB でファイルを回転させ、合計で3つのファイルを保存します。 特別な致命的な書き込み動作は、1レコードによって普通の境界を超えることができます。 したがって、ログは保持ウィンドウを持っており、永久的な監査証跡はありません。 診断分野はtuncatedである場合もあります。 失敗の直後に関連レコードを保存し、イベントが起こらないという証拠から欠如を区別します。

ソース: ロガーと保持診断の赤化境界Notebookの失敗の細部成果物コンテンツのステータス

最初は、コミットされた変更の後で失敗したリフレッシュ/クリーンアップからの失敗した操作を区別し、結果の配達からの背景の仕事の完了を区別して下さい。 突然変異を繰り返す前に保存された状態を点検して下さい。 回復テーブル は、ブロックされたキューの復元、保持された PDF リファレンス、スタイルコレクションの編集、Windows インストーラー メッセージをカバーしています。 バックグラウンドタスク は実行状態を説明しています。 リモート監視エラーは、最終ジョブ結果とは異なるままです。