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

# Analytics

## Overview

<img src="https://mintcdn.com/nuwacomgmbh/n4lKCOY9l7_aCUKc/images/analyticsen.png?fit=max&auto=format&n=n4lKCOY9l7_aCUKc&q=85&s=cce30460f7344183bdc6af7b4bba36c1" alt="Analyticsen" width="3984" height="1816" data-path="images/analyticsen.png" />

Analytics provides workspace administrators with aggregated insights into usage across Chat, Agents, Workflows, and the nuwacom API. Use it to monitor adoption, compare activity over time, and export chart data for reporting.

Analytics are available in the workspace settings.

## Key benefits

* Track workspace usage across chats, Agents, Workflows, and the nuwacom API.
* Review central workspace metrics, including users, Agents, Workflows, and documents.
* Compare activity over time by grouping data by day, week, or month.
* Export chart data as CSV for analysis in Excel, reporting tools, or internal reports.

## When to use Analytics

Analytics help admins understand how a workspace is used over time. The area supports usage reviews, internal reporting, adoption tracking, and function-level analysis across Chat, Agents, Workflows, and API usage.

***

## How to view analytics data

1. Open Workspace settings.
2. Select Analytics.
3. Choose an analytics tab.
4. Set the Date range and Group by filters.

***

## Setting the date range and grouping

The filters above the analytics view control how data appears across charts and metrics. When a filter changes, all affected charts and metrics update based on the selected settings.

### Group by

**Group by** defines the time interval used to aggregate the data. Available examples include day, week, and month.

### Date range

**Date range** defines the period used for the usage statistics. Available examples include today, last week, and a custom range.

***

## Analytics areas

The Analytics area contains separate tabs for different evaluation areas. The available tabs are **Overview**, **Chat**, **Agents**, **Workflows**, and **API**.

### Overview

The Overview tab shows central workspace metrics. These include Users in workspace, Total Agents, Total Workflows, and Total documents.

| Metric           | Description                                                        |
| :--------------- | :----------------------------------------------------------------- |
| **Active users** | Shows the number of individual users who sent at least one message |
| **All messages** | Shows all user messages across all conversations                   |

Moving the cursor over a chart bar displays the exact value for the selected point in time.

### Chat

The Chat tab shows how Chat was used within the selected date range. The data follows the selected grouping, for example by day.

| Metric                       | Description                                                                           |
| :--------------------------- | :------------------------------------------------------------------------------------ |
| **All messages**             | Shows the total number of user messages across all conversations.                     |
| **Model usage distribution** | Shows which AI models were used for generated answers.                                |
| **Knowledge Base searches**  | Shows the number of AI answers that retrieved content from connected knowledge bases. |

Message-based metrics count user messages. Generated AI answers are reflected separately in model usage metrics.

### Agents

The Agents tab shows how Agents were used within the selected date range. Evaluations follow the selected date range and grouping, for example by day.

| Metric                 | Description                                                                                  |
| :--------------------- | :------------------------------------------------------------------------------------------- |
| **Agent messages**     | Shows the number of user messages sent in conversations with an Agent.                       |
| **Active Agent users** | Shows the number of individual users who sent at least one message in an Agent conversation. |
| **Messages per Agent** | Shows how many user messages were sent to each Agent.                                        |
| **Agent model usage**  | Shows which AI models were used for answers in Agent conversations.                          |

### Workflows

The **Workflows** tab shows how Workflows were executed within the selected date range and which status each execution ended with. The data follows the selected date range and grouping, for example by day.

The status overview summarizes the main execution statuses above the chart.

| Metric                            | Description                                                                                                                                                                                                                          |
| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Completed executions**          | Shows successfully completed Workflow executions.                                                                                                                                                                                    |
| **Failed executions**             | Shows Workflow executions that did not complete due to an error.                                                                                                                                                                     |
| **Cancelled executions**          | Shows Workflow executions that ended early.                                                                                                                                                                                          |
| **Workflow executions by status** | Shows the number of Workflow executions over time. The colored bar sections show how statuses are distributed across each time interval. This makes periods with many completed, failed, or cancelled executions easier to identify. |

### API

The **API** tab shows usage of the nuwacom API within the selected date range. The evaluation follows the selected date range and grouping, for example by day.

| Metric                  | Description                                                                                                                                                       |
| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Total API calls**     | Shows how many API requests were executed in total within the selected date range. This provides a compact view of overall API usage in the workspace.            |
| **API calls over time** | Shows the number of API calls for each time interval. This makes visible when the API was used most often and how usage developed within the selected date range. |

***

## Exporting data

Select **Export CSV** on a chart to download the data currently represented by that chart. Each export contains one row per data point (for example, one row per model) and the corresponding aggregated count for the selected date range. The filename includes the chart type and the selected time period.

The exported data can be processed outside nuwacom, for example in Excel, a reporting tool, or internal analyses.

***

## Additional metric information

The information icon next to an evaluation opens a short description of the corresponding metric. This helps verify what a chart or metric represents before the data is used in reports.

***

## FAQ

<AccordionGroup>
  <Accordion title="Who can access Analytics?">
    The Analytics area is visible only to workspace admins. Open **Workspace settings**, then select **Analytics**.
  </Accordion>

  <Accordion title="Which areas can be evaluated in Analytics?">
    Analytics includes **Overview**, **Chat**, **Agents**, **Workflows**, and **API**. These areas provide general workspace metrics as well as insights into individual functions.
  </Accordion>

  <Accordion title="Which API usage is displayed?">
    The **API** tab shows the total number of API calls and their development over the selected date range. This shows when the API was used and how usage changed.
  </Accordion>

  <Accordion title="How can the date range and grouping be changed?">
    Use the filters above the analytics view. Select a date range such as today, last week, or a custom range. Group the data by day, week, or month.
  </Accordion>

  <Accordion title="Can Analytics data be exported?">
    Data from each chart can be exported individually as a CSV file. The export reflects the selected date range and grouping. The file can then be used in Excel, reporting tools, or internal analyses.
  </Accordion>

  <Accordion title="Can admins view usage data for individual users based on their email addresses?">
    No. For data protection reasons, nuwacom does not provide usage data at the level of individual users or email addresses. All metrics are displayed in anonymized and aggregated form only.

    To assess individual license usage, teams can use internal discussions or surveys as an additional source of information.
  </Accordion>

  <Accordion title="Does Analytics include usage from embedded chats or widgets?">
    No. Analytics currently only includes usage within the nuwacom platform. Requests made through embedded chats or widgets via iFrame are not included in the Analytics data.
  </Accordion>
</AccordionGroup>
