SystemLink保存と転送の保存されたトランザクションの手動検査

SystemLinkの保存と転送に関する問題をトラブルシューティングする際には、データがSystemLinkに転送される前にローカルにキャッシュされる保存ディレクトリを手動で検査する必要がある場合があります。この記事では、このような手動検査を実行する方法について説明します。

保存ディレクトリには3つのサブディレクトリがあり、それぞれに異なる種類のキャッシュ データが含まれています。

• assetmgmt : キャリブレーション イベントや新しい資産の場所などの資産状態の更新。
• file： SystemLinkに転送されるまでローカルにキャッシュされたファイル
• testmon : テスト結果はSystemLinkに転送されるまでローカルにキャッシュされます

これらの各フォルダーには次の項目が含まれています。

• __CACHE__ : サーバに送信されたトランザクションに関する情報を追跡するファイルです。「timestamp」フィールドには、転送サービスが最後にトランザクションの転送を試みた時刻が示されます。
• <guid>.jsonl : ランダムなGUID名を持つファイルです。これらのファイルには、通常複数のファイルに分散して保存されたトランザクションが含まれます。フォーマットは転送サービスに固有ですが、すべてのデータはプレーンテキストで保存され、各行は保存されたトランザクションを表します。
• quarantine : サーバからエラー応答を受け取ったトランザクションを記録する JSON ファイルが格納されるフォルダです。これらのトランザクションは、保存と転送サービスによって再試行されません。

1. C:\ProgramData\National Instruments\Skyline\Data\Storeフォルダを参照します。ここにトランザクションが保存されます。

2. 各フォルダを開き、 __CACHE__ファイルから.jsonlトランザクションファイルの数とタイムスタンプを確認します。以下の点に注意してください。

• 隔離ディレクトリ内のファイルは、手動で解決する必要がある問題が発生したことを示しています。トランザクションが多数ある場合は、 利用可能なパッチで既に対処できるシステム上の問題を示している可能性があります。
• 隔離ディレクトリ外にあるファイルは、必ずしも問題を示すものではありません。隔離ディレクトリは、トランザクションがサーバに転送される前に保管される場所です。しかし、大量のトランザクションが存在する場合は、問題を示している可能性があります。転送サービスがクラッシュしているか、新しいデータの処理速度に対応できていない可能性があります。__ CACHE__タイムスタンプは、これらのいずれに該当するかを判断するのに役立ちます。
• __CACHE__ ファイルに含まれるタイムスタンプは、転送サービスがトランザクションを転送した最後の時刻を示します。
  • タイムスタンプが異常に古い場合、転送サービスがトランザクションの転送中にクラッシュしている可能性があります。この場合、転送サービスからイベントまたはログを取得する必要があります（ 「SystemLink Forwarding ServiceのWindowsイベントログのキャプチャ」および「SystemLink Forwarding Serviceのログのキャプチャ」を参照してください）。また、3つのサブディレクトリ（ asstmgmt 、 file 、 testmon ）のタイムスタンプを比較することもできます。フォルダは順番に転送されるため、タイムスタンプが一致していない場合は、クラッシュが発生した場所を特定する手がかりとなる可能性があります。
  • タイムスタンプが最新である場合、次の2つの問題のいずれかが発生している可能性があります。
    • 新規受信データのレートが、転送された送信データのレートよりも高い場合。この場合、転送間隔を調整することでパフォーマンスを向上させることができます。 「SystemLink転送間隔の設定」を参照してください。
    • 非隔離ストア内の各jsonlファイルの個々の行のタイムスタンプを調べることもできます。最後の行がCloseFileトランザクションで、タイムスタンプが__CACHE__よりも古い場合、パッチで修正された既知のバグの兆候である可能性があります。これらはクリーンアップされていない.jsonlファイルです。パフォーマンスを向上させるために削除できます。

3. .jsonlファイルが作成されない場合は、保存フォルダへの書き込み時に Windowsのアクセス権限に問題がある可能性があります。以下の症状がないか確認し、 「SystemLink 保存と転送でトランザクションが保存されない」を参照してください。

• Test Monitor Client Data Storeフォルダ ( C:\ProgramData\National Instruments\Skyline\Data\Store\testmon ) に.jsonlファイルがありません。
• __CACHE__ファイルは、テストを実行した後、トランザクションがない (「forwardedTransactionCounts」配列が空) ことを示します。また、ファイルが保存されていないことも示します。