User Guide: SNMP plug-in version 2.10.0 for VST-APL

Event Filter

Screen Reference > System > Event Filter

Event Filter List
Add Event Filter
Event List Dialog Box
Device List Dialog Box (Name)
Device List Dialog Box (IP Address)
Device List Dialog Box (MAC Address)
Device List Dialog Box (Model Name)
Action Command List Dialog Box
Event Filter Details
Update Event Filter
The Event Filter is a feature that takes an automatic action when an event occurs (eg. "node detected" and "trap received"). Possible actions include sending an email.
You can specify what action to take when what type of event occurs on which node on "Add Event Filter" or "Update Event Filter" dialog box.

Event Filter List

This page lists all event filters configured on a monitored network and allows you to view, edit and delete some or all of them. You can also create a new event filter by specifing an IP address or device name.

Note
By clicking a column header (eg. "ID", "Event Name" or "Memo"), you can sort the list by the column. Order (ascending or descending) can be toggled by clicking the header.
Table 1: Event Filter List
Item Name Contents
Number of items displayed on the page Select a number of event filters displayed on a page. Options are 10, 25, 50 and All.
"Create" button Create a new event filter.
Add Event Filter page will appear.

Copy to Clipboard 		Copies the event filter list (Event Name, Event Type, Node Name, Node Address, Node Device Name, Memo and Action Command) to clipboard as a tab-delimited text.
It is useful when you want to copy a list to your text editor.
You can filter target subnets with "Search" box. "Number of items on the page" and the current page do not affect an output.

Export to CSV file 		Exports the event filter list (Event Name, Event Type, Node Name, Node Address, Node Device Name, Memo and Action Command) to a CSV file.
You can filter target subnets with "Search" box. "Number of items on the page" and the current page do not affect an output.

Export to Excel 		Exports the event filter list (Event Name, Event Type, Node Name, Node Address, Node Device Name, Memo and Action Command) to an Excel book file (.xlsx for Microsoft Excel 2007 or later).
You can filter target subnets with "Search" box. "Number of items on the page" and the current page do not affect an output.

Print 		Shows the event filter list (Event Name, Event Type, Node Name, Node Address, Node Device Name, Memo and Action Command) on another browser window or tab and opens a print dialog box.
You can filter target subnets with "Search" box. "Number of items on the page" and the current page do not affect an output.
Search field Lets you filter target subnets by keywords.
The search ignores case.
ID Shows an ID of the event filter which was automatically assigned when it was created on "Add Event Filter" dialog box.
Event Name Shows an arbitrary name of the event which you entered on "Add Event Filter" or "Update Event Filter" dialog box.
Event Type Select a type (Error, Alarm, Trap or Event) of the event to react.
  • Error:
    Targets errors output from the SNMP Plug-in.
    Note
    When you select "Error" as the event type, "overLimit" errors are not supported.
    If you select "Error", leave "Node names", "Addresses", "MAC Addresses", and "Model Names" blank.
  • Alerm:
    Note
    This item is not supported.
  • Trap:
    Targets traps received from the target node.
    If you want to target only traps from a specific node, enter any or all of the following: "Node Names", "Addresses", "MAC Addresses", and "Model Names".
    If the target node is not selected, the action command set in the event filter will operate even if a trap is received from a non-monitored node.
    Note
    The events displayed under the "Trap" event type are MIB traps preinstalled in the SNMP Plug-in and traps imported by the user using the MIB compiler. Select the appropriate one.
  • Notes:
    This applies to changes in the status of monitoring devices detected by the SNMP Plug-in (addition/deletion of nodes, attribute changes, etc.).
    Note
    When "Notes" is selected as the event type, "nop" and "test" are not supported in the event.
Node Address Shows addresses of the target node. Multiple items are delimited by commas.
Node Device Name Shows device names of the target nodes. Multiple items are delimited by commas.
Notes Shows an arbitrary memo strings which you input on "Add Event Filter" or "Update Event Filter" dialog box.
Action Command Shows an action to take upon when the event occurs. Multiple items are delimited by commas. Its ID is shown in parenthesis.
"Edit" button Opens Update Event Filter page for the event filter.
"Details" button Opens Event Filter Details page for the event filter.
"Delete" button Opens "Delete Event Filter" dialog box.
Clicking "Yes" in the dialog box deletes the event filter. Click "No" or "Close (x)" button at the top left of the dialog box allows you to cancel the delete operation and goes back to "Event Filter List" page.
Page Navigation Lets you view a specific page of the list.
  • First
    The first page is displayed.

  • Previous
    Displays the page immediately before the current display page.

  • Page Number
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next
    Displays the next page after the currently displayed page.

  • Last
    Display the final page.

Add Event Filter

You can create and add a new event filter on this page.
An event filter runs an action command when a specific event occurs on a target node.
Target nodes for an event filter are all nodes which meet all of the following specified criteria.
Even when you specify multiple conditions for some of the criteria, only nodes matching all the criteria are selected as targets.
For instance,
Then only Node B becomes a target for an action command.
If you want to run the action command on all of the node A, B and C, create two separate event filters, one matches Node Name and the other matches IP Address.
Note
Currently, MAC Address is not supported for the criteria of target node.
Note that you have to create an action command using Action Command before creating an event filter.

Table 2: Add Event Filter
Item Name Contents
Event Name Specify a display name of the event (filter). You can specify 1 to 4096 single-byte alphabets, numbers, and symbols.
Event Type Select a type (trap, info, error or alarm) of the event to react.
Event Shows a selected event and its description.
"Select Event" button Opens "Event List" dialog box and lets you choose one.
Node Name Shows selected node names, device names and subnet names.
  • Name:
    Shows a selected node name. It is the same as the "Name" on "Device Details" page and "Source Name" on "Event Log".

  • Device Name:
    Shows a device name of the target node. It is automatically configured when the device was added. It is an IP address or a hostname of the device.

  • Subnet:
    Shows a subnet to which the device belongs.

  • "Select Target Node Name" button:
    Opens "Device List" dialog box and lets you choose target nodes by their node names.
Node's IP Address Shows selected target IP addresses.
  • "Select Target Node IP Address" button:
    Opens "Device List" dialog box and lets you choose target nodes by their IP addresses.
Nodes's MAC Address Shows selected target MAC addresses.
  • "Select Target Node MAC Address" button:
    Opens "Device List" dialog box and lets you choose target nodes by their MAC addresses.
Node Device Name Shows selected target device name. It is the same as log's "Source Model Name".
  • "Select Target Node Device Name" button:
    Opens "Device List" dialog box and lets you choose target nodes by their device name.
Action Command Shows a selected action's ID, command type and memo to take when the specified event occurs.
  • ID:
    Shows an ID of the action command created on Action Command.

  • Command Type:
    Shows a command type (Sending email).

  • Notes:
    Shows a notes on the action command.

  • "Select Action Command" button:
    Opens "Action Command List" dialog box.
    It lets you choose an action command to run from a list of commands configured on Action Command.
Notes Input any notes. You can specify half-width alphabets, numbers, and symbols within 4096 characters.
"Create" button Save the newlly created event filter configuration.

Event List Dialog Box

This dialog box lets you choose a target event for an event filter.

Table 3: Event List Dialog Box
Item Name Contents
Target Event (Top of the dialog box)
Event Shows event names.
Description Shows brief event descriptions.
Event List (Bottom of the dialog box)
  Lists candidate events for a target event, which are registered in SNMP Plug-in.
Contents of the list varies depending on the event type you choose on the "Add Event Filter" dialog box.
Note
When you choose "Trap" for "Event Type", all traps for all devices added to SNMP Plug-in are listed even if you selected target nodes. Narrow down the event list using Search box then select an event.
Note
The language displayed in the description column depends on the installation environment, so even if Japanese is selected in Vista Manager EX user settings, it will be displayed in English.
Number of items displayed on the page Select a number of events displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter target event candidates by keywords.
The search ignores case.
Radio Buttons Select a radio button to select that event. You cannot select multiple events. Selecting an event deselects the one previously selected.
Event Shows a name of the event.
Description Shows brief event descriptions.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the event selection and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the event selection and go back to "Add Event Filter" or "Update Event Filter" page.

Device List Dialog Box (Name)

This dialog box lets you choose target nodes by their node names.

Table 4: Device List Dialog Box (Name)
Item Name Contents
Target Nodes (Top of the dialog box)
Checkbox Target nodes are checked. You can uncheck those checkboxes or the ones in the node list at the bottom of the dialog box to deselect target nodes.
Subnet Name Shows node names of the selected target nodes.
Device Shows device names of the selected target nodes.
Subnet Shows subnet names where the selected target nodes were added.
Node List (Bottom of the dialog box)
  Lists candidates for the target nodes, which are registered in SNMP Plug-in.
Number of items displayed on the page Select a number of nodes displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter target node candidates by keywords.
The search ignores case.
Checkbox Check those boxes to select target nodes. You can uncheck those checkboxes or the ones in the target node list at the top of the dialog box to deselect target nodes.
Subnet Name Shows node names It is the same as the "Name" on "Device Details" page and "Source Name" on "Event Log".
Device Shows a device name of the target node. It is automatically configured when the device was added. It is an IP address or a hostname of the device.
Note
Device added manually has a device name in the format of "<IP-Address>_<Numbers>".
Subnet Shows a subnet to which the device belongs.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the target node selection and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the target node selection and go back to "Add Event Filter" or "Update Event Filter" page.

Device List Dialog Box (IP Address)

This dialog box lets you choose target nodes by their IP address.

Table 5: Device List Dialog Box (IP Address)
Item Name Contents
Target Nodes (Top of the dialog box)
Checkbox Target nodes are checked. You can uncheck those checkboxes or the ones in the node list at the bottom of the dialog box to deselect target nodes.
IP Address Shows IP addresses of the selected target nodes.
Node List (Bottom of the dialog box)
  Lists candidates for the target nodes, which are registered in SNMP Plug-in.
Number of items displayed on the page Select a number of nodes displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter target node candidates by keywords.
The search ignores case.
Checkbox Check those boxes to select target nodes. You can uncheck those checkboxes or the ones in the target node list at the top of the dialog box to deselect target nodes.
IP Address Shows IP addresses of the devices registered in SNMP Plug-in.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the target node selection and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the target node selection and go back to "Add Event Filter" or "Update Event Filter" page.

Device List Dialog Box (MAC Address)

This dialog box lets you choose target nodes by their MAC address.

Table 6: Device List Dialog Box (MAC Address)
Item Name Contents
Target Nodes (Top of the dialog box)
Checkbox Target nodes are checked. You can uncheck those checkboxes or the ones in the node list at the bottom of the dialog box to deselect target nodes.
MAC Address Shows MAC addresses of the selected target nodes.
Node List (Bottom of the dialog box)
  Lists candidates for the target nodes, which are registered in SNMP Plug-in.
Number of items displayed on the page Select a number of nodes displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter target node candidates by keywords.
The search ignores case.
Checkbox Check those boxes to select target nodes. You can uncheck those checkboxes or the ones in the target node list at the top of the dialog box to deselect target nodes.
MAC Address Shows MAC addresses of the devices registered in SNMP Plug-in.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the target node selection and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the target node selection and go back to "Add Event Filter" or "Update Event Filter" page.

Device List Dialog Box (Model Name)

This dialog box lets you choose target nodes by their model names.

Table 7: Device List Dialog Box (Model Name)
Item Name Contents
Target Nodes (Top of the dialog box)
Checkbox Target nodes are checked. You can uncheck those checkboxes or the ones in the node list at the bottom of the dialog box to deselect target nodes.
Model Name Shows model names of the selected target nodes.
Node List (Bottom of the dialog box)
  Lists candidates for the target nodes, which are registered in SNMP Plug-in.
Number of items displayed on the page Select a number of nodes displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter target node candidates by keywords.
The search ignores case.
Checkbox Check those boxes to select target nodes. You can uncheck those checkboxes or the ones in the target node list at the top of the dialog box to deselect target nodes.
Model Name Shows model names of the devices registered in SNMP Plug-in.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the target node selection and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the target node selection and go back to "Add Event Filter" or "Update Event Filter" page.

Action Command List Dialog Box

This dialog box lets you choose an action command to run when an event occurs on the target nodes from a list of commands configured on Action Command.

Table 8: Action Command List Dialog Box
Item Name Contents
Selected Action Commands List (Top of the dialog box)
Checkbox Selected action commands are checked. You can uncheck those checkboxes or the ones in the action command list at the bottom of the dialog box to deselect target nodes.
ID Shows IDs of the selected action commands.
Command Type Shows types of the selected action commands.
Notes Shows notes for the selected action commands.
Action Command List (Bottom of the dialog box)
  Lists candidates for the action commands, which are registered in SNMP Plug-in.
Number of items displayed on the page Select a number of actions displayed on a page. Options are 10, 25, 50 and All.
Search field Lets you filter action candidates by keywords.
The search ignores case.
Checkbox Check those boxes to select actions. You can uncheck those checkboxes or the ones in the selected action command list at the top of the dialog box to deselect actions.
ID Shows an ID of the action command created on Action Command.
Parameters Shows parameters to the command.
Command Type Shows a command type (Sending email).
Notes Shows a notes on the action command.
Page
  • Number of items:
    Shows a range of items which is currently displayed in the list in the format of "Shows No.XX to XX of XX items."

  • First:
    The first page is displayed.

  • Previous:
    Displays the page immediately before the current display page.

  • Page Number:
    Click the number to display the corresponding page. The currently displayed page is highlighted with a gray button background.

  • Next:
    Displays the next page after the currently displayed page.

  • Last:
    Display the final page.
"OK" button Saves the action command to run and update "Add Event Filter" or "Update Event Filter" pages.
"Cancel" button Discards the action command selection and go back to "Add Event Filter" or "Update Event Filter" page.

Event Filter Details

This dialog box shows detailed information on an event filter.

Table 9: Event Filter Details
Item Name Contents
ID Shows an ID of the event filter which was automatically assigned when it was created.
Event Name Shows a name of the event filter which is registered on SNMP Plug-in.
Event Type Shows a type (trap, info, error or alarm) of the event.
Event Shows a selected event and a short description.
Node Name Shows selected target nodes.
Node's IP Address Shows selected target IP addresses.
Nodes's MAC Address Shows selected target MAC addresses.
Node Device Name Shows selected target device name.
Action Command Shows a selected action's command type and a note.
  • Command Type:
    Shows a command type (Sending email).

  • Notes:
    Shows a notes on the action command.
Notes Shows a note on the event filter.
Edit Clicking it opens Update Event Filter page for the event filter.
Delete Opens "Delete Event Filter" dialog box.
Clicking "Yes" in the dialog box deletes the event filter. Click "No" or "Close (x)" button at the top left of the dialog box allows you to cancel the delete operation and goes back to "Event Filter Details" page.

Update Event Filter

This dialog box lets you change an existing event filter.

Table 10: Update Event Filter
Item Name Contents
ID Shows an ID of the event filter which was automatically assigned when it was created.
Event Name Specify a display name of the event (filter).
Event Type Select a type (trap, info, error or alarm) of the event to react.
Event Shows a selected event and its description.
"Select Event" button Opens "Event List" dialog box and lets you choose one.
Node Name Shows selected node names, device names and subnet names.
  • Name:
    Shows a selected node name. It is the same as the "Name" on "Device Details" page and "Source Name" on "Event Log".

  • Device Name:
    Shows a device name of the target node. It is automatically configured when the device was added. It is an IP address or a hostname of the device.

  • Subnet:
    Shows a subnet to which the device belongs.

  • "Select Target Node Name" button:
    Opens "Device List" dialog box and lets you choose target nodes by their node names.
Node's IP Address Shows selected target IP addresses.
  • "Select Target Node IP Address" button:
    Opens "Device List" dialog box and lets you choose target nodes by their IP addresses.
Nodes's MAC Address Shows selected target MAC addresses.
  • "Select Target Node MAC Address" button:
    Opens "Device List" dialog box and lets you choose target nodes by their MAC addresses.
Node Device Name Shows selected target device name. It is the same as log's "Source Model Name".
  • "Select Target Node Device Name" button:
    Opens "Device List" dialog box and lets you choose target nodes by their device name.
Action Command Shows a selected action's ID, command type and memo to take when the specified event occurs.
  • ID:
    Shows an ID of the action command created on Action Command.

  • Command Type:
    Shows a command type (Sending email).

  • Notes:
    Shows a notes on the action command.

  • "Select Action Command" button:
    Opens "Action Command List" dialog box.
    It lets you choose an action command to run from a list of commands configured on Action Command.
Notes Input any notes.
"Save" button Save the changes made to the event filter configuration.

(C) 2024 Allied Telesis, Inc. All rights reserved.

C613-04172-00 Rev A

02 Aug 2024 14:28