The edgemon command and associated arguments are as follows:
oid objectOID index flags interval sampleType oper value "descr" "action" [supersededBy | objClass objInst objAttr severity]
filesystem|interface|cpu|disk name variable-name index flags interval sampleType oper value "descr" "action" [supersededBy | objClass objInst objAttr severity]
setstatus index status
delete index
list
List of arguments deliminted by | means the list on the left side or the list on the right side could be used.
Specifies the OID to monitor. You can specify the OID using the complete dotted-decimal value (for example, 1.3.6.1.2.1.25.1.5.0) or the symbolic MIB name (for example, hrSystemNumUsers.0). Either way, you must specify the object instance, which is typically zero for non-tabular MIB variables and corresponds to the specific instance of an attribute that belongs to a MIB table.
Examples:
Specifies the row (index) of the monitor table to use for this entry. Each row in the table is uniquely identified by an index number. Rows 1 through 10 are reserved for internal use by the agent, so the index value must be greater than 10 and unique across the table.
Specifies any additional behavioral instructions for this entry using a hexadecimal flags value (for example, 0x00000001). For more information about available flags, see Self Monitor Table Flags.
Specifies how often in seconds the monitoring should occur. For example, the value 30 instructs the agent to monitor this entry every 30 seconds. The value must be a minimum of 30 and a multiple of 30 seconds.
Specifies a sample type of either absolute or delta. This value indicates whether the agent should sample the object's absolute value or take the difference between successive samples.
Specifies the Boolean operator for evaluating an the current entry value against the provided threshold value.
Valid values for the operator are as follows:
Default: nop
Specifies the integer threshold value to which the current value of the monitored attribute is compared using the specified operator.
Specifies an arbitrary description (0 to 512 characters in length) of the table entry.
Specifies a command (0 to 2048 characters in length), including the full path and any parameters, to run when the threshold condition is met and the agent sends a threshold breach trap (legacy monitors) or state change trap (stateful monitors). For stateful self monitors, the command does not run if a threshold breach does not result in an object state change. If the string is empty, the agent performs no action for this entry.
Note: You can change the default settings for when the agent performs actions. For more information, see the chapter "Agent Configuration."
Specifies the table index that acts as a parent or overriding partner to this entry. Valid values are existing or future SystemEDGE monitor indexes (a positive integer value). The default is zero (0), indicating default behavior.
Note that usage of the object state model (entering a severity other than none) obsoletes and disables this functionality.
Specifies the object class of the monitored object for use with the state management model. Define a value for this property (along with objInst and objAttr) for creating a managed object that aggregates all entries with the same values. The agent uses the sysedge.oid file to assign a default value.
Default: MIB group or table name (see sysedge.oid)
Specifies the object instance of the monitored object for use with the state management model. Define a value for this property (along with objClass and objAttr) for creating a managed object that aggregates all entries with the same values. The agent uses the sysedge.oid file to assign a default value for tabular objects based on a specific attribute value and assigns null as the default for non-tabular objects.
Specifies the object attribute for use with the state management model. Define a value for this property (along with objClass and objInst) for creating a manged object that aggregates all entries with the same values. The agent uses the sysedge.oid file to assign a default value that corresponds to the MIB attribute name.
Default: MIB attribute name
Specifies the severity to use for the object state management model. This value defines the state to assign to the entry when a threshold breach occurs. Valid values are as follows:
A value of none creates a legacy monitor, which excludes the entry from the object state management model.
Default: none
Specifies the name of the file system, network interface, CPU, or disk to monitor, depending on type of command you entered (filesystem, interface, cpu, or disk). For example, C: for filesystem.
Specifies the variable from the Systems Management Empire MIB table to monitor corresponding to the command you entered (filesystem, interface, cpu, or disk). For example, you can monitor a file system's capacity by specifying devCapacity as the variable-name.
Specifies the entry's status, which can be one of the following:
Copyright © 2013 CA. All rights reserved. |
|