デプロイメントが正常に完了したか否かにかかわらず、デプロイメントの結果は出力ログに記録されます。出力ログは、エラーのトラブルシューティング、情報の収集、および個々の手順の結果の検証に役立ちます。
出力ログの確認方法
出力ログは、
「Deployments」画面の「Deployment statuses」列にあるマークをクリックすると表示されます。
列内の各マークは以下のステータスを示しています。
白:Queued(キューに追加済み)/黄色:In Progress(実行中)/緑色:Complete(完了)/赤色:Error(エラー)
「Deployment statuses」列のマーククリックすると、対象の端末一覧に移動します。
「Deployment status」列内のマークをクリックすると、各ステップの出力とデプロイメント中に発生した可能性のあるエラーを含むブラウザ内ポップアップが開きます。ここに表示されるテキストはコピー&ペーストに対応しているため、結果を他のチームメンバーやサポート窓口と共有する必要がある場合に便利です。デプロイが「In Progress」の状態にある間は、出力ログの一部を表示することもできます。
出力ログの構成
出力ログは、「Output」と「Errors」の2つのセクションで構成されています。「Output」セクションは常に存在し、展開中に生成された情報テキストが表示されます。ここに表示されるテキストは、インストーラーファイル、実行中のスクリプト、またはPDQエージェント自体から生成される可能性があります。「Output」セクションにはエラーが含まれる場合もありますが、主にログファイルやコマンドラインコンソールで通常生成される情報を中継するように設計されています。
「Errors」セクションは、デプロイメントでエラーコードまたはエラーメッセージが返された場合にのみ表示されます。「Errors」セクションの目的は、「Output」セクションに含まれない可能性のあるエラーを特定することです。
以下は「Output」セクションにターゲットマシン上で埋め込みPowerShellスクリプトが実行されたログの一例です。「Errors」セクションにはそのエラーの内容が表示されます。
出力ログの内容
PDQ Connectは、実行されるアプリケーションまたはスクリプトがログを提供し、それをエージェントに出力として渡すことを前提としています。デプロイされるアプリケーションがログを提供しない場合は、PDQ Connect Agent に渡す情報はありません。
例1)
msiexec.exe /i "7z2301-x64.msi" /qnコマンドを使用して 7-zip をデプロイしました。ログ記録用のパラメータは定義されていないため、出力ログには PDQ Connect エージェントによって実行されたアクションのみが表示されます。
例2)
変更したコマンドmsiexec.exe /i "7z2301-x64.msi" ALLUSERS=1 /qn /norestart /log output.logを使用して、同じ .msi ファイルをデプロイしています。/logパラメータは、PDQ Connect Agent に自動的に渡されるログ ファイルを生成するために使用されます。その結果、PDQ Connect の出力ログには、デプロイに関するより詳細な情報が含まれます。
タスク ID について
PDQ Connect のすべてのデプロイメントには、その特定のデプロイメントを一意に識別するランダムな GUID が割り当てられます。この GUID は、非公式に「タスク ID」として参照できます。タスク ID は、出力ログの「Error」セクションで確認でき、「タスク 'dvc_task_{GUID}' の実行に失敗しました」というメッセージが表示される場合があります。「dvc_task_」は GUID の接頭辞で、デプロイメントを表していることを示しています。
タスク ID は、デプロイメント中に一時ファイルをダウンロードしたりスクリプトを実行したりするために使用される作業ディレクトリとも一致します。PDQ Connect で実行中のデプロイメントの作業ディレクトリは以下になります。
C:\ProgramData\PDQ\PDQConnectAgent\Downloads\dvc_task_{GUID}