Tracing Dashboards

Application Service Dashboards

Service and Application dashboards are available as two Explore hierarchies. You can access them in the Explore By drop down menu.

The Application Service 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. If not present, all services will belong to a "default" application. See how to modify the attributes of your spans. The third level shows the top 50 most active operations executed on the service.

The Service Application View takes a contrary approach, displaying services by top level and breaking down their health by application. This view is especially useful for shared services that support more than one application. The third level shows the top 50 most active operations performed on the selected service and application.

Services need to be active in the last 15 minutes to appear on the list. Recent inactivity will result in a grayed-out list entry.

Tracing metrics retention has default metrics retention.

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 service_latency_type filter to view other percentile aggregations.

  

• 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, just like for any other Sumo Logic dashboard, you can view the side panel's Infrastructure tab to drill down to related metrics or traces for the selected service.

note

Drilling to traces by application and to logs by both service and application are coming soon and are not working yet.

Install the App

The Tracing - Application Services Health App is automatically installed for all users of your organization once Sumo Logic detects OT compatible tracing data coming from your instrumented services. The content is placed in Sumo Logic Tracing - default dashboards inside the Admin Recommended folder and is automatically available for all users in the organization.

note

Do not modify or delete content in the Admin Recommended folder as it is automatically maintained and updated. If for any reason this gets removed, you can install the App manually from App Catalog. 

To install the app, do the following:

1. From the App Catalog, search for and select the Tracing - Application Services Health.

   

   If you want to see a preview of the dashboards included with the app before installing, click Preview Dashboards.

2. To install the app, click the Add to Library button and complete the following fields.

   • App Name. You can retain the existing name, or enter a name of your choice for the app.

   • Advanced. Select the Location in Library (the default is the Personal folder in the library), or click New Folder to add a new folder.

     

3. Click Add to Library.

Once an app is installed, it will appear in your Personal folder or the folder you specified. From here, you can share it with your organization.

Dashboard Panels

Add Service Map and Trace List panels to explore your application environment and review all traces directly through your Dashboard. Duplicate or add multiple panels with different filtering or queries to refine views and support your organization. 

See the Dashboard (New) guide for additional information and options to create panels, configure filters, create and filter with template variables from dashboard headers, and more.

Service Map panel

The Service Map panel displays a service map for filtered applications and services, with the ability to explore the environment.

To add a Service Map panel to your Dashboard:

1. Open a Dashboard or create a new Dashboard.

2. Click Add Panel and select Service Map. Or select the Service Map option on a new Dashboard.

   

   A panel configuration page opens.

   

3. Select from the drop-down menus to filter the Service Map by the following:

   

   • Application if your tracing data has the application=[app-name] tag
   • Service 
   • To pass the variables from dashboard filters, set application={{application}} and/or service={{service}}

4. Do not set the time. Service Map always shows last 72h of data.

5. The Chart Type is set to Graph.

6. 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.

   

7. Click Add to Dashboard. The panel loads in your Dashboard to review your applications and services according to filtering.

   

Trace List panel

The Trace List panel displays the Traces page table to give at-a-glance tracking for traces. To view deeper details, click a trace from the panel to open the Trace View. 

note

You are limited to 3 Trace List panels in a dashboard.

To add a Trace List panel to your Dashboard:

1. Open a Dashboard or create a new Dashboard.

2. Click Add Panel and select Trace List. Or select the Trace List option on a new Dashboard.

   

   A panel configuration page opens.

   

3. Configure a Trace query 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.

   

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		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.
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.

1. 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.

   

2. Click Add to Dashboard. The panel loads in your Dashboard to review all traces according to the query.