chocolatey.log の解析

このセクションでは、失敗した chocolatey パッケージのインストールをトラブルシューティングする方法に焦点を当てます。

要件

トラブルシューティングに必要、または役立つ項目は次のとおりです：

• ログファイル、特に chocolatey.log.

• 高度な検索機能を備えたお好みのテキストエディタ（推奨：Notepad++、Visual Studio Code）。

• 失敗したパッケージのパッケージID（例： generic-mozilla-firefox.

• 失敗したインストールのタイムスタンプ（必須ではありませんが役立ちます）。

ログファイルの構造

エントリポイントとデバッグ情報

パッケージインストールのエントリポイントを chocolatey.log 内で見つけるには、正確に次の検索文字列を使用してください（パッケージIDは適宜変更してください）： generic-mozilla-firefox --version= （バージョン文字列が確実にわかっている場合は当然追加できますが、必須ではありません）

こうすることで、指定したパッケージIDに対するインストールまたはアップグレードの choco プロセスの開始点を見つけることができます。

ログの完全な行は次のように表示されることがあります（代わりに upgrade は次のようにもなり得ます install 操作に応じて）：

2023-08-22 15:05:36,664 [DEBUG] - Command line: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"

chocolatey.log 内の choco インストールのエントリポイント

この行には、インストールされるパッケージのバージョン番号や使用された params（RealmJoin ポータルで構成されたパッケージ引数）など、いくつかの重要な情報が既に含まれています。

次の行には多くの（関連性の低い）デバッグ情報が含まれ、その中には chocolateyInstall.ps1 の完全な内容が出力されます。 デバッグ情報の中に、次の2つのセクションが表示されます RJAppDeployToolkit: Input Environment Variables 同じ Log Analytics アカウントを RJAppDeployToolkit: Resulting Variables。両セクションは互いに隣接して表示され、次によって提供された変数と値を示します RJAppDeployToolkit

RJAppDeployToolkit の出力

インストールプロセス

実際のパッケージインストールスクリプトは、次のログメッセージの後に開始されます：

2023-08-22 15:05:47,000 [DEBUG] - Running 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'

パッケージインストールスクリプトとクライアントの状態によって、最初のステップは通常ソフトウェアが既にインストールされているかどうかの確認です。これは、実際のインストール前にアンインストールが必要かどうかを判断するために行われます。 ログでは、次のいずれか、または複数のログメッセージでこれを追跡できます：

2023-08-22 15:05:47,057 [DEBUG] - Entered function 'Get-RealmjoinRegistryUninstallInfo' with parameters [...]]

2023-08-22 15:05:47,053 [DEBUG] - Entered function 'Uninstall-RealmjoinPackage' with parameters [...]]

チェックと可能なアンインストールが実行された後、アプリケーションのメインインストールが開始されます。これは次のログメッセージで示されます（ファイル名は当然異なります）：

2023-08-22 15:05:47,858 [INFO ] - Starting RealmJoin-Install of Git-2.42.0-64-bit.exe

インストールは通常、バイナリファイルのダウンロードから始まります。ダウンロードの開始と終了は次のログメッセージで表されます：

2023-08-22 15:05:48,273 [INFO ] - Downloading generic-git-git from 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Download of Git-2.42.0-64-bit.exe (58.35 MB) completed.

ダウンロード完了後、chocolatey はダウンロードしたファイルのハッシュをチェックし、期待される値と比較します。ハッシュが一致すれば、セットアップファイルが最終的に実行されます。 実行に関するログメッセージは次のログメッセージで確認できます：

2023-08-22 15:06:00,743 [DEBUG] - Elevating Permissions and running ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. This may take a while, depending on the statements.

このメッセージには、セットアップファイルへのファイルパスや、セットアップファイルを起動するために使用されたすべての（サイレント）パラメータを含む完全なコマンドラインが含まれています。また、セットアップファイルがログファイルを提供し、パッケージスクリプトに含まれている場合に、その関連するセットアップログファイルのパスを見つけるのにも役立ちます。

プロセスが終了した後、別のログメッセージが記録され、再び完全なファイルパスとすべてのパラメータが含まれます。さらに、このメッセージにはセットアッププロセスが返した終了コードも含まれます。これは成功または失敗したインストールの最も重要な指標です：

2023-08-22 15:06:52,321 [DEBUG] - Command ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] exited with '0'.

パッケージによっては、パッケージのインストール後にいわゆる「postActions」が実行される場合があります。これらは一部のレジストリ設定、デスクトップアイコンの削除、あるいは別のセットアップファイルの実行（そのファイルのダウンロードから再開）などである可能性があります。postActions の部分はログファイル内で次の開始および終了メッセージで示されます：

2023-09-13 16:49:18,550 7224 [INFO ] - Running postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions finished.

chocolatey のインストールプロセスは、次のログメッセージで終了します（文言はインストール／アップグレードにより異なる場合があります）：

2023-09-13 17:01:39,433 8336 [INFO ] - The install of generic-google-chrome was successful.