> For the complete documentation index, see [llms.txt](https://docs.cw.crisisworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/diagnostics.md).

# Diagnostics

This page explains how to use the Diagnostics screens.

## Overview

Diagnostics is used to ensure that your system continues to run smoothly and can help when obtaining support from the Help Desk.&#x20;

This screen shows helps you:

* Check for potential application problems and resolve them ([App Data](#app-data))
* [Set a custom location](#custom-location)
* Run automatic maintenance commands to help Datalink support you ([Diagnostics](#diagnostics))
* Find the version of the software that you're running ([Software Information](#software-information))

### Access

Diagnostics is accessed from the [User Menu](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties.md#user-menu) via the Diagnostics link under SYSTEM.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FxvbJZaaEyDn7tWRzosGo%2Fimage.png?alt=media&amp;token=d4676a72-a882-4f87-9efa-20cd916dccaa" alt="" width="235"><figcaption><p>Diagnostics link in the User Menu</p></figcaption></figure>

### Navigation

All of the Diagnostics are displayed on one page in sections.

You can collapse specific sections using the Hide <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F7ZZMpdnZJfzp9Ab1FsX8%2Fimage.png?alt=media&amp;token=2e67fca9-a64c-46f0-859e-f07ed8d438c3" alt="" data-size="line"> button.

You can show expand sections using the Show <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F9uP11qqMNYIOeHZRCOwj%2Fimage.png?alt=media&amp;token=955b44cf-29c5-41d3-971e-6ae4df1d744f" alt="" data-size="line"> button.

## App Data

App Data gives a snapshot of the health of the system, including the main registers.

Use the Reload Settings button <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FGwYjNuCjifXugEaQsgJI%2Fimage.png?alt=media&amp;token=2af255d2-887d-41c2-9607-c9d03b1bee8b" alt="" data-size="line"> or the Refresh<img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FIr0MOPze07CX0TMyXpGD%2Fimage.png?alt=media&amp;token=e6299aed-12e2-434e-b6b4-19a96985bc27" alt="" data-size="line">button to apply available updates​.

The icons indicate as following:

* <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FbbplZybEziJLCqxsHe9M%2Fimage.png?alt=media&amp;token=e9134fe9-abd3-492e-acfe-782e5d5c4747" alt="" data-size="line"> Spinning loading symbols indicate that the diagnostic is still being run. Please be patient until the process completes. If the spinning continues longer than reasonable reload the settings or contact the Help Desk.
* <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FrxauGDSjhxAQYvkOtzMa%2Fimage.png?alt=media&amp;token=180ec835-879e-4af2-a28e-7d2d3c835d13" alt="" data-size="line">Green Ticks indicate that these registers are running properly. A green tick at the top right corner indicates that all systems are functioning normally.
* Orange exclamation mark icons flag potential problems. If you are also experiencing problems, contact the Help Desk and which settings were flagged.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FgqviYvoJ5xhbb3esrrCR%2Fimage.png?alt=media&amp;token=21c8d076-48f9-4ffb-8ef3-23c031d69ad3" alt="" width="375"><figcaption><p>Updating settings screen</p></figcaption></figure>

#### Restart App

Sometimes you may be advised to restart the app to reset your session. Us the Restart App button to shut down the session, log out and log in again automatically.

#### Sign Out

You can sign out using the red Sign Out button.

## Offline functionality support

This setting enables you to enable offline support by going offline or going online.

By default your system will be online, you can go offline using the Go offline button.

If you're offline, you can go online using the Go online button.

## Location Services

Location tracking is used to mark the location of records you create and helps to find nearby assets. Upon starting, the app may ask to connect to location services on the device.

This section holds the current tracking connection status, including the last update and location in latitude and longitude.

For troubleshooting, you can reset location services using the Reset button.

## Custom Location

{% hint style="info" %}
This section may not be available for all users, it is a Site configuration. If you do not have access to this section, this may be for a reason.
{% endhint %}

This setting allows you to enter a custom Latitude and Longitude to simulate being in another location. This can be useful when training or simulating conditions in one location from another.

{% hint style="info" %}
A custom location will affect your default location in maps throughout the system.
{% endhint %}

To set a Custom Location:

1. Enter a decimal value for the Latitude into the **Latitude** box
2. Enter a decimal value for the Longitude into the **Longitude** box

{% hint style="info" %}
The format of the values entered into these fields is important otherwise it will not work.

It should just be decimal numbers and an optional negative prefix in Latitude for South or Longitude for West.

Do not include the degrees symbol, quotes or direction suffix.

The location for Sydney, for example, would entered as be **Latitude** -33.8688 and **Longitude** 151.2093.

You can obtain accurate Latitude and Longitude values for locations through applications like Google Maps.
{% endhint %}

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FyvnUknpNZ1IqweFutOZL%2Fimage.png?alt=media&amp;token=7ab2eb1e-9cff-4aea-99db-c9aa24f525bf" alt="" width="375"><figcaption></figcaption></figure>

## Diagnostics

This section contains key information to assist Datalink when there are ongoing problems.

Session includes the unique code your system is using to maintain its session.

#### Reset Configuration

Do not use this option unless you've first spoken with Help Desk about.a problem that this may solve as it may have unexpected effects.

If requested to, use the Reset Configuration ![](https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F4TJeQ5pIt8QfRu2Vyql0%2Fimage.png?alt=media\&token=9a455c3c-4531-4c31-aa09-532660c5a6e3) button.

#### Sending Diagnostics

If there are ongoing problems, it may be useful to send diagnostics to Datalink. You may also be requested this by Help Desk.&#x20;

Doing so includes important information that can identify the session and help Datalink to diagnose the sequence of events that led to a problem or error.

You can do this using the Send Diagnostics ![](https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FncRFvGHP9PxXFeykRw83%2Fimage.png?alt=media\&token=da0d1677-73c4-439a-97be-c7ec043c4e35) button.


---

# 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.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/diagnostics.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.
