# APM Traces

The **Trace List** shows raw trace and span data, where you can apply filters, restrict results by service, names of end points, span type, and many other attributes.

View the traces associated with your service to drill down to problematic spans. You can filter on core facets such as status, resource, and error type. By default, Kloudfuse filters the traces based on service, environment, and operation name.

For more detailed trace information, you can click the span name and view its flame graph.

Follow these steps to get to the **Traces** interface:

1. Click the **APM** tab, and then the **Traces** option in the drop-down menu.

2. The **Traces** interface appears.

## Using the APM Traces interface

The **Traces** interface has the following information and affordances:

APM Traces

01. **[Filters](https://docs.kloudfuse.com/platform/3.2.5/apm-traces-filters/)** help you to determine what requires your immediate attention. For details, see [APM Traces Filters](https://docs.kloudfuse.com/platform/3.2.5/apm-traces-filters/).

To show filters, expand the filters: click the  (Show filters) icon in the top left corner of the page.

To hide the filters, click the  (Hide filters) icon in the top right corner of the filter panel.

02. **Search** for any tag on ingested spans.

03. **Overall interval**. The default is **Last 5 minutes**. Click the drop-down to use the time picker and select the appropriate time interval.

04. **Refresh display**: click  (Refresh) to update the display.

05. The **View type** selector enables you to specify the view by selecting one of the following modes:

-  (List view )

This is the default.

This article discusses this view.

-  ( [Time Series view](https://docs.kloudfuse.com/platform/3.2.5/apm-trace-time-series-view/))

- )

-  ( [Table view](https://docs.kloudfuse.com/platform/3.2.5/apm-trace-table-view/))

-  ( [Pie Chart view](https://docs.kloudfuse.com/platform/3.2.5/apm-trace-pie-chart-view/))

-  ( [Heatmap view](https://docs.kloudfuse.com/platform/3.2.5/apm-trace-heatmap-view/))

06. Select the **Errors only** option to report only on traces that contain an error.

07. From the **Spans** drop-down, select if you plan to examine all spans, [service entry spans](https://docs.kloudfuse.com/platform/3.2.5/glossary/#service-entry-span) only, or [trace root spans](https://docs.kloudfuse.com/platform/3.2.5/glossary/#trace-root-span) only.

08. **Total Requests** counter reports the number of requests that your system traces.

09. **Compare** option enables you to compare the time series to an earlier time interval.

Depending on the time series data, you can compare the metric to _1 hour before_, _1 day before_, _1 week before_, _1 month_, and _1 year before_.

In this example, we compare the traces with 1 day before:

10. Click  (Explore Metric) icon to expand the chart to full size.

See [View full size chart](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#full).

11. Click the  (gear) icon, and select **Show Log Scale** option.

12. A **chart** of all traces that meet the filtering and time interval criteria.

Hover your pointer over the chart to note the values of the metric and specific times.

13. The **Options** menu controls the measurements that appear in the **Traces** list.

14. Click **Add to Dashboard** to add the results to a dashboard; see [Add to Dashboard](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#dashboard).

15. Click **Download** to save the selected traces to your computer in one either CSV or JSON format. See [Download Traces](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#download).

16. List for all **Traces**. You can control the columns of this list through the **[Options](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#options)** drop-down.

17. Hover your pointer over the name of the trace; Kloudfuse displays some of the attribute. Here, the attributes are availability zone, cloud account id, kf platform, kube cluster name, and kube namespace.

18. To see the full detail of the trace, click on any column in the list.

Kloudfuse displays the entire detail of the trace. See [Trace Details](https://docs.kloudfuse.com/platform/3.2.5/apm-trace-detail/).

- **Info**, including span name, trace id, duration, latency, method, all attributes, and so on metrics, and logs.

- **Metrics**, with graphs for the trace that correspond to the [Hits](https://docs.kloudfuse.com/platform/3.2.5/apm-service-detail-hits/), [Errors](https://docs.kloudfuse.com/platform/3.2.5/apm-service-detail-errors/), [Latency](https://docs.kloudfuse.com/platform/3.2.5/apm-service-detail-latency/), and [Execution Time Breakdown](https://docs.kloudfuse.com/platform/3.2.5/apm-service-detail-exec-time/).

- **Logs**, that lists all log entries for the trace ID.

19. Hover the pointer over the **Trace latency Breakdown** linear chart in one of the spans.

Kloudfuse displays all spans covered by the trace, their duration, and the relative percentage allocated to that span.

## View full size chart

To see the full metric chart, click  (Explore Metric) icon to expand the chart to full size.

The chart provides the following information and affordances:

1. The **chart** of the metric for the specified time interval appears in the main area.

2. The **metric** and its statistics (Avg, Min, Max, Sum, and Value) appear under the horizontal axis.

3. Click the selector for the **chart type**, and choose one of the options from the drop-down:

- Line has the _normal_, _thick_, and _thin_ option.
   - Bar has the "stacked" option.
   - Area has the _stacked_ option.
   - Points, which has no additional display options.

4. **Overall interval**. The default is **Last 5 minutes**. Click the drop-down to use the time picker and select the appropriate time interval.

5. **Compare to Previous** if you chose the **Line** [chart type](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#chart-type).

Depending on the time series data, you can compare the metric to the previous _Hour_, _Day_, _Week_, _Month_, and _Quarter_.

6. Choose the **Y Scale** setting: click either the  (Linear) or  option.

## Add to Dashboard

To add the current results to a dashboard, follow these steps:

1. In the interface, click the  (Add to Dashboard) button.

2. The **Add panel to dashboard** dialog appears.

3. In the dialog, specify if you want to add to a **[New Dashboard](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#new)** (default), or an **[Existing Dashboard](https://docs.kloudfuse.com/platform/3.2.5/apm-traces/#existing)**:

- New Dashboard
   - Existing Dashboard

1. Select the folder from the drop-down.
2. Enter the name of the new dashboard.
3. Enter the panel name for the new chart.

1. Select the folder from the drop-down.
2. Select the dashboard from the drop-down.
3. Enter the panel name for the new chart.

## Download Traces

Kloudfuse downloads _all_ trace data, not just the portions you choose to display:

- Date
- Service
- Span Name
- Duration
- Method
- Status Code
- Endpoint
- Trace Span Count
- Trace Latency Breakdown
- Span Type
- Span ID
- Parent Span ID
- Trace ID
- Root Span

To download the selected traces to your computer, follow these steps:

1. In the **Traces** interface, click  (Download).

2. A dialog window appears, with the following options:

- Download as CSV
   - Download as JSON

3. Select one of the options by clicking on it.
4. The download starts.
5. Unless you are downloading a very small volume of data, you will see the **Downloading traces** progress dialog.

6. \[Optional\] Click **Interrupt download** if you want to stop a very large download.

Kloudfuse gives you the option to save partial results (all the traces saved to your system buffer at the time you interrupted the download), or to cancel the saving process.
