# Getting started with Diagnostics

Diagnostics are an effective set of tools and dashboards for assessing and troubleshooting various IT issues. Diagnostics are integrated throughout the product.

* The Diagnostics panel is integrated directly into the Applications module to aid in troubleshooting web application issues for page loads. Refer to the [Embedded Diagnostics side panel in the Applications module](#gettingstartedwithdiagnostics-pageloads) for more information.
* The [Diagnostics for alerted issues](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/responding-to-alerts/diagnostics-for-alerted-issues) dashboard is directly connected to the drill-down options on the Alerts overview page.
* Drill down on issues using diagnostics from Device View.

## Accessing Diagnostics <a href="#gettingstartedwithdiagnostics-accessingdiagnostics" id="gettingstartedwithdiagnostics-accessingdiagnostics"></a>

* Select **Alerts and Diagnostics** from the main menu.
* Click on a dashboard in the **Diagnostics** section of the navigation panel.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-e6aec3db89a0df808cf3f56ff85fdffab613c13f%2Fdiag-1691735681.png?alt=media" alt="Accessing Diagnostics"><figcaption></figcaption></figure>

## Diagnostic dashboards <a href="#gettingstartedwithdiagnostics-diagnosticdashboards" id="gettingstartedwithdiagnostics-diagnosticdashboards"></a>

The Diagnostics dashboards contain a similar design pattern.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-24024d457ee373e45d800b29048cc65364ac5421%2Fdiag-1691570732.png?alt=media" alt="Execution crashes details page"><figcaption></figcaption></figure>

### Top banner <a href="#gettingstartedwithdiagnostics-topbanner" id="gettingstartedwithdiagnostics-topbanner"></a>

The banner at the top of the page shows the summary and impact of the issue. It includes a gauge with an action menu that links to the Investigations page with more drill-down options.

### Assess issue <a href="#gettingstartedwithdiagnostics-assessissue" id="gettingstartedwithdiagnostics-assessissue"></a>

Understand the context and scope of the issue with a timeline of events and filtering capabilities by technical properties, location and organization entities.

### Troubleshoot <a href="#gettingstartedwithdiagnostics-troubleshoot" id="gettingstartedwithdiagnostics-troubleshoot"></a>

#### **Benchmarking**

Diagnostics uses anonymized cross-customer statistics from Nexthink cloud customers to help scope and troubleshoot issues. If the system does not show benchmark statistics for a given binary name, device model or version, it means that the system does not have enough statistical data to calculate it. Customers are opted-in by default to share telemetry so they can benefit from the benchmarking insights. Contact your Nexthink representative if you wish to opt out of this feature.

#### **Insights**

View automated AI-powered insights that offer analysis to help find the root cause of the issue impacting devices. The algorithm uses Bayesian inference that learns from the data of all devices in customer's environment to quantify the likelihood that a given attribute is relevant to the issue. The insight’s relevancy is based on the confidence level that is calculated using the following parameters:

* How many devices with specific property value are impacted.
* How many devices with specific property value are impacted compared to the number of impacted devices in the overall population (e.g. specific binary version vs. all binary versions).
* The frequency of the issue for the given property value.
* The frequency of the issue for the given property value compared to the frequency of the issue in the overall population.

The factors listed above affect the relevancy of a version, but do not constitute a hard threshold.

Find more information about individual pages:

* [Execution crashes](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics/execution-crashes)
* [High CPU usage](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics/high-cpu-usage)
* [System crashes](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics/system-crashes)
* [Binary profiling](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics/binary-profiling)
* [Diagnostics for alerted issues](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/responding-to-alerts/diagnostics-for-alerted-issues)
* [Additional dashboards](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics/additional-dashboards)

## Embedded Diagnostics side panel in the Applications module <a href="#gettingstartedwithdiagnostics-embeddeddiagnosticssidepanelintheapplicationsmodulepageloads" id="gettingstartedwithdiagnostics-embeddeddiagnosticssidepanelintheapplicationsmodulepageloads"></a>

The system automatically enables diagnostics for the Applications module. Find them in the side panel on the Page loads and Reliability pages.

For more information, refer to the [Diagnostics section](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/responding-to-alerts/diagnostics-for-alerted-issues) of the Monitoring capabilities documentation.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-7f5c86fbc88e487c59ad93d1d4d430b6138d845d%2Fdia-1655975591.png?alt=media" alt="Embedded Diagnostics for troubleshooting in Application Experience"><figcaption></figcaption></figure>

## Permissions <a href="#gettingstartedwithdiagnostics-permissions" id="gettingstartedwithdiagnostics-permissions"></a>

To enable proper permissions for Diagnostics:

* Select **Administration** from the main menu.
* Click on **Roles** from the navigation panel.
* Click on the **New role** button to create a new role or edit an existing role by hovering over it and clicking on the edit icon to change the role configuration.
* In the **Permissions** section, scroll down to the **Diagnostics** section to enable appropriate permissions for the role.

Refer to the [Roles](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/administration/account-management/roles) documentation for a detailed description of the permission options.

### View domain <a href="#amplify-dataprivacysettingsforamplify" id="amplify-dataprivacysettingsforamplify"></a>

The table below showcases what users with full and limited view domain access can do, assuming the necessary permissions are enabled.

| Capabilities                                        | Full access                                                                                                                                                                                                                                               | Limited access                                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Manage all checklists                               | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fxe9qrauGrjOJZofKmIuR%2Fimage.png?alt=media&#x26;token=9d5e2cb5-213d-4ef7-a437-026ef7ef7bfc" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| Manage Amplify (requires add-on license of Amplify) | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FNJMvV1b1bzoiP8793YsF%2Fimage.png?alt=media&#x26;token=7e5eded1-77fa-482a-847f-d0386fb45328" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| View all checklists                                 | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| View Amplify (requires add-on license of Amplify)   | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| View device view                                    | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| View Diagnostics dashboards                         | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original">                                                           |
| View installed packages in Amplify                  | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FaCReZvIm6aIKYmnX8L9A%2Fimage.png?alt=media&#x26;token=a286bfe6-52ab-42bc-b574-813c4cf527a4" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FqOThjUq22x9ZZUyvnewE%2Fspaces_xJSUDk9NTtCHYPG5EWs3_uploads_xe9qrauGrjOJZofKmIuR_image.webp?alt=media&#x26;token=7f1f84d9-f4f1-4cf9-a14c-6c3fd916e39f" alt="" data-size="original"> |

***

RELATED LINKS

* [Diagnostics for alerted issues](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/responding-to-alerts/diagnostics-for-alerted-issues)
* [Monitoring capabilities](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/applications/monitoring-applications/monitoring-web-applications-old-experience/diagnostics-for-web-applications)
* [Roles](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/administration/account-management/roles)


---

# 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.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/alerts-and-diagnostics/getting-started-with-diagnostics.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.
