1. Use dsconfig to configure a gauge and set the override-severity property to critical.

    The following example configures the CPU Usage (Percent) gauge.

    $ dsconfig set-gauge-prop \
      --gauge-name "CPU Usage (Percent)" \
      --set override-severity:critical
  2. Run the status tool to verify that an alarm was generated with corresponding alerts.

    The status tool provides a summary of the server’s current state with key metrics and a list of recent alerts and alarms.

    The sample output has been shortened to show just the alarms and alerts information.

    $ bin/status
    
                            --- Administrative Alerts ---
     Severity : Time            : Message
     ---------:-----------------:------------------------------------------------------
     Info     : 11/Aug/2014     : A configuration change has been made in the
              : 15:48:46 -0500  : Directory Server:
              :                 : [11/Aug/2014:15:48:46.054 -0500]
              :                 : conn=17 op=73 dn='cn=Directory Manager,cn=Root
              :                 : DNs,cn=config' authtype=[Simple] from=127.0.0.1
              :                 : to=127.0.0.1 command='dsconfig set-gauge-prop
              :                 :  --gauge-name 'Cleaner Backlog (Number Of Files)'
              :                 : --set warning-value:-1'
     Info     : 11/Aug/2014     : A configuration change has been made in the
              :  15:47:32 -0500 : Directory Server: [11/Aug/2014:15:47:32.547 -0500]
              :                 : conn=4 op=196 dn='cn=Directory Manager,cn=Root
              :                 : DNs,cn=config' authtype=[Simple] from=127.0.0.1
              :                 : to=127.0.0.1 command='dsconfig set-gauge-prop
              :                 : --gauge-name 'Cleaner Backlog (Number Of Files)'
              :                 :  --set warning-value:0'
     Error    : 11/Aug/2014     : Alarm [CPU Usage (Percent). Gauge CPU Usage (Percent)
              :  15:41:00 -0500 : for Host System has
              :                 : a current value of '18.583333333333332'.
              :                 : The severity is currently OVERRIDDEN in the
              :                 : Gauge's configuration to 'CRITICAL'.
              :                 : The actual severity is: The severity is
              :                 : currently 'NORMAL', having assumed this severity
              :                 : Mon Aug 11 15:41:00 CDT 2014. If CPU use is high,
              :                 : check the server's current workload and make any
              :                 : needed adjustments. Reducing the load on the system
              :                 : will lead to better response times.
              :                 : Resource='Host System']
              :                 : raised with critical severity
    Shown are alerts of severity [Info,Warning,Error,Fatal] from the past 48 hours
     Use the --maxAlerts and/or --alertSeverity options to filter this list
                             --- Alarms ---
     Severity : Severity Start : Condition : Resource    : Details
              : Time           :           :             :
     ---------:----------------:-----------:-------------:------------------------------
     Critical : 11/Aug/2014    : CPU Usage : Host System : Gauge CPU Usage (Percent) for
              : 15:41:00 -0500 : (Percent) :             : Host System
              :                :           :             : has a current value of
              :                :           :             : '18.785714285714285'.
              :                :           :             : The severity is currently
              :                :           :             : 'CRITICAL', having assumed
              :                :           :             : this severity Mon Aug 11
              :                :           :             : 15:49:00 CDT 2014. If CPU use
              :                :           :             : is high, check the server's
              :                :           :             : current workload and make any
              :                :           :             : needed adjustments. Reducing
              :                :           :             : the load on the system will
              :                :           :             : lead to better response times
     Warning  : 11/Aug/2014    : Work Queue: Work Queue  : Gauge Work Queue Size (Number
              : 15:39:40 -0500 : Size      :             : of Requests) for Work Queue
              :                : (Number of:             : has a current value of '27'.
              :                : Requests) :             : The severity is currently
              :                :           :             : 'WARNING' having assumed this
              :                :           :             : severity Mon Aug 11 15:48:50
              :                :           :             : CDT 2014. If all worker
              :                :           :             : threads are busy processing
              :                :           :             : other client requests, then
              :                :           :             : new requests that arrive will
              :                :           :             : be forced to wait in the work
              :                :           :             : queue until a worker thread
              :                :           :             : becomes available
    Shown are alarms of severity [Warning,Minor,Major,Critical]
    Use the --alarmSeverity option to filter this list