chocolatey.log の分析

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

要件

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

• ログファイル、特に chocolatey.log.
• 高度な検索機能を備えた任意のテキストエディター。推奨: Notepad++, Visual Studio Code。
• 失敗したパッケージのパッケージ ID。たとえば generic-mozilla-firefox.
• 失敗したインストールのタイムスタンプ（必須ではありませんが、役立ちます）。

ログファイルの構造

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

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

これにより、指定した package ID に対するインストールまたはアップグレードの choco プロセスの開始点を見つけられます。

ログ内の完全な行は、次のようになることがあります。 アップグレード 〜である場合もあります インストール 操作によって異なります：

2023-08-22 15:05:36,664 [DEBUG] - コマンドライン: "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 Portal で構成された package arguments）など、重要な情報がすでに含まれています。

以降の行には、多くの（関連性のない）デバッグ情報が含まれます。たとえば、chocolateyInstall.ps1 の完全な内容が出力されます。 デバッグ情報の中には、次の 2 つのセクションがあります RJAppDeployToolkit: 入力環境変数 および RJAppDeployToolkit: 結果変数。両方のセクションは隣り合って配置され、 RJAppDeployToolkit

RJAppDeployToolkit の出力

インストール処理

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

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

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

2023-08-22 15:05:47,057 [DEBUG] - パラメーター [...]] で関数 'Get-RealmjoinRegistryUninstallInfo' に入りました

2023-08-22 15:05:47,053 [DEBUG] - パラメーター [...]] で関数 'Uninstall-RealmjoinPackage' に入りました

チェックと、必要に応じたアンインストールが実行された後、アプリケーションの本体インストールが開始されます。次のログメッセージがその目印です（もちろんファイル名は異なります）：

2023-08-22 15:05:47,858 [INFO ] - Git-2.42.0-64-bit.exe の RealmJoin-Install を開始

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

2023-08-22 15:05:48,273 [INFO ] - 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe' から generic-git-git をダウンロードしています

[...]

2023-08-22 15:05:57,293 [INFO ] - Git-2.42.0-64-bit.exe (58.35 MB) のダウンロードが完了しました。

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

2023-08-22 15:06:00,743 [DEBUG] - 権限を昇格して ["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" ] を実行します。指定された内容によっては、しばらく時間がかかる場合があります。

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

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

2023-08-22 15:06:52,321 [DEBUG] - コマンド ["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" ] は '0' で終了しました。

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

2023-09-13 16:49:18,550 7224 [INFO ] - postActions を実行中...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions が終了しました。

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

2023-09-13 17:01:39,433 8336 [INFO ] - generic-google-chrome のインストールは成功しました。