# Use PerformanceGuard in ServiceNow Incidents

> See PerformanceGuard computer information and events on a ServiceNow incident, open the computer in PerformanceGuard, and attach a PDF report.

Source: https://docs.capaone.com/performanceguard/technical-reference/use-performanceguard-in-servicenow-incidents/  
Product: PerformanceGuard — a separate CapaSystems product; do not apply this page to any other.

When the PerformanceGuard Incident Management Connector is installed in ServiceNow, incidents show PerformanceGuard data about the affected computer. Service desk staff can use it to diagnose performance problems without leaving the incident.

:::note[Before you start]
- A ServiceNow administrator must install and configure the connector. See [ServiceNow Integration](/performanceguard/technical-reference/servicenow-integration/).
- Your ServiceNow user needs the PerformanceGuard user role from the connector.
- Your browser must be able to reach the PerformanceGuard web interface over HTTPS. The incident form loads the PerformanceGuard data directly from the PerformanceGuard server.
:::

## Show PerformanceGuard data on an incident

1. In ServiceNow, open an incident or create a new one.
2. In **Configuration item**, select the computer the incident is about.

![New ServiceNow incident with a Configuration item selected and the PerformanceGuard tab below](/attachments/performanceguard/975d6064-dad2-4310-97ab-1daaf80553d1.png)

![PerformanceGuard tab on an incident, with Computer Info and Top Events - Past 24 Hours](/attachments/performanceguard/a4d6c889-cf32-4c14-b86d-7c3af51671a3.png)

The connector looks up the computer name in PerformanceGuard. If it finds a PerformanceGuard agent with that name, a **PerformanceGuard** tab appears on the incident form. If it doesn't find an agent, the tab stays hidden.

:::tip
If your incident form uses another field than **Configuration item** for the computer name, your ServiceNow administrator can change which field the connector reads. See [ServiceNow Integration](/performanceguard/technical-reference/servicenow-integration/).
:::

## What the PerformanceGuard tab shows

| Part | What it shows |
|:--|:--|
| **Computer Info** | Details about the computer from PerformanceGuard, such as hardware, operating system, network, recent startup and login times, and agent details. If PerformanceGuard has no agent for the computer, it shows **No PerformanceGuard Agent Found**. |
| **Top Events - Past 24 Hours** | The PerformanceGuard events for the computer in the 24 hours before the incident was created. The table shows the time, the event rule name, and the event label. Select a column heading to sort by it, and select it again to reverse the order. |
| **Buttons** | **Open in PerformanceGuard** and **Attach PerformanceGuard Report**. See the following sections. |

For more about the event rules behind the events, see [Alert Rules](/performanceguard/administration/manage-thresholds-and-events/alert-rules/).

## Open the computer in PerformanceGuard

1. On the **PerformanceGuard** tab, select **Open in PerformanceGuard**.
2. Confirm that you want to open PerformanceGuard in a new tab.

PerformanceGuard opens the dashboard that your administrator chose for the connector, showing data for the incident's computer. You may have to sign in to PerformanceGuard first.

## Attach a PerformanceGuard report

1. On the **PerformanceGuard** tab, select **Attach PerformanceGuard Report**. In older versions of the connector, the button is called **Attach PG Report**.

   The button shows **Getting PDF Link...** while PerformanceGuard creates a PDF of the dashboard for the computer.
2. When the button changes to **Download Attached PDF**, save the incident to keep the report link on it.

Anyone who opens the incident later can select **Download Attached PDF** to open the report as it looked when it was created.