API events
Home > Administration > Event Administration > API events
Contents
1 Overview
There are multiple ways to get events into Veloopti.
- Using the veloopti-event.exe program
- Using a web post
1.1 Using the veloopti-event.exe program
This method allows you to create a Veloopti event using the veloopt-event.exe program. This program comes with every agent.
1.1.1 Usage
Parameter | Required | Description |
---|---|---|
/severity=<severity>
or /sev=<severity> |
True | Specifies the severity of the event. The following severities are supported: information, warning, and critical. matching shortened versions.
|
/short_description="<short description>"
or /short="<short description>" |
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.
|
/long_description="<long description>"
or /long="<long description>" |
False | 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.
|
/application=<Alias>
or /app=<Alias> |
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.
|
/itil=<classification> | False | Specifies the (optional) ITIL classification of the event. The following values are supported: availability, performance, capacity, and security. There are matching shortened versions.
|
/key="<event key>" | False | 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 (\")
|
/node_id="<event source node id>" | 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.
|
/property="<name>:<value>" | False | 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>".
|
/add_help="<help text>"
or /add="<help text>" |
False | Specifies the optional Help Text of the event. The Help Text is 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.
|
/close | False | 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.
|
/info | False | Shows the detailed synopsis, command line help and examples. This option does not take an argument value.
/info |
/version
or /ver |
False | Shows the version information of the "veloopti-event" command. This option does not take an argument value.
|
1.1.2 Alias mappings
The Alias directs the event to the correct application.
To create an alias you need a role that has the Global Rename Application or Application "Manage Alias" permission. From the application view click on the more option menu item and select Rename application. From this dialogue box fill in the Alias that you want to use for the application.
1.1.3 Examples
veloopti-event.exe /severity=warning /short_description="Testing event " /long_description="This is the long description, amazing, eh?" /app=test2
1.2 Using a web post
Coming soon!