Explore logs, traces, and sessions

Explore is where you search the raw telemetry of a project. You can go from a log line to its trace, and from a trace to the logs it wrote, without losing your place in the results.

​

Open Explore

1. Open your project and select Logs in the sidebar, under Telemetry.
2. Select Logs, Traces, or Sessions at the top of the page.

When you change to another tab, Explore keeps the time range and the environment. Logs and Traces also keep the service filter. Each tab has its own search box.

​

Search logs

Type a query in the search box and press Enter. The box uses Lucene syntax by default, for example level:error or message:"timeout". To write SQL instead, change Lucene to SQL. Use the Filters sidebar to narrow the results: The sidebar also shows up to eight tag keys from the results. On a small screen, select Filters to open the sidebar. Above the results, four tabs show the same logs in different ways:

• Events: the log lines.
• Patterns: similar lines grouped into one pattern.
• Changes: the values that changed most, compared with the previous window of the same length.
• Volume: the number of logs over time.

Patterns, Changes, and Volume are not available for SQL queries. Select Live off to turn on live mode, which loads new results every 5 seconds.

​

Search traces

Select Traces. Search by operation name or trace ID. The filters include Environment, Namespace, Service, Root span, HTTP method, HTTP status code, Trace status, and duration. Trace samples lists single traces. Aggregates groups the traces by service and shows the number of traces and the average duration for each service.

​

Open a log or a trace

Select a row to open it in a panel next to the results.

• A log has the tabs Attributes, Trace, Related logs, and Raw.
• A trace has the tabs Waterfall, Related logs, and Raw. Select a span in the waterfall to see its Overview, Attributes, Events, Links, and Raw data.

When a log and a trace share a trace ID, you can move between them in the panel. If the record has a file path and a line number, the panel shows the source location. When the project has a linked GitHub repository, select Open in GitHub to open the file at that line. For traces, send the OpenTelemetry attributes code.file.path and code.line.number.

​

Find a session

Select Sessions to list recorded browser sessions. Search by URL, environment, or session ID. The list shows the duration, the environment, the number of errors, and the start time of each session. Select a session to watch it. See Session replay.

​

Share what you found

The page URL stores the tab, the filters, and the selected log, trace, span, or session. Copy the URL to share the same view with a teammate. Reload and the browser Back button keep it too.

​

Next steps