> For the complete documentation index, see [llms.txt](https://docs.expel.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.expel.io/workbench-reference/dashboards/service-review-dashboard.md).

# Service Review Dashboard

The Service Review dashboard shows a full picture of how your organization and Expel are working together to keep your environment secure. Access it by going to **Dashboards > Service Review**.

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FFxAdslSFwkiBIIB38Cn6%2Fwb_servicereview_dashboard.png?alt=media&amp;token=1864f542-9b22-4fa4-92b0-374449a8af21" alt="Image of the Service Review Dashboard."><figcaption></figcaption></figure>

## About the Dashboard

See below for more more details about each part of the page.

<details>

<summary>"How are we working together?" panels</summary>

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FFtFsYgBnHCJDKzPWh58l%2Fwb_servicereview_area1.png?alt=media&amp;token=5ab21fd6-b91b-4ee3-96d7-49dda2aa9f38" alt="Image showing the how are we working together section at the top of the page."><figcaption></figcaption></figure>

* The `Time to remediate with Verify Actions` panel shows the mean time from alert arrival in Workbench to the first Remediation Action completed, for incidents that require verification with your organization. This metric allows you to see how responsive your organization is to our alerts.
* The `Time to remediate without Verify Actions panel` shows the mean time from alert arrival in Workbench to the first remediation action completed, for incidents that *do not* require verification with your organization. This metric allows you to see how responsive Expel is after an alert happens, in cases where we are able to remediate the issue without notifying your organization first.

</details>

<details>

<summary>Download Reports</summary>

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FVfsdDQ8LGgFB8ONunsvl%2Fwb_servicereview_downloadreports.png?alt=media&amp;token=3a81afe1-8d70-4324-a2cf-28e1a0cb5426" alt=""><figcaption></figcaption></figure>

You can download four standard SOC operational reports as CSV files. A blank entry indicates no incident or remediation occurred during the reporting period. See the [Reports Reference](#reports-reference) for more information about how the data is calculated.&#x20;

{% hint style="info" %}
These reports are currently available for all standard time ranges (last month, past 7 days, past 30 days, past 90 days, past 180 days). Custom time ranges are not yet supported.
{% endhint %}

* `Mean Time to X (MTTX) Reports` shows the mean time (in minutes) to detect, triage, decision, investigate, acknowledge, and respond based on alert severity (All Severities, Critical, High, Medium, Low, Tuning). Suppressed alerts are not included in this report.
* `Top Detections by Volume` shows the top 10 detections by volume that were triggered during the reporting period, the number of alerts for each, and the most common close reason. The report also breaks down the alerts into those that were suppressed or benign, and offers a percentage for each (for example, if 200 alerts out of 2500 for a particular detection were suppressed, this would account for 8% of all alerts for that detection).
* `Close Reason Breakdown` lists all close reasons during the reporting period, the count of alerts for each one, and each count's percentage of the total count.
* `All Expel Alerts, Investigations, Incidents` lists all Alerts, Investigations, and Incidents that were closed during the reporting period. This information helps you manually validate the totals against other reports, or make your own calculations based on custom filters or groupings.

</details>

<details>

<summary>"Time to" panels</summary>

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FCkpyBVpHcFhljYQMNNcJ%2Fwb_servicereview_3panels.png?alt=media&amp;token=b93c0289-d928-416d-a876-933b8dead3e8" alt="Image showing the three panels, which look like boxes."><figcaption></figcaption></figure>

These three panels offer more details about response times. You can use them to help monitor and/or improve your engagement with security questions or assigned actions.

* The `Time to triage` panel shows the actual triage times for alerts.
* The `Time to complete Verify Actions` panel shows the mean time it takes for your organization to respond to a Verify Action.&#x20;
* The `Time to complete Remediation Actions` shows the mean time it takes for your organization to complete an assigned Remediation Action.

</details>

<details>

<summary>How we think about Verify Actions</summary>

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2F9cLYldYfyCmseWbygWKW%2Fwb_servicereview_verifyactions.png?alt=media&amp;token=6b3750ac-6dd1-4ff4-9d42-1a0408702b9e" alt="Image showing the verify actions information area."><figcaption></figcaption></figure>

This panel offers general information about Verify Actions and some tips for accelerating your remediations.

</details>

<details>

<summary>Automations and context</summary>

<div align="left"><figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FclLYxpVUiyDVURrQmn9U%2Fwb_servicereview_automations.png?alt=media&amp;token=2dde6c43-5698-4ee0-97cf-24561447c9cf" alt="Image showing automations and context, with percentages and an explanation for each." width="375"><figcaption></figcaption></figure></div>

This panel shows you how your automations and context are performing over the specified time period.

</details>

<details>

<summary>Expel Alert count by time of day, UTC</summary>

<figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FD1576Y8E0zWmvqvplSzv%2FService_Review_dashboard_Example_Alert_Count.png?alt=media&amp;token=bf43143d-dd48-4b3e-9b91-5c816260d913" alt="Image showing alert count by time of day in a chart format."><figcaption></figcaption></figure>

This panel shows you a heat map of your Expel Alerts by time of day and day of week. You can use it to help your organization provide appropriate staffing when Expel Alerts are most common.

</details>

<details>

<summary>What has Expel been up to?</summary>

<div align="left"><figure><img src="https://2371323735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F82234aPbNfd179j5U4ti%2Fuploads%2FWgUKlvd14LcpBqLjvmgf%2Fwb_servicereview_lastpanel.png?alt=media&amp;token=63970f4d-3849-4069-97a1-717a35cae636" alt="Image showing the What has Expel been up to box." width="375"><figcaption></figcaption></figure></div>

This panel shows you the detections that were added or updated for the specified time period.

</details>

## Reports Reference

### Scope and Limitations

All data in the available SOC operational reports is only based on `Closed` alerts. **No Managed Phishing or Threat Hunting alerts are included in the data.**&#x20;

### MTTX Formulas

<table data-search="false"><thead><tr><th width="162.9375">Mean Time to (MTT*)</th><th>Definition</th><th>Formula</th></tr></thead><tbody><tr><td><strong>D</strong>etect</td><td>The time between when an event is created in your environment, and when an Expel Alert is created.</td><td><p><code>time_to_detect_ms = expel_alert_created_at − first_detected_at</code>, converted to minutes (<code>/ 60000</code>), then averaged across alerts.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If the raw difference is ever negative, it will null.</p></div></td></tr><tr><td><strong>T</strong>riage</td><td>The time between Expel Alert creation and the first SOC analyst touch.</td><td><code>time_to_touch_ms = first_touched_at − expel_alert_created_at</code>, ÷ 60000, averaged (<code>avg_time_to_touch</code>).</td></tr><tr><td><strong>D</strong>ecision</td><td>The time between Expel Alert creation and the analyst's first disposition decision.</td><td><code>time_to_decision_ms = first_decision_at − expel_alert_created_at</code>, ÷ 60000, averaged (<code>avg_time_to_decision</code>).</td></tr><tr><td><strong>I</strong>nvestigate</td><td>The time between Investigation creation and investigative work ending.</td><td><code>time_to_investigate_ms = investigative_work_first_ends_at − inv_created_at</code>, ÷ 60000, averaged (<code>avg_time_to_investigate</code>).</td></tr><tr><td><strong>A</strong>cknowledge</td><td>The time between the lead Alert's creation and an Incident being declared.</td><td><code>time_to_acknowledge_ms = inv_first_moved_to_incident_at − lead_expel_alert_created_at</code>, ÷ 60000, averaged (<code>avg_time_to_acknowledge</code>).</td></tr><tr><td><strong>R</strong>espond</td><td>The time between the lead Alert's creation and the first Remediation Action being created.</td><td><code>time_to_respond_ms = first_remediation_created_at − lead_expel_alert_created_at</code>, ÷ 60000, averaged (<code>avg_time_to_respond</code>).<br></td></tr><tr><td><strong>V</strong>erify</td><td>Time between when an assigned Verify Action is first acknowledged by you and when a response occurs.</td><td><p> <code>time_to_verify_by_customer_sec = GREATEST(first_acknowledged_at − first_customer_assigned_at, 0)</code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The formula floors at 0. If the raw difference is ever negative, it is corrected to 0.</p></div></td></tr><tr><td><strong>R</strong>emediate</td><td>Time between when the lead Expel Alert is created and when the first recommended Remediation Action is completed.</td><td><p> <code>created_completed_all − lead_expel_alert_created_at</code></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This is distinct from the <code>first_remediation_completed_at</code> field.</p></div></td></tr></tbody></table>

### Troubleshooting

If you have trouble exporting any of the reports, or if you believe you have found inaccurate data, please [contact our Support team](/support/how-to-reach-us.md).


---

# 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.expel.io/workbench-reference/dashboards/service-review-dashboard.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.
