Entering content frame

Background documentation MONITOR Locate the document in its SAP Library structure

This section contains the commands used for working with the Monitoring Service. They are added to the Shell environment by executing ADD MONITOR on the command line.

CHANGE_DESCRIPTION

Syntax

CHANGE_DESCRIPTION <monitor node> <new description>

Arguments

 

<monitor node>

The full path from Root to the node.

<new description>

The new description.

Description

Changes the description of a monitor node.

Example

CHANGE_DESCRIPTION /Root/Services/Timeout "new description"

This example displays the subtree /Root/Services/Timeout as text.

CHANGE_PERIOD

Syntax

CHANGE_PERIOD <monitor node> <new period>

Arguments

 

<monitor node>

The full path from Root to the node.

<new period>

The new period.

Description

Changes the period through which the data is pulled by the monitor resource.

Example

CHANGE_PERIOD /Root/Services/Timeout/
EstimatedFrequencyPerMinute 1 minute
– changes the period to 1 minute

CHANGE_PERIOD /Root/Services/Timeout/
EstimatedFrequencyPerMinute 2 hour
– changes the period to 2 hour

CHANGE_PERIOD /Root/Services/Timeout/
EstimatedFrequencyPerMinute 3 day
– changes the period to 3 day

CHANGE_REACT_ON_FAILURE

Syntax

CHANGE_REACT_ON_FAILURE <monitor node> <new value>

Arguments

 

<monitor node>

The full path from Root to the node.

<new value>

The new value for react-on-failure. The possible values are: unregister_monitor/ignore.

Description

Changes the way the monitor reacts on resource failure.

Example

CHANGE_REACT_ON_FAILURE /Root/Services/
Timeout/EstimatedFrequencyPerMinute unregister_monitor
– changes react-on-failure to unregister_monitor

CHANGE_REACT_ON_FAILURE /Root/Services/
Timeout/EstimatedFrequencyPerMinute ignore
– changes react-on-failure to ignore

CHANGE_STATES

Syntax

CHANGE_STATES <monitor node> <state group> <states>

Arguments

 

<monitor node>

The full path from Root to the node.

<state group>

Defines the state group that will be modified.

To change existing states, use: GreenStates, YellowStates, RedStates

To add new states, use: AddGreenStates, AddYellowStates, AddRedStates

<states>

The states to update/add

Description

Changes the states of a state monitor node.

Example

CHANGE_STATES "/Root/Services/SSL Provider/Expiration of Certificates" greenstate1 greenstate2 – removes the old green states and adds the new states.

CHANGE_STATES "/Root/Services/SSL Provider/Expiration of Certificates" AddYellowState greenstateN – adds new states to existing yellow states.

CHANGE_THRESHOLDS

Syntax

CHANGE_THRESHOLDS <monitor node> <green to yellow> <yellow to red> <red to yellow> <yellow to green>

or,

CHANGE_THRESHOLDS <monitor node> <threshold> <new value>

Arguments

 

<monitor node>

The full path from Root to the node.

<green to yellow>

The new value for the 'green to yellow' threshold.

<yellow to red>

The new value for the 'yellow to red' threshold.

<red to yellow>

The new value for the 'red to yellow' threshold.

<yellow to green>

The new value for the 'yellow to green' threshold.

<threshold>

Changes one threshold: GreenToYellow, YellowToRed, RedToYellow, YellowToGreen

<new value>

The new value for the threshold.

Description

Changes monitor thresholds. You can change all thresholds at once, or only a particular one.

Example

CHANGE_THRESHOLDS list_monitor_tree /Root/Services/Timeout/
EstimatedFrequencyPerMinute 10 20 20 10
– changes all thresholds

CHANGE_THRESHOLDS list_monitor_tree /Root/Services/Timeout/
EstimatedFrequencyPerMinute GreeenToYellow 20
– changes the GreenToYellow threshold

LIST_MONITOR_TREE

Syntax

LIST_MONITOR_TREE [monitor node] [-text]

Arguments

 

[monitor node]

The full path from Root to a particular node, which subtree will be listed.

[-text]

Displays the tree without the tree structure formatting.

Description

Lists the whole monitoring tree.

Example

LIST_MONITOR_TREE /Root/Services -text – displays the subtree /Root/Services without formatting

LIST_MONITOR_TREE -text – displays the whole tree without formatting

LIST_MONITOR_TREE /Root/Applications – displays the subtree /Root/Applications in a tree format

MONITOR_INFO

Syntax

MONITOR_INFO <monitor node>

Arguments

 

<monitor node>

The full path from Root to the node.

Description

Displays detailed information for a monitor node.

Example

MONITOR_INFO /Root/Services/Timeout/
EstimatedFrequencyPerMinute

Note

To change the separator char, use the SETSP command from the ADMIN group.

See also:

 

Monitoring in the Administration Manual

 

Leaving content frame