> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/monitoring.md).

# Monitoring

To access the monitoring tools, simply go to the **Insights** section in the top navigation bar of your Dashboard.

<figure><img src="/files/JEVK07ZKdsAUxkYy0BVu" alt="UCL dashboard with the Insights tab highlighted in the top navigation bar, showing connected apps"><figcaption></figcaption></figure>

### Overview Dashboard

<figure><img src="/files/y5r4Z5ARwgyTASUUFzci" alt="UCL Insights Overview dashboard showing active tenants, connectors, success rates, and usage metrics"><figcaption></figcaption></figure>

The dashboard represents each action triggered by a connector (e.g., sending a message, syncing data) and monitors them across key metrics:

* **Active Tenants (%)** – total tenants connected and their active percentage.
* **Active Connectors** – number of connectors currently in use.
* **Tenant Request Success Rate** – percentage of successful requests per tenant.
* **Monthly Usage** – number of actions performed this month.
* **Weekly Usage** – number of actions performed this week.
* **Today's Usage** – number of actions performed today.
* **Connection Success Rate** – percentage of successful connector connections.
* **Average API Latency** – average time an API takes to respond.
* **Average Workload Latency** – average time a workload (background process) takes to complete.
* **Total Data Transfer** – total volume of data transferred across tenants.
* **Tenant Usage Summary** – per-tenant details including names, connections, errors, and total data transferred.
* **Most Used Connectors** – list of the top connectors in your workspace.
* **Connection Error Rate** – percentage of connection errors across all tenants.

{% hint style="info" %}
Workspace-specific data is not displayed here.
{% endhint %}

### Tool Usage

* A **graph** shows tool usage trends for the current month (date-wise).
* **App Breakdown** section lists:
  * Tool (the app name)
  * Tool calls
  * Tool used
  * Response usage
* Use the **filter** at the top to switch between current month or current week views.

<figure><img src="/files/tznIcy53bgBMM5RwjPGL" alt="UCL Insights Tool Usage page with a monthly trend graph and App Breakdown table showing tool calls and response usage"><figcaption></figcaption></figure>

### Logs

The logging system provides detailed visibility into every action performed.

* **Filter by status** to quickly narrow down logs.
* View details for each action, including:
  * Connector name
  * Action performed
  * Status
  * Duration
  * Request time

{% hint style="info" %}
Expand a log entry to view the **full request details**.
{% endhint %}

<figure><img src="/files/F6kNztzwUovwsmh1Mh41" alt="UCL Insights Logs tab showing a table of connector actions with status codes, durations, and request times"><figcaption></figcaption></figure>

By clicking the **→** button, you can access detailed insights for individual logs, including:

* Unique log IDs
* Timestamps
* Detailed request parameters and responses

<figure><img src="/files/5CWAHDGbeifWbA1zvpMt" alt="Expanded log entry showing request JSON with action ID, parameters, and response timing details"><figcaption></figcaption></figure>

### **Why Monitoring Matters**

* **Privacy & Ownership** – Each tenant's monitoring data is strictly isolated, with full control over their data access and retention policies.
* **Faster Issue Resolution** – Easily trace failures to a specific connector, tool, or tenant.
* **Operational Confidence** – Know which parts of your system are underperforming or underutilized.
* **Security & Compliance** – Every request is tenant-scoped and logged, making audits and access reviews simple.
* **Scalability** – As you grow, dashboards help ensure consistent quality of service across all users.

> UCL doesn't just route and execute, it gives you full observability to manage and optimize your integration layer with confidence.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/monitoring.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.