--- id: tracing-dashboards title: Application Service APM/Tracing Dashboards sidebar_label: APM and Tracing Dashboards description: Explore and create Tracing dashboards, install apps, and more. slug: /help/docs/apm/traces/tracing-dashboards/ canonical: https://www.sumologic.com/help/docs/apm/traces/tracing-dashboards/ --- import useBaseUrl from '@docusaurus/useBaseUrl'; To access APM hierarchies: 1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Observability**, and then under **Application Monitoring**, select **Applications**. You can also click the **Go To...** menu at the top of the screen and select **Applications**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). Go to the **Home** screen and select **Explore**. 1. In the upper-left corner of the screen, select an **APM:** hierarchy from the dropdown menu. An expandable list of your hierarchy appears in the panel. Out-of-the-box dashboards are available as three hierarchies. * The **APM: Application View** groups services into higher-level applications based on the `application=[app-name]` custom tag that you may add to your tracing data if you want to leverage it fully. Without the tag, all services will belong to a "default" application. The fourth and last level of the hierarchy shows the top 50 most active operations executed on the service. See [Working with Span attributes](/docs/apm/traces/advanced-configuration/working-with-span-attributes) to learn how to customize your span attributes and set up application name. * The **APM: Service View** takes a contrary approach, displaying services by top level and breaking down their health by application. This view can be useful for shared services that support more than one application. The fourth level shows the top 50 most active operations performed on the selected service and application. * The **APM: Environment View** displays environments at the top level and breaks down application health by environment (such as `prod` or `dev`), with up to 10 values of **deployment.environment** tag. This view can be useful for understanding the top-down hierarchy of applications and services in a particular environment. The fourth level shows the top 50 most active operations executed on the environment, application, and service.
Service Dashboards from traces
Services must be active within the last 15 minutes to appear on the list. Recent inactivity will result in a grayed-out list entry. Each dashboard is a fully customizable set of panels based on automatically generated metrics using tracing data as input. You can get insight into microservice health by looking at stats from: * **Latency**: (real-time average) the average time it takes for entry spans for that service to complete. Apart from average you can also select p99, p95, p90, p50 options in the `latency_type` filter to view other percentile aggregations. Percentile aggregations are based on the [metrics histograms](/docs/metrics/introduction/metric-histograms/) feature.
Latency type * **Requests**: (real-time counter) the number of entry spans reported by the service. * **Errors**: (real-time counter) the number of entry spans for the service that finished with an error. By clicking on any data point on the chart, you can view the side panel's **Entities** tab and drill down to related metrics or traces for the selected service. Explore coffee app to drill down on infrastructure tab :::note Tracing metrics retention has [default metrics retention](/docs/apm/traces/view-and-investigate-traces#set-time-range). ::: ## Installing the Tracing App (Optional) The **Tracing - Application Services Health** app is automatically installed for all users of your organization once Sumo Logic detects OpenTelemetry-compatible tracing data coming from your instrumented services. The content is placed in **Sumo Logic Tracing - default dashboards** inside the **Installed Apps** folder and is automatically available for all users in the organization. :::note Do not modify or delete content in the **Installed Apps** folder as it is maintained by Sumo Logic. If for any reason this gets removed, you can install the App manually from App Catalog. ::: import AppInstall from '../../reuse/apps/app-install-v2.md'; ## Upgrade/Downgrade the Tracing App (Optional) import AppUpdate from '../../reuse/apps/app-update.md'; ## Uninstalling the Tracing App (Optional) import AppUninstall from '../../reuse/apps/app-uninstall.md'; ## Dashboard Panels There are three tracing-specific dashboard panels available out of the box: **Services Map**, **Services List**, and **Trace List** panels, which explore your application environment and review all traces from your Dashboard. Duplicate or add multiple panels with different filtering or queries to refine views and support your organization. See the [Dashboard guide](/docs/dashboards) for additional information and options to create panels, configure filters, create and filter with template variables from dashboard headers, and more. ### Services panels The **Services Table** and **Services Graph** panels display a services list and services map, respectively, for filtered applications and services, with the ability to explore the environment. To add a Service Map panel to your Dashboard, see [Add services panel to dashboard](/docs/apm/services-list-map/#add-services-panel-to-dashboard). ### Trace List panel The Trace List panel displays the [Traces page](view-and-investigate-traces.md) table to give at-a-glance tracking for traces. To view deeper details, click a trace from the panel to open the [Trace View](view-and-investigate-traces.md). :::note You are limited to three Trace List panels in a dashboard. ::: To add a Trace List panel to your Dashboard: 1. Open or create a new Dashboard. 2. Click **Add Panel** and select **Trace List**. Or select the **Trace List** option on a new Dashboard.
Add tracelist
A panel configuration page opens.
Create tracelist 3. Configure a [Trace query](view-and-investigate-traces.md) to search for desired set of traces. 4. Select a time range or create a custom range for the panel. You can set this when creating or at any time when viewing the Dashboard panel.
Time range 5. The **Chart Type** is set to Table. 6. Enter the **Rows Per Page** for the panel, between 5 to 100. The default amount is 15. The panel automatically paginates traces to browse through and view all traces. 7. Select the Table columns of trace data to load in the panel: | Column name | Example value | Description | |:--|:--|:--| | Trace ID | ffaf2f69ee8ad0c1 | The unique identifier of the trace. | | Root Service | api | The service that started the trace. | | Started At | 07/27/2020 09:01:04.533 | When the trace started. | | Duration | 12.582 ms | The amount of time the trace spans. | | Number of spans | 35 | A trace consists of spans. This number tells you how many spans are in the trace. | | Duration Breakdown | 300 | Each color indicates a service. The colors assigned to services are always the same on your account. You can change the color in the span summary tab after clicking on the individual span in trace view.
Hover over to view a percentage breakdown of how long each span covers in the trace.
Duration breakdown legend | | Number of errors | 0 | The number of errors in the trace. | | Status | 200 | The HTTP status code of the trace. A menu is available in this column when hovering on a row. The menu has an option to **Show similar traces**.
Traces status | 8. Click the **General** tab to edit the Panel Details. Enter a name for the panel, set a **Title Font Size**, and add a short **Description**.
Trace list 9. Click **Add to Dashboard**. The panel loads in your Dashboard to review all traces according to the query.
Panel trace ### Dashboard Examples #### 01. Application Service Overview APM Dashboard #### 01. Environment Overview APM Dashboard #### 01. Operation Overview APM Dashboard #### 02. Service Health Across Applications APM Dashboard #### 02. Service Health Across Applications within Environment APM Dashboard #### 03. Application Service Health Across Operations APM Dashboard #### 03. Application Service Health Across Operations within Environment APM Dashboard #### 04. Application Health Across Services APM Dashboard #### 04. Service Health Across Applications and Operations APM Dashboard #### 04. Service Health Across Applications and Operations within Environment APM Dashboard #### 05. Application Service Health Across Environments APM Dashboard #### 06. Service Health Across Environments APM Dashboard