The ev390snmetric utility is used by the Ironstream monitor
scripts to send events with the metric data obtained by the monitor script. The
program may also be used in custom monitor scripts to send metric data as
events to ServiceNow. The command and parameters are shown below:
ev390snmetric -description string -host string -info string -metric string -resource string -value string -version
where:
|
host (required)
|
The hostname of the z/OS LPAR from which the metric was obtained. |
|
metric (required)
|
A name for the metric that will be in the “metric name” event field. |
|
value (required)
|
A numeric value for the metric, for example if the metric was CPU utilization it would be the utilization value obtained, such as 95. |
|
resource
|
A name to be placed in the “resource” field of the event. |
|
description
|
A string of data to be placed in the “Description” field of the event. |
|
info
|
Additional or custom information fields and values can be sent with the event using this parameter. The additional fields must be specified in the format of fieldname:value.
Multiple field value pairs may be specified by separating them with a comma, for example:
field1:value1,field2:value2,field3:value
|
|
version
|
Returns the current version of the ev390snmetric command and does not result in any event being sent. |
|
Example:
Send an event to ServiceNow reporting on the
state of a monitor on the mainframe myhost1 with the metric name “Z_STATUS”,
including additional information in the “other” field:
ev390snmetric -host myhost1.mysite.com -metric Z_STATUS -value 22.22 -resource Z -description "The Z Report" info other:otherinfo