> For the complete documentation index, see [llms.txt](https://docs.spectralink.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spectralink.net/amie-essentials/applications/logging.md).

# Logging

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-b4a44ed15e573e3a2da75f8ac191fe04187211ed%2Fimage148.png?alt=media)

The Logging app lets you configure a syslog server for log captures. A syslog server provides valuable logging information about the smartphone’s operation. The Logging app also provides debugging tools under the Advanced Debugging tab.

Complete information about the options offered by SAM can be found in the *Versity Applications Administration Guide*, available online at the Spectralink support site (see Appendix A: Spectralink References). Only a brief summary is provided here.

{% hint style="warning" %}
**LTE phones (96 Series) should not use logging**

Logging requires a fair amount of data usage. When LTE phones are using data on the cellular network, they can easily exceed their limit. Therefore, disable logging on LTE phones while using an LTE data connection.
{% endhint %}

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-a7f5e53824d088155dc3730c36bbb401292d1d64%2Fimage149.png?alt=media)

## Syslog

Syslog settings can be set at an Enterprise, Group, or Device level. Messages are buffered in the smartphone and can be retrieved through a USB download.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-26ff4997547e1a3f90c89fd5d669230186b18628%2Fimage150.png?alt=media)

### *Enable Syslog Service*

**Entry criteria**

|               |                                                 |
| ------------- | ----------------------------------------------- |
| **Type**      | Radio button                                    |
| **Default**   | Off                                             |
| **Unique?**   | No                                              |
| **Required?** | No; default will be used if left blank          |
| **Level**     | Enterprise usually, but may be set at any level |
| **Notes**     |                                                 |

### *Syslog Server Address*

IP address of the syslog server, or the relevant DNS name. If a DNS address is used, it must be fully qualified; for example: logPcap.spectralink.com. (“logPcap” will not work.)

**Entry criteria**

|               |                                                 |
| ------------- | ----------------------------------------------- |
| **Type**      | Text field                                      |
| **Default**   | None                                            |
| **Unique?**   | No                                              |
| **Required?** | Yes, for syslog server functionality            |
| **Level**     | Enterprise usually, but may be set at any level |
| **Notes**     | See above                                       |

### Syslog Server Port

**Entry criteria**

|               |                                                            |
| ------------- | ---------------------------------------------------------- |
| **Type**      | Numeric value; Accepts 0, 1 to 65535                       |
| **Default**   | 514; Leaving this value blank will enter the default value |
| **Unique?**   | No.                                                        |
| **Required?** | Yes, for syslog server functionality                       |
| **Level**     | Enterprise usually, but may be set at any level            |
| **Notes**     |                                                            |

### *Logcat Parameters*

Enter the string for filtering per <https://developer.android.com/studio/command-line/logcat.html>

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | string                                            |
| **Default**   | \*:w                                              |
| **Unique?**   | No                                                |
| **Required?** | Yes, if using a syslog server                     |
| **Level**     | Enterprise usually, but may be set at any level   |
| **Notes**     | See *Versity* *Applications Administration Guide* |

## Advanced Debugging

Advanced debugging options allow you to access technical debugging utility features on the Versity smartphone, including capturing a bug report. The various options are summarized here. Refer to the Logging section of the *Versity* *Applications Administration Guide* for various complexities and usage notes.

### General settings

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-fc56e2d8cb74b3bbdde36620c3f0f62106e08326%2Fimage151.png?alt=media)

#### WLAN Log File Upload

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Enable Crash Dump USB Download Mode

{% hint style="warning" %}
**For use by Spectralink support personnel only!**

When Enable Crash Dump USB Download Mode is allowed, instead of rebooting on certain types of (extremely rare) crashes the phone will become unresponsive while it holds its current state information to be retrieved by Spectralink personnel. Since the phone can become unresponsive, this setting should only be used by Spectralink personnel.
{% endhint %}

#### *Zip File Password Protect*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### *Password Parameter*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Text field                                        |
| **Default**   | admin                                             |
| **Unique?**   | No                                                |
| **Required?** | Yes, to access options                            |
| **Level**     | May be set at any level                           |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### *Allow On-Device Configuration*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### *Enable Wake Lock*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Enable UART Console Output

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

### **Bug Report, Logcat,** Network Capture Settings

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-0a3f6a5de2c40b37ca3ac07447d526a12227e720%2Fimage153.png?alt=media)

#### *Capture Bug Report*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Enable Logcat

If an upload server is configured, captured logcats will be uploaded to it.

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | On                                                |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | Device usually but may be set at any level        |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Network Capture

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Snapshot Length

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | string                                            |
| **Default**   | 114                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | May be set at any level                           |
| **Notes**     | See *Versity* *Applications Administration Guide* |

### QXDM Settings

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-547ef5397c484605414ea63887a5dd804026a711%2Fimage154.png?alt=media)

#### QXDM

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### QXDM Configuration File

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Dropdown menu                                     |
| **Default**   | Audio and network Related                         |
| **Unique?**   | No                                                |
| **Required?** | Yes, for QXDM log                                 |
| **Level**     | Any                                               |
| **Notes**     | See *Versity* *Applications Administration Guide* |

### Upload Server

The Upload Server is used for continuous uploads of logging files: bugreports, logcat, network captures, and qxdm.

Enter the upload server configuration parameters. If configured, bug reports will be uploaded to this location. If no server is configured, logs must be manually downloaded from the phone.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-bca73392ded713c978753cf27c184c6a96b64f8c%2Fimage155.png?alt=media)

#### Upload Server Address

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Text                                              |
| **Default**   | None                                              |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Upload Server Port

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Text                                              |
| **Default**   | 80                                                |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Network Protocol

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Dropdown menu                                     |
| **Default**   | HTTP                                              |
| **Unique?**   | No                                                |
| **Required?** | Yes                                               |
| **Level**     | Any                                               |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### User Edit Network Configuration

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Dropdown menu                                     |
| **Default**   | User cannot edit network configuration settings   |
| **Unique?**   | No                                                |
| **Required?** | Yes                                               |
| **Level**     | Any                                               |
| **Notes**     | See *Versity* *Applications Administration Guide* |

#### Network Configuration

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Dropdown menu                                     |
| **Default**   | Use only unmetered Wi-Fi connections              |
| **Unique?**   | No                                                |
| **Required?** | Yes                                               |
| **Level**     | Any                                               |
| **Notes**     | See *Versity* *Applications Administration Guide* |

### *Log Bundle*

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-9eadf32da4c51f0e36af7fa62b8df58d2da60a09%2Fimage156.png?alt=media)

#### *Capture Log Bundle*

**Entry criteria**

|               |                                                   |
| ------------- | ------------------------------------------------- |
| **Type**      | Radio button                                      |
| **Default**   | Off                                               |
| **Unique?**   | No                                                |
| **Required?** | No                                                |
| **Level**     | As needed for debugging; May be set at any level  |
| **Notes**     | See *Versity* *Applications Administration Guide* |


---

# 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.spectralink.net/amie-essentials/applications/logging.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.