diff --git a/docs/product/explore/logs/index.mdx b/docs/product/explore/logs/index.mdx index dca4829155843..d0d9ff0e0f9e5 100644 --- a/docs/product/explore/logs/index.mdx +++ b/docs/product/explore/logs/index.mdx @@ -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. @@ -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. + + + Auto-refresh is not available in the aggregates view. + + +## 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. diff --git a/docs/product/explore/metrics/index.mdx b/docs/product/explore/metrics/index.mdx index 06a8f32b4f838..af50dac693eda 100644 --- a/docs/product/explore/metrics/index.mdx +++ b/docs/product/explore/metrics/index.mdx @@ -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