> 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] - コマンドライン: "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] - 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1' を実行中
```

{% endcode %}

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

{% code overflow="wrap" %}

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

{% endcode %}

{% code overflow="wrap" %}

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

{% 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] - コマンド ["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' で終了しました。
```

{% 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.
