Skip to main content
Sumo Logic

Panels

Panels are the building blocks used to create a dashboard. Each panel displays analytics for a specific query. The type of panel you choose to display your data depends on the type of query you want to run.

Related topics:

Time Series Panel 

time series panel.png

Time series panels provide information on a series of data points ordered in time. Typically, a time series is a sequence taken at successive equally spaced points in time. Examples of time series are CPU and Memory over time.

In a time series, time is often the independent variable and the goal is usually to make a forecast for the future. Time series are frequently plotted with area or line charts. 

These are best used for looking at statistics taken over time. Things like CPU, Memory, and disk usage statistics fall into this category.

Time series panels accept aggregate fields with epoch values (milliseconds since 1970).

Available chart types:

What is the difference between a categorical and time series panel?

The categorical panel type contains charts that graph data across categories. This includes:

  • Bar charts over categories
  • Column charts over categories
  • Pie Charts
  • Tables over categories
  • Bubble Charts
  • Scatter Charts

The time series panel type is designed to graph data over time. Time series panels accept aggregate fields with epoch values (milliseconds since 1970). You can use the timeslice operator to provide a time series.

The types of charts you’ll find in the time series panel include:

  • Area
  • Bar
  • Column
  • Line
  • Table

Categorical Panel

categorical icon.png

Categorical panels provide information on the number of occurrences (frequency) of distinct values. Categorical frequencies are typically shown in pie, table, and column charts. 

These are best used to understand the distribution of data by categories. For example, understanding the number of CPUs used by machine type, or the number of requests handled by a pod.

Available chart types:

The following image shows an example of Scatter and Bubble charts.
scatter and bubble charts.png

Single Value Panel

single value panel.png

Single Value Panels are great at providing high level overviews. They look great on executive dashboards and can provide at-a-glance information to help decide where to inspect and troubleshoot further.

Only single value charts are supported.

single value charts.png

Honeycomb Panel

honeycomb panel.png

Honeycombs are great at helping you find areas of significant activity amongst a set of entities, like hotspots in a cluster. These are ideal if you want to find the instance running high CPU usage amongst all the instances in your cluster.

This requires numerical aggregates. If you're trying to plot text you can use nested if statements to assign numbers based on specific values. For example, the following query checks the parsed field environment for specific values and assigns a number between 0 and 3. The aggregate operator max simply returns the max value by _collector.

| if(environment="good",1,
if(environment="lag",2,
if(environment="fail",3,0))) as status
| where status!=0
| max(status) by _collector

honeycomb charts.png

Map Panel

map panel.png

Maps identify where requests are coming from. These are ideal for geolocation data.

Only map charts are supported.

new map charts.png

Text Panel

text panel.png

Text can clarify what you're showing on dashboards or act as a note to your viewer. Text panels provide the flexibility to display descriptive text in or above other panels.

Titles are displayed in the same size and font. Text is styled using Markdown syntax, meaning that you can control the size and weight of the text. Not all Markdown syntax options are supported; see Markdown Syntax.

There's no limit to the number of Text Panels you can add to Dashboards. These types of Panels don't count against the quota in Sumo Logic Free accounts.

To add a Text Panel:

  1. With the Dashboard open, click the Add Panel button.
    add panel.png
  2. Choose Text as the Panel Type. 
  3. The Text Editor and Visual Settings are displayed.
    Display options.png
    1. Input your Text or Markdown syntax in the Text Editor pane. See Markdown Syntax for details on what is supported.
    2. The Visual Settings options allow you to adjust the font, colors, and alignment of your data.
    3. A title is optional, you can toggle its visibility in the Panel Details covered in the next section.
  4. Next, to set a Title, select the General menu icon to open the Panel Details pane.
    Panel details general icon.png
    • A title is optional. Use the toggle switch labeled Show Title to set if the title is displayed. If desired, enter a title and set the font size.
  5. The Panel Preview section displays your text panel based on your settings.
    Text Panel preview.png
  6. When you're done click Add to Dashboard at the top of the window.
    Add to Dashboard button.png
Add links to text panels

Text panels can provide links to URLs or other Dashboards with markdown syntax. To create a link to a URL, surround your linked text with square brackets [], then add your URL in parenthesis (), as shown.

To add a link to a Panel in order to drill down to another Dashboard, see Add Dashboard Link.

Syntax

[<Text>](<URL>)

link syntax example Jan 2021.png

In the panel, the link is displayed. 

Service Map Panel

icon-service-map.png

The Service Map is a high-level view of your application environment, giving you a greater view and understanding of your application architecture and dependencies between monitored microservices.

The panel gives you a fully functioning map to zoom in and out and move through services. The size and color of application entities shows status and activity. Click on a service to open the Entity Inspector to drill down to traces, metrics, and the service dashboard.

You can filter the map according to application and service. 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.

panel-service.png

To add a Service Map panel:

  1. With the Dashboard open, click the Add Panel button and select Service Map
    add-servicemap.png
    A panel configuration page opens.
    create-servicemap.png
  2. Select from the drop-down menus to filter the Service Map by the following:
    filter-servicemap.png
    • 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}}
  3. Do not set the time. Service Map always shows last 72h of data.

  4. The Chart Type is set to Graph.

  5. 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.
    tracelist-details.png

  6. Click Add to Dashboard

Trace List Panel

icon-trace-list.png

Transaction tracing captures and tracks distributed business workflows, by enriching and analyzing traces, logs, and metrics in real-time with automated generated application topology. Each trace provides details on root service, when it occurred and how long, the number of spans, and a breakdown of services. The panel panel displays the Traces page table to give at-a-glance tracking for traces through your Dashboard. To view transaction and service details, click a trace from the panel to open the Trace View

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.

panel-trace.png

To add a Trace List panel:

  1. With the Dashboard open, click the Add Panel button. 
    add-tracelist.png
    A panel configuration page opens.
    create-tracelist.png

  2. Configure a Trace query to search for desired set of traces. 

  3. 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.
    timerange.png

  4. The Chart Type is set to Table.

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

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

span-hover-view.png
Number of errors 0 The number of errors in the trace.
Status 200 The HTTP status code of the trace.
  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.
    tracelist-details.png

  2. Click Add to Dashboard