This article explain how to setup a dashboard to monitor disk space on Linux (*nix) and Windows.

Watch video on YouTube Dashboard with Disk & File System Metrics.

Create category

Go to Administration menu and select Category. Add a new category named ‘fs_space’. Scripts use this category when sending data to Apsolab-Server. You can change the category name but you will have to change it in the script file. We will need this category later to create filter.

Create data dictionary

Create data dictionary elements by selecting Import from Administration menu. On Linux, data definition file (mds.json) is located under /opt/apsolab/latest/script/tools/disk-space/mds.json. On Windows, data definition file (mds.json) is located under \Apsolab\Apsolab-IT\script\tools\disk-space\mds.json.

Create task

Go to Administration menu and select Tasks. Add a new task (click on green ‘+’ icon).

  • Give it a name
  • Select task type ‘Run script on server’
  • In the schedule section, set your running preference (days and frequency)
  • To monitor Windows disks from Windows: copy&paste text from \Apsolab\Apsolab-IT\script\tools\disk-space\xlog-mds.bat in script text box. Read comments at begin of script. With this script, you can monitor multiple disks on multiple hosts. Simply enter multiple lines with: call :mds host-name disk
  • To monitor Xnix file systems from Windows: copy&paste text from /opt/apsolab/latest/script/tools/disk-space/xlog-mds.sh in script box. This script can monitor multiple file systems on one host. Read comments at begin of script to configure file systems and Apsolab-Server host parameters. If you want to monitor multiple hosts, create one task per host. Select task type ‘Run script on remote host using SSH’. This script require ‘xlogagent.pl’ Perl script be installed on remote host. Xnix SSH user must use bash shell.
  • To monitor Xnix file systems from Linux: copy&paste text from /opt/apsolab/latest/script/tools/disk-space/xlog-mds-ssh.sh in script box. This script can monitor multiple file systems on one host. Read comments at begin of script to configure file systems and SSH host parameters. If you want to monitor multiple hosts, create one task per host. Xnix SSH user must use bash shell.
  • Save the task

Create filter

From Tools menu select ‘Filter Manager’.

  • Click ‘New Filter’ and give it a name like: Backup file system
  • Select ‘Category’ tab
  • Click ‘Enable Category Filter’
  • Click ‘fs_space’ (or any category you may have specified in the first step)
  • Select ‘Tags & Pattern’ tab
  • Click ‘Enable Dynamic Tags & Pattern Filter’
  • Click first line check box and select field ‘FS Name’
  • Select equal operator
  • Enter file system name in the text box. Ex: /mnt/repo/backup (use the exact same string as in the script)
  • Click ‘Save Filter’ button on the right side
  • Click ‘Close’ button

Create dataset

From Tools menu select ‘Dataset Manager’. Add a new dataset (click on green ‘+’ icon).

  • Give it a name. Ex: Backup FS last used %
  • Select filter. Ex: Backup file system
  • Select Operation: Last field value (group by time)
  • Select Data field: FS Used %
  • Click ‘Apply’

Create gauge

From Tools menu select ‘Chart Manager’. Add a new gauge (click on gauge with embedded green ‘+’ icon in the upper left).

  • Give it a name. Ex: Backup FS last used %
  • Select dataset. Ex: Backup FS last used %
  • Select period: Ex: Last 24 hours
  • Enter a caption for the gauge. Ex: Backup %
  • Set range width to 15
  • Click ‘Apply’

Create one gauge per disk / file system.

Create chart

From Tools menu select ‘Chart Manager’. Add a new chart (click on the green ‘+’ icon in the upper left).

  • Select ‘Chart’ tab (the first one)
  • Give it a name and title. Ex: Disk space usage
  • Check ‘Show time frame’
  • Select period. Ex: Last 3 months
  • Set Group by to ‘Day’
  • Click on ‘Series 1′ tab
  • Select chart type: Spline: Smooth lines connecting the value points
  • Select Dataset. Ex: Backup FS last used %
  • Uncheck ‘Show labels’
  • Check ‘Hide zero’
  • Select a color for this serie
  • Enter a ‘Data description’
  • Enter Y-axis description: %
  • Enter Y-axis min: 0, max: 100, interval: 10
  • Click ‘Save’
  • Click ‘Close’

Create dashboard

From Dashboards menu select ‘Dashboard Manager’. Add a new dashboard (click on the green ‘+’ icon in the upper left).

  • Enter a dashboard name in the ‘Dashboard Control Panel’
  • Drag&Drop gauge and chart in the window area
  • Position & resize objects
  • You can change object refresh interval with context menu (right click)
  • Check ‘Auto resize objects’
  • If you don’t want to see objects window title, click ‘Hide Title’ button
  • Click ‘Save’
  • Click ‘Close’

You can open your dashboard from the ‘Dashboards’ menu or from the Dashboards window list (show column).