# Traces Panel

* [Add a panel with tracing visualizations](#tracespanel-addapanelwithtracingvisualizations)
  * [Before you begin](#tracespanel-beforeyoubegin)
  * [Add the Traces panel query](#tracespanel-addthetracespanelquery)
* [Add TraceQL with table visualizations](#tracespanel-addtraceqlwithtablevisualizations)
  * [Use a variable to add other links to traces](#tracespanel-useavariabletoaddotherlinkstotraces)

Traces let you follow a request as it traverses the services in your infrastructure. The Traces panel visualizes traces data into a diagram that allows you to easily interpret it.

***

### Add a panel with tracing visualizations <a href="#tracespanel-addapanelwithtracingvisualizations" id="tracespanel-addapanelwithtracingvisualizations"></a>

Once you have tracing data available in your Algology stack, you can add tracing panels to your Algology dashboards.

Using a dashboard variable, `traceID`, lets you create a query to show specific traces for a given trace ID.

#### Before you begin <a href="#tracespanel-beforeyoubegin" id="tracespanel-beforeyoubegin"></a>

To use this procedure, you need:

* An Algology instance
* A Tempo data source connected to your Algology instance

#### Add the Traces panel query <a href="#tracespanel-addthetracespanelquery" id="tracespanel-addthetracespanelquery"></a>

To view and analyze traces data in a dashboard, you need to add the tracing panel to your dashboard and define a query using the panel editor. The query determines the data that is displayed in the panel.

This procedure uses dashboard variables and templates to allow you to enter trace IDs which can then be visualized. You’ll use a variable called `traceId` and add it as a template query.

1. From your Algology stack, create a new dashboard or go to an existing dashboard where you’d like to add tracing panels.
2. Select **Add visualization** from a new dashboard or select **Add Panel** on an existing dashboard.
3. Search for and select the appropriate tracing data source.
4. In the top-right of the panel editor, select the **Visualizations** tab, search for, and select **Traces**.
5. Under the **Panel options**, enter a **Title** for your trace panel.
6. In the query editor, select the **TraceQL** query type tab.
7. Enter `${traceId}` in the TraceQL query field to create a dashboard variable. This variable is used as the template query.
8. Select **Apply** in the panel editor to add the panel to the dashboard.
9. Go to the dashboard **Settings** and add a new variable called `traceId`, of variable type **Custom**, giving it a label if required. Select **Apply** to add the variable to the dashboard.
10. Verify that the panel works by using a valid trace ID for the data source used for the trace panel and editing the ID in the dashboard variable.

***

### Add TraceQL with table visualizations <a href="#tracespanel-addtraceqlwithtablevisualizations" id="tracespanel-addtraceqlwithtablevisualizations"></a>

While you can add a trace panel visualization to a dashboard, having to manually add trace IDs as a dashboard variable is cumbersome. It’s more useful to instead be able to use TraceQL queries to search for specific types of traces and then select appropriate traces from matching results.

1. In the same dashboard where you added the trace visualization, select **Add panel** to add a new visualization panel.
2. Select the same trace data source you used in the previous section.
3. In the top-right of the panel editor, select the **Visualizations** tab, search for, and select **Table**.
4. In the query editor, select the **TraceQL** tab.
5. Under the **Panel options**, enter a **Title** for your trace panel.
6. Add an appropriate TraceQL query to search for traces that you would like to visualize in the dashboard. This example uses a simple, static query. You can write the TraceQL query as a template query to take advantage of other dashboard variables, if they exist. This lets you create dynamic queries based on these variables.

When results are returned from a query, the results are rendered in the panel’s table.

#### Use a variable to add other links to traces <a href="#tracespanel-useavariabletoaddotherlinkstotraces" id="tracespanel-useavariabletoaddotherlinkstotraces"></a>

The results in the Traces panel include links to the **Explore** page that renders the trace. You can add other links to traces in the table that fill in the `traceId` dashboard variable when selected, so that the trace is visualized in the same dashboard.

To create a set of data links in the panel, use the following steps:

1. In the right-side menu, under **Data links**, select **Add link**.
2. Add a **Title** for the data link.
3. Find the UUID of the dashboard by looking in your browser’s address bar when the full dashboard is being rendered. Because this is a link to a dashboard in the same Algology stack, only the path of the dashboard is required.
4. In the **URL** field, make a self-reference to the dashboard that contains both of the panels. This self-reference uses the value of the selected trace in the table to fill in the dashboard variable. Use the path for the dashboard from the previous step and then fill in the value of `traceId` using the selected results from the TraceQL table. The trace ID is exposed using the `traceID` data field in the returned results, so use that as the value for the dashboard variable.
5. Select **Save** to save the data link.
6. Select **Apply** from the panel editor to apply the panel to the dashboard.
7. Save the dashboard.

You should now see a list of matching traces in the Table visualization. While selecting the **TraceID** or **SpanID** fields will give you the option to either open the **Explore** page to visualize the trace or following the data link, selecting any other field (such as **Start time**, **Name** or **Duration**) automatically follows the data link, filling in the `traceId` dashboard variable, and then shows the relevant trace in the trace panel.

***