Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 26 additions & 2 deletions docs/product/explore/logs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Conditions in which auto-refresh is disabled:
- Auto-refresh is disabled due to high data volume (100 logs per second). Try adding a [filter](/concepts/data-management/filtering/#logs-filtering) to reduce the number of logs.
- Auto-refresh will be disabled due to reaching a max auto-refresh time of 10 minutes.
- Auto-refresh will be disabled if there is an error fetching logs.
- Auto-refresh is not available in the aggregates view.
- Auto-refresh is not available in the [aggregates view](#aggregates-view).

**Export Data**
You can export up to 10,000 log lines in CSV or [JSON Lines (JSONL)](https://jsonlines.org/) format.
Expand All @@ -88,7 +88,31 @@ You can export up to 10,000 log lines in CSV or [JSON Lines (JSONL)](https://jso
- **Note:** Use either format to export the currently displayed columns, or use JSONL to export All Columns.
- Depending on the size, the file will either download directly or be sent to you via email.

### Query Volumes
## Visualizing Log Data

The Logs Explorer includes a **Visualize** panel under **Advanced** that controls the charts displayed above the log table.

### Configuring Charts

- The first chart defaults to `count(logs)` as a fixed time-series bar chart representing log volume over the selected time range. Change the function (like `sum`, `avg`, `count`) to visualize a different metric.
- Click **+ Add Chart** to add additional charts. Each additional chart lets you choose a function (like `sum`, `avg`, `count`) and an attribute (like `payload_size`) to visualize.
- Additional charts also support **Area**, **Line**, and **Bar** chart types.

### Group By

Use the **Group By** section under Visualize to break down charts by an attribute (for example, `device.name` or `severity`). You can ad multiple Group Bys to the same chart.

## Aggregates View

Switch to the **Aggregates** tab to see the grouped by log data. The table shows one row per group with columns for each function you've configured in Visualize (for example, `count(logs)` and `sum(payload_size)` grouped by `device.name`).

Use the aggregates view to identify high-volume log sources, compare payload sizes across functions, or spot patterns without scrolling through individual log lines.

<Alert level="info">
Auto-refresh is not available in the aggregates view.
</Alert>

## Query Volumes
When the number of logs returned by a query is too high, there are a couple of changes to the logs explorer functionality. To reduce query volumes, consider [filtering logs](/concepts/data-management/filtering/#logs-filtering) or refining your [search query](/concepts/search/) with more specific criteria.
- Auto-refresh will be disabled.
- Data shown in the chart will be extrapolated from a sampled amount of the complete dataset.
Expand Down
27 changes: 17 additions & 10 deletions docs/product/explore/metrics/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,26 +65,33 @@ Distributions record numeric values to compute statistical aggregates.

## Viewing and Exploring Application Metrics

The Metrics Explorer provides two main views:
Each metric query in the Explorer is displayed as its own block (labeled **A**, **B**, **C**, etc.) with a chart on the left and a data panel on the right. See [multiple metrics and equations](#multiple-metrics-and-equations) for more. Each block includes:

### Aggregates View
- **Metric selector** — choose the metric name (like `cart.add`, `chat.open`)
- **Agg** — select the aggregation function (examples:`sum`, `avg`, `p95`)
- **Group by** — optionally break out by an attribute
- **Search bar** — filter to specific attribute values

![Metrics Aggregates View Screenshot](./img/aggregates.png)
### Chart Types

Each metric block displays a time-series chart. You can switch the chart type from the chart header:

The Aggregates tab shows trends and totals across any attributes you've added to your metrics. You can:
- **Line** — general-purpose trend visualization
- **Area** — useful for cumulative values or showing volume
- **Bar** — good for daily or interval-based comparisons
- **Heatmap** — shows value density over time, ideal for distribution metrics where you want to see where values concentrate rather than just percentile lines, or sums of single counts

- View time-series charts showing metric trends
- Group by custom attributes (e.g., `sum(metrics_value)` grouped by `email_type`)
- Apply filters to drill down into specific segments
- Compare multiple time periods
### Aggregates View

![Metrics Aggregates View Screenshot](./img/aggregates.png)

Use this view to spot trends, identify anomalies, and understand aggregate behavior across your application.
Switch to the **Aggregates** tab (in the data panel to the right of the chart) to see your metric data grouped and summarized. When you've set a **Group by** attribute, the aggregates table shows one row per group with the selected aggregation applied. Use this view to spot trends, identify anomalies, and compare segments.

### Samples View

![Samples View Screenshot](./img/samples.png)

The Samples tab shows individual metric events with **direct links to their traces**. This is where trace-connected metrics shine:
The **Samples** tab shows individual metric events with **direct links to their traces**. This is where trace-connected metrics shine:

- See each individual metric event as it occurred
- Click any sample to open the full trace waterfall
Expand Down
Loading