Changes

API events

3,812 bytes added, 21:11, 6 December 2018
m
no edit summary
{| class="wikitable"
! Parameter
! Required
! Description
|-
| /severity=<severity>
| can be expressed as ''or'' /sev=<severity>| True| Specifies the severity of the event. The following severities are supported: information, warning, and critical and. matching shortened versions.e.g.<code>/sev=info</code> <code>/severity =warning</code>
|-
| /short_description=&#34;&#60;short&nbsp;description>&#34;
| can be expressed as ''or'' /short=&#34;&#60;short&nbsp;description>&#34;| True| Specifies the short description of the event. This argument is limited to 80 characters and will be truncated if more are supplied.This argument will need to quoted as it will probably contain spaces.e.g.<code>/short_description="Greater than 100 emails are in the deferred queue"</code> <code>/short ="Greater than 100 emails are in the deferred queue"</code>
|-
| /long_description="<long&#8239;description>"
 ''or'' /long="<long&#8239;description>"| Set Long DescriptionFalse| Specifies the optional long description of the event. If not provided then the long description will be set to the same value as the short description. <code>/long_description="The application is processing a larger number of requests that normal. More than 1000 have been processed in the last minute and the average is less than 50."</code> <code>/long="The application is processing a larger number of requests that normal. More than 1000 have been processed in the last minute and the average is less than 50."</code>
|-
| /application=<Alias>
 ''or'' /app=<Alias>| Set True| Specifies the application short name of the event. This argument requires a valid "application alias" to have been configured in Veloopti for a given application.<code>/app=OS</code> <code>/app=MyApplication</code>
|-
| /itil=<classification>
| Set False| Specifies the (optional) [https://en.wikipedia.org/wiki/ITIL ClassificationITIL] classification of the event. The following values are supported: availability, performance, capacity, and security. There are matching shortened versions.<code>/itil=avail</code> <code>/itil=cap</code> <code>/itil sec</code> <code>/itil performance</code>
|-
| /key="<event key>"
| Set Message KeyFalse| Specifies the (optional) key for the event. The key is used to specify uniqueness of an event for use with duplicate suppression and auto closing. The key can be set to any string of alphanumeric characters including:spaces ( ), colons (:), commas (,), periods (.), forward slashes (/), back slashes (\\), NOTE: back slashes require delimiting single quotes ('), NOTE: single quotes may require delimiting (\') double quotes ("), NOTE: double quotes may require delimiting (\") <code>/key="MyAPP:Calculator:Calc:1"</code> <code>/key="EastCoast:Web:LoadBalance:availability:main web site"</code>
|-
| /node_id&#61;&quot;&lt;event&nbsp;source&nbsp;node&nbsp;id&gt;&quot;
| Set Event Source False| Specifies the (optional) source node id for the event. The node_id setting is used to specify a different node id rather than associating the event with the node where the command is run. The node_id is the unique Node Id. <code>/node_id="f7a0d939-0434-45ed-8548-895d35a54623"</code> <code>/node_id="29c3b745-067c-4715-b799-60c70171be2f"</code>
|-
| /property="<name>:<value>"
| Add PropertyFalse| Specifies additional custom properties of the event. May be entered multiple times as required. Can be expressed as /prop These properties are displayed under the Event Details and provide extra context to the event. These properties are also passed to Integrations for use in external services. This argument may need to quoted as it could likely contain spaces.This argument value consists of two (2) parts separated by a colon (:) "<KEY>:<VALUE>". <code>/prop="logfile:/var/log/audit/audit.log"</code> <code>/property="disk:C:\"</code> <code>/prop="file:config.txt"</code>''NOTE: only the first colon (:) is used when delimiting in the example of /property "disk:C:\"''
|-
| /add_help="<help&nbsp;text>"
 ''or'' /add="<help&nbsp;text>"| Add False| Specifies the optional Help Text of the event. The Help Textis displayed under the Event Details and included in notifications and integrations. It is useful for including information to operators on how or why an event is likely to have occurred or instructions to assist with further diagnosis or how to resolve the event. <code>/add_help="It is possible that the data disk is full and more space is needed. Check the log files. Restart the application once fixed."</code> <code>/add="It is possible that the data disk is full and more space is needed. Check the log files. Restart the application once fixed."</code>
|-
| /close
| Set CloseFalse|Sets the closed flag on the event. Veloopti will match the event on existing open events based on the Short Description or Key (if provided). If an existing open event is found, it will be auto- closed by Veloopti. This option does not take an argument value.| <code>/help| Display command line usage help</code>
|-
| /info
| Display False| Shows the detailed synopsis, command line usage help and examples. This option does not take an argument value./info
|-
| /version
 ''or'' /ver| Display command False| Shows the version informationof the "veloopti-event" command. This option does not take an argument value.<code>/ver</code>
|}