> For the complete documentation index, see [llms.txt](https://docs.countercyclical.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.countercyclical.io/workspace-settings/usage-analytics.md).

# Usage Analytics

Monitor workspace participation, collaboration, and research activity over time.

**Usage Analytics** provides workspace-level visibility into how Countercyclical is being used. It combines participation metrics, resource activity, event timelines, and geographic context to help administrators understand adoption and activity across their research environment.

See also [Credits](https://docs.countercyclical.io/plans-and-billing/credits) and [Spend Controls](https://docs.countercyclical.io/plans-and-billing/spend-controls).

Access Usage Analytics from [**Settings › Advanced › Usage**](https://dashboard.countercyclical.io/settings/workspace/advanced/usage).

### Workspace Events

Usage Analytics is built around **workspace events**. An event represents an action taken on a workspace resource, such as creating, updating, deleting, or otherwise interacting with research and collaboration resources.

The selected reporting period determines which events and metrics are included throughout the page.

### Overview

The **Overview** summarizes workspace activity for the selected period. Use the timeframe selector to adjust the reporting window.

The overview includes:

* **Active Members** — Workspace members who recorded activity during the period.
* **Active Guests** — Guest users who recorded activity.
* **Active Contributors** — Users who contributed activity rather than only accessing the workspace.
* **Contributor Rate** — The proportion of active participants who contributed.
* **Activity Events** — Total workspace events captured during the period.
* **Active Days** — Number of days on which workspace activity occurred.
* **Resources Touched** — Distinct resources associated with activity.
* **Resource Types Active** — Number of different resource types represented in the activity.
* **Resources Created, Updated, and Deleted** — Resource lifecycle activity during the period.
* **Comments Added** — Collaboration through resource comments.
* **Collaborator Changes** — Changes to resource collaborators or collaboration configuration.
* **Versions Created** — New resource versions recorded during the period.
* **Exports Completed** — Completed export activity.
* **Events per Resource** — Average event volume across resources with recorded activity.

Together, these metrics provide a high-level view of both workspace adoption and the intensity of research activity.

### Event Timeline

The **Event Timeline** visualizes event volume across the selected period.

Use it to identify when workspace activity occurred and compare activity levels over time. Different event series are represented visually within the chart, making periods of concentrated activity easier to identify.

This view is useful for understanding whether research activity is continuous, clustered around particular periods, or changing over time.

### Resource Activity

**Resource Activity** shows where workspace activity is occurring at the individual-resource level.

Each row identifies the resource, its **Workspace Resource** type, and associated **Collaborators** where applicable. This makes it possible to distinguish activity across Investments, Memos, Reports, Pipeline components, and other supported workspace resources.

Use the table to identify heavily used research artifacts, understand which types of resources are generating activity, and see where collaboration is occurring. Pagination is available when activity spans more resources than can be displayed on one page.

### Activity Timeline

The detailed **Activity Timeline** provides a chronological view of workspace events organized around the resources that generated them.

Events are positioned along the timeline according to when they occurred, with resource labels and event counts providing context around concentrations of activity. Multiple events associated with the same resource can be grouped together.

Use the cadence control to adjust the timeline's temporal scale. The timeline can also be zoomed to inspect a narrower period in greater detail.

This provides a more resource-oriented view than the aggregate Event Timeline, making it useful when investigating when a particular research artifact became active or experienced a concentrated series of changes.

### Event Locations

**Event Locations** provides a geographic view of workspace activity for the selected reporting period.

Locations associated with captured events are represented on an interactive map. Use the map controls to zoom, reposition, or reset the geographic view.

This can help administrators understand the geographic distribution of workspace usage, particularly for research teams operating across offices or regions.

Location information should be interpreted as contextual usage telemetry rather than a precise record of a user's physical location.

### Using Usage Analytics

Usage Analytics is designed to provide operational visibility into the workspace rather than evaluate the quality of individual research.

Administrators can use it to understand platform adoption, identify active research resources, observe collaboration patterns, review activity trends, and determine how broadly Countercyclical is being used across the organization.

Because individual events represent actions rather than the significance of the underlying work, metrics such as event volume or contributor rate are best interpreted alongside the team's actual research processes and operating model.

#### Related Pages

{% content-ref url="/pages/etk4rJ30XzJ8ZGLP2l5S" %}
[Credits](https://docs.countercyclical.io/plans-and-billing/credits.md)
{% endcontent-ref %}

{% content-ref url="/pages/SiQGAuX5WSKMVw9t9L26" %}
[Spend Controls](https://docs.countercyclical.io/plans-and-billing/spend-controls.md)
{% endcontent-ref %}

{% content-ref url="/pages/0FKOlcKwMVueudIIMH8E" %}
[Analytics](https://docs.countercyclical.io/agents/analytics.md)
{% endcontent-ref %}
