> ## Documentation Index
> Fetch the complete documentation index at: https://aletyx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Review execution history, audit logs, and analytics for deployed models.

Review execution history, audit logs, and analytics for deployed models. All guides require Management access.

Monitoring has three screens, each in the left sidebar:

| Screen         | Use it to…                                                            |
| -------------- | --------------------------------------------------------------------- |
| **Monitoring** | Browse and inspect individual model executions                        |
| **Audit Log**  | See who changed what and when (configuration changes, not executions) |
| **Insights**   | View aggregate metrics and trend charts                               |

## Executions

<img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/executions-list.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=4695ca1c3dbd8584b4334a933e184f8f" alt="Monitoring executions list" width="1892" height="909" data-path="images/decision-control/how-to/executions-list.png" />

<Info>
  **Executions vs. Execute Rules history**

  These are the **persisted** server-side execution records — they survive reloads and are visible to everyone with Management access. The History tab inside [Execute Rules](/docs/decision-control/how-to/management-execute#how-to-review-execution-history-in-execute-rules) is your local replay buffer for the current session.
</Info>

### How to view and filter executions

Browse all model executions and narrow the list.

**Steps:**

1. Open **Monitoring → Monitoring** (executions list).
2. Use **Search by unit or model…**, the **Status** filter, and the **Range** (or custom **Start/End Date**) filter.
3. Sort via column headers; **Clear Filters** to reset; **Refresh Data** to reload.

**Verify:** The table shows matching executions with paging.

### How to view execution details

Inspect one execution's inputs, outputs, and metadata.

**Steps:**

1. In the executions list, click **View Details** (or the row).
2. Review the **Execution Detail** tab; switch input/output between **Form View** and **JSON**.
3. (Optional) Click the copy icon next to the execution ID to copy a shareable link to this execution.

**Verify:** The detail page shows the execution summary and I/O.

### How to run a simulation against another model version

Re-run a past execution's inputs against a different model version and compare — the fastest way to answer "would this case behave differently on the new version?"

**Prerequisites:** Viewing an execution detail.

**Steps:**

1. Open the **Simulator** tab.
2. Search/select a model version (by name, version, or hash).
3. Click **Run Simulation**.
4. Use the diff controls (**Show diff only**, search, theme) to compare outputs.

   <img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/simulator-diff.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=67653da7e5372af266ccd6f399da92d5" alt="Simulator diff between two versions" width="1920" height="1068" data-path="images/decision-control/how-to/simulator-diff.png" />

**Verify:** A visual diff comparison renders original vs. simulated output.

## Audit Log

<img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/audit-log.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=ae22cd53f1bddc06954140b1bcb12d0c" alt="Audit log table" width="1902" height="923" data-path="images/decision-control/how-to/audit-log.png" />

The audit log captures **configuration changes** — uploads, enable/disable toggles, deletes, description edits. Every row tells you who did what, to which entity, when.

| Operation  | Means                                                             |
| ---------- | ----------------------------------------------------------------- |
| **INSERT** | An entity was created (e.g., a model uploaded)                    |
| **UPDATE** | An entity was modified (e.g., description edited, status toggled) |
| **DELETE** | An entity was removed                                             |

### How to view and filter the audit log

**Steps:**

1. Open **Monitoring → Audit Log**.
2. Use **Search…**, **Entity Type**, **Operation** (INSERT/UPDATE/DELETE), and **Range**/custom dates.
3. Sort columns; **Clear Filters** to reset.
4. Click **View Details** on a row for the full entry.

**Verify:** The table filters accordingly and the details modal opens.

### How to export the audit log to CSV

Download audit entries for offline review.

**Prerequisites:** At least one audit entry (the button is disabled otherwise).

**Steps:**

1. On **Audit Log**, apply any filters you want.
2. Click **Export CSV**.

**Verify:** A CSV file downloads containing the audit entries.

## Insights

Insights has four views you switch between with tabs at the top:

<Tabs>
  <Tab title="Overview">
    Big-picture metric cards and the most recent activity at a glance.

    <img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/insights.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=c48547ac92a7c24f138d2fee9faf8c5a" alt="Insights — Overview" width="1908" height="911" data-path="images/decision-control/how-to/insights.png" />
  </Tab>

  <Tab title="Models & Versions">
    Per-model and per-version statistics — useful to spot a version that's getting hit (or failing) more than expected.

    <img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/models-versions-tab.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=30ae5bb839b5c0feede1027d7320029b" alt="Insights — Models & Versions" width="1890" height="923" data-path="images/decision-control/how-to/models-versions-tab.png" />
  </Tab>

  <Tab title="Executions">
    Trend charts over time. Adjust **Range** and **Granularity** to zoom from "last hour" to "last quarter".

    <img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/executions-tab.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=71fa9370564b647a9f4ed399c892a324" alt="Insights — Executions" width="1898" height="904" data-path="images/decision-control/how-to/executions-tab.png" />
  </Tab>

  <Tab title="Operations">
    Audit operation counts — how many **INSERT** / **UPDATE** / **DELETE** operations happened, broken down by entity type.

    <img src="https://mintcdn.com/aletyx-3353d50c/-SprOR0k3X7EKq06/images/decision-control/how-to/operations-tab.png?fit=max&auto=format&n=-SprOR0k3X7EKq06&q=85&s=e7ba928e24d062d6fe8cfedc6087fadc" alt="Insights — Operations" width="1900" height="911" data-path="images/decision-control/how-to/operations-tab.png" />
  </Tab>
</Tabs>

### How to view insights and analytics

**Steps:**

1. Open **Monitoring → Insights**.
2. Pick the tab you need (see above).
3. Click **Refresh Data** to reload.

**Verify:** Cards and charts render with current data.
