Skip to content

Create a dashboard for Linux hosts in an organizer

This tutorial shows how to create a dashboard dedicated to the Linux hosts found in a Collection Zone organizer. If you have not already created any organizers, use the procedures on this page to create at least one, and then come back.

In this tutorial, all of the hosts are virtual machines running on the same vSphere hypervisor host. It's OK if your hosts are not virtual machines, but they do need to be Linux hosts.

The following example shows the result of this tutorial.

Define the dashboard name and scope

  1. In the Zenoss Cloud header area, click DASHBOARDS.

    1. If you do not own any dashboards, the page looks like similar to this (the header may have different options):

      Click CREATE A NEW DASHBOARD, then skip ahead to substep d.

    2. If you do own one or more dashboards, the page displays the first dashboard in your list.

    3. Click the panel toggle (highlighted in red), and then click NEW DASHBOARD.

    4. The result is the Define Dashboard Scope page.

  2. In the name field (upper-left), replace My Dashboard with a descriptive name.

    This tutorial uses SE Demo Systems. Use a name that works for you.

  3. Click ADD ENTITIES.

  4. In the Add Source area, click the name of a Collection Zone that includes an organizer.

    Most customers have just one Collection Zone. Here, the Collection Zone name is Cz0.

    When you select a Collection Zone, the page expands to display filtering options.

    Zenoss recommends using one or more filters in all Collection Zone scopes. The remaining steps demonstrate adding an organizer filter.

  5. Click the "Included in ANY of these Organizers field.

    The field displays the organizers in your Collection Zone.

  6. Click the name of the organizer that contains the Linux hosts to include in this dashboard.

    The list updates to display the names of the entities and folders included in the organizer.

  7. Continue opening folders, if necessary, and then click the name of the organizer that contains the Linux hosts to include in this dashboard.

    This tutorial uses the SE-Demo-Systems organizer.

  8. Collapse the list of organizers by clicking outside the Included in ANY of these Organizers field.

  9. Click the check mark icon, immediately below the ADD ENTITIES button.

    The filtering options collapse. This allows you to add multiple sources, if desired, and to customize filtering for each source.

  10. Click NEXT, in the upper-right corner.

    The dashboard opens in edit mode. Continue to the next section.

Create Graph tiles

To create a Graph tile, you need to know the name of the metric to display. Metric names are often obscure, so this tutorial supplies the names. Otherwise, you can use the metric dictionary to find metric names. Just open the Smart View page of an entity that collects the metric you want to include in a tile, identify the metric, and then open the metric dictionary editor. This procedure is demonstrated in the Graph tile tutorial.

Create a tile for the 5-minute load average

The first tile, in row 1, column 1, shows the 5-minute load average of each host in the dashboard's scope.

  1. In the AVAILABLE TILES palette, click the Graph tile icon.

    The TILE CONFIGURATION dialog (a modal dialog) replaces the dashboard editor window with the Graph tile configuration tabs and fields. (For more information about the dialog, see the Graph tile reference page.)

  2. In the Tile title field, enter 5 Minute Load Average.

  3. In the Tile information area, specify the metric to display.

    1. In the Entity and metric field, enter upti, and then select uptime_laLoadInt5 from the list.

      The dialog updates to highlight your selection, immediately below the Entity and metric field, and to display a graph. By default, the graph is a line graph that aggregates data points from all of the entities in scope that collect the uptime_laLoadInt5 metric.

    2. In the Aggregator field, select none.

      The dialog updates to show separate line graphs for each entity in scope. When you move your pointer over the over graph, a popup displays the entity and metric names and the data points.

    3. From the list in the Label format field, select Entity name.

      Since this tile will only display one metric, including the metric name is unnecessary.

  4. Add a legend to the tile.

    1. Near the top-left of the dialog, click the CHART OPTIONS tab.

    2. From the Legend position list, select right.

      The graph updates to include a legend of entity names. Each name is a link to the entity's Smart View page.

  5. In the upper-right corner of the dialog, click SAVE.

    New tiles are placed in the first available cell, starting in row 1, column 1, and continuing down the rows and across the columns, from left to right.

  6. Resize the tile to occupy rows 1 and 2 in columns 1 and 2 (a total of four cells).

Create the remaining Graph tiles

Create the remaining Graph tiles as specified in the following tabs. Like the first tile, these tiles are configured to show data about each host or component in the dashboard's scope.

The upper-left position is row 1, column 3 and it spans rows 1-2 and columns 3-4.

Tile title CPU Utilization
Entity and metric cpu_ssCpuUsedPerCpu
Aggregator none
Label format Entity name
Legend position right

The upper-left position is row 1, column 5 and it spans rows 1-2 and columns 5-6.

Tile title Memory Utilization
Entity and metric mem_MemUsedPercent
Aggregator none
Label format Entity name
Legend position right

The upper-left position is row 3, column 1 and it spans rows 3-4 and columns 1-2.

Tile title Traffic In
Entity and metric intf_ifInOctets
Aggregator none
Label format Entity name
Legend position right

The upper-left position is row 3, column 3 and it spans rows 3-4 and columns 3-4.

Tile title Traffic Out
Entity and metric intf_ifOutOctets
Aggregator none
Label format Entity name
Legend position right

Create a Metric Outliers tile

This dashboard already includes line graphs of the 5-minute load average (row 1, column 1), but there's a tile that you can use to highlight entities with data points that exceed a threshold, the Metric Outliers tile.

  1. On the AVAILABLE TILES palette, click the Metric Outliers icon.

  2. In the TILE CONFIGURATION dialog, configure the tile:

    1. In the Tile title field, replace Metric Outliers with Load Average.

    2. In the Metric field, enter upti, and then select uptime_laLoadInt5 from the list.

    3. In the Target Percent field, replace 50 with 1.

      This means that data points must satisfy the threshold criteria 1% of the dashboard's time range.

    4. In the Defined Range area, reduce the value from 7 to 1.

  3. At the bottom of the TILE CONFIGURATION dialog, click SAVE.

  4. Place the tile in row 5, column 3.

This tile uses hexagons to represent entities and arranges entities in alphabetical order. Entities that exceed the a threshold show up in the color associated with the threshold.

Create events tiles

Two tiles summarizing events round out the dashboard, one showing event totals and another identifying the entities that are producing the greatest numbers of events.

Create an Event Count tile

The Event Count tile displays a doughnut chart representing the severities of events reported against entities in the dashboard's scope. For this dashboard, you'll create a tile to show the count of critical and error events.

  1. On the AVAILABLE TILES palette, click the Event Count icon.

  2. In the TILE CONFIGURATION dialog, configure the tile:

    1. In the Tile title field, enter Production Events.

    2. In the Severities area, click Warning to deselect it.

    3. In the Production state field, select Production.

    4. In the Priority levels field, select Highest and High.

    5. In the Event status field, select Open.

  3. Click SAVE.

  4. Drag the tile to row 4, column 5.

Create a Top Event Producers tile

The Top Event Producers tile displays the count of events and the names of the entities that have the greatest number of events reported against them.

  1. On the AVAILABLE TILES palette, click the Top Event Producers icon.

  2. In the TILE CONFIGURATION dialog, configure the tile:

    1. Leave the Tile title field unchanged.

    2. In the Severities area, click Warning to deselect it.

    3. In the Label format field, select Entity name.

  3. Click SAVE.

  4. Resize the tile to span rows 3 and 4.

  5. In the upper-right corner of the window, click SAVE.

Congratulations, you're done! Compare your dashboard with the example at the beginning of this tutorial, if you wish.