# Collecting Logfiles

There are two main methods on how to easily collect the log files from an affected device.\
Logs can either be obtained directly on the client or remotely using the [RealmJoin Portal](https://portal.realmjoin.com).\
Both ways will result in the same ZIP file.

## On the client

The easiest way to collect the logs is using the built-in *Collect Logs* feature of the RealmJoin client:

1. Hold `CTRL+Shift` while clicking on the RealmJoin tray icon.
2. Select `Show Debug Window` (2nd item from the bottom).
3. In RealmJoin debug window click on the `Collect Logs` button.
4. A ZIP-file called `RealmJoin_Diagnostic.zip` will be created on the user's desktop.
5. This ZIP-file contains all important logs for troubleshooting failed installations.

<figure><img src="/files/O2FTQ6kvMjCpafNcWSEc" alt=""><figcaption><p>Collecting logs on the client using RealmJoin debug window</p></figcaption></figure>

## Remotely using the RealmJoin portal

Log files can also be requested remotely using the RealmJoin portal.

{% hint style="info" %}
For this feature to work, the client needs to be online and have a running RealmJoin tray. Also, you will need to wait for the next RealmJoin client sync cycle to complete until the log file download will be available. The usual sync cycle is 30 minutes, which is the maximum wait time.

The sync can be forced from the client by running `Sync this device` from the RealmJoin tray menu.
{% endhint %}

1. Open the [RealmJoin Portal](https://portal.realmjoin.com)
2. Search for the affected device and open the device page.
3. On the `Overview` tab, search for the section `Extended Logs`
4. Click on the `Request Logs` button.
5. Wait until the logs are availble, if the client is online the maximum wait time is around 30 minutes.
6. Click the download button left to the `Request Logs` button to download the ZIP file containing the logs.

{% hint style="warning" %}
The log ZIP file download is available to every user that has access to the RealmJoin Portal, not only the requesting account.
{% endhint %}

<figure><img src="/files/aqHsktxpkmXJQFCfRjkm" alt=""><figcaption><p>Requesting Logs using the RealmJoin Portal</p></figcaption></figure>

## Log files on AVD and MU devices

On devices with multiple users a drop down section allows to request logs for specific users.

<figure><img src="/files/GNlEG54XnwrTDcbFUtke" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/other/troubleshooting/package-installation-issues/collecting-logfiles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.