> 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/troubleshooting-failed-craft-packages.md).

# 失敗した craft パッケージのトラブルシューティング

ユーザー スコープでは tray.log、システム スコープでは realmjoin.log を読んで、失敗した craft パッケージのインストールを診断します。

craft パッケージには個別のログはありません（インストーラーが craft パッケージ内に明示的に書き込んだ場合を除く）。\
どのスコープで実行されるかによって `システム` または `ユーザー`、（非常に基本的な）出力は次の場所にあります `tray.log` （ユーザースコープの場合）または次の場所にある `realmjoin.log` （システムスコープの場合）。

## ユーザースコープの craft パッケージ

ユーザースコープで実行される craft パッケージについては、上記のとおり、出力は次の場所にあります `tray.log` ファイル。パッケージ ID の代わりに、設定されたパッケージの表示名を使って該当行を見つけることができます：

{% code overflow="wrap" %}

```log
2023-11-07 15:37:57.7527|INFO|RealmJoin.Core.SoftwarePackaging.CraftPackageEntry|   1|craft パッケージ Microsoft Teams 1.6.0.2757300（ユーザー）をインストールしています
```

{% endcode %}

これにほぼ即座に（インストール時間によっては）続いて次が表示されます：

{% code overflow="wrap" %}

```log
2023-11-07 15:38:51.1590|INFO|RealmJoin.Core.SoftwarePackaging.CraftPackageEntry|   1|パッケージ結果：コード = 0、出力：

2023-11-07 15:38:51.1590|INFO|RealmJoin.Core.SoftwarePackaging.CraftPackageEntry|   1|Microsoft Teams 1.6.0.2757300（Craft）パッケージのインストールに成功しました。
```

{% endcode %}

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FdzUye7qk7RCTQ1YAF9f1%2Fcraft-user-install.png?alt=media&amp;token=4ee49916-b9c4-4682-ad19-595d30bcd9c7" alt=""><figcaption><p>craft ユーザーパッケージのインストール成功時の出力例</p></figcaption></figure>

## システムスコープの craft パッケージ

システムスコープで実行される craft パッケージの関連ログは、次の間で分割されます `tray.log` ダウンロードと初期化の情報用の `realmjoin.log` 実際の出力と戻りコード用のものです。それ以外は、ユーザーの craft パッケージのインストール時と同じです。

以下の例では、パッケージの出力がログファイルにどのように含まれるかを示します：

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FyedjTexR79xW04oBU6nV%2Fcraft-system-install.png?alt=media&amp;token=f8c6ccc5-50ca-429f-95d3-c42204a5d116" alt=""><figcaption><p>ログファイルに表示される craft パッケージスクリプトの出力。</p></figcaption></figure>

その `tray.log` ファイルには、パッケージがシステムスコープで実行されるかユーザースコープで実行されるかを示すヒントが、バージョン番号の後の括弧内に常に含まれます：

{% code overflow="wrap" %}

```log
2023-11-07 15:48:58.5875|INFO|RealmJoin.Core.SoftwarePackaging.CraftPackageEntry|   1|craft パッケージ RealmJoin Set Environment Variable 2.0.0.0（システム）をインストールしています
```

{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/troubleshooting-failed-craft-packages.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
