This page last changed on Jul 20, 2009 by mmcgarry.
Metric Chart
Topics marked with * relate to HQ Enterprise-only features.
This screen allows users to view selected metric in chart form. To display the page
- Navigate to the resource for which you wish to see a metric chart.
- In the Resources tab, mark the checkbox next to the Resource of interest
- Toggle the Problem Metrics/All Metrics control as desired, and click the View Metrics button.
- Place your cursor over the callout icon for the metric you wish to chart, and select the View Full Chart option.
Charts can be one of several types, dictated by the number of metrics and number of resources plotted.
Feedback is welcome. Click Add Comment at the bottom of the page.
Tasks Available on This Screen
On this screen, users can do the following tasks:
To graph different kinds of data for a metric:
- In the chart legend, check or uncheck the desired kinds of data (described below) and click the
button.
The chart will be refreshed to reflect the new selections.
To change the display range:
- At the bottom right of the "Metric Chart" section, either:
- To move forward or back eight hours, click
or , respectively. The new display range is indicated.
- For a specific date/time range:
- Click Edit Range.
- For a range counting back from the current time: Select a length of time.
- For a date/time range: Select a date/time range.
- Click

The metric charts on the screen automatically refresh to reflect the new display range. This display range value applies to all resource-monitoring screens.
To save the chart to the Dashboard:
- At the top of the page, click Save Chart to My Dashboard, to add the chart to the "Saved Charts" portlet in the dashboard.
- In HQ Enterprise 4.2 and later, if you have edit permissions for multiple dashboards, the Tools menu will instead have an Save Chart to Dashboards option. Select the option to view a list of dashboards for which you have edit permissions. You can select one or more dashboards, and click Add to add the chart to those dashboards.
To save the chart in CSV format:
- At the top of the page, click Export to CSV.
For Single Resources
To change the baseline or acceptable range of values for the charted metric:
- In "Metric Baseline & Expected Range," click Change Value next to the Baseline, High Range, or Low Range.
- Either leave the displayed calculated value or enter another value.
Enter the unit of measure appropriate for the selected metric. For example, % for the Availability metric or MB for the Free Memory metric.
If specifying both high and low values, the low must be lower than the high.
- Click Save Value.
HQ automatically checks "Baseline," "High Range," or "Low Range" (depending on what was changed) in the chart legend and refreshes the chart with those values.
back to top
Sections on This Screen
Metric Chart
The chart legend allows users to select types of data to include in the chart:
- Actual: The observed metric value at any point in time
- Peak: The highest observed metric value (this will be a horizontal line)
- Average: The average of observed metric values across the entire graph (this will be a horizontal line)
- Low: The lowest observed metric value (this will be a horizontal line)
- Low Range: The user-specific lowest acceptable metric value (this will be a horizontal line)
- High Range: The user-specific highest acceptable metric value (this will be a horizontal line)
- Baseline: The HQ- or user-set baseline value (this will be a horizontal line)
- Control Actions: Indicates on the chart when control actions where performed on the resource (to help correlate the actions with changes in performance)
Participating Resource
This section lists the resource and its metrics or the resources (in the case of charting a group) that are plotted in the chart. Users can change the individual resource's metrics or the set of group member resources that are included in the chart.
Metric Baseline and Expected Range
This section allows the user to view and change the values current calculated or set for the metric baseline and the acceptable range of metric values (outside of which observed metric values will be considered "out-of-bounds" (or "OOB")). This section is available only when a single metric is charted.
back to top
Reading a Chart
The Y-axis represents the metric value; the X-axis, time. Each column represents a 1/60 time slice of the selected metric display range. A chart can plot a maximum of 60 points.
The chart displays:
- The average, peak, and low observed values for the metric for the slice of time along the X-axis
- If available, the established baseline, high range (highest acceptable), and low range (lowest acceptable) values
Each column displays :
- The observed metric value for that slice of time. For dynamic metrics, this can be an average. See details below.
- (In the case where the plotted point is an average) The range (represented by an I bar) of metric values collected in that slice of time
Time Slices
The charts are divided into a maximum of 60 slices, where each slice represents the same amount of time, over any display range the user chooses. Here are a few examples to help explicate the use of time slices:
- If the metric a user is viewing has a collection interval of 5 minutes and the selected display range is an hour long (making 12 observed metric values), then the chart will contain only 12 time slices, and each slice will represent a single observed metric value.
- If the selected display range is 5 hours long (making 12 collections per hour x 5 hours = 60 observed metric values), then the chart will display 60 time slices, and each slice will represent a single observed metric value.
- If the selected display range is 10 hours long (making 12 collections per hour x 10 hours = 120 observed metric values), then the chart will still display its maximum of 60 time slices, but each time slice represents an average of the two observed metric values leading up to the (slice of) time.
Display of Dynamic Data vs. Static Data
For static metrics, the plotted point represents a single metric value at one moment in time. For dynamic metrics, a point on the chart represents the average of the metric values observed over the period of time that ended at the specific time (X-axis value). How long is that period of time over which the value was averaged? That depends on the display range. For a display range of eight hours, each charted point represents the average of the preceding eight-minute period (8 hours / 60 time slices along the X-axis = 8 minutes). If the metric is collected every 60 seconds, and the chart's display range is 60 minutes, each of the 60 plotted points on the graph represents the single, observed value for the metric at a single point in time.
Display of Cumulative Data
The values for data that is cumulative (trending up or down) — such as bytes served, uptime, minimum response time, number of transactions — are not averaged. A point charted for this kind of data shows the maximum (or minimum) value for the time slice.
back to top
Navigating via the Masthead Menu
Main screens in Hyperic contain a masthead menu. Users can navigate to the following parts of HQ using this menu:
Dashboard |
Displays the Dashboard, the starting screen in HQ, which displays information about resource health, recent alerts, recently performed auto-discovery scan, and control actions |
Resources |
Click the menu name to access either Browse (takes users to the Browse Resources screen, where they can locate and navigate through information about all managed resources), Currently Down (takes users to the Currently Down screen, where they can look at all managed resources that are unavailable), Nagios Availability (available only when Nagios is installed), or Recently Viewed (provides a drop-down list of resources that the user has recently viewed. Selecting one of those resources takes the user to the Current Health screen for the resource). |
Analyze |
Click the menu name to access Reporting * (presents the Reporting screen, from which reports can be generated), Alert Center (presents the Alert Center, which displays a deployment wide alert summary), or Event Center (presents the Event Center, which displays a deployment-wide event summary). |
Administration |
Takes users (with "Administer Hyperic HQ Server Configuration" permissions) to the Administration screen, where they can manage the system-wide settings |
Search |
The Search box in the upper right of the Masthead allows you to search for HQ resources of any type and HQ users.
Search results appear after four characters are entered in the text box. Results will include the first 10 platforms, servers, services, and groups whose name includes the search string.
Double-click a resource in the list to navigate to its Resource page. |
The masthead also displays the two most recently triggered alerts. Users can click the alert's time to be taken to the alert detail.
back to top
|