ログと診断

最終更新日時: 2026/10/14

QV2QS は実行ごとに構造化された診断ログを書き込みます。ロギングシステムには2つの階層があります。実行をまたいで存続する永続的なシステムログと、変換出力に同梱される実行ごとの構造化ログです。

システムログ

QV2QS はディスク上の固定された場所でローリングログファイルを維持します。システムログは、実行可能ファイルが起動すると開始され、いかなるプロジェクトやバッチからも独立して、アプリケーションレベルのイベントを記録します。

場所: %LOCALAPPDATA%\QV2QS\qv2qs.log

システムログは、以下の設定でローテーションファイルハンドラーを使用します。

アクティブなログファイルが25 MBに達すると、QV2QSはそのファイルをローテーションし、新しいログファイルを作成します。直近3つのバックアップが保持されます。古いバックアップは自動的に削除されます。

実行ごとの構造化ログ

変換の実行ごとに、その実行の詳細なイベントを含む個別のログファイルが生成されます。ファイル名はqv2qs_run_<version>_<timestamp>.logで、JSONデータ列を含むタブ区切り値 (TSV) 形式で記述されています。

既定の場所: %LOCALAPPDATA%\QV2QS\logs\

シングルプロジェクトモードでは、出力フォルダーが初期化された後、QV2QSはログファイルをプロジェクト出力フォルダーのlogs/サブフォルダー (例: <outputDir>/Sales/logs/) に昇格させます。ログファイルは変換出力に含まれています。

バッチモードでは、プロジェクトごとのログは、各プロジェクトの出力フォルダー内のlogs/ サブフォルダーに書き込まれます。

ログファイル形式

各ログファイルはTSVヘッダー行で始まります:

ts_utc	level	version	run_id	logger	event	message	data

タイムスタンプの衝突

2つの実行が同じ秒内に開始され、同じタイムスタンプを生成する場合、QV2QSは、上書きを避けるために、ファイル名に_2、_3、またはそれ以降の番号を追加します。

どのログを確認しますか

QV2QS は、実行の異なる段階で、2つの別々のログに書き込みます。システムログは常に利用可能です。実行ごとのログは、起動時の初期化が完了した後にのみ作成されます。

ログレベル

5つのログレベルが利用可能で、詳細度が高い順から低い順にリストされています。

ログレベルは、--logLevel または QV2QS_LOG_LEVEL 環境変数で設定します。両方が設定されている場合、CLIフラグが優先されます。

--logLevel DEBUG を、最も詳細な出力を取得するように設定します。デバッグレベルのエントリには、変換の決定、クラウドAPI呼び出し、スクリプトの変更、およびオブジェクト処理の詳細が含まれます。

コマンドラインを変更せずにデバッグログを有効にするには、QV2QSを実行する前に環境変数を設定します。

set QV2QS_LOG_LEVEL=DEBUG
QV2QS.exe --prjPath ./MyApp-prj --outputDir ./output --qvw MyApp.qvw --unbuildOnly

ログのクリーンアップ

ログファイルは、永続ログディレクトリに実行を重ねるごとに蓄積されます。--cleanLogs を使用して、実行開始時に30日以上前のログファイルを削除します。クリーンアップは永続ログディレクトリにのみ適用されます。出力ディレクトリ内のプロジェクトごとのログは影響を受けません。

シークレットマスキング

ログエントリは機密性の高い値を自動的にマスクします。APIキー、トークン、パスワード、およびクライアントシークレットは、最後の4文字のみが表示されるように伏せられています。シークレットを含むコマンドライン引数も、ログに記録される際にマスクされます。

QlikView デスクトップエンジンログ記録

PRJ生成が有効になっている場合、QV2QSは、各ファイルに対してどのQlikView Desktopエンジンが使用されているかをログに記録します。ログイベントprj_generate_startは、バンドルされたポータブルエンジンとシステムにインストールされたバージョンのどちらがアクティブであるかを記録し、利用可能な場合はバンドルされた実行可能ファイルのファイルバージョンを含みます。

QlikView Desktopへの接続が確立されると、prj_qv_ready イベントは、実行中のエンジンによって報告された QlikView のバージョン (たとえば、12.100.20100.0) を記録します。バンドルされたエンジンを使用する場合、exe_file_version フィールドは、実行可能ファイルから読み取られたファイルバージョンを記録します。

バッチモードでは、ログイベントprj_batch_prereqは、いずれのファイルも処理される前に、バッチ全体のエンジン選択とバンドルされたバージョンを記録します。バンドルされたエンジンもシステムインストールも利用できない場合、エラーはprj_batch_no_qvとしてシステムログに記録されます。

--logLevel DEBUG を、エンジン検出中にチェックされたファイルパスを含む詳細なエンジン解決手順をキャプチャするように設定します。

コンソール出力 対 ファイルロギング

コンソール出力とファイルログは独立したシステムです。

コンソール出力はログファイルに表示されません。--console silent フラグは、ファイルログに影響を与えることなく、コンソール出力を抑制します。

CLI引数

詳細はこちら

• 引数参照
• トラブルシューティング