Skip to main content

Use charts and graphs

Contributors netapp-pcarriga

You can use charts and reports to monitor the state of the StorageGRID system and troubleshoot problems.

Note The Grid Manager is updated with each release and might not match the example screenshots on this page.

Types of charts

Charts and graphs summarize the values of specific StorageGRID metrics and attributes.

The Grid Manager dashboard includes cards that summarize available storage for the grid and each site.

Dashboard data and metadata space usage breakdown

The Storage usage panel on the Tenant Manager dashboard displays the following:

  • A list of the largest buckets (S3) or containers (Swift) for the tenant

  • A bar chart that represents the relative sizes of the largest buckets or containers

  • The total amount of space used and, if a quota is set, the amount and percentage of space remaining

Tenant dashboard

In addition, graphs that show how StorageGRID metrics and attributes change over time are available from the Nodes page and from the SUPPORT > Tools > Grid topology page.

There are four types of graphs:

  • Grafana charts: Shown on the Nodes page, Grafana charts are used to plot the values of Prometheus metrics over time. For example, the NODES > Network tab for a Storage Node includes a Grafana chart for network traffic.

    Nodes page Network tab
    Note Grafana charts are also included on the pre-constructed dashboards available from the SUPPORT > Tools > Metrics page.
  • Line graphs: Available from the Nodes page and from the SUPPORT > Tools > Grid topology page (select the chart icon Icon Chart (New) after a data value), line graphs are used to plot the values of StorageGRID attributes that have a unit value (such as NTP Frequency Offset, in ppm). The changes in the value are plotted in regular data intervals (bins) over time.

    Line Graph
  • Area graphs: Available from the Nodes page and from the SUPPORT > Tools > Grid topology page (select the chart icon Icon Chart (New) after a data value), area graphs are used to plot volumetric attribute quantities, such as object counts or service load values. Area graphs are similar to line graphs, but include a light brown shading below the line. The changes in the value are plotted in regular data intervals (bins) over time.

    Area Graph
  • Some graphs are denoted with a different type of chart icon Chart Icon and have a different format:

    Charts Lost Object Detected
  • State graph: Available from the SUPPORT > Tools > Grid topology page (select the chart icon Icon Chart (New) after a data value), state graphs are used to plot attribute values that represent distinct states such as a service state that can be online, standby, or offline. State graphs are similar to line graphs, but the transition is discontinuous; that is, the value jumps from one state value to another.

    State Graph

Chart legend

The lines and colors used to draw charts have specific meaning.

Example Meaning

screenshot showing dark green line

Reported attribute values are plotted using dark green lines.

screenshot showing shading that indicates data binning

Light green shading around dark green lines indicates that the actual values in that time range vary and have been "binned" for faster plotting. The dark line represents the weighted average. The range in light green indicates the maximum and minimum values within the bin. Light brown shading is used for area graphs to indicate volumetric data.

screenshot showing blank areas on plot line

Blank areas (no data plotted) indicate that the attribute values were unavailable. The background can be blue, gray, or a mixture of gray and blue, depending on the state of the service reporting the attribute.

screenshot showing light blue shading indicating indeterminate values

Light blue shading indicates that some or all of the attribute values at that time were indeterminate; the attribute was not reporting values because the service was in an unknown state.

screenshot showing gray shading due to unknown values

Gray shading indicates that some or all of the attribute values at that time were not known because the service reporting the attributes was administratively down.

screenshot showing mix of indeterminate and unknown values

A mixture of gray and blue shading indicates that some of the attribute values at the time were indeterminate (because the service was in an unknown state), while others were not known because the service reporting the attributes was administratively down.

Display charts and graphs

The Nodes page contains the charts and graphs you should access regularly to monitor attributes such as storage capacity and throughput. In some cases, especially when working with technical support, you can use the SUPPORT > Tools > Grid topology page to access additional charts.

Before you begin

You must be signed in to the Grid Manager using a supported web browser.

Steps
  1. Select NODES. Then, select a node, a site, or the entire grid.

  2. Select the tab for which you want to view information.

    Some tabs include one or more Grafana charts, which are used to plot the values of Prometheus metrics over time. For example, the NODES > Hardware tab for a node includes two Grafana charts.

    Nodes Page Hardware Tab Graphs
  3. Optionally, position your cursor over the chart to see more detailed values for a particular point in time.

    Nodes Page Memory Usage Details
  4. As required, you can often display a chart for a specific attribute or metric. From the table on the Nodes page, select the chart icon Chart Icon to the right of the attribute name.

    Note Charts aren't available for all metrics and attributes.

    Example 1: From the Objects tab for a Storage Node, you can select the chart icon Chart Icon to see the total number of successful metadata store queries for the Storage Node.

    Successful Metadata Queries
    Charts Successful Metadata Queries

    Example 2: From the Objects tab for a Storage Node, you can select the chart icon Chart Icon to see the Grafana graph of the count of lost objects detected over time.

    Object Count Table
    Charts Lost Object Detected
  5. To display charts for attributes that aren't shown on the Node page, select SUPPORT > Tools > Grid topology.

  6. Select grid node > component or service > Overview > Main.

    screenshot described by surrounding text
  7. Select the chart icon Chart Icon next to the attribute.

    The display automatically changes to the Reports > Charts page. The chart displays the attribute's data over the past day.

Generate charts

Charts display a graphical representation of attribute data values. You can report on a data center site, grid node, component, or service.

Before you begin
Steps
  1. Select SUPPORT > Tools > Grid topology.

  2. Select grid node > component or service > Reports > Charts.

  3. Select the attribute to report on from the Attribute drop-down list.

  4. To force the Y-axis to start at zero, clear the Vertical Scaling checkbox.

  5. To show values at full precision, select the Raw Data checkbox, or to round values to a maximum of three decimal places (for example, for attributes reported as percentages), clear the Raw Data checkbox.

  6. Select the time period to report on from the Quick Query drop-down list.

    Select the Custom Query option to select a specific time range.

    The chart appears after a few moments. Allow several minutes for tabulation of long time ranges.

  7. If you selected Custom Query, customize the time period for the chart by entering the Start Date and End Date.

    Use the format YYYY/MM/DDHH:MM:SS in local time. Leading zeros are required to match the format. For example, 2017/4/6 7:30:00 fails validation. The correct format is: 2017/04/06 07:30:00.

  8. Select Update.

    A chart is generated after a few seconds. Allow several minutes for tabulation of long time ranges. Depending on the length of time set for the query, either a raw text report or aggregate text report is displayed.