Grafana Introduction¶

This notebook describes the basic mechanisms for navigating Grafana dashboards. Grafana provides a detailed overview of how to use dashboards at https://grafana.com/docs/grafana/latest/dashboards/use-dashboards/

Finding Dashboards¶

Note that dashboard availability and names may not match those shown here.

Some featured dashboards can be quickly accessed from the front page of the Public, https://public-metrics.fabric-testbed.net or Infrastructure, https://infrastructure-metrics.fabric-testbed.net metric websites.

To browse the complete list of available dashboards open, the side menu by clicking on the hamburger (three horizontal lines) to the right. Then choose Dashboards.

This will take you to a list of all the dashboards. Click on a dashboard name to go to the dashboard.

image.png

Some dashboards are collections of other dashboards. Click on the Featured Dashboards to see a the list of dashboards that are accessible from the site's front page. These dashboards will have more information about them on the links from the front page.

image.png

To quickly search for dashboards use the Search or jump to.... text box at the top-center of the page. image.png

Click on a result to go to the dashboard.

image.png

Using Drop Down Variables¶

Many of the dashboard views can be customized by choosing variables that affect the queries used to display the data. These drop downs are located in the upper left of the dashboards.

image.png

The Rack drop down is used on many dashboards. It allows the selection of which rack(s) are included in the queries. A rack is a FABRIC site (aka hank). Site names are abbreviations of 3 or 4 lower case characters. Select the checkboxes of sites you want to be represented in the graph.

image.png

The Host drop down is used on many dashboards. It allows the selection of which host(s) are included in the queries. Host values may change depending on the dashboard. In this example, the host names are for FABRIC nodes. They are labled by site name - hn (head node) or w# (worker node).

image.png

Some drop downs have pre-set options, but can also accept user input. Type in the value you want if it is not available in the drop down list.

image.png

image.png

Selecting Time Range¶

Dashboards generally have two types of data - instant or range values.

  • Instant values are single values taken at a specific time.
  • Range values are a set of values covering a given time span.

The time picker drop down allows the selection of the time period you want to display.

It shows the current selected value. image.png

Selecting the drop down will give you a quick list on the right of common values you may choose. These values are relative times in relation to the current time.

image.png

You may also choose to set an Absolute time range. Selections can be made using the calendar picker, or typed in precisely in the From and To boxes.

image.png

The times shown usually default to the browsers time zone. Note that all FABRIC racks and metric collections always use UTC, therefore all the rack times will be in the same time zone. If you choose a rack in California, one in New York and one in Europe all the times are recored in UTC. When they are displayed, all the times will be shifed to the same time zone you have selected.

image.png

Auto Refresh¶

If you have picked a relative time range, you may also choose a refresh rate. Since most metrics are collected at a 30 second rate, anything less than 30 seconds will not be effective and just use more resources. The Auto setting will adjust the refresh rate to match what is visible in the graph. If the resolution allows you to see 5 seconds of data, then the refresh will be set to 5 seconds, etc...

image.png

If you have choosen an absolute time range, the refresh will be turned off.

Viewing Panels¶

Dashboards are composed of panels. Panels may contain a variety of data and visualizations. Some dashboards have lots of panels and you may just want to focus on one. Some panels may have dense data and you may want to get a better view.

image.png

View Single Panel¶

To select a single panel for viewing, use the three dots menu in the upper right of the panel. Select View . You may also hover the mouse over the panel and type'v'.

image.png

image.png

Select Visible Data¶

Some graphs can contain "too much" data. The data can be reduced by using some of the drop down variables. In this case you could reduce the data using the drop down and selecting just the rack in which you are interested.

image.png

image.png

Alternatively, if you are interested in picking out a certain graph line, such as this peak at worker node 2 at mass, you can select that node using the list of nodes ot the right.

image.png

image.png

The selected nodes will be highlighted in the list.

image.png

If you would like to see multiple graph lines, you can use control-click to select/unselect multiple nodes.

image.png

Zooming / Narrowing/Expanding Time Range¶

Zooming in by choosing a narrower time range can be done quickly by right clicking and dragging across the section of the graph you want to examine more closely.

Screenshot 2024-09-19 134747.png

Now the graph has gone from a relative time range of 24 hours to an absolute time range covering the selected area.

Screenshot 2024-09-19 134820.png

You can continue to zoom in narrowing the time range.

Screenshot 2024-09-19 134836.png

Now you can easily see the individual data points. Hover over the points to bring up the tooltip with the exact value.

image.png

To Zoom out, use the eye glass with the minus sign to the right of the time drop down.

Screenshot 2024-09-19 134909.png

Now the time range has expanded.

Screenshot 2024-09-19 134935.png