> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md).

# chocolatey.log の分析

## 要件

以下の項目は、トラブルシューティングに必要または役立ちます:

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

## ログファイルの構造

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

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

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

ログ内の完全な行は、代わりに次のようになる場合があります: `アップグレード` は次のようになる場合もあります `インストール` 操作によって:

{% code overflow="wrap" fullWidth="false" %}

```log
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"
```

{% endcode %}

<figure><img src="/files/474d6b552ba8282e191757a77d5d91a03f6c8fdb" alt=""><figcaption><p>chocolatey.log 内の choco インストールのエントリポイント</p></figcaption></figure>

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

以下の行には、多くの（本質的ではない）デバッグ情報が含まれ、その中には chocolateyInstall.ps1 の完全な内容も出力されます。\
デバッグ情報の中には、次の 2 つのセクションがあります `RJAppDeployToolkit: 入力環境変数` および `RJAppDeployToolkit: 結果の変数`。両方のセクションは隣り合って配置され、によって提供された変数と値を示します `RJAppDeployToolkit`

<figure><img src="/files/0c2df4f58ac66db3e0cf39d2cbc5a8f61bab729c" alt=""><figcaption><p>RJAppDeployToolkit の出力</p></figcaption></figure>

### インストールプロセス

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

{% code overflow="wrap" %}

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

{% endcode %}

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

{% code overflow="wrap" %}

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

{% endcode %}

{% code overflow="wrap" %}

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

{% endcode %}

確認と必要に応じたアンインストールの実行後、アプリケーションのメインインストールが開始されます。これは次のログメッセージで示されます（もちろんファイル名は異なります）:

{% code overflow="wrap" %}

```log
2023-08-22 15:05:47,858 [INFO ] - Git-2.42.0-64-bit.exe の RealmJoin-Install を開始しています
```

{% endcode %}

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

{% code overflow="wrap" %}

```log
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) のダウンロードが完了しました。
```

{% endcode %}

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

{% code overflow="wrap" %}

```log
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" ] を実行しています。これは、指定内容によってはしばらく時間がかかる場合があります。
```

{% endcode %}

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

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

{% code overflow="wrap" %}

```log
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'.
```

{% endcode %}

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

{% code overflow="wrap" %}

```log
2023-09-13 16:49:18,550 7224 [INFO ] - postActions を実行しています...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions が完了しました。
```

{% endcode %}

chocolatey のインストールプロセスは、次のログメッセージで終了します（install / upgrade によって表現は異なる場合があります）:

{% code overflow="wrap" %}

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

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/analysing-chocolatey.log.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
