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

# Explore your data usage

> Exploring your data usage to understand how your customers are consuming your products

In the Hyperline platform, an event is a specific action or occurrence that can be tracked and measured.
You can explore it in the **Events** section or retrieve events programmatically via the [API](../../api-reference/endpoints/billable-events/get-events).
This view is global and will show all the events that are being tracked.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage10.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=dae9ab3d9c41eeb6266ef77826473378" width="3016" height="1530" data-path="images/usage/usage10.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage11.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=93ebf0a3b35ce9c468e7e581f35b1a5a" width="3020" height="1548" data-path="images/usage/usage11.png" />
</Frame>

However, for each subscription and invoice, you can explore a more detailed view of the events.

## Explore usage data

You will be able to view the product's consumption along with the amount billed for each event.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage12.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=0556dfee7c5f8759be5abd544946c3c3" width="2378" height="1502" data-path="images/usage/usage12.png" />
</Frame>

In order to do so, an action **Explore consumption** is available on different levels:

### Open data consumption on subscription

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage13.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=ad02f5160e1f414aab516097540b897f" width="2620" height="1042" data-path="images/usage/usage13.png" />
</Frame>

### Explore invoice consumption

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage14.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=c6c9b1892301ad10c79274ecced425c7" width="2610" height="998" data-path="images/usage/usage14.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage15.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=78a9c6fb760ffd72a5d65e2b469d4176" width="2616" height="1012" data-path="images/usage/usage15.png" />
</Frame>

### Explore consumption on customer portal

In the customer portal, you can delve into the consumption details of each subscription.

This can be found in the 'Subscription Details' section.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage16.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=1b86433438e5f8fc9df1e07ca813dd87" width="3022" height="1600" data-path="images/usage/usage16.png" />
</Frame>

Here, you can view and analyze the usage data associated with each subscription.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage17.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=2a876187520380821a7150034364e568" width="3024" height="1624" data-path="images/usage/usage17.png" />
</Frame>

## Download usage data

You can export usage data in CSV format for analysis and processing.

### Export single product events

To download events for a specific product, click the **Export CSV** button in the consumption view.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage18.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=4aad9307c001fd276a75e87b04df114b" width="2382" height="1494" data-path="images/usage/usage18.png" />
</Frame>

The CSV file includes the following columns:

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage19.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=7f78fcbbfa8b55a48b0739c34724943b" width="1772" height="1044" data-path="images/usage/usage19.png" />
</Frame>

### Export all invoice events

When viewing an invoice with multiple usage-based products, you can download all events at once as a ZIP file containing separate CSV files for each product.

Click the **Export all events** button on the invoice page. The ZIP file will be named `events-{invoiceNumber}.zip` and contain one CSV file per product, with filenames based on the product names.

This is particularly useful when you need to analyze usage data across multiple products for a single billing period.

## Customize displayed event name

The event name can be customized when you create or edit the product.
It will be used to identify the event in the consumption.

In order to have a dynamic name for each event, it can depend on a specific key of the event.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage20.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=1d552927eac626628fd68b8a0ffa14b4" width="2994" height="1462" data-path="images/usage/usage20.png" />
</Frame>

## Customize exposed columns

In the product editing section, you have the option to customize the columns that appear in the consumption CSV export.

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage21.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=db83d05d95e22660e729b1f134887ee2" width="2998" height="1046" data-path="images/usage/usage21.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/hyperline/n-I64WmSUBhZI20V/images/usage/usage22.png?fit=max&auto=format&n=n-I64WmSUBhZI20V&q=85&s=354d61070929d20e3fa2ebf2c3ef55e7" width="1770" height="964" data-path="images/usage/usage22.png" />
</Frame>
