注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
ピアリングジョブ
Peer Manager は、ピアリングジョブを使用してスペース間でデータを送信します。このページでは、接続の概要ページにあるピアリングジョブのテーブルの読み方、同時ジョブと逐次ジョブの違い、各ジョブのステータスの意味、および確認したいジョブに絞り込む方法を説明します。
ピアリングジョブの仕組み
各ピアリングジョブは、単一の方向に送信される特定の種類のデータに対応します。Peer Manager は、接続のすべてのジョブをその接続の概要ページに一覧表示します。各行には、ジョブの種類、ステータス、生成元、および実行時刻が表示されます。
Peer Manager は、次の2つのプロパティでジョブの種類を表します。
- ペイロードの種類： ジョブが運ぶコンテンツの種類を示します。データジョブはオブジェクト、リンク、およびファイルのコンテンツを転送します。一方、ACK ジョブは、以前送信したデータをリモートシステムが受信したことを確認する受信確認と、オブジェクトタイプのマッピング設定など、共有状態に関する各システムの認識を同期するメタデータを運びます。
- 方向： エンロールメントからデータを送信するジョブ（エクスポート）か、リモートエンロールメントからデータを受信するジョブ（インポート）かを示します。
エクスポートジョブでは、ジョブの種類の下に実行順序の値も表示され、ジョブが同時か逐次かを示します。詳細は後述します。インポートジョブには、対応するエクスポートの実行順序が表示されますが、実際にはすべてのインポートジョブが同時に実行されます。
ジョブの種類
エクスポートジョブは、同時または逐次のいずれかの実行順序モードで実行されます。この違いを理解すると、接続の正常性を判断しやすくなります。
同時
同時ジョブは、リアルタイムでオンデマンドに実行されるエクスポートです。データが作成または更新されるたびに起動し、並列で実行されます。生成元は、任意の数の同時ジョブを同時に実行できます。同時ジョブは、定常状態のピアリングで接続を最新に保つための高速な経路です。
同時ジョブは、リアルタイムのオブジェクト、リンク、およびファイルの変更であるデータペイロードと、確認（Ack）ペイロードの両方を運びます。確認ペイロードは、データのインポート直後にシステムが返す受信確認で、受信したことを確認することで送信元による再送を停止させます。同時のデータジョブが転送を行うための高速な経路であるのと同様に、同時の Ack ジョブは転送を確認するための高速な経路です。ジョブテーブルでは、ペイロードの種類が Ack、実行順序が同時という組み合わせで、これらの即時の受信確認を識別できます。
逐次
逐次ジョブは、未転送分を補うための定期的なバッチジョブで、特定のリレーションシップに対して一度に1件ずつ実行されます。生成元は、リレーションシップごとに一度に1件の逐次ジョブのみを実行します。逐次ジョブは、失敗した同時エクスポートや、接続が利用できなかった間に蓄積した未処理データなど、リアルタイムの経路で取りこぼしたものを補完するために存在します。リレーションシップの逐次ジョブは順番に実行されるため、大規模な逐次ジョブがある場合、そのジョブが完了するまで、同じリレーションシップの次の逐次ジョブは実行されません。
ジョブのステータス
各ジョブには、ライフサイクルのどの段階にあるかを示すステータスが表示されます。次のテーブルは、ジョブテーブルに表示されるステータスを説明しています。
| ステータス | 意味 |
|---|---|
| データ収集中 | 生成元が、リモートシステムからまだ受信確認されていないすべてのデータを収集し、転送用にパッケージ化しています。後述のデータ収集にかかる時間を参照してください。 |
| エクスポート中 | エンロールメントでエクスポートが生成され、転送の準備が行われています。 |
| 保存中 | 転送前に、エクスポートペイロードがストレージに書き込まれています。 |
| ダウンロード可能 | エクスポートが生成され、手動でダウンロードできる状態です。このステータスは、リモートシステムが直接取得するのではなく、エクスポートをダウンロードし、クロスドメインソリューションを介して転送するデータリレー接続に適用されます。 |
| プル待ち | エクスポートが保存され、リモートシステムがプルするのを待っています。リモートシステムが進行中の転送を完了し、プルを開始すると、転送が始まります。 |
| 空 | ジョブは実行されましたが、データも受信確認も転送されませんでした。後述の空のジョブを参照してください。 |
| 失敗 | ジョブが完了しませんでした。Peer Manager は、ジョブが失敗した段階の詳細なエラーメッセージと、エラーインスタンス ID をコピーオプションを表示します。この ID を Palantir サポートに共有すると、トラブルシューティングに役立ちます。 |
インポートジョブは、リモートシステムからデータが到着し、エンロールメントに引き渡されるにつれて、対応する受信段階を進みます。
データ収集にかかる時間
逐次ジョブは、後続のほかのステータスよりも長くデータ収集中ステータスにとどまることがあります。これは、リモートシステムからまだ受信確認されていないすべての未処理データを、ピアの生成元が抱えているために発生する場合があります。逐次ジョブが実行されると、前回転送に成功してから蓄積したすべてのデータを収集します。これには、初回の同期時に送信された初期データや、リアルタイムのピアリングに失敗していた間、または接続が利用できなかった間に蓄積したすべてのデータが含まれます。
収集段階が長くなる一般的な原因は、未処理データの蓄積です。たとえば、接続で新しいオブジェクトタイプのピアリングを有効にすると、Peer Manager はその履歴を逐次ジョブで送信するため、完了までにより長い時間がかかります。
初期同期時やダウンタイムの後に、データ収集中の段階がときどき長くなることは想定されています。ただし、大量のデータを収集するために逐次ジョブが常にこの段階にとどまる場合は、リアルタイムのピアリングが遅れているか、現在の設定で処理できる量を超えるデータが生成されていることを示します。接続でエクスポートの失敗が繰り返されていないか確認してください。
空のジョブ
空のジョブはデータも受信確認も転送しません。スケジュールされた逐次ジョブが実行され、転送するものが見つからない場合に発生します。
空のジョブは問題がなく、想定されるものです。空のジョブが存在することは、同時のリアルタイムピアリングが追いついており、再試行を必要とする失敗が発生していないことを意味するため、正常な兆候です。空のジョブに対して何もする必要はなく、Peer Manager はデフォルトでジョブテーブルから空のジョブを非表示にします。
ジョブテーブルを絞り込む
利用可能なフィルターを使用して、ジョブテーブルに表示するジョブを絞り込みます。
- 検索条件： ジョブIDで特定のジョブを検索します。
- 方向：****エクスポートまたはインポートのジョブのみを表示します。
- ペイロードの種類：****データまたは Ack のジョブのみを表示します。
- 実行順序：****同時または逐次のジョブのみを表示します。
- 生成元： 特定の生成元のジョブのみを表示します。
- ステータス： 選択したステータスのジョブのみを表示します。空のジョブはデフォルトで非表示です。このフィルターを使用して空のジョブを表示したり、データを転送したジョブのみに絞り込んだりできます。
- 時間： 選択した時間範囲に実行されたジョブのみを表示します。その範囲内のいずれかの時点で実行されていたジョブが該当します。
すべてのフィルターをリセットを選択すると、すべてのフィルターがクリアされ、ジョブの全一覧に戻ります。
接続の正常性を判断する
Peer Manager は、空ではない最新のジョブから接続の正常性を算出して表示するため、空のジョブは正常性インジケーターに影響しません。
次の目安に従って、接続の正常性を評価します。
- 同時ジョブは定常状態の経路です。 リアルタイムのピアリングが追いついている場合、ほとんどの転送は逐次ジョブではなく同時ジョブを介して行われます。これは、長時間実行される複数の逐次ジョブで転送する必要があるほど大量の未処理データがないことを示します。
- 逐次ジョブは未処理データの蓄積を示します。 小規模、短時間、または空の逐次ジョブは、接続が正常であることを示します。大量のデータを常に収集する逐次ジョブは、リアルタイムのピアリングが遅れているか、現在の設定で処理できる量を超えるデータが生成されていることを示します。
- 失敗したジョブには対応が必要です。 Peer Manager が表示するエラーメッセージとエラーインスタンスIDを使用して、失敗したジョブを調査します。