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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://axiom.co/docs/feedback

```json
{
  "path": "/query-data/stream",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Stream data with Axiom

> The Stream tab enables you to process and analyze high volumes of high-velocity data from a variety of sources in real time.

The Stream tab allows you to inspect individual events and watch as they’re ingested live.

It can be incredibly useful to be able to live-stream events as they’re ingested to know what’s going on in the context of the entire system. Like a supercharged terminal, the Stream tab in Axiom allows you to view streams of events, filter them to only see important information, and finally inspect each individual event.

This section introduces the Stream tab and its components that unlock powerful insights from your data.

## Choose a dataset

The default view is one where you can easily see which datasets are available and also see some recent saved queries in case you want to jump directly into a stream:

<Frame caption="Datasets overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/choose-a-dataset-1.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=ad0e8f724e62376c0f6a3a13eea05b49" alt="Datasets overview" width="1625" height="1085" data-path="doc-assets/shots/choose-a-dataset-1.png" />
</Frame>

Select a dataset from the list of datasets to continue.

## Event stream

Upon selecting a dataset, you are immediately taken to the live event stream for that dataset:

<Frame caption="Event stream">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/event-stream-1.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=79f45cdaa0be05e25683745606631540" alt="Event stream" width="1624" height="1197" data-path="doc-assets/shots/event-stream-1.png" />
</Frame>

You can click an event to be taken to the event details slide-out:

<Frame caption="Event details">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/event-slideout-1.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=4c97d4fc146421e38cd70e26d5e10ca0" alt="Event details" width="1082" height="1008" data-path="doc-assets/shots/event-slideout-1.png" />
</Frame>

On this slide-out, you can copy individual field values, or copy the entire event as JSON.

You can view and copy the raw data:

<Frame caption="Event details">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/raw-data-1.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=56e5266945f2fbbc37afbd71c8a2daeb" alt="Event details" width="1056" height="777" data-path="doc-assets/shots/raw-data-1.png" />
</Frame>

## Filter data

The Stream tab provides access to a powerful filter builder right on the toolbar:

<Frame caption="Filter bar">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/filtering-1.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=b2a3ae784263c99c8beb48edc1d18f1b" alt="Filter bar" width="1210" height="541" data-path="doc-assets/shots/filtering-1.png" />
</Frame>

For more information, see the [filters documentation](/dashboard-elements/create#filters).

## Time range selection

The stream has two time modes:

* Live stream (default)
* Time range

Live stream continuously checks for new events and presents them in the stream.

Time range only shows events that fall between a specific start and end date. This can be useful when investigating an issue. The time range menu has some options to quickly choose some time ranges, or you can input a specific range for your search.

When you are ready to return to live streaming, click this button:

<Frame caption="Return to Live button">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/stream-live-button.gif?s=710f3a8311118a0594377d6fe7daab10" alt="Return to Live button" width="134" height="50" data-path="doc-assets/shots/stream-live-button.gif" />
</Frame>

Click the button again to pause the stream.

## View settings

The Stream tab is customizable via the view settings menu:

<Frame caption="View menu">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/view-settings-1.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=d993d7e1d8c6dc5932bcff9f6949dc60" alt="View menu" width="484" height="629" data-path="doc-assets/shots/view-settings-1.png" />
</Frame>

Options include:

* Text size used in the stream
* Wrap lines
* Highlight severity (this is automatically extracted from the event)
* Show the raw event details
* Fields to display in their own column

## Saved queries

The saved queries slide-out is activated via the toolbar:

<Frame caption="Saved queries">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/stream-starred.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=cc1342bee8724d1a456576cd679292eb" alt="Saved queries" width="478" height="128" data-path="doc-assets/shots/stream-starred.png" />
</Frame>

For more information, see [Saved queries](/query-data/datasets#saved-queries).

## Highlight severity

The Stream tab allows you to easily detect warnings and errors in your logs by highlighting the severity of log entries in different colors.

To highlight the severity of log entries:

1. Specify the log level in the data you send to Axiom. For more information, see [Requirements for log level fields](/reference/limits#requirements-for-log-level-fields).
2. In the Stream tab, click <Icon icon="gear" iconType="solid" /> in the top right, and then select **Highlight severity**.

As a result, Axiom automatically searches for the words `warn` and `error` in the keys of the fields mentioned in Step 1, and then displays warnings in orange and errors in red.
