Log & Event Manager User Guide

Transcription

Log & Event Manager User Guide
Contents
Copyright © 1995-2015 SolarWinds Worldwide, LLC. All rights reserved worldwide. No part of this
document may be reproduced by any means nor modified, decompiled, disassembled, published or
distributed, in whole or in part, or translated to any electronic medium or other means without the
written consent of SolarWinds. All right, title, and interest in and to the software and documentation
are and shall remain the exclusive property of SolarWinds and its respective licensors.
SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS OR OTHER TERMS, EXPRESS
OR IMPLIED, STATUTORY OR OTHERWISE, ON SOFTWARE AND DOCUMENTATION
FURNISHED HEREUNDER INCLUDING WITHOUT LIMITATION THE WARRANTIES OF
DESIGN, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND
NONINFRINGEMENT. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS
LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR
ANY OTHER LEGAL THEORY EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
The SolarWinds, the SolarWinds & Design, ipMonitor, LANsurveyor, Orion, and other SolarWinds
marks, identified on the SolarWinds website, as updated from SolarWinds from time to time and
incorporated herein, are registered with the U.S. Patent and Trademark Office and may be registered
or pending registration in other countries. All other SolarWinds trademarks may be common law
marks or registered or pending registration in the United States or in other countries. All other
trademarks or registered trademarks contained and/or mentioned herein are used for identification
purposes only and may be trademarks or registered trademarks of their respective companies.
Microsoft®, Windows®, and SQL Server® are registered trademarks of Microsoft Corporation in the
United States and/or other countries.
LEM 6.1
2/3/15
2
LEM User Guide
Chapter 1: Introduction
1
How LEM Works
1
LEM Architecture
2
LEM Manager
3
Protocols and Communication Direction
4
New Items in 6.1
4
Chapter 2: Upgrading
6
LEM 6.1
6
New Licensing Requirements Started With Version 5.3
6
Upgrading from Version 5.6 or Later
7
Determining the LEM Components Version
7
Best Practices for Appliance Upgrades
8
Resizing the LEM Virtual Appliance
8
Increasing the LEM Virtual Appliance
8
Cloning the LEM Virtual Appliance
9
To clone a disk in Hyper-V:
10
Determining Automatic Update Settings
12
Upgrading LEM Appliance
12
Troubleshooting Errors During the Appliance Upgrade
Upgrading LEM Connectors
13
14
Applying a LEM connector Update Package
15
Additional Information
17
Updating Agents
17
Upgrading LEM Consoles
18
Upgrading LEM Reports
18
Upgrading LEM Agents
19
Upgrade Paths for Versions Prior to 5.7
20
i
LEM User Guide
Chapter 3: Introduction to the Console
Opening Views in the Console
22
22
Working with Grids
23
Rearranging Grid Columns
23
Sorting a Grid by its Columns
24
Logging In and Out of Managers
25
Logging Into a Manager
25
Logging Out of a Manager
26
Logging Out of the LEM Console
26
Chapter 4: Getting Started
27
Configuring Email Alerting
28
Configuring an Active Directory Connection
29
Adding a Node
29
Rules
30
Adding Rules with the Rules Wizard
31
Chapter 5: Useful Tasks
33
Tour Log & Event Manager
33
Ops Center
33
Monitor
34
Explore
35
Build
36
Rules – Additional Details
36
Manage
36
Additional Information
37
Adding Devices
38
Agent Installation
39
ii
Table of Contents
Configuring Non-Agent Devices
39
Configuring Connectors for Agent and Non-Agent Devices
40
Troubleshooting
41
Additional Information
42
Verifying Data
43
Which Do I Pick?
44
nDepth: A Fully Integrated IT Search Solution
44
LEM Reports: For Compliance and Historical Reporting Needs
45
Troubleshooting
46
Additional Information – nDepth
47
External Resources
47
Additional Information – LEM Reports
48
Adding Filters
48
Which Do I Pick?
49
Use the Default Filters as Examples
49
Other Filter Scenarios
50
Example: Change Management
50
Troubleshooting
51
Additional Information
52
Adding Rules
53
Use Pre-configured Rules to Get Started
53
Example: Change Management
54
Other Rule Scenarios
55
Troubleshooting
56
Additional Information
57
Analyzing Data
57
Which Do I Pick?
58
nDepth: A Fully Integrated IT Search Solution
58
LEM Reports: For Compliance and Historical Reporting Needs
59
iii
LEM User Guide
Troubleshooting
60
Additional Information – nDepth
61
Additional Information – LEM Reports
62
Chapter 6: Leveraging
63
Monitoring Windows Domain Controllers for Brute Force Hacking Attempts
63
Configuring the SolarWinds LEM Agent
64
Creating a LEM Rule to Track Failed Login Attempts to Administrative Accounts
68
Monitoring Firewalls for Port Scans and Malformed Packets
70
Setting a Firewall to Log to a LEM Appliance
70
Configuring a Firewall Connector on a LEM Manager
71
Viewing Network Traffic from Specific Computers
72
Creating a LEM Rule to Notify of Potential Port Scanning Traffic
73
Monitoring Antivirus Software for Viruses that are Not Cleaned
74
Setting Antivirus Software to Log to a LEM Appliance
74
Configuring the Antivirus Connector on a LEM Manager
75
Creating a LEM Rule to Track When Viruses Are Not Cleaned
76
Monitoring Proxy Servers for Suspicious URL Access
76
Setting Proxy Server to Log to a SolarWinds LEM Appliance
77
Configuring a Proxy Server Connector on a SolarWinds LEM Manager
77
Monitoring Microsoft SQL Databases for Changes to Tables and Schema
79
Leveraging the Incidents Report in Security Audits
82
Chapter 7: Ops Center
84
Widgets
84
User Details Page
86
User: Details Widget
87
User: All Events Widget
87
Node Details Page
87
iv
Table of Contents
Node: Details Widget
88
Node:Connectors Applied Widget
88
Node: All Events Widget
88
Ops Center Widget Manager
89
Using the Widget Builder
90
Viewing Specific Widget Data
95
Refreshing a Widget’s Data
96
Opening a Filter From a Widget
96
Editing a Widget’s Chart Presentation
98
Resizing a Widget
99
Viewing a Widget’s Legend
99
Widget Storage
100
Chapter 8: Monitor
101
Monitor View Features
101
Filters and Filter Groups
103
Standard LEM Filters
104
Filter Creation
107
Features of Filter Creation
108
Events
110
Applying a Filter to the Events Grid
110
Sorting the Events Grid
110
Highlighting Events
111
Copying Event Data to the Clipboard
112
Marking Events as Read and Unread
113
Removing Events
114
Using the Event Details/Event Description Pane
115
Event Severity Levels
117
v
LEM User Guide
Chapter 9: Explore
118
nDepth
118
nDepth's Visual Tools
119
nDepth's Primary Uses
119
Exploring Events vs. Log Messages
120
Opening nDepth
120
Opening nDepth From Another Data Source
121
Scheduled Saved Searches
124
nDepth's Search Bar
125
nDepth Explorer Toolbar
127
nDepth's History Pane
128
Using the nDepth Histogram
129
Histogram Features
130
Searching the Activity Associated with a Particular Histogram Bar
131
Moving the Search Period
131
Changing the Period's Start and End Time
132
Using Result Details
133
Interpreting Search Results in Events Mode
134
Interpreting Search Results in Log Messages Mode
134
Adding Search Strings from Result Details
136
Using Explorers with Result Details
137
Responding to Result Details
138
Exporting Result Details Data to a Spreadsheet
139
Common nDepth Data Fields
139
Common Data Fields Categories in Events Mode
139
Common Data Field Categories in Log Messages Mode
140
Using the Word Cloud
141
Opening the Word Cloud
142
vi
Table of Contents
Viewing Statistics in the Word Cloud
142
Filtering the Contents of the Word Cloud
142
Exploring Items in the Word Cloud
143
Using the Tree Map
144
Opening the Tree Map
145
Resizing Tree Map Categories
145
Exploring items in the Tree Map
145
Using nDepth widgets
146
Default nDepth Chart Widgets
146
nDepth Explorer and Widget Icons
146
Viewing a widget's details
148
Creating a search string from a widget item
148
Adding new nDepth Widgets
149
Editing nDepth Widgets
149
Adding a Chart Widget to the nDepth Dashboard
150
Adding a main nDepth view to the nDepth Dashboard
151
Using Search Builder
151
Opening Search Builder
152
Switching from the Search Bar to Search Builder
152
Search Builder features
154
Configuring a Search with Search Builder
157
Utilities
159
Explorer Types
160
NSLookup Explorer
161
Traceroute Explorer
162
Whois Explorer
163
Manually Exploring an Item
165
vii
LEM User Guide
Chapter 10: Build
166
Groups
166
Group types
166
Groups View Features
168
Refining the Groups Grid
169
Rules
170
Rules View Features
170
Rules Grid Columns
170
Refine Results Form
171
Rule Categories and Tags
173
Rule Tagging
173
Users
174
Users View Features
174
Users Grid Columns
175
Refining the Users Grid
176
Viewing a User’s System Privileges
176
Chapter 11: Manage
178
Appliances View Features
178
Appliances Grid Columns
179
Details Pane
181
Configuring a Manager's Properties
182
The Login Tab
183
The License Tab
185
License Recycling
185
The Settings Tab
186
Configuring Event Distribution Policy
188
Practical Uses for Event Distribution Policy
188
viii
Table of Contents
Opening the Event Distribution Policy Window
189
189
About the Event Distribution Policy Window
190
Configuring Event Distribution Policy
191
Pushing event policy to lower-level event types
192
Exporting a Manager’s Event Policy
193
Nodes
194
Nodes View Features
194
Nodes Grid Columns
196
Adding a Syslog Node
198
Scan for New Nodes
199
Adding Nodes Manually
200
200
Refining the Agents Grid
200
Chapter 12: Access Controls
202
Adding New Users
202
Editing User Settings
207
Deleting Users
208
Restricting LEM Reports
208
Chapter 13: Utilizing the Console
Filters
210
210
Features of the Conditions Box
215
Creating a New Filter
219
Editing an Existing Filter
220
Cloning an Existing Filter
220
Pausing Filters
221
Resuming Paused Filters
222
ix
LEM User Guide
Turning Filters On and Off
223
Copying a Filter
223
Importing a Filter
224
Exporting a Filter
225
Deleting a Filter
225
Managing Filter Groups
226
Adding a New Filter Group
226
Renaming a Filter Group
226
Rearranging Filter Groups
227
Moving a Filter From One Group to Another
227
Deleting a Filter Group
228
Responding to Events
229
Using the Respond Form’s Drag and Drop Functionality
Event Explorer
229
231
Opening the Event Explorer
231
Event Explorer Features
232
Exploring Events
233
Using the Event Map
234
Reading an Event Map
234
Event Map Legend
235
Using the Event Grid
236
Viewing information in the event grid
236
Exploring From the Event Grid
237
Using the Event Details Pane
237
Opening and Closing the Event Details Pane
238
Viewing an Event’s Event Details
238
Exploring From the Event Details Pane
238
Performing nDepth Searches
239
Creating Search Conditions
241
x
Table of Contents
Deleting Items From Search Strings
243
Creating Custom time frames
244
Saving a Search
245
Using a Saved Search
246
Making Changes to a Saved Search
246
Exporting nDepth Search Results to PDF
247
Exploring Search Results from Graphical Views
248
Taking Action on Event Details
249
Deleting a Saved Search
249
Creating Search Conditions
250
Deleting Items From Search Strings
252
Creating Custom time frames
253
Managing Connectors
254
Adding New Connector Instances
255
Starting a Connector Instance
257
Stopping a Connector Instance
258
Editing a Connector Instance
259
Deleting a Connector Instance
259
Creating Connector Profiles to Manage and Monitor LEM Agents
260
File Integrity Monitoring Connectors
262
Features of FIM
262
What can FIM detect?
263
Adding a FIM Connector
263
Monitors
264
Adding Custom Monitors
264
Editing Monitors
264
Promoting a Monitor to a Template
264
Deleting a Monitor
265
Adding Conditions
265
xi
LEM User Guide
Editing Conditions
266
Deleting Conditions
266
FIM Connector Advanced Settings
266
Managing Widgets
268
Opening and Closing the Widget Manager
269
Creating New Master Widgets
269
Editing Master Widgets
270
Adding Widgets to the Dashboard
271
Deleting Master Widgets
271
Editing a Dashboard Widget
272
Deleting Dashboard Widgets
272
Chapter 14: Advanced Configurations
274
Setting up an Appliance
274
Adding Appliances to the Console
274
Copying Appliance Data
276
Removing an Appliance
276
Managing Connectors
277
Configuring Manager Connectors (general procedure)
277
Configuring Agent Connectors (general procedure)
278
Using Connector Profiles to Configure Multiple Agents
278
Managing Groups
279
Adding a New Group
279
Editing a Group
279
Cloning a Group
280
Importing a Group
281
Exporting a Group
282
Deleting a Group
282
Configuring Event Groups
283
xii
Table of Contents
Configuring an Event Group
283
Event List Features
284
Configuring Directory Services Groups
286
How to Use Directory Services Groups
286
Synchronizing Directory Service Groups with LEM
286
Viewing a Directory Services Group Members
288
Directory Services Group Grid Columns
288
Deleting DS Groups
289
Configuring Email Templates
289
Step 1: Creating the Email Template
289
Step 2: Adding Message Parameters
291
Step 3: Creating the message
292
Managing email template folders
292
Configuring State Variables
293
Adding new State Variable fields
293
Editing State Variable fields
295
Deleting State Variable fields
295
Managing State Variable Folders
296
Configuring Time of Day Sets
296
Configuring a Time of Day Set
296
Selecting periods in the time grid
298
Configuring User-Defined Groups
298
Examples of User-Defined Groups
299
Configuring a User-Defined Group
299
Adding data elements to a User-Defined Group
300
Editing a data element in a User-Defined Group
302
Deleting a data element from a User-Defined Group
302
Configuring Connector Profiles
304
Connector Profile Rules
305
xiii
LEM User Guide
Creating a Connector Profile (general procedure)
305
Step 1: Selecting a template for the profile
305
Step 2: Selecting the Agents that are members of the profile
307
Editing a Connector Profile’s Connector Settings
308
Opening a Connector Profile’s Settings
309
Adding a New Connector Instance
309
Editing a Connector Profile’s Connector Settings
310
Managing Rules
311
Rule Creation
311
Rule Creation Features
312
Advanced Thresholds
313
Opening the Set Advanced Threshold form
313
Setting an advanced threshold
314
Adding a Threshold Field
314
Editing threshold fields
315
Deleting a threshold field
316
Using the Actions box
316
Using constants and fields to make actions flexible
316
Configuring a Rule’s Actions
317
Adding a New Rule
318
Rule Window Features
319
Correlations Box Features
324
Editing Rules
326
Subscribing to a rule
328
Enabling a rule
329
Placing rules in test mode
331
Activating rules
333
Disabling a rule
334
Cloning rules
335
xiv
Table of Contents
Importing a rule
336
Exporting rules
337
Deleting Rules
338
Connector Configuration Features
339
Connectors Grid Columns
341
Connectors Grid Icons
341
Refining the Connectors Grid
342
Chapter 15: Scalability
344
Setting up an Addition nDepth Appliance
344
Using a separate nDepth appliance
344
Installing a Separate nDepth Appliance
345
Configuring Network Connectors for Use with nDepth
345
Alternate Storage Methods
345
Where to Find the Numbers
346
Disk Usage Summary
346
Log Storage Maintenance Report
347
Alternate Storage Methods
348
Chapter 16: Enabling Transport Layer Security
349
Enabling Standalone LEM Appliance
349
Setting up a Dedicated LEM User for Reports Accessing
350
Configuring Reports Application
350
Enabling TLS on a LEM Manager with a Dedicated Database Appliance
351
Enabling TLS on LEM Database
352
Importing Certificates into the Manager and Database
353
Chapter 17: Troubleshooting
354
Disconnected or Missing LEM Agents
354
xv
LEM User Guide
Connected LEM Agents
355
Troubleshooting Network Devices Logging to LEM
356
Devices Logging to a Log File on the Appliance
358
Contacting Support
358
Appendix A: Standard Widget Tables
359
Appendix B: Events
362
Types of Events
362
Asset Events
364
Audit Events
367
Incident Events
386
Internal Events
387
Security Events
393
Appendix C: Appendix Event Data Fields
441
Appendix D: Connector Categories
444
Appendix E: CMC Commands
469
Logging on to CMC
469
Using the CMC 'appliance' Menu
471
Using the CMC 'manager' Menu
472
Using the CMC 'ndepth' menu
474
Using the CMC 'service' Menu
475
Appendix F: Report Tables
478
Table of Audit reports
478
Table of Security reports
498
xvi
Table of Contents
Table of Support Reports
514
Report schedule definitions
516
Appendix G: Connector Configuration Tables
Connector Categories
517
517
Configuring Sensors
523
Configuring Actors
527
Setting up a Notification System
529
Appendix H: Filter Configuration Tables
Filter Condition Table
532
532
Comparing Values with Operators
534
Selecting a new operator
535
Operator tips
536
Table of operators
536
Examples of AND and OR conditions
538
Configuring event filter notifications
538
Selecting the notification method
539
Notifications table
539
Appendix I: Rule Configuration Tables
xvii
543
Chapter 1: Introduction
SolarWinds Log & Event Manager (LEM) is a state-of-the-art virtual appliance that adds value to
existing security products and increases efficiencies in administering, managing and monitoring
security policies and safeguards on your network.
SolarWinds LEM is based on brand new concepts in security. You can think of it as an immunity
system for computers. It is a system that is distributed throughout your network to several “points of
presence” that work together to protect and defend your network. SolarWinds LEM responds
effectively with focus and speed to a wide variety of threats, attacks, and other vulnerabilities.
SolarWinds LEM collects, stores and normalizes log data from a variety of sources and displays that
data in an easy to use desktop or web console for monitoring, searching, and active response. Data is
also available for scheduled and ad hoc reporting from both the LEM Console and standalone LEM
Reports console.
Some common use cases for SolarWinds LEM include the following:
l
Correlating network traffic from a variety of sources using filters and rules.
l
Visualizing log data in dynamic graphs, charts and other widgets.
l
Monitoring USB mass storage device activity on network Agents.
l
Responding to countless threats, attacks and other vulnerabilities with easy to use
point-and-click and automated active responses.
l
Searching normalized log data for events of interest.
l
Change Management and other security-related reporting for management and
auditors.
How LEM Works
The SolarWinds LEM system is based on software modules called Agents, which collect and
normalize log data in real time before it’s processed by the virtual appliance, and other non-Agent
devices, which send their log data directly to the Manager for both normalization and processing.
Agents are installed on workstations, servers, and other network devices where possible. Agents
communicate the log data from each device’s security products to the LEM virtual appliance. These
1
Chapter 1: Introduction
security products include anti-virus software, network-based intrusion detection systems, and logs
from operating systems.
When an Agent cannot be installed on a device, that device can be set to send its log data to the LEM
Manager for normalization and processing. Examples of devices that cannot host Agent software
include firewalls, routers, and other networking devices.
LEM accepts normalized data and raw data from a variety of devices. LEM agent connectors
normalize the data before sending the data to the LEM manager. Non-agent devices send their log
data in raw form to the LEM manager. The following diagram shows this flow of data and the ports
involved. Once normalized, log data is processed by the LEM Manager, which provides a secure
management clearinghouse for normalized data. The Manager’s policy engine correlates data based
on user defined rules and local alert filters, and initiates the associated actions when applicable.
These actions can include notifying users both locally in the Console and by email, blocking an IP
address, shutting down or rebooting a workstation, and passing the alerts on to the LEM database for
future analysis and reporting within the Reports application.
LEM Architecture
The LEM architecture is uniquely designed for gathering and correlating logs and events in real-time at
network speed and further defend the network using LEM’s Active Response Technology. The figure
below illustrates the typical log sources and LEM software components. It also illustrates the
direction in which communication is initiated and the network protocols used
2
LEM Manager
LEM Manager
The LEM Manager is a result of the Virtual Appliance that is deployed, it consists of the following key
components:
l
Hardened Linux® OS
l
Syslog Server and SNMP Trap Receiver
l
High compression, search optimized database
l
Web server
l
Correlation engine
For Network Device log sources such as routers, firewalls, and switches, LEM relies on these
devices sending Syslog messages to the Syslog server running on the LEM appliance.
3
Chapter 1: Introduction
For Servers and Applications LEM largely relies on a LEM Agent installed on these servers. The LEM
Agent has a negligible footprint on the server itself, and provides a number of benefits to ensure logs
are not tampered with during collection or transmission while being extremely bandwidth friendly.
For Workstations, the LEM Agent used on Windows® workstations is the same as the one used for
Windows servers.
Other SolarWinds solutions like Network Performance Monitor (NPM), Server & Application Monitor
(SAM) and Virtualization Manager (VMan) can send performance alerts as SNMP Traps to LEM. LEM
can correlate these performance alerts with LEM events.
You can install the LEM Reports Console on any number of servers to schedule the execution of over
300 audit-proven reports. From a security standpoint, the command service > restrictreports can be
used to limit the IPs that can run these reports
Protocols and Communication Direction
Below is a summary of the protocols and communication direction.
l
Network devices can send Syslogs to LEM Manager over TCP or UDP. The direction
of this communication is from the network device to the LEM Manager.
l
LEM Agents installed on servers and workstations initiate TCP connections to the LEM
Manager, so the Agents push data to the LEM Manager.
New Items in 6.1
l
An updated Getting Started wizard that guides you through an overview of the
functionality and basic configuration tasks for LEM , such as:
l
Configuring email server
l
Configuring directory services group access
l
Configuring connectors for non-agent data (utilizing existing add node
wizard framework in new format)
l
Enabling key rules quickly
4
New Items in 6.1
l
Guidance for agent installation and configuration
l
Customizing content to match your needs
5
Chapter 2: Upgrading
This chapter provides instructions for upgrading to the latest version of SolarWinds Log & Event
Manager. The LEM upgrade process consists of upgrading the LEM appliance and related
components: console, agents, and reports.
The LEM 6.1 appliance upgrade package upgrades all components of LEM appliances running LEM
version 5.6 or later. If you are running an earlier version of LEM or TriGeo SIM, see Upgrade Paths for
Versions Prior to 5.7
LEM 6.1
This upgrade is recommended for all LEM components. The latest LEM agents are available both as
standalone installers and as part of the LEM appliance upgrade package.
For more information about the details of this release, see Log & Event Manager Version 6.1 Release
Notes.
New Licensing Requirements Started With Version 5.3
If you are upgrading a LEM virtual appliance from a version earlier than 5.3, this upgrade requires
applying a new license file within 30 days. If you do not apply your license within that time frame, your
LEM appliance will stop collecting data.
Obtain a license key from the SolarWinds Customer Portal. Enter this key in the LEM console to
apply the nodes license to your LEM manager.
To apply a LEM license key:
1. Open the LEM console and log into your LEM manager as an administrator.
2. Navigate to Manage > Appliances.
3. Click License on the Properties pane.
4. Select Automatic or Manual in the Type field.
6
Chapter 2: Upgrading
Note: We recommend selecting Automatic here, but the Manual option is available
when the computer being used to complete this procedure is not able to connect to the
Internet.
5. Enter the license key in the Key field.
6. Enter Name, Email, and Phone.
7. Click Activate.
8. Click OK when the license has been successfully activated.
Upgrading from Version 5.6 or Later
The procedures in this section apply to LEM versions 5.6 and later. If you are running an earlier
version, see Upgrade Paths for Versions Prior to 5.7
Determining the LEM Components Version
While it is only necessary to follow a specific upgrade path when upgrading LEM appliances, we
recommend maintaining a consistent version across all LEM components. Complete the following
procedures to determine the current version of each of those components.
To determine the version of your LEM appliance:
1. Open the LEM console and authenticate to the manager.
2. Select the appliance to view its details in the Details pane on the bottom left.
Note: If you cannot connect to your LEM appliance using your LEM console, SolarWinds Support can
assist you in finding this information.
To determine the LEM console version:
1. Open the LEM console.
2. Click the SolarWinds logo in the top left corner.
To determine the LEM Reports version:
1. Open LEM Reports.
2. Click the Settings tab.
7
Best Practices for Appliance Upgrades
3. Click Help and then select About Reports.
To determine the LEM agents version:
1. Open the LEM console and authenticate to the manager.
2. Click Manage > Nodes and note the Version column.
Note: The current version of the LEM agent is 6.1.
Best Practices for Appliance Upgrades
If you have multiple LEM appliances, including hardware and virtual appliances, we recommend you
upgrade them in the following order.
1. Database appliances
2. nDepth appliances
3. Manager appliances
Note:
l
You can upgrade logging servers and network sensors at any time.
l
If you have a High Availability (HA) system, upgrade the primary appliance(s)
first, followed by the secondary appliance(s).
Resizing the LEM Virtual Appliance
Increase and decrease the capacity of your LEM virtual appliance using the following procedures.
Increasing the LEM Virtual Appliance
You can increase the capacity of your LEM virtual appliance by increasing the hard disk in your
vSphere or Hyper-V client. To increase the size of your virtual appliance, consider the following
notes:
l
The virtualization platform disk size limits are 2040 GB for Microsoft Hyper-V and 2TB
for VMware vSphere ESXi.
8
Chapter 2: Upgrading
l
After you increase the size of your virtual disk, you cannot decrease it using the same
methods. Cloning allows you to decrease the size, but not below the original size of the
disk.
l
You cannot increase the size of your virtual appliance if you have snapshots for the
VM.
In VMware, you can edit the VM settings and change the size of the disk if there are no snapshots. On startup, the virtual appliance recognizes the change in disk size and repartitions and adjust the
filesystems appropriately.
If there are snapshots, the disk size field is disabled. To increase the size of your virtual appliance,
you must delete all snapshots of the VM.
You may also increase the existing VM by cloning it into a larger disk.
Cloning the LEM Virtual Appliance
To increase or decrease the capacity of the virtual appliance, create a secondary hard disk for the
virtual appliance in your vSphere or Hyper-V client, and then start the virtual appliance to
automatically clone the existing disk to the secondary hard disk.
Note: The new disk must be large enough to accommodate all of the data on the existing disk, but it
does not have to have the same maximum capacity.
To clone a disk in vSphere:
1. Open vSphere.
2. In the left pane, select the LEM appliance.
3. In the Inventory menu, click Virtual Machine > Power > Shut Down Guest.
4. Add the new disk:
a. In the Inventory menu, click Virtual Machine > Edit Settings.
b. Click Add.
c. In the center pane, select Hard Disk, and then click Next.
d. Select Create a new virtual disk, and then click Next.
9
To clone a disk in Hyper-V:
e. Enter the settings for a new hard disk that is large enough to accommodate all of
the data on the existing disk.
f. Click Browse to select a new datastore.
g. Click Next.
h. In the Virtual Device Node menu, select SCSI (0:2), and then click Next. The
Virtual Device Node value should be higher than the value for Hard Disk 1.
i. Click Finish.
j. Click OK.
5. On the vSphere Client window, click Inventory > Virtual Machine > Power > Power
On. The appliance starts up, clones the primary disk to the new disk, and then shuts
down. This takes between 15 minutes and several hours, depending on the size of the
disk.
6. Replace the old disk with the new one:
a. In the Inventory menu, click Virtual Machine > Edit Settings.
b. In the left pane, select the old hard disk.
c. Click Remove.
d. Select Remove from virtual machine and delete files from disk.
e. Select the new hard disk.
f. In the right pane, select SCSI (0:0) in the Virtual Device Node menu.
g. Click OK.
7. Power on the LEM appliance.
Note: We recommend taking a new appliance snapshot at this time.
To clone a disk in Hyper-V:
1. Open Hyper-V Manager.
2. In the left pane, select the LEM appliance.
10
Chapter 2: Upgrading
3. In the Actions pane (right), click Shut Down.
4. Add the new disk:
a. In the Actions pane, click Settings.
b. In the left pane under Hardware, click IDE Controller 0.
a. In the right pane, select Hard Drive, and then click Add.
b. Under Virtual hard disk (.vhd) file in the Media section, click New.
c. On the New Virtual Hard Disk Wizard window, select Fixed size and then click
Next.
d. Specify a name and location for the new disk, and then click Next.
e. Specify a size for the new blank disk that is large enough to accommodate all of
the data on the existing disk, and then click Next.
f. Click Finish.
g. In the left pane under IDE Controller 0, select the new hard disk.
h. In the right pane, select 1 in the Location menu.
i. Click OK.
5. Back on the Hyper-V Manager window, click Start in the Actions pane. The appliance
starts up, clones the primary disk to the new disk, and then shuts down. This takes
between 15 minutes and several hours, depending on the size of the disk.
6. Replace the old disk with the new one:
a. In the Actions pane, click Settings.
b. In the left pane under IDE Controller 0, select the old hard disk.
c. In the right pane, click Remove.
d. In the left pane under IDE Controller 0, select the new hard disk.
e. In the right pane, select 0 in the Location menu.
f. Click OK.
11
Determining Automatic Update Settings
7. Power on the LEM manager.
Determining Automatic Update Settings
Before upgrading the LEM manager appliance, verify that the Global Automatic Update settings for
your LEM agents have been configured according to your preferences.
To view or modify Global Automatic Update settings:
1. Open the LEM console and authenticate to the manager.
2. Go to Manage > Appliances, and then click the Settings tab in the Properties pane.
3. Select or clear Enable Global Automatic Updates according to your preferences.
4. Click Save.
Upgrading LEM Appliance
Complete the following procedure to upgrade all LEM appliances. During this process, the upgrade
script disconnects the LEM appliance from all LEM agents and consoles. If upgrading from a version
earlier than 5.3, it also reboots the LEM appliance when the upgrade is complete.
Note: If upgrading a hardware (SIM) appliance, the upgrade repartitions the available disk space on
the appliance upon reboot. This adds up to 15 minutes to the upgrade process. Do not turn off or
reboot the appliance until after it starts up completely.
To upgrade LEM appliance:
1. Prepare the upgrade media:
a. Download the Appliance upgrade for all appliance types zip file from the
SolarWinds Customer Portal.
b. Unzip the file.
c. Open the SolarWinds Log & Event Manager v6.1 Upgrade folder.
d. Copy the TriGeo and Upgrade folders to the root of a network share. For
example: C:\share\TriGeo\ and C:\share\Upgrade\.
12
Chapter 2: Upgrading
2. Connect to the LEM appliance using either the virtual console (vSphere or Hyper-V
Manager) or an SSH client such as PuTTY.
Note: Use port 32022 when using a SSH client.
3. Access the CMC prompt:
l
In vSphere: Arrow down to Advanced Configuration, and then press Enter.
l
In PuTTY: Log in using your CMC credentials.
4. At the cmc> prompt, enter upgrade.
5. Follow the onscreen instructions to complete the LEM appliance upgrade.
Troubleshooting Errors During the Appliance Upgrade
If you encounter errors during the appliance upgrade, consider the scenarios below before you
proceed or contact Support.
For additional information about contacting Support for assistance with any of these scenarios, see
the KB article, How to send LEM debugging information to Support.
To troubleshoot a generic "An error occurred during the upgrade" message:
1. Rerun the upgrade script.
2. If the script returns the error again, pull a debug and open a Support ticket.
If you receive a "You must upgrade to 5.6 before upgrading to 6.1" error, see Upgrade Paths for
Versions Prior to 5.7 for the appropriate upgrade procedure.
To troubleshoot a "The current hostname is invalid" message:
This error occurs when the hostname for your LEM appliance contains an underscore (_) character.
To resolve this issue, complete the following procedure.
1. Enter exit to return to the cmc> prompt.
2. At the cmc> prompt, enter appliance.
3. At the cmc::acm prompt, enter hostname.
13
Upgrading LEM Connectors
4. Follow the on screen instructions to change the hostname for your LEM appliance to
something that does not contain the underscore character.
5. Rerun the upgrade script.
6. If the script returns the error again, pull a debug and open a Support ticket.To
troubleshoot a "The database is not running" message, pull a debug and open a Support
ticket.
Upgrading LEM Connectors
All LEM upgrades include a connector update, but we often update the stand-alone Connector Update
package between releases as well. To ensure you have the latest version of all of the LEM
connectors, download the current Connector Update package here:
http://downloads.solarwinds.com/solarwinds/Release/LEM/SolarWinds-LEM-Connectors.zip.
To apply a LEM connector update package:
1. Prepare the update package:
a. Download the Connector Update package using the link above, or from the
Additional Components page for LEM on the SolarWinds Customer Portal. The
download is approximately 3 MB.
b. Unzip the file.
c. Open the SolarWinds-LEM-Connectors folder.
d. Copy the LEM folder to the root of a network share. For example:
C:\share\LEM\.
2. Connect to the LEM appliance using a virtual console or SSH client.
3. Access the CMC prompt:
l
Virtual Console: Arrow down to Advanced Configuration, and then press Enter.
l
SSH Client: Log in using CMC credentials.
4. At the cmc> prompt, enter manager.
5. At the cmc::cmm# prompt, enter sensortoolupgrade.
14
Chapter 2: Upgrading
6. Press Enter to validate the entry.
7. Enter n to indicate that the update is on the network.
8. Press Enter to validate your entry.
9. Enter the server and share the name for the location where the update package was
saved in \\server\share format.
10. Enter y to confirm the entry.
11. Enter the domain and user name for a user that can access the share in domain\user
format.
12. Enter y to confirm the entry.
13. Enter the password for the user.
14. Re-enter the password to confirm the entry.
15. Enter 1 to start the update. The update takes several minutes.
Note: Verify that the configured connectors restart after they are updated by watching
for InternalToolOnline alerts in the default SolarWinds Alerts filter in the LEM console.
16. After the update is finished, enter exit twice to exit the CMC interface.
For additional information, see Applying a LEM connector Update Package
Applying a LEM connector Update Package
Apply the LEM data connector update package any time SolarWinds updates a connector you use,
usually when Support informs you to do so. SolarWinds automatically updates all of your data
connectors any time you perform an appliance upgrade, but you can use stand-alone connector
updates from Support as needed to address "Unmatched Data" alerts in your environment.
To apply a LEM connector update package:
1. Prepare the update package by downloading the Connector Update package from the
Additional Components page on the SolarWinds Customer Portal.
15
Applying a LEM connector Update Package
a. Open the SolarWinds-LEM-Connectors folder.
b. Copy the LEM folder to the root of a network share. For example:
C:\share\LEM\.
2. Connect to your LEM virtual appliance using a virtual console or SSH client.
3. Access the CMC prompt using the appropriate method below:
a. Virtual Console: Arrow down to Advanced Configuration, and then press
Enter.
b. ◦SSH Client: Log in using your CMC credentials.
4. At the cmc> prompt, enter manager.
5. At the cmc::cmm# prompt, enter sensortoolupgrade.
6. Press Enter to validate your entry.
7. Enter n to indicate that your update is on the network.
8. Press Enter to validate your entry.
9. Enter the server and share name for the location into which you saved the update
package in \\server\share format.
10. Enter y to confirm your entry.
11. Enter the domain and user name for a user that can access the share in domain\user
format.
12. Enter y to confirm your entry.
13. Enter the password for the user.
14. Re-enter the password to confirm your entry.
15. Enter 1 to start the update. The update takes several minutes.
Note: Verify your configured connectors restart after they are updated by watching for
InternalToolOnline alerts in the default SolarWinds Alerts filter in the LEM Console.
16. After the update is finished, enter exit twice to exit the CMC interface.
16
Chapter 2: Upgrading
Additional Information
During the update process, the update script restarts all LEM connectors that you have configured. In
most cases, restarted connectors only trigger one "offline" and one "online" alert in your LEM
Console. However, you might also see an InternalWarning alert similar to the one shown below.
Alert Name: InternalWarning
EventInfo: -1:Start location was -1. Init set to 'newest' record, record info: 1 - 193 (101 - 293) @ -1.
InsertionIP: lab-vm-exc10.lab.exc Manager: lem DetectionIP: 10.0.0.1 InsertionTime: 11:51:04
Mon Jan 16 2012 DetectionTime: 11:51:04 Mon Jan 16 2012 Severity: 2 ToolAlias: NT DNS
InferenceRule: ProviderSID: FASTCenter normal error ExtraneousInfo: Component:
FASTCenter:NT DNS Description: -1:Start location was -1. Init set to 'newest' record, record info: 1
- 193 (101 - 293) @ -1. Detail: StackTrace:
This alert indicates that a connector has started at the beginning of the corresponding log file, and
could be related to any on of the following possible scenarios, listed in the order of their likelihood.
l
You have an unnecessary connector configured. For example, you might have the NT
DNS connector configured on a server that is not running the DNS service.
l
You have a misconfigured connector. For example, you might have a connector
pointing to the wrong location for the requisite log file.
l
The device associated with the connector rotated its logs while the connector was
offline.
Updating Agents
If this tool update is used at the Agent level (such as an Event Log tool), the Agents need to be
updated.
1. Start the LEM Console
2. Open the Manage > Nodes.
3. Highlight the Node to be updated in the list and click Remote Updates >Update to
update the tool on those Agents.
17
Upgrading LEM Consoles
Note: You can select more than one agent at a time by using the Shift or Ctrl keys in
conjunction with your mouse-clicks. Alternatively, you can enable “Global Automatic
Updates” from Manage > Appliances >Settings to have the Manager automatically
update the Agents as they connect.
It could take a couple of minutes for the update to complete as it is being broadcast out to your
agents. When the update is complete, the Agents have an Update Status of "Updated" a green
checkmark in the Update Status column.
Upgrading LEM Consoles
After the LEM manager is upgraded, the LEM web console is automatically updated. You may be
automatically reconnected during upgrade but to ensure you are running the latest version you should
refresh the console in your browser, or close and reopen your browser, and reconnect.
To upgrade your LEM desktop console:
After you upgrade your LEM manager, upgrade the LEM desktop console to take advantage of the
new features in this release. If the LEM desktop console is not upgraded, you will experience missing
features and unexpected behavior.
1. Uninstall the existing air console.
2. Download the Log & Event Manager Console v6.1.zip file from the SolarWinds
Customer Portal and extract its contents.
3. Run SolarWindsLEMConsole.air and complete the installation wizard.
Note: Both the LEM desktop console and web consoles preserve all filters and other
local settings from previous versions of the LEM console.
Upgrading LEM Reports
After upgrading the LEM manager, upgrade the LEM Reports to be compatible with the web console.
Note: Previously scheduled reports will not run until you upgrade to the latest version. 18
Chapter 2: Upgrading
To upgrade LEM Reports:
1. Download the Log & Event Manager Reports v6.1.zip file from the SolarWinds
Customer Portal and extract its contents.
2. Run setup.exe and complete the installation wizard.
Upgrading LEM Agents
Upgrade all of your LEM agents to take advantage of several enhancements, including an updated
Java Runtime Environment (JRE), and several infrastructure updates.
If you selected Enable Global Automatic Updates when you completed Determining Automatic
Update Settings, your LEM agents have been automatically upgraded and there is nothing further for
you to do.
If you did not select Enable Global Automatic Updates when you completed Determining Automatic
Update Settings, use the following procedures to upgrade your LEM agents. You can upgrade your
LEM agents either from your LEM console or using the appropriate installer.
To manually upgrade your LEM agents from your LEM console:
1. Open the LEM console and authenticate to the manager.
2. Click Manage, and then select Nodes.
3. Select the LEM agent(s) you want to upgrade. Use Ctrl+click to select multiple agents.
4. Click Remote Updates and then select Update. The LEM manager attempts to
automatically restart the SolarWinds Log and Event Manager Agent service when the
update is complete.
5. If a LEM agent does not reconnect within a reasonable time, restart the service on the
affected computer manually.
To manually upgrade LEM agents using an installer:
Note: Install the new version of your LEM agents in the same folder as your existing LEM agents.
Installing over the existing agent allows the installer to update the LEM agent software while
maintaining all other configuration settings.
19
Upgrade Paths for Versions Prior to 5.7
1. Download the appropriate agent Installer from the Additional Components page of the
SolarWinds Customer Portal and extract the ZIP file's contents.
2. Run setup.* and complete the installation wizard.
Note: For information about running the remote installer for Windows agents, see the Using the LEM
Remote Agent Installer KB article.
Upgrade Paths for Versions Prior to 5.7
The LEM appliance upgrade package upgrades only LEM version 5.7 and later. If you are running an
earlier version of LEM or TriGeo SIM, upgrade your appliance to a compatible version first, using the
following upgrade paths.
Note: If you need upgrade media for prior versions of LEM or TriGeo SIM, open a Support ticket.
The full upgrade paths from earlier versions of LEM (formerly TriGeo) are as follows:
LEM
Version
Upgrade Path
3.5.x
3.5.6 > 4.0 > 4.5.3 > 5.0.2 > 5.2.1 > 5.4 > 5.6 > 6.0.1 >6.1
3.5.6
4.0 > 4.5.3 > 5.0.2 > 5.2.1 > 5.4 > 5.6 >6.0.1 > 6.1
4.0
4.5.3 > 5.0.2 > 5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
4.5.3
5.0.2 > 5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
4.6
5.0.2 > 5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
5.0.x
5.0.2 > 5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
5.0.2
5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
5.1.x
5.2.1 > 5.4 > 5.6 > 6.0.1 > 6.1
5.2.1
5.4 > 5.6 > 6.0.1 > 6.1
5.3
5.4 > 5.6 > 6.0.1 > 6.1
20
Chapter 2: Upgrading
LEM
Version
Upgrade Path
5.4
5.4 > 5.6 > 6.0.1 > 6.1
5.5
5.6 > 6.0.1 > 6.1
5.6
6.0.1 > 6.1
6.0
> 6.0.1
6.0.1
>6.1
21
Chapter 3: Introduction to the Console
The LEM Console is organized into different functional areas, called views. These views organize
and present different information about the components that make up the LEM system.
l
In Ops Center, you'll find a dashboard view that presents visual representations of
your data.
l
In Monitor, you'll filter and view event details.
l
In Explore, you'll find utilities for investigating events and their details.
l
In Build, you'll create critical components of LEM that function on a Manager for
processing process data.
l
In Manage, you'll manage properties associated with Agents and Managers, and
configure data sources to integrate your network security data with LEM.
l
Reports is a separate application. Its reporting tools let you run or schedule reports
about the data that is stored in your LEM database.
The following topics briefly explain the role of each view of the Console, the view’s primary uses, and
where to get information on performing key tasks within that view. Topics are arranged here in an
order that will help you understand the most fundamental items first, such as events, event filters,
and widgets. They then progress to more advanced features, such as exploring events, and creating
Groups and rules.
Opening Views in the Console
The Console is made up of multiple views, where each view has a special function.
To open a view:
l
To open the Ops Center view (to work with widgets), click Ops Center .
l
To open the Monitor view (to view, manage, and create filters), click Monitor.
l
To open the Explore view (to work with explorers), click Explore .
22
Chapter 3: Introduction to the Console
l
To open the Explore view (to search or view event data or log messages), click
Explore and then select nDepth.
l
To open the Explore view (to view additional utilities), click Explore and then select
Utilities.
l
To open the Groups view (to build and manage Groups), click Build and then select
Groups.
l
To open the Rules view (to build and manage policy rules), click Build and then select
Rules.
l
To open the Users view (to add and manage Console users), click Build and then
select Users.
l
To open the Appliances view (to add and manage appliances), click Manage and then
select Appliances.
l
To open the Nodes view (to add and manage Agents), click Manage and then select
Nodes.
Working with Grids
Grids are used throughout the Console. The following topics explain how to perform common tasks
with grids, such as selecting rows and grid cells, resizing grid columns, rearranging grid columns, and
sorting a grid by its columns.
Rearranging Grid Columns
When needed, you can rearrange the order in which grid columns appears. The columns will stay in
their rearranged order until you exit the Console. Upon reopening the Console, the columns revert to
their default order.
To rearrange grid columns:
Click the header of the column you want to move; then drag it to the right or left and drop it into the
desired position.
23
Sorting a Grid by its Columns
Sorting a Grid by its Columns
You can sort the data in a grid by clicking its column headers. You can sort each column in ascending
(alphabetical) order, or in descending (reverse alphabetical) order. In many cases, you can sort a grid
by more than one column by using the Ctrl+click method.
Note: Before sorting the Monitor view’s event grid, you must first click the grid’s Pause button to
stop the incoming event traffic. When you are done, click Resume to continue receiving event traffic.
To sort a grid:
l
Click one of the grid’s column headers to sort the grid by that column. If the column
header shows an upward ▲ arrow, it means the column data is sorted in ascending
order (alphabetically, or from lowest to highest: A to Z, 1 to 0).
If the column header shows a downward ▼ arrow, it means the column data is sorted in
descending order (reverse alphabetical, or from highest to lowest: Z to A, 0 to 1).
l
Click the column header again to sort the grid by the same column, but in reverse order.
To sort a grid by multiple columns:
l
Press and hold the Ctrl key; then click another column header. You can tell how the
table is sorted by the small ▲ and ▼ arrows in the column headers, and by the little
numbers (1 and 2) that appear next to them. An “up” ▲ arrow means the column is
sorted in ascending order. A “down” ▼ arrow means it is sorted in descending order.
Then numbers state the column sort order. 1 is the first sort, 2 is the second sort, and
24
Chapter 3: Introduction to the Console
so on.
l
If a secondary column’s sort order is in the wrong direction, press the Ctrl key and click
the column header again. This will reverse the column’s sort order.
By pressing Ctrl and then clicking the Name column, you can also sort the tool names
in ascending or descending order. In the example shown here, the Name column was
sorted in ascending order, so the specific tools would appear in alphabetical order
within each tool category.
Logging In and Out of Managers
When first connecting to the web console, you are prompted to authenticate to the host manager. If
you have additional managers associated with that console, log in to configure them or view their
events. Logging out will disconnect you from additional managers in the web console. To disconnect
from the host manager, close the browser window.
Note: Only existing Administrator, Auditor, and Monitor Users can log on to the system.
Contacts cannot log on to LEM.
Logging Into a Manager
1. At the top of the LEM Console, click Manage and then click Appliances.
2. In the Appliances grid, click to select the appliance you want to work with.
3. Click the gear
button and then select Login. Depending on the Manager’s Login
tab settings (in the Properties pane), the LEM Console may automatically log you on to
the appliance. Otherwise, the Login form appears.
4. In the Username box, type user name for this Manager.
5. In the Password box, type password for this Manager.
6. Click OK or press Enter to log on. A
25
icon appears in the Manager’s Status
Logging Out of a Manager
column, indicating that you are logged on to that Manager.
Logging Out of a Manager
1. At the top of the Console, click Manage and then click Appliances.
2. In the Appliances grid, click the gear
button for the Manager you want to log out
of, and then select Logout. After a moment, a
icon appears in the Manager’s
Status column, indicating that you are no longer logged on to that Manager.
Logging Out of the LEM Console
Clicking the Logout button closes the Console window and disconnects the Console from any
connected Managers. Logging out of the Console causes it to disappear to the Managers, but the
Managers continue to gather information from their Agents. However, when you reopen the Console,
it will not display the Manager and Agent event traffic that occurred when it was closed. Instead, the
event grid will be blank.
It is recommended that you keep the Console running either on your workstation or a secondary
workstation to best monitor events on a daily basis.
26
Chapter 4: Getting Started
1. To start the LEM web console, launch a web browser and enter the Web Console URL
provided during the configuration of VMware vSphere or Microsoft Hyper-V.
2. Click Connect.
3. Accept the license agreement and then click OK. Click Cancel if you do not wish to
accept the license agreement.
4. Enter your email. This is required for all evaluation users.
5. Select the check box to assist the SolarWinds Improvement program in collecting
anonymous data about your product usage.
6. Click Save.
When you start the Console for the first time, the Manage >Appliances view appears, so you can
configure and log in to a Manager. Otherwise, the Console restores the view that was open the last
time you closed the Console.
The Getting Started Wizard is a quick and easy guide to getting your initial system setup and
configured so you can start working with LEM. We recommend working through the wizard to set up
some of the basics settings.
27
Chapter 4: Getting Started
The Getting Started Wizard widget is located on the Ops Center tab.
Configuring Email Alerting
This wizard walks you through a short process to set up to receive email alerts when there is a
problem with a device that is being monitored.
1. From the Getting Started widget, click Configure Basic LEM Settings.
2. Click Next on the Welcome to LEM window.
3. Enter the Mail Host.
4. Enter the Port number.
5. Select the Transport Protocol.
6. Enter the Return Address.
7. Enter the Return Address Display Name.
8. Enter the Authentication Server Username.
28
Configuring an Active Directory Connection
9. Enter the Authentication Server Password.
10. If desired, click Test Email.
11. Click Next.
Configuring an Active Directory Connection
Configure the Directory Service connector on your LEM Manager to enable the LEM Manager to
establish an LDAP connection to your Active Directory server to import your organizational groups.
1. Enter a Domain Name.
2. Enter the Directory Service Server.
3. Enter a User Name.
4. Enter a Password.
5. Select the Encryption method.
6. Enter a Custom Port.
7. Click the Test Domain Connection.
Adding a Node
The Add Nodes to Monitor wizard walks you through adding a Node to monitor a network device.
The wizard locates the new node and then recommends an appropriate connector. For information on
adding other types of Nodes, see Adding Nodes Manually
Adding a Syslog Node:
1. From the Getting Started widget, click Add Nodes to Monitor.
2. Select Syslog node.
3. Enter the IP Address of the node.
4. Select the Node Vendor from the list.
5. Configure the node so LEM can receive syslog messages. If you need help, click the
links provided for enabling specific vendor devices.
29
Chapter 4: Getting Started
6. Select the I have configured this node so that LEM can receive its Syslog
messages check box.
7. Click Next and LEM then scans for new devices.
Rules
The Rules wizard combines all steps necessary for enabling bulk basic rules in one area:
l
Setup email action configuration
l
Setup email alert recipients
l
Select categories of rules enabled. General best practice steers users towards
important rules to enable
There are three methods to access the Rules wizard.
l
Click Define Rules and Configure Alerts from the Getting Started widget.
l
Click the Try it Now link in the What's New in LEM widget.
l
Select Build > Rules and click Add Rules in the Rules area.
30
Adding Rules with the Rules Wizard
Adding Rules with the Rules Wizard
1. Click Define Rules and Configure Alerts.
2. Select the rules categories you wish to use from the Rules Category screen.
3. Click Next.
4. Select the rules within the chosen categories and click Next.
31
Chapter 4: Getting Started
5. Configure your Email Server Settings if you have not already done so previously. For
more information, see Configuring Email Alerting
6. Select the email recipients.
7. Click Next.
8. Review the rules summary page for all rule categories, and then click Finish.
For more information on adding rules, see Rule Categories and Tags
Click the Advanced LEM Tools link to learn more about Advanced LEM Tools, such as filters, reports,
nDepth searches, and custom rules.
32
Chapter 5: Useful Tasks
Tour Log & Event Manager
Click the
video icon to view the corresponding tutorial.
Access your log and event data using the LEM web console or local desktop console. Both interfaces
allow you to monitor your data in real time with filters, respond automatically to specific events with
rules, and analyze events on your network with the nDepth search utility. Access all of these features
and more on the navigation bar at the top of the LEM Console window.
Ops Center
Use the Ops Center tab as a real-time graphical overview of the events on your network. The Ops
Center includes the following useful components:
l
A customizable dashboard with several default charts and graphs, called widgets
l
The Widget Manager to browse, edit, add, and pin widgets
l
Informational widgets with links to videos, documents, and other resources
To add a widget to the Ops Center dashboard:
1. In the LEM Console, click the Ops Center tab.
2. Click Widget Manager in the upper-right corner.
3. Find and select a filter from the Categories list.
4. In the Widgets pane, scroll through the available widgets to put the widget you want in
the main preview position.
5. Click Add to Dashboard in the upper-right corner.
6. To re-position the widgets on the dashboard, drag and drop them into a new position.
33
Chapter 5: Useful Tasks
To create a new widget using Widget Manager:
1. In the LEM Console, select the Ops Center tab.
2. Click Widget Manager in the upper-left corner.
3. Click the plus
button at the top of the Categories list.
4. Complete the Widget Builder form.
5. To pin the new widget to the dashboard, select Save to Dashboard.
6. Click Save.
Monitor
Use the Monitor tab to view all of the monitored events on your network in real time. Monitor includes
the following useful components:
l
A real-time event stream to which you can apply event filters
l
The Event Details pane, which displays the details for any event you highlight in the
event stream
l
A Widgets pane, which displays a graphical representation of the current filter, if
available
l
Several default filters to refine the data you see in the event stream
l
A GUI filter editor, called Filter Creation, to create and edit event filters
To apply a filter to the Monitor event stream, select a default or custom filter from the Filters list.
To view the Event Details for a specific event in the event stream, select the event in the event
stream.
To change the widget the Widgets pane displays for a filter:
1. In the LEM Console, select the Monitor tab.
2. Select the filter you want to modify in the Filters pane.
3. Click the menu at the top of the Widgets pane, and then select the widget you want that
filter to display.
34
Explore
Explore
Use the Explore tab menu to access several analysis utilities to get additional information about the
events you see in the LEM Console. Use the nDepth option in the Explore menu to search and
analyze the events on your network. nDepth includes the following useful components:
l
A variety of clickable charts and utilities to view and refine search results
l
A comprehensive toolbar to switch between multiple utilities and views
l
A Result Details utility to view all of your search results in text format
l
A PDF export utility to configure and export custom reports
Use the Utilities option in the Explore menu to access several IT analysis utilities, including:
l
WhoIs
l
NSLookup
l
Traceroute
l
Flow (sFlow and NetFlow)
To execute a WhoIs, NSLookup, or Traceroute task from an event or search result in the
LEM Console:
1. Find the event or search result you want to explore further, and then select it.
2. Click the Explore menu on the Event Grid or nDepth title bar (next to Respond), and
then select the utility you want to use.
To execute a blank WhoIs, NSLookup, or Traceroute task in the LEM Console:
1. Click the Explore tab on the navigation bar, and then select Utilities.
2. Click the Explore button on the Utilities title bar , and select the utility you want to use.
3. Complete the form for the utility, and then click Search.
For information about using the Flow task in the Explore > Utilities view, see the KB article, "Use
your LEM appliance as a Flow collector."
35
Chapter 5: Useful Tasks
Build
Use the Build tab menu options to customize LEM behavior. The Build menu consists of the following
options:
l
Groups: Create and manage lists of users, computers, and information.
l
Rules: Create and manage rules that correlate events from different systems and
instruct the LEM appliance to respond accordingly.
l
Users: Create and manage LEM Console users.
For additional information about the Users and Groups options in the Build menu, see the following
KB articles:
l
"Getting Started with User-Defined Groups"
l
"Creating Users in the LEM Console"
Rules – Additional Details
View custom and pre-configured rules in the Rules view under the Build menu. The Rules view
consists of the following useful components:
l
A GUI editor, just like Filter Creation
l
A community rule set, organized by event-centric categories
l
35 active responses to assign to custom or pre-configured rules
Manage
Use the Manage tab menu to access details about your LEM architecture. The Manage menu
consists of the following options:
l
Appliances: Add LEM appliances to monitor in the LEM Console, view your LEM
license details, and configure global settings.
l
Nodes: View and manage LEM nodes, including remote logging devices and LEM
Agents.
36
Additional Information
To set your LEM Console authentication preferences:
1. In the LEM Console, click the Manage tab, and then select Appliances.
2. Click the Login tab on the Properties pane.
3. If you want your LEM Console to authenticate to your LEM appliance upon launch,
enter your LEM Username and Password.
4. If you want your LEM Console to ask you for your LEM Password upon launch, enter
just your LEM Username.
5. Select Login Automatically Next Time.
6. Select Save Credentials.
7. Click Save.
To set the global password policy for LEM users:
1. In the LEM Console, click the Manage tab, and then select Appliances.
2. Click the Settings tab on the Properties pane.
3. Adjust the Minimum Password Length according to your preference.
4. If you want to require complex passwords for LEM users, select Must Meet
Complexity Requirements.
Note: Complex passwords must include any three of the following four character types:
l
Capital letters
l
Lower-case letters
l
Numerals (0-9)
l
Symbols (!, @, #, etc.)
5. Click Save.
Additional Information
For additional information about how to use the LEM Console, consult the following resources:
37
Chapter 5: Useful Tasks
l
Introduction to the Console
l
Ops Center
l
Monitor
l
Explore
l
Build
l
Manage
Adding Devices
Click the
video icon to view the corresponding tutorial.
Configure your IT devices to work with LEM using one of two options:
l
Install the LEM Agent and connectors directly on the device
l
Set the device to log to LEM and then configure the appropriate connectors directly on
the LEM appliance.
Install the LEM Agent on computers that allow third party software. SolarWinds provides LEM Agents
for these operating systems:
l
Microsoft Windows (local and remote installers)
l
Linux
l
Mac OS X
l
Solaris on Intel
l
Solaris on Sparc
l
HPUX on PA
l
HPUX on Itanium
l
AIX
Configure other devices, such as firewalls, routers, or switches to send logs directly to the LEM
appliance using syslog or SNMP traps.
38
Agent Installation
Agent Installation
The LEM Agent is a necessary component to monitor local events on the computers on your network.
Install the LEM Agent on servers, domain controllers, and workstations. The LEM Agent then
captures log information from sources such as Windows Event Logs, a variety of database logs, and
local antivirus logs. The LEM Agent also allows LEM to take specific actions that you use rules to
define. You can also trigger actions manually from the LEM Console using the Respond menu.
Installing a LEM Agent:
1. Click the DOWNLOAD: Agents link in the LEM Console Getting Started widget, or
visit the SolarWinds Customer Portal for a complete list of available downloads.
2. Download the appropriate installer, and then run it on the computer(s) you want to
monitor
Note: If you are deploying LEM Agents to Windows computers, you can use the Remote Agent
Installer for a faster deployment.
View and manage installed LEM Agents in the Nodes view of the LEM Console. The LEM Agent for
Windows includes several pre-configured connectors so you immediately start to see data from these
computers after you have installed the LEM Agent. By default, the LEM Agent for Windows includes
the following pre-configured connectors:
l
Windows Security Log (for the host OS version)
l
Windows Active Response
l
Windows Application Log
l
Windows System Log
For other operating systems, or for broader coverage on your Windows computers, configure specific
connectors to get exactly what you are looking for.
Configuring Non-Agent Devices
Non-Agent devices include any supported network or security device on which you cannot install a
LEM Agent. Some common examples are firewalls, routers, and switches. To monitor these devices
with LEM, configure each device to log to the LEM appliance using syslog or SNMP traps. Then,
configure the appropriate connector on the LEM appliance using the LEM Console.
39
Chapter 5: Useful Tasks
Configuring Connectors for Agent and Non-Agent Devices
The procedure for configuring connectors for Agent and non-Agent devices is generally the same. The
major difference is where you find the configuration forms in the LEM Console. Complete the
following procedure to configure connectors for all the devices you want to monitor with LEM.
To configure connectors in the LEM Console:
1. In the LEM Console, click the Manage tab, and the select Nodes (for Agent
connectors) or Appliances (for non-Agent connectors).
2. Click the gear
button next to the LEM Node or Manager you want to configure,
and then select Connectors.
3. If you want to view or modify the configured connectors, select Configured in the
Refine Results pane.
4. To find the connectors you need, use the search box and filter menus on the Refine
Results pane.
5. After you've identified the connector to be configured, click the gear
button next
to it, and then select New.
6. Complete the Connector Configuration form according to the device you're configuring.
The following fields/descriptions are common for most connectors:
l
Alias: a "user friendly" label for your connectors
l
Log File: the location of the log file the connector will normalize; this is a location
on either the local computer (Agents) or LEM appliance (non-Agent devices)
l
Output, nDepth Host, and nDepth Port: values used specifically for LEM
environments that are configured to store original log messages; for additional
ixxnformation, consult the resources at the end of this section
7. After completing the form, click Save.
8. In the Connectors list, click the gear
button next to the new connector (denoted
by an icon in the Status column), and then select Start.
40
Troubleshooting
9. After starting the connector, verify that it is working by checking for events on the
Monitor tab.
To configure FIM connectors in the LEM Console:
1. In the LEM Console, click the Manage tab, and the select Nodes.
2. Click the gear
icon next to the LEM Node you want to configure, and then select
Connectors.
3. To find the connectors you need, enter FIM in the Refine Results search box.
4. Click the gear
icon next to the connector to be configured, and then select New.
5. In the Monitor Templates area, click the gear
icon next to the desired Monitor
Template and select Add to selected monitors. The Monitor template moves to the
Selected Monitors area.
6. After completing the form, click Save.
7. In the Connectors list, click the gear
icon next to the new connector (denoted by
an icon in the Status column), and then select Start.
8. After starting the connector, verify that it is working by checking for events on the
Monitor tab.
For more information on FIM connectors, see .
Troubleshooting
If you have configured a device to log to the LEM appliance, but you cannot determine the exact
logging location, check the logging facilities on the LEM appliance to determine where your data is
going.
To check the logging facilities on the LEM appliance:
1. Connect to your LEM appliance using the VMware console view, or an SSH client such
as PuTTY.
41
Chapter 5: Useful Tasks
2. If you are connecting to your appliance through SSH, log in as the CMC user, and
provide the appropriate password.
3. If you are connecting to your appliance using VMware, select Advanced
Configuration on the main console screen, and then press Enter to get to the
command prompt.
4. At the cmc> prompt, enter appliance.
5. At the cmc::acm# prompt, enter checklogs.
6. Enter an item number to select a local facility to view.
7. Look for indications of specific devices logging to this facility, such as the product
name, device name, or IP address.
8. After you have determined the facility your device is logging to, configure the connector
with the corresponding Log File value.
For additional troubleshooting tips related to LEM Agents or remote logging devices, see the following
KB articles:
l
"Troubleshooting LEM Agent Connections"
l
"Troubleshooting 'Unmatched Data' or 'Internal New Tool Data' events in your LEM
Console"
Additional Information
For additional information about configuring devices to monitor with LEM, see Leveraging
For additional information about installing LEM Agents on a variety of operating systems, see the
following KB articles:
l
"Using the SolarWinds LEM Agent Installer for Windows"
l
"Using the SolarWinds LEM Remote Agent Installer"
l
"Using the SolarWinds LEM Agent Installer non-interactively"
l
"Using the SolarWinds LEM Agent Installer for Linux"
l
"Using the SolarWinds LEM Agent Installer for Mac OS X"
42
Verifying Data
For additional information about how to tune Windows logging for your LEM deployment, see the
following KB articles:
l
"Audit Policy and Best Practice"
l
"LEM Manager crashes after receiving a high number of events from Windows 7 or
Windows Server 2008"
l
"How to enable file auditing in Windows"
l
"Monitoring Account Lockout Events"
For additional information about how to monitor and configure groups of LEM Agents using Connector
Profiles, see the KB article, "How to create Connector Profiles to manage and monitor LEM Agents."
For a list of supported Agent and non-Agent devices, see "Comprehensive Data Source Support for
All Your Logs & Events."
For additional information about configuring connectors for specific devices, search the "Connectors"
category of the LEM Knowledge Base.
For additional information about configuring LEM and your connectors to store original log messages,
see the following KB articles:
l
"Configuring Your LEM Appliance for Log Message Storage and nDepth Search"
l
"Do not modify the Output, nDepth Host, or nDepth Port fields when configuring LEM
connectors unless your appliance is set up to store original log data"
For additional information about creating filters for specific devices, see the KB article, "How can I
see all traffic from a specific device in my LEM Console?".
Verifying Data
Click the
video icon to view the corresponding tutorial.
Now that LEM is collecting your log data, use nDepth and LEM Reports to search, analyze, and
report on that data. In most cases, use the nDepth Explorer in the LEM Console to search and
analyze your data. Use the stand-alone LEM Reports application to report on your data.
43
Chapter 5: Useful Tasks
Which Do I Pick?
Use nDepth if you want to perform immediate search or analysis tasks, or create specific custom
PDF reports. Use nDepth to:
l
Search your log data interactively
l
Search for specific variables, such as user names, IP addresses, or specific events
l
Perform root-cause analysis
l
Troubleshoot specific issues
l
Explore data and produce custom PDF reports
Use LEM Reports if you want to view or schedule fixed reports for regulatory and compliance
purposes or to:
l
Automate reporting
l
Produce compliance reports
l
View reports based on specific regulatory compliance initiatives
l
Provide proof that you are auditing log and event data to auditors
l
Schedule formatted reports for LEM Reports to run and export automatically
nDepth: A Fully Integrated IT Search Solution
Open nDepth in the LEM Console in any of these three ways:
1. Select an event on the Monitor tab, click the Explore menu, and then select nDepth.
2. Select a filter in the Filters pane on the Monitor tab, click the gear
icon at the top
of the Filters pane, and then select Send to nDepth.
3. Click the Explore tab from anywhere in the LEM Console, and then select nDepth.
Consult nDepth for several analytical connectors that it summarizes on both its dashboard and
toolbar. Use this view to:
44
LEM Reports: For Compliance and Historical Reporting Needs
l
Search original log messages (AKA "raw logs") or normalized events
l
View search results in several charts and graphs, and add values from these visuals
directly to your search just by clicking them
l
Refine the time frame of your searches using pre-defined or custom ranges
l
View the text output of your search results using the Result Details connector on the
nDepth toolbar
l
Export your search results in CSV or fully-customizable PDF format
l
Save searches for future use
LEM Reports: For Compliance and Historical Reporting Needs
LEM Reports is a stand-alone application that you install separately from the LEM Console. Access
LEM Reports using a shortcut, if available, or by navigating to the SolarWinds Log and Event
Manager application group in your Windows Start menu.
Use LEM Reports to:
l
Run hundreds of pre-configured compliance and security reports
l
Schedule reports for LEM Reports to run automatically
l
Filter the reports list by industry or requirement
l
Run Master, Detail, or Top level reports according to how much information you need
l
Use Select Expert to filter your report data by specific values, such as computer name,
IP address, or user name
l
Export reports into several formats, including PDF, CSV, and RPT
To get started with LEM Reports, filter the reports listing by the industries or requirements relevant to
your network. Then, the next time you open LEM Reports, access your custom list of reports by
clicking Industry Reports on the main view.
To filter the reports list by industry or requirement:
1. Open LEM Reports.
2. On the Settings tab, click Manage, and then select Manage Categories.
45
Chapter 5: Useful Tasks
3. Select your industries and requirements in the left pane. Mix and match as necessary.
For example, if you are a school that accepts credit card payments, select Education,
FERPA, and PCI.
4. Click OK.
5. To view the filtered list of reports, click the Category menu back on the Settings tab,
and then select Industry Reports.
Select which reports to run based on their values in the Level column on the Settings tab:
l
Master: Reports at this level contain all of the data for their category. For example, the
master-level Authentication report contains all authentication-related data.
l
Detail: Reports at this level contain information related to a specific type of event. For
example, the Authentication – Failed Authentications detail-level report only contains
data related to "Failed Authentication" events.
l
Top: Reports at this level display the top number of occurrences for a specific type of
event. Use the default top number, or Top N, of 10, or customize this when you run the
report.
Troubleshooting
If you have installed LEM Reports, but are unable to open the application or run reports, complete the
following procedures to troubleshoot the issue.
To troubleshoot application launch errors on computers running Windows Vista,
Windows 7, and Windows Server 2008:
1. Uninstall LEM Reports and Crystal Reports v11 Runtime.
2. Reinstall both components as Administrator.
3. Adjust the LEM Reports properties to run the program in Windows XP compatibility
mode and as an administrator:
a. Right-click the LEM Reports shortcut on your desktop or in the SolarWinds
Log and Event Manager program group in your Windows Start menu, and then
select Properties.
46
Additional Information – nDepth
b. Click the Compatibility tab.
c. Select Run this program in compatibility mode for, and then select
Windows XP (Service Pack 3).
d. Select Run this program as an administrator.
e. Click OK.
4. Launch LEM Reports.
To address "Logon failed. Database Vendor Code 210" errors:
Add the computer running LEM Reports to the list of authorized reporting computers. By default, the
LEM appliance restricts all access to LEM Reports. To allow specific computers to run LEM Reports
or remove all reporting restrictions, complete the procedures in the KB article, "Configuring Report
Restrictions."
Additional Information – nDepth
For additional information about how to use nDepth to search and analyze your data in the LEM
Console, consult the following resources.
l
Explore
l
Utilizing the Console
External Resources
For examples of how to execute nDepth searches, see the following KB articles:
l
l
"How to create an nDepth query for all activity by a single user"
"Sending Filters to nDepth for Historical Search"
For additional information about how to save nDepth searches for future use, see the KB article,
"Save nDepth searches to quickly execute frequent queries."
For additional information about how to export nDepth search results in CSV or PDF format, see the
KB article, "Export nDepth results in custom or text formats for retention and ad hoc reporting."
47
Chapter 5: Useful Tasks
For additional information about configuring your LEM appliance to store and search original log data,
see the following KB articles:
l
"Configuring Your LEM Appliance for Log Message Storage and nDepth Search"
l
"Using your LEM Console to view and search original log messages"
l
"Do not modify the Output, nDepth Host, or nDepth Port fields when configuring LEM
connectors unless your appliance is set up to store original log data"
Additional Information – LEM Reports
For additional information about how to run, schedule, and configure formatted compliance and
security reports using LEM Reports, consult the following resources.
l
Reports
l
Report Tables
For information about installing LEM Reports on computers without the LEM Console, see the KB
article, "Configuring LEM Reports on Computers Without the LEM Console."
For information about how to schedule several best practice compliance and security reports, see the
following KB articles:
l
l
l
"Configuring Default Batch Reports on XP/2003 Computers"
"Configuring Default Batch Reports on Vista/7/2008 Computers"
"Report Formats and their corresponding numbers listed in a LEM scheduled report ini
file"
For additional information about working with individual reports in LEM Reports, see the following KB
article
l
"Filtering and Exporting LEM Reports"
l
"Creating a Custom Filtered Report"
Adding Filters
Click the
video icon to view the corresponding tutorial.
48
Which Do I Pick?
Filters group and display events that your LEM Agents and remote logging devices send to LEM.
They are based on events, which are the normalized version of these network events. For LEM, the
terms "events" and "alerts" are interchangeable. View these events in real time on the Monitor tab in
the LEM Console.
Which Do I Pick?
Create filters when you want to group a particular type of event. The following are just a few examples
of what you might create a filter to catch:
l
All events from your firewalls
l
All events from your domain controllers
l
All events for a specific type of user
l
All events except for recurring, expected events
Create rules when you want LEM to take some kind of action in response to one or more events. In
many cases, you base rules on several events that LEM correlates to trigger an action, but you can
also configure a rule to look for a single event. Rule actions include, but are not limited to:
l
Sending an email
l
Logging a user off
l
Shutting down a computer
l
Deleting an Active Directory group
l
Blocking an IP address
Use the Default Filters as Examples
The LEM Console includes several pre-configured filters on the Monitor tab. Examine the conditions
of these filters to get a sense of how broad or specific filters can be. The following are two examples
of these extremes:
l
All Events: This filter does not have any specific conditions, so it captures all events,
regardless of the source or event type.
49
Chapter 5: Useful Tasks
l
User Logons: This filter has a single condition that means, "UserLogon Exists." It
captures all events with the event type "UserLogon" and nothing else – not user log
offs, not user logon failures.
To view the conditions of a default filter:
1. In the LEM Console, click the Monitor tab.
2. Select the filter you want to examine in the Filters pane.
3. Click the gear
button at the top of the Filters pane, and then select Edit.
4. If you make any changes to the filter, click Save. Otherwise, click Cancel.
Other Filter Scenarios
Some scenarios may warrant a filter so you can monitor them more closely:
l
Change management events: Monitor configuration changes made to your network.
l
High volume events: Watch for spikes of traffic, or unexpected off-peak traffic.
l
Events of general interest: Keep track of logon failures and failed authentications.
Note: A failed authentication is an event triggered by three logon failures by the same account within
an extremely short period of time.
l
Rule scenarios: Determine whether you have the right events to create a rule for a
specific scenario.
l
Daily problems: Get a head start on operational problems like account lockouts by
seeing the events in real time.
Example: Change Management
Create a change management filter to monitor configuration changes users make to your network.
Keep this filter general, as illustrated here, or refine it to show you only certain changes or changes
made by certain users.
50
Troubleshooting
To create a filter for all change management events:
1. In the LEM Console, click the Monitor tab.
2. Click the plus
button at the top of the Filters pane, and then select New Filter.
3. Enter an appropriate name for the filter, such as Change Management Events.
4. Fill the filter's Conditions box with an appropriate event or event group. For this
example, use an Event Group Exists condition to capture all events from a certain
group:
a. Click Event Groups on the left pane.
b. Find the Change Management Events event group, and drag it into the
Conditions box.
5. Click Save.The LEM Console takes you to the new filter on the Monitor tab. Examine the events
here, and click an event to see more information in the Event Details pane.
Troubleshooting
If you have created a filter, but it is not capturing the expected events, check the All Events filter to
ensure the events are making it to the LEM Console.
To use the All Events filter to troubleshoot custom filters:
1. In the LEM Console, click the Monitor tab.
2. Click All Events in the Filters pane.
3. Locate an event you expected to see in your custom filter. If necessary, pause the filter
and sort it by any of the column headers.
4. If you locate a related event, verify the field-value combinations in the event match the
ones you used in your filter. For example, if your filter is looking for *firewall* in the
ConnectorAlias field, ensure the Connector Alias field in your event contains the word
firewall.
51
Chapter 5: Useful Tasks
5. If you cannot locate a related event, verify one of your monitored devices is logging the
event, and that the device is sending its events to LEM. For example, create another
filter to show all events from the specific device using the ConnectorAlias or
DetectionIP event field, as illustrated in the KB article, "How can I see all traffic from a
specific device in my LEM Console?".
Additional Information
For additional information about how to create filters in the LEM Console to monitor events of interest,
consult the following resources.
l
Monitor
l
Filter Configuration Tables
l
Appendix Event Data Fields
For a general procedure and video addressing how to create filters in the LEM Console, see the KB
article, "Creating Filters for Real-time Monitoring in Your LEM Console."
For additional information about how to create filters for specific events, devices, or time frames, see
the following KB articles:
l
l
"Quickly Creating a Filter for a Specific Event Type"
"Use Time of Day Sets to pinpoint specific time frames in filters and rules"
For additional information about advanced options related to filters and the Monitor view, see the
following KB articles:
l
"Disabling Windows Noise Events Using Event Distribution Policy "
l
"Disabling Windows Filtering Platform Events Using Event Distribution Policy"
l
"Modifying Filters for 'Monitor' Users"
l
"Modifying AND and OR Relationships in Filters and Rules Using Nested Groups"
l
"Filters with an AND relationship between conditions with different event types do not
return any results"
52
Adding Rules
Adding Rules
Click the
video icon to view the corresponding tutorial.
Rules correlate events that your LEM Agents and remote logging devices send to LEM, and assign
automatic actions or responses to those events. These actions differentiate filters from rules: filters
only display events, while rules instruct LEM to take action. Rule actions include, but are not limited
to:
l
Sending an email
l
Logging a user off
l
Shutting down a computer
l
Deleting an Active Directory group
l
Blocking an IP address
Use Pre-configured Rules to Get Started
The LEM appliance includes hundreds of pre-configured rules. Use these rules to instruct LEM to
respond to specific events on your network.
To clone and enable a rule for use on your network:
1. In the LEM Console, click the Build tab, and then select Rules.
2. Use the Folders list or the Refine Results pane to browse, search, or filter for specific
rules or scenarios.
3. After you find a rule you want to clone, click the gear
button next to it, and then
select Clone.
4. On the Clone Rule dialog, select a Custom Rules folder and rename the rule if you
wish, and then click OK.
5. In the Rule Creation view, customize the rule further if necessary, select Enable at the
top of the form, and then click Save.
6. Back in the main Rules view, click Activate Rules to sync your local changes with the
LEM appliance.
53
Chapter 5: Useful Tasks
Example: Change Management
Create a change management rule to notify you anytime a user makes any kind of change to your
network configurations. Examples of such network changes include:
l
Adding, changing, or deleting users in Active Directory
l
Installing software on monitored computers
l
Changing firewall policy
Create a general change management rule, similar to the filter illustrated in the previous section, to
instruct LEM to notify you anytime any user makes a configuration change, or create a more specific
rule to only fire for specific users, groups, or types of changes.
Note: An important rule of thumb is, "If you can see it in your LEM Console, you can build a rule for
it." Remember to use your filters as a starting-place as you consider creating custom rules.
To create a rule that sends you an email anytime someone adds a user to an administrative
group:
1. In the LEM Console, click the Build tab, and then select Rules.
2. Click the plus
button in the upper-right corner.
3. Enter an appropriate name for the rule, such as New Admin User.
4. Populate the rule's Correlations box with an appropriate event or event group. For this
example, use a NewGroupMember.EventInfo Equals *admin* condition to fire
anytime LEM gets a NewGroupMember event with the text, "admin" anywhere in the
EventInfo field:
a. Click Eventson the left pane.
b. At the top of the Events list, enter NewGroupMemberto search for that event,
and then select it in the list.
c. In the Fields: NewGroupMemeber list, find EventInfo, and then drag it into
the Correlations box.
54
Other Rule Scenarios
d. In the text field (denoted by a pencil icon in the Correlations box), enter *admin*
to account for all variations on the word "administrator."
5. Leave the Correlation Time box as-is so your rule fires anytime LEM captures this type
of event.
6. Add the Send Email Message action to the Actions box:
a. Click Actions on the left pane.
b. Find Send Email Message, and then drag it into the Actions box.
c. Select a template from the Email Template menu.
d. Select a LEM user from the Recipients menu.
e. Drag and drop event fields or constants from the left pane into the Send Email
Message form to complete the action.
Note: Always use event fields for the event(s) present in the Correlations box. For example,
use NewGroupMember.DetectionTime to populate the DetectionTime field in this example.
7. Select Enable at the top of the Rule Creation form, and then click Save.
8. To sync your local changes with the LEM appliance, click Activate Rules back in the
main Rules view.
After you enable and activate this rule, the LEM appliance sends an email anytime someone adds a
user to any group in Active Directory that contains the text, "admin" in its name.
For more detailed information about how to create LEM rules to take action on your network, see the
KB article, "Creating Rules from Your LEM Console to Take Automated Action."
Other Rule Scenarios
Countless scenarios may warrant a rule. Consider these combinations of rules and actions:
l
Respond to other change management events with the Send Email Message action.
l
Respond to port scanning events with the Block IP action.
55
Chapter 5: Useful Tasks
l
Respond to isolated spikes in network traffic with the Send Email Message or Disable
Networking action.
l
Respond to users playing games on monitored computers with the Send Popup
Message or Kill Process action.
l
Respond to users attaching unauthorized USB devices to monitored computers using
the Detach USB Device action.
Basically, any activity or event that can pose a threat to your network might warrant a LEM rule.
Troubleshooting
If you have created a rule, but you are not getting the expected results, verify the following to track
down the root cause:
1. Check for the requisite events on the Monitor tab. For example, if your rule is based on
the NewGroupMember event, see if you can find one in the All Events or default
Change Management filter.
2. If you do not see the requisite events, troubleshoot your devices and connectors to get
the events into LEM. Otherwise, continue troubleshooting here.
3. Check for an InternalRuleFired event in the SolarWinds Events filter.
4. If you do not see an InternalRuleFired event for your rule, check the following to
continue troubleshooting. Otherwise, skip to Step 5 to continue.
l
Is your rule enabled?
l
Did you modify the Correlation Time or Response Window in your rule?
l
Did you click Activate Rules after saving your rule?
l
Is the time on your device more than 5 minutes off from the time on your LEM
appliance?
5. If you see an InternalRuleFired event for your rule, but the rule LEM does not respond
as expected, check the following, according to the action you configured:
l
Send Email Message: Verify you have configured and started the Email Active
56
Additional Information
Response connector on the LEM appliance.
l
Send Email Message: Verify you have associated an email address for the
LEM user you selected as your email recipient.
l
Agent-based Actions: Verify you have installed the LEM Agent on the
computer you want LEM to respond to.
l
Block IP: Verify you have configured the active response connector for the
firewall you want to use to take this action. The active response connector is
separate from the data gathering connector.
For more detailed information about how to troubleshoot LEM rules and active responses, see the KB
article, "Troubleshooting LEM Rules and Email Responses."
Additional Information
For a general procedure and video addressing how to create and clone rules in the LEM Console, see
the following KB articles:
l
"Creating Rules from Your LEM Console to Take Automated Action"
For additional information about the active responses available for LEM rules, see the following KB
articles:
l
"How does the Block IP active response work?"
l
"How does the Detach USB Device active response work?"
l
"How does the Append Text To File active response work?"
l
"How do the computer-based active responses work?"
l
"How do the user-based active responses work?"
l
"How do the Kill Process active responses work?"
l
"How does the Disable Networking active response work?"
Analyzing Data
Click the
video icon to view the corresponding tutorial.
57
Chapter 5: Useful Tasks
Now that LEM is collecting your log data, use nDepth and LEM Reports to search, analyze, and
report on that data. In most cases, use the nDepth Explorer in the LEM Console to search and
analyze your data. Use the stand-alone LEM Reports application to report on your data.
Which Do I Pick?
Use nDepth if you want to perform immediate search or analysis tasks, or create specific custom
PDF reports. Use nDepth to:
l
Search your log data interactively
l
Search for specific variables, such as user names, IP addresses, or specific events
l
Perform root-cause analysis
l
Troubleshoot specific issues
l
Explore data and produce custom PDF reports
Use LEM Reports if you want to view or schedule fixed reports for regulatory and compliance
purposes. Use LEM Reports to:
l
Automate reporting
l
Produce compliance reports
l
View reports based on specific regulatory compliance initiatives
l
Provide proof that you are auditing log and event data to auditors
l
Schedule formatted reports for LEM Reports to run and export automatically
nDepth: A Fully Integrated IT Search Solution
Open nDepth in the LEM Console in any of these three ways:
1. Select an event on the Monitor tab, click the Explore menu, and then select nDepth.
2. Select a filter in the Filters pane on the Monitor tab, click the gear
button at the top
of the Filters pane, and then select Send to nDepth.
3. Click the Explore tab from anywhere in the LEM Console, and then select nDepth.
Consult nDepth for several analytical connectors that it summarizes on both its dashboard and
toolbar. Use this view to:
58
LEM Reports: For Compliance and Historical Reporting Needs
l
Search original log messages (AKA "raw logs") or normalized events
l
View search results in several charts and graphs, and add values from these visuals
directly to your search just by clicking them
l
Refine the time frame of your searches using pre-defined or custom ranges
l
View the text output of your search results using the Result Details connector on the
nDepth toolbar
l
Export your search results in CSV or fully-customizable PDF format
l
Save searches for future use
LEM Reports: For Compliance and Historical Reporting Needs
LEM Reports is a stand-alone application that you install separately from the LEM Console. Access
LEM Reports using a shortcut, if available, or by navigating to the SolarWinds Log and Event
Manager program group in your Windows Start menu.
Use LEM Reports to:
l
Run hundreds of pre-configured compliance and security reports
l
Schedule reports for LEM Reports to run automatically
l
Filter the reports list by industry or requirement
l
Run Master, Detail, or Top level reports according to how much information you need
l
Use Select Expert to filter your report data by specific values, such as computer name,
IP address, or user name
l
Export reports into several formats, including PDF, CSV, and RPT
To get started with LEM Reports, filter the reports listing by the industries or requirements relevant to
your network. Then, the next time you open LEM Reports, access your custom list of reports by
clicking Industry Reports on the main view.
To filter the reports list by industry or requirement:
1. Open LEM Reports.
2. On the Settings tab, click Manage, and then select Manage Categories.
59
Chapter 5: Useful Tasks
3. Select your industries and requirements in the left pane. Mix and match as necessary.
For example, if you are a school that accepts credit card payments, select Education,
FERPA, and PCI.
4. Click OK.
5. To view the filtered list of reports, click the Category menu back on the Settings tab,
and then select Industry Reports.
Select which reports to run based on their values in the Level column on the Settings tab:
l
Master: Reports at this level contain all of the data for their category. For example, the
master-level Authentication report contains all authentication-related data.
l
Detail: Reports at this level contain information related to a specific type of event. For
example, the Authentication – Failed Authentications detail-level report only contains
data related to "Failed Authentication" events.
l
Top: Reports at this level display the top number of occurrences for a specific type of
event. Use the default top number, or Top N, of 10, or customize this when you run the
report.
Troubleshooting
If you have installed LEM Reports, but are unable to open the application or run reports, complete the
following procedures to troubleshoot.
To troubleshoot application launch errors on computers running Windows Vista,
Windows 7, and Windows Server 2008:
1. Uninstall LEM Reports and Crystal Reports v11 Runtime.
2. Reinstall both components as Administrator.
3. Adjust the LEM Reports properties to run the program in Windows XP compatibility
mode and as an administrator:
1. Right-click the LEM Reports shortcut on your desktop or in the SolarWinds Log and
Event Manager program group in your Windows Start menu, and then select
Properties.
2. Click the Compatibility tab.
60
Additional Information – nDepth
3. Select Run this program in compatibility mode for, and then select Windows XP
(Service Pack 3).
4. Select Run this program as an administrator.
5. Click OK.
4. Launch LEM Reports.
To address "Logon failed. Database Vendor Code 210" errors:
Add the computer running LEM Reports to the list of authorized reporting computers. By default, the
LEM appliance restricts all access to LEM Reports. To allow specific computers to run LEM Reports
or remove all reporting restrictions, complete the procedures in the KB article, "Configuring Report
Restrictions."
Additional Information – nDepth
For additional information about how to use nDepth to search and analyze your data in the LEM
Console, consult the following resources.
l
Explore
For examples of how to execute nDepth searches, see the following KB articles:
l
"How to create an nDepth query for all activity by a single user"
l
"Sending Filters to nDepth for Historical Search"
For additional information about how to save nDepth searches for future use, see the KB article,
"Save nDepth searches to quickly execute frequent queries."
For additional information about how to export nDepth search results in CSV or PDF format, see the
KB article, "Export nDepth results in custom or text formats for retention and ad hoc reporting."
For additional information about configuring your LEM appliance to store and search original log data,
see the following KB articles:
l
"Configuring Your LEM Appliance for Log Message Storage and nDepth Search"
l
"Using your LEM Console to view and search original log messages"
61
Chapter 5: Useful Tasks
l
"Do not modify the Output, nDepth Host, or nDepth Port fields when configuring LEM
connectors unless your appliance is set up to store original log data"
Additional Information – LEM Reports
For additional information about how to run, schedule, and configure formatted compliance and
security reports using LEM Reports, consult the following resources.
l
"Reports" on page 1.
l
See page 478 for details.
For information about installing LEM Reports on computers without the LEM Console, see the KB
article, "Configuring LEM Reports on Computers Without the LEM Console."
For information about scheduling several best practice compliance and security reports, see the
following KB articles:
l
"Configuring Default Batch Reports on XP/2003 Computers"
l
"Configuring Default Batch Reports on Vista/7/2008 Computers"
l
"Report Formats and their corresponding numbers listed in a LEM scheduled report ini
file"
For additional information about working with individual reports in LEM Reports, see the following KB
articles:
l
"Filtering and Exporting LEM Reports"
l
"Creating a Custom Filtered Report"
62
Chapter 6: Leveraging
This chapter provides a series of use cases to get you started with SolarWinds LEM. Use these
scenarios to ensure you have the most basic coverage in your environment, though the third party
products you use or other variables in your network might be different than the ones provided in these
examples.
This chapter addresses the following use cases.
l
"Leveraging" on page 63
l
"Monitoring Firewalls for Port Scans and Malformed Packets" on page 70
l
Monitoring Antivirus Software for Viruses that are Not Cleaned
l
Monitoring Proxy Servers for Suspicious URL Access
l
"Monitoring Microsoft SQL Databases for Changes to Tables and Schema" on page 79
l
Leveraging the Incidents Report in Security Audits
Monitoring Windows Domain Controllers for Brute Force
Hacking Attempts
Monitor the Windows domain controllers to track failed logon attempts to administrative accounts,
which can be indicative of "brute force" or other hacking attempts. Also, gain visibility into account
lockout, user and group modification, and other change management events across your network.
Install a LEM Agent on all domain controllers to ensure the LEM Manager captures all of your domain
events, even if they are not replicated across all of your domain controllers. View the events in the
default Change Management filter in your LEM Console, and create custom filters to show all activity
on these critical servers.
This section contains the following procedures:
l
"Configuring the SolarWinds LEM Agent" on page 64
l
"Using Connector Profiles to Maintain and Monitor Multiple Domain Controller Agents"
on page 66
63
Chapter 6: Leveraging
l
"Creating a LEM Rule to Track Failed Login Attempts to Administrative Accounts" on
page 68
l
"Tuning Windows Logging for LEM Implementation" on page 68
Configuring the SolarWinds LEM Agent
Install a LEM Agent and configure the appropriate connectors to monitor domain events on your
network along with local events on the servers themselves. Use the procedures below to configure a
SolarWinds LEM Agent on a single Windows domain controller. For information about installing
several SolarWinds LEM Agents remotely, see the "Remote Installation" knowledge base (KB)
article.
The following table provides the installation requirements for the LEM Agent:
Software/Hardware
Operating System
Requirements
AIX, Linux, Solaris, Windows XP, Windows Vista, Windows 7, Windows 8, Windows Server 2000, Windows Server 2003, Windows
Server 2008
CPU Speed
450 MHz Pentium III or equivalent
Memory
512 MB RAM
Hard Drive Space
1 GB
Environment Variables
The ability to install all software with administrator rights
Installing a LEM Agent on a single Windows domain controller:
1. Download the SolarWinds LEM Agent installer for Windows.
a. If you are a licensed LEM customer, download the installer from the SolarWinds
customer portal.
b. If you are an evaluation LEM customer, see the "Additional Evaluation
Downloads" KB article.
2. Extract the contents of the installer ZIP file to a local or network location.
3. Run Setup.exe.
64
Configuring the SolarWinds LEM Agent
4. Click Next to start the installation wizard.
5. Accept the End User License Agreement and click Next.
6. Enter the hostname of your LEM Manager in the Manager Name field and click Next.
Do not change the default port values.
7. Confirm the Manager Communication settings and click Next.
8. Specify whether to install USB-Defender with the LEM Agent and click Next. The
installer includes USB-Defender by default. To omit this from the installation, clear the
Install USB-Defender checkbox.
Note: Install USB-Defender on every system. USB-Defender never detaches a USB
device unless you have explicitly enabled a rule to do so. By default, USB-Defender
simply generates events related to USB mass storage devices attached to your LEM
Agents
9. Confirm the settings on the Pre-Installation Summary and click Install.
10. Once the installer finishes, click Next to start the LEM Agent service.
11. Inspect the Agent Log for any errors and click Next.
12. Click Done to exit the installer.
The SolarWinds LEM Agent continues running on your computer until you uninstall or manually stop
it. It begins sending events to your SolarWinds LEM Manager immediately.
Configuring additional connectors on your SolarWinds LEM Agent:
1. Open your SolarWinds LEM Console and log into your SolarWinds LEM Manager as an
administrator.
2. Click the Manage tab, and then click Nodes.
3. Locate the LEM Agent in the list. Use the Refine Results pane on the left if necessary.
4. Click the gear
button next to the LEM Agent (left), and then click Connectors.
5. Locate the connector you want to configure in the list. Use the Refine Results pane on
the left if necessary.
6. Click the gear
button next to the connector (left), and then click New.
65
Chapter 6: Leveraging
7. Modify the connector if necessary and then click Save.
8. Click the gear
button next to the new instance of the connector , indicated by an
icon in the Status column, and then click Start.
9. Click Close to close the Connector Configuration window.
10. Configure the following additional connectors on your Windows domain controllers, as
applicable.
l
Windows Directory Service Log
l
Windows DNS Server Log
l
Windows DHCP Server version
Using Connector Profiles to Maintain and Monitor Multiple Domain
Controller Agents
Use Connector Profiles to maintain and monitor multiple domain controllers in the LEM Console.
Connector Profiles allows you to configure and modify connector settings at the profile level, and they
also provide a group by which you can filter your event traffic coming into your SolarWinds LEM
Console from your SolarWinds LEM Agents. Use the procedures below to create a Connector Profile
based on a single SolarWinds LEM Agent and a corresponding filter to monitor activity on the
computers in that profile.
Note: Microsoft changed the way Windows computers log security events with their latest operating
system releases. For that reason, SolarWinds LEM Agents on computers running Windows Server
2008, Windows Vista, or Windows 7 require different connectors than those Agents on computers
running older operating systems. If you are running both old and new versions of these Windows
operating systems in your environment, create a Connector Profile for each operating system.
Creating a Connector Profile based on a single SolarWinds LEM Agent:
1. Install the SolarWinds LEM Agent software on all of the computers you want to end up
in your new Connector Profile.
2. Configure a single SolarWinds LEM Agent to serve as the template for your Connector
Profile. For more information, see Configuring the SolarWinds LEM Agent
3. In the LEM Console, select the Build tab, and then click Groups.
66
Configuring the SolarWinds LEM Agent
4. Click the
button in the upper right, and then click Connector Profile.
5. Enter a Name and Description for the Connector Profile.
6. Select the recently configured SolarWinds LEM Agent from the Template list.
7. Click Save.
8. Locate your new Connector Profile in the Groups list. Use the Refine Results pane on
the left if necessary.
9. Click the gear
button next to your Connector Profile (left), and then click Edit.
10. Locate the SolarWinds LEM Agents you want to add to your Connector Profile in the
Available Agents pane, and click the arrow next to them to add them to the Contained
Agents pane.
11. If you are finished adding SolarWinds LEM Agents to your Connector Profile, click
Save.
Creating a filter for all activity from the computers in a Connector Profile:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator or auditor.
2. Click Monitor.
3. Click the
button on the Filters pane (left), and then click New Filter.
4. Enter a Name and Description for the filter.
5. Click Event Groups on the components list (left).
6. Click Any Event.
7. In the Fields: Any Event list below, click and drag DetectionIP into the Conditions box
(right).
8. Click Connector Profiles on the components list (left).
9. Click and drag your Connector Profile into the Conditions box (right), replacing the Text
Constant field, which is denoted by a pencil icon.
10. Click Save.
67
Chapter 6: Leveraging
Creating a LEM Rule to Track Failed Login Attempts to
Administrative Accounts
Clone and enable the Critical Account Logon Failures rule to track failed login attempts to the default
Administrator account in Windows. The default action for this rule is to generate a HostIncident
event, which you can use in conjunction with the Incidents report to prove to auditors that you are
auditing the critical events on your network. For more information about scheduling and leveraging the
Incidents report, see Leveraging the Incidents Report in Security Audits
Cloning and enabling the Critical Account Logon Failures rule:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Click the Build tab, and then click Rules.
3. Enter Critical Account Logon Failures in the search box at the top of the Refine
Results pane.
4. Click the gear
button next to the rule (left), and then click Clone.
5. Select the folder where you want to save the cloned rule, and then click OK.
6. Select Enable at the top of the Rule Creation window, next to the Description field.
7. Click Save.
8. Back on the main Rules screen, click Activate Rules.
Tuning Windows Logging for LEM Implementation
After you have installed and configured you SolarWinds LEM Agents, optimize your SolarWinds LEM
deployment by tuning Windows to log the specific events you want to see in your SolarWinds LEM
Console and store on your SolarWinds LEM database. Use the recommendations below to get
started with this tuning process.
Note: Set group and local policies according to the needs of your environment. We provide
recommendations to illustrate common, but not universal, use cases. For additional information about
tuning Windows logging, see the Windows Logging section of the SolarWinds Knowledge Base, or
technet.microsoft.com.
68
Creating a LEM Rule to Track Failed Login Attempts to Administrative Accounts
Default Domain Policy
Configure logging for default domain policy in Windows as recommended in the following table.
Policy
Success Failure Not Defined
Audit account logon events
Yes
Yes
Audit account management
Yes
Yes
Audit directory service
Not defined
access
Audit logon events
Yes
Yes
Audit object access
Audit policy change
Not defined
Yes
Yes
Audit privilege use
Not defined
Audit process tracking
Yes
No
Audit system events
Yes
Yes
Default Domain Controller Policy
Configure logging for your default domain controller policy in Windows as recommended in the
following table.
Policy
Success Failure
Audit account logon events
Yes
Yes
Audit account management
Yes
Yes
Audit directory service
Yes
Yes
Yes
Yes
access
Audit logon events
Audit object access1
Yes
69
Chapter 6: Leveraging
Policy
Success Failure
Audit policy change
Yes
Audit privilege use
Yes
Yes
Audit process tracking
Yes
Yes
Audit system events
Yes
Yes
1Audit object access
is required for file auditing. For more information, see the How to enable file
auditing in Windows KB article
For more information about the policies discussed above and how to configure their auditing, see the
Audit Policy and Best Practice KB article
Monitoring Firewalls for Port Scans and Malformed
Packets
Monitor firewalls to detect port scans and other network attacks based on unusual traffic patterns and
malformed packets. Also, gain visibility into web traffic and other network traffic events across your
network. Configure your firewalls to log to your SolarWinds LEM appliance and set up the appropriate
connector on your SolarWinds LEM Manager. View the events in the default Firewall filter in your
SolarWinds LEM Console, and create custom filters to show traffic to or from specific computers.
This section contains the following procedures.
l
"Setting a Firewall to Log to a LEM Appliance" on page 70
l
"Configuring a Firewall Connector on a LEM Manager" on page 71
l
"Viewing Network Traffic from Specific Computers" on page 72
l
"Creating a LEM Rule to Notify of Potential Port Scanning Traffic" on page 73
Setting a Firewall to Log to a LEM Appliance
Set your firewall to log to your SolarWinds LEM appliance to centralize its log data with the rest of
your SolarWinds LEM events. The process for doing this is different for each vendor, and it even
differs across firewall versions. For that reason, we document each firewall separately, which is
beyond the scope of this guide.
70
Configuring a Firewall Connector on a LEM Manager
Firewalls from popular vendors such as Cisco, Check Point, and Juniper can be integrated with
SolarWinds LEM appliances. For more information, see the following KB articles.
l
"Configuring a Cisco PIX or ASA Firewall to Log to Your LEM Appliance"
l
"Integrating Check Point with SolarWinds LEM "
l
"Integrating Juniper Firewalls with SolarWinds LEM "
If your firewall vendor is not listed here, search for your vendor in the SolarWinds LEM Knowledge
Base. If documentation is not available, please contact Support.
Configuring a Firewall Connector on a LEM Manager
After you have set your firewall to log to your SolarWinds LEM appliance, configure the corresponding
connector on your SolarWinds LEM Manager. Many of the firewall connectors are similar, though
some will have a few unique settings. The procedure below illustrates how to set up a connector for a
Cisco PIX firewall, and you can find instructions for additional firewall connectors in the SolarWinds
LEM Knowledge Base.
To configure the Cisco PIX and IOS connector on your SolarWinds LEM Manager:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Click the Manage tab, and then click Appliances.
3. Click the gear
button next to the SolarWinds LEM Manager (left), and then click
Connectors.
4. In the Connector Configuration window, enter Cisco PIX in the search box at the top of
the Refine Results pane.
5. Click the gear
button next to the Cisco PIX and IOS connector, and then click
New.
6. Replace the Alias value with a more descriptive connector alias. For example, PIX
Firewall.
71
Chapter 6: Leveraging
7. Use firewall somewhere in the Alias field to ensure the default Firewall filter captures
your firewall data.
8. Verify the Log File value matches the local facility defined in your firewall settings.
9. Click Save.
10. Click the gear
button next to the new instance of the connector, indicated by an
icon in the Status column, and then click Start.
11. Click Close to close the Connector Configuration window.
Viewing Network Traffic from Specific Computers
Create custom filters to make specific firewall events more visible than others. For example, if you
want to monitor all traffic coming from a specific computer more closely than other firewall traffic,
create a filter for all network traffic coming from that source machine. Use Connector Profiles and
other groups to broaden or refine the scope of custom filters like this.
Creating a filter for all traffic from a specific computer:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator or auditor.
2. Click Monitor.
3. Click the
button on the Filters pane (left), and then click New Filter.
4. Enter a Name and Description for the filter.
5. Click Event Groups on the components list (left).
6. Click Network Audit Events.
7. In the Fields: Network Audit Events list below, click and drag SourceMachine into the
Conditions box (right).
8. Enter the computer's name into the Text Constant field, which is denoted by a pencil
icon. Use a wildcard character (*) after the computer name to avoid having to enter the
computer's fully qualified domain name.
72
Creating a LEM Rule to Notify of Potential Port Scanning Traffic
Note: Use a Connector instead of a Text Constant to filter for all network traffic coming
from a group of similar computers.
9. Click Save.
Creating a LEM Rule to Notify of Potential Port Scanning Traffic
Clone and enable the PortScans rule to recognize suspicious firewall traffic that can be indicative of
port scanning. The default action for this rule is to generate a TCPPortScan event, which the
SolarWinds LEM Console displays in the default Security Events filter. Use these events to monitor
suspicious network traffic and potentially take action against an external source.
Cloning and enabling the PortScans rule:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Click the Build tab, and then click Rules.
3. Enter PortScans (one word) in the search box at the top of the Refine Results pane.
4. Click the gear
button next to the rule (left), and then click Clone.
5. Select the folder where you want to save the cloned rule, and then click OK.
6. Select Enable at the top of the Rule Creation window, next to the Description field.
7. Optionally, to tune the rule to be more appropriate for your environment, consider the
following:
l
Subscribe to the rule to track its activity in the Subscriptions report.
l
Increase the number of events in the Correlation Time box to modify how frequently the
rule fires.
l
Omit vulnerability scanners from the Correlations by changing the TCPTrafficAudit
"exists" condition to TCPTrafficAudit .SourceMachine = Your Scanners, where Your
Scanners is a User-Defined Group, Connector Profile, or Directory Service Group that
represents that group of computers.
73
Chapter 6: Leveraging
l
Modify the default action or add additional actions to do things such as send an email
message, or block an IP address.
Note: For more information about working with SolarWinds LEM rules, see the Rules section of the
SolarWinds Knowledge Base.
9. If you are finished configuring your rule, click Save.
10. Back on the main Rules screen, click Activate Rules.
Monitoring Antivirus Software for Viruses that are Not
Cleaned
Monitor your antivirus software to track whether or not your antivirus solution is able to fully clean the
viruses it detects. Configure your antivirus software to log to your SolarWinds LEM appliance and set
up the appropriate connector on your SolarWinds LEM Manager. View the events in the default Virus
Attack filter in your SolarWinds LEM Console.
This section contains the following procedures.
l
"Setting Antivirus Software to Log to a LEM Appliance" on page 74
l
"Configuring the Antivirus Connector on a LEM Manager" on page 75
l
"Creating a LEM Rule to Track When Viruses Are Not Cleaned" on page 76
Setting Antivirus Software to Log to a LEM Appliance
Set your antivirus software to log to your SolarWinds LEM appliance to centralize its log data with the
rest of your SolarWinds LEM events. The process for doing this is different for each vendor, and it
even differs across antivirus versions. For that reason, we document each antivirus solution
separately, which is beyond the scope of this guide.
You can integrate antivirus software from popular vendors such as Symantec, and McAfee with your
SolarWinds LEM appliance. For more information, see the following KB articles.
l
Configuring Symantec Endpoint Protection 11
l
Configuring McAfee EPO
If your antivirus vendor is not listed here, search for your vendor in the SolarWinds LEM Knowledge
Base. If documentation is not available, please contact Support.
74
Configuring the Antivirus Connector on a LEM Manager
Configuring the Antivirus Connector on a LEM Manager
After you have set your antivirus to log to your SolarWinds LEM appliance, configure the
corresponding connector on your SolarWinds LEM Manager. Many of the antivirus connectors are
similar, though some will have a few unique settings. The procedure below illustrates how to set up a
connector for Symantec Endpoint Protection, and you can find instructions for additional firewall
connectors in the SolarWinds LEM Knowledge Base.
Configuring the Symantec Endpoint Protection 11 connector on your SolarWinds LEM
Manager:
1. Replace the Alias value with a custom alias or accept the default.
2. Verify the Log File value matches the Log Facility defined in your antivirus settings.
3. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
4. Select the Manage tab, and then click Appliances.
5. Click the gear
button next to your SolarWinds LEM Manager (left), and then click
Connectors.
6. In the Connector Configuration window, enter Symantec Endpoint Protection in the
search box at the top of the Refine Results pane.
7. Click the gear
button next to the Symantec Endpoint Protection 11 connector,
and then click New.
Note: For Symantec Endpoint Protection (SEP), the Log Facility is equal to the local facility on your
SolarWinds LEM appliance plus 16. So, the default Log File value of /var/log/local6.log on your
SolarWinds LEM appliance actually corresponds to Log Facility 22 in your SEP11 settings.
8. Click Save.
9. Click the gear
button next to the new instance of the connector , indicated by an
icon in the Status column, and then click Start.
10. Click Close to close the Connector Configuration window.
75
Chapter 6: Leveraging
Creating a LEM Rule to Track When Viruses Are Not Cleaned
Clone and enable the Virus Attack – Bad State rule to track the state of virus attacks reported by your
antivirus software. The Bad Virus State User-Defined Group defines a bad state as any virus that has
not been fully cleaned by your antivirus software. That is, any virus that has been left alone,
quarantined, or renamed.
The default action for this rule is to generate a HostIncident event, which you can use in conjunction
with the Incidents report to prove to auditors that you are auditing the critical events on your network.
For more information about scheduling and leveraging the Incidents report, see Leveraging the
Incidents Report in Security Audits
Cloning and enabling the Virus Attack – Bad State rule:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Select the Build tab, and then click Rules.
3. Enter Virus Attack – Bad State in the search box at the top of the Refine Results
pane.
4. Click the gear
button next to the rule (left), and then click Clone.
5. Select the folder where you want to save the cloned rule, and then click OK.
6. Select Enable at the top of the Rule Creation window, next to the Description field.
7. Click Save.
8. Back on the main Rules screen, click Activate Rules.
Monitoring Proxy Servers for Suspicious URL Access
Monitor proxy servers to track when users attempt to access suspicious websites by partial or
complete URL addresses. Configure your proxy server to log to your SolarWinds LEM appliance and
set up the appropriate connector on your SolarWinds LEM Manager.
This section contains the following procedures:
76
Setting Proxy Server to Log to a SolarWinds LEM Appliance
l
""Setting Proxy Server to Log to a SolarWinds LEM Appliance" on page 77
l
"Configuring a Proxy Server Connector on a SolarWinds LEM Manager" on page 77
l
"Creating a SolarWinds LEM Rule to Notify of Suspicious URL Attempts" on page 78
Setting Proxy Server to Log to a SolarWinds LEM Appliance
Set your proxy server to log to your SolarWinds LEM appliance to centralize its log data with the rest
of your SolarWinds LEM events. The process for doing this is different for each vendor, so we
document each proxy server separately, which is beyond the scope of this guide.
You can integrate proxy servers from popular vendors such as Websense, and Barracuda with your
SolarWinds LEM appliance. For more information, see the following KB articles.
l
"Integrating Websense with SolarWinds LEM"
l
"Integrating Barracuda with SolarWinds LEM "
If your firewall vendor is not listed here, search for your vendor in the SolarWinds LEM Knowledge
Base. If documentation is not available, please contact Support.
Configuring a Proxy Server Connector on a SolarWinds LEM
Manager
After you have set your proxy server to log to your SolarWinds LEM appliance, configure the
corresponding connector on your SolarWinds LEM Manager. Many of the proxy server connectors are
similar, though some have a few unique settings. The procedure below illustrates how to set up a
connector for a Websense proxy server, and you can find instructions for additional firewall
connectors in the SolarWinds LEM Knowledge Base.
Configuring the Websense Web Filter and Websense Web Security connector:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Select the Manage tab, and then click Appliances.
3. Click the gear
button next to your SolarWinds LEM Manager (left), and then click
Connectors.
77
Chapter 6: Leveraging
4. In the Connector Configuration window, enter Websense Web Filter in the search box
at the top of the Refine Results pane.
5. Click the gear
button next to the Websense Web Filter and Websense Web
Security connector , and then click New.
6. Replace the Alias value with a custom alias or accept the default.
7. Click Save.
8. Click the gear
button next to the new instance of the connector, indicated by an
icon in the Status column, and then click Start.
9. Click Close to close the Connector Configuration window.
Creating a SolarWinds LEM Rule to Notify of Suspicious URL
Attempts
Clone and enable the Known Spyware Site Traffic rule to track when users attempt to access
suspicious websites by partial or complete URL addresses. The default action for this rule is to
generate a HostIncident event, which you can use in conjunction with the Incidents report to prove to
auditors that you are auditing the critical events on your network. For more information about
scheduling and leveraging the Incidents report, seeLeveraging the Incidents Report in Security Audits
Note: Before enabling this rule, ensure your proxy server transmits complete URL addresses to your
SolarWinds LEM Manager by checking the URL field of any WebTrafficAudit event generated by your
proxy server. If your proxy server does not log web traffic events with this level of detail, check the
events coming from your firewalls, as they can sometimes be used for this rule as well.
Cloning and enabling the Known Spyware Site Traffic rule:
1. Open theSolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Select the Build tab, and then click Rules.
3. Click Default Rules on the Refine Results pane (left).
4. Enter Known Spyware Site Traffic in the search box at the top of the Refine Results
pane.
78
Monitoring Microsoft SQL Databases for Changes to Tables and Schema
5. Click the gear
button next to the rule (left), and then click Clone.
6. Select the folder where you want to save the cloned rule, and then click OK.
7. Select Enable at the top of the Rule Creation window, next to the Description field.
8. Click Save.
9. Back on the main Rules screen, click Activate Rules.
Monitoring Microsoft SQL Databases for Changes to
Tables and Schema
Monitor databases to track successful or failed attempts to make changes to their tables or schema.
Install MSSQL Auditor on a LEM Agent running Microsoft SQL Profiler to monitor local or remote
Microsoft SQL databases. MSSQL Auditor runs as a service in addition to the LEM Agent service.
l
"Configuring Database Servers" on page 79
l
"Configuring the MSSQL Auditor Connector on a SolarWinds LEM Agent" on page 81
l
"Creating a SolarWinds LEM Rule to Send Notifications of Microsoft SQL Database
Change Attempts" on page 81
Configuring Database Servers
Install and configure MSSQL Auditor on your database server to allow SolarWinds LEM Agent
access to details about database configuration changes on that computer.
Install the following components on your database server prior to installing MSSQL Auditor.
l
Microsoft SQL 2005 or 2008 Profiler
l
Microsoft .NET 2.0 Framework
l
SolarWinds LEM Agent for Windows
Installing MSSQL Auditor on a SolarWinds LEM Agent
1. Download SolarWinds-LEM-v6.1-MSSQLAuditor.zip from the SolarWinds customer
79
Chapter 6: Leveraging
portal under Additional Components.
2. Run mssqlaudsetup.exe.
3. Click Next to start the wizard.
4. Accept the End User License Agreement, and then click Next.
5. Click Change to specify an installation folder, or accept the default, and then click
Next.
6. Click Install.
7. When the installation is finished, select Launch SolarWinds MSSQL Auditor, and
then click Finish.
To configure MSSQL Auditor for use with your servers:
Note: If you did not select Launch SolarWinds MSSQL Auditor after installing the application, you
can launch it from the SolarWinds Log and Event Manager program group in your Start menu.
1. Enter the name of the SQL server to be monitored in the SQL Server\Instance field,
and click Add Server.
Note: To specify an instance other than the default, enter your server name in the following
format: Server\Instance.
2. Repeat this step for all of the servers to be monitored.
3. To use an account other than the Local System Account to run MSSQL Auditor on your
database server, select This Account in the Run Service As section, and provide
the appropriate credentials.
Note: We recommend you use an account in the "sysadmin" role on your database, though the
account only needs to have Execute permissions for any stored procedures with the xp_trace prefix.
4. Click Start Auditor Service, which is denoted by a green "Play" icon, in the Manage
Auditor Service section.
5. Click OK.
80
Monitoring Microsoft SQL Databases for Changes to Tables and Schema
Configuring the MSSQL Auditor Connector on a SolarWinds LEM
Agent
To configure the MSSQL Auditor connector on your SolarWinds LEM Agent:
1. Open the SolarWinds LEM Console and log into theSolarWinds LEM Manager as an
administrator.
2. Select the Manage tab, and then click Nodes.
3. Locate the SolarWinds LEM Agent for your database server and verify it is connected
to your LEM Manager.
4. Click the gear
button next to the SolarWinds LEM Agent, and then
click Connectors.
5. Enter MSSQL in the search box at the top of the Refine Results pane.
6. Click the gear
button next to the SolarWinds Log and Event Manager MSSQL
Auditor connector , and then click New.
7. Give the new connector a custom Alias, or accept the default.
8. Verify that the value in the Log File field matches the folder in which the logs are stored
on your database server, and then click Save.
9. Click the gear
button next to the new instance of the connector , indicated by an
icon in the Status column, and then click Start.
10. Repeat these steps for the MSSQL 2000 Application Log connector .
11. Click Close to close the Connector Configuration window.
Creating a SolarWinds LEM Rule to Send Notifications of Microsoft
SQL Database Change Attempts
Clone and enable the MSSQL Database Change Attempt rule to track when users attempt to change
properties on a monitored Microsoft SQL database. The default action for this rule is to generate a
HostIncident event, which you can use in conjunction with the Incidents report to prove to auditors
that you are auditing the critical events on your network. For more information about scheduling and
leveraging the Incidents report, see "Leveraging the Incidents Report in Security Audits
81
Chapter 6: Leveraging
Clone and enable the MSSQL Database Change Attempt rule to track when users attempt to change
properties on a monitored Microsoft SQL database. The default action for this rule is to generate a
HostIncident event, which you can use in conjunction with the Incidents report to prove to auditors
that you are auditing the critical events on your network. For more information about scheduling and
leveraging the Incidents report, see "Leveraging the Incidents Report in Security Audits
Cloning and enabling the MSSQL Database Change Attempt rule:
1. Open the SolarWinds LEM Console and log into the SolarWinds LEM Manager as an
administrator.
2. Select the Build tab, and then click Rules.
3. Enter MSSQL Database Change Attempt in the search box at the top of the Refine
Results pane.
4. Click the gear
button next to the rule (left), and then click Clone.
5. Select the folder where you want to save the cloned rule, and then click OK.
6. Select Enable at the top of the Rule Creation window, next to the Description field.
7. Click Save.
8. Back on the main Rules screen, click Activate Rules.
Leveraging the Incidents Report in Security Audits
Auditors typically require that IT administrators review the critical events on their networks on a daily
basis. Create a method for reviewing these events by utilizing Incident events as discussed in the
previous sections in this chapter. After you have defined your critical network events as Incidents,
schedule the Incidents report to run daily and follow the procedure suggested below to maintain a
paper trail to use during your security audits.
We recommend scheduling 4 reports to run on a daily basis, one of which is the Incidents report. For
more information on scheduling these daily reports, see the following KB articles.
l
"Configuring Default Batch Reports on XP/2003 Computers"
l
"Configuring Default Batch Reports on Vista/7/2008 Computers"
82
Leveraging the Incidents Report in Security Audits
Maintaining a paper trail for your security audits using the daily Incidents report:
1. Open the Incidents report every day for the previous day.
2. Print the report and review its contents.
3. Document any action you took as a result of the report on the printed report and sign it.
4. File the printed and signed report in a safe location for your next security audit.
83
Chapter 7: Ops Center
The Ops Center is a dashboard used for viewing and managing informational widgets. Each widget
represents a high-level graphical view of specific network activity. Widgets are designed to present
important high-level information in easy-to-read graphical formats, such as charts and graphs.
Widgets are filter-driven — that is, a filter is the data source for the graphical representation found in
the widget. In fact, widgets appear in Monitor, as well, so you can see graphical views of your filters
along with their grid-based views.
You can select from a library of commonly used widgets, or you can create your own widgets. You
can add or remove widgets, edit existing widgets, or resize, refresh, and rearrange widgets to meet
your personal preferences.
Click to select the widget you want to work with. You can point to the widget to display ToolTips and
details about its graph. You can also use the control options on its toolbar to change the widget’s
settings display format.
You can resize widgets, but they are limited to certain sizes and aspect ratios to keep the Ops
Center tidy and organized.
The following table describes the key features of the Ops Center view.
Widgets
Each widget represents a high-level graphical view of specific network activity. Widgets are designed
to present important high-level information at a glance. Most widgets are filter-driven—that is, a filter
is the data source for what you are graphing in the widget.
84
Chapter 7: Ops Center
Name
Widget Manager
Description
Click this button to alternately open and close the Widget
Manager. The Widget Manager includes two panes—the
Categories pane and the Widgets pane.
Getting Started
Tips and shortcuts to get you started configuring and exploring
LEM
Node Health
A view of the status of each device being monitored by LEM.
thwack Community & Support
Access to useful information from the thwack community.
Top 10 Events
Displays the top 10 events in the selected time range.
Help
Links to different resources to help you learn more about LEM
What's New in LEM
A list of items that have been added or improved in this version.
Events per Minute
Displays the total count of events per minute for the past 15
minutes.
85
User Details Page
Name
Description
Custom Widget
Example of what can be created on a custom widget.
Top 10 Nodes by # of Events
Displays the top 10 most active nodes(by # of events).
Top 10 Users by # of Events
Displays the top 10 users with the most events in the selected
time range.
Network Events by Source
Displays the top 10 machines generating network events.
Machine
User Logons by Source
Displays the top 5 user logons by source machine.
Machine
Data Simulator
Plays back different kinds of simulated network data.
Top 10 Rules by Number of
Displays the top 10 most commonly triggered rules and how
Rules Fired
many times each has been triggered over a selected time
period.
User Details Page
From the Top 10 Users widget, click on a user to open the User Details page. Every user has a User
Details page that displays all related information, including all events, for that user.
The User Details page contains the User:Details and User:All Events widgets.
86
Chapter 7: Ops Center
User: Details Widget
Displays detailed user information such as User Name, Manager, User Type, etc.
User: All Events Widget
Lists all events generated by the selected user and displays statistics of the events in a graph. Click
an event to see the Event Details page for the selected event.
The User:All Events menus provide several presentation options:
l
Filter events by event group
l
Switch between Grid and Details views
l
Select by time
Color-coding allows you to easily pick out events that might need attention. A green line on a graph
represents informational events, a yellow line represents warning events, and a red line represents
critical events.
Node Details Page
From the Top 10 Nodes, click a node to open the Nodes Details page. The Nodes Details page
displays overview information on every device that is monitored by LEM.
87
Node: Details Widget
The Nodes Details page contains the Node:Details, Node:Connectors Applied, and Nodes:All
Events widgets.
Node: Details Widget
Represents the detailed information about the specified node such as Node IP, Node Name, Last
Event etc.
Node:Connectors Applied Widget
l
Provides a list of connectors which are configured for the specified node
l
Shows whether the connector is enabled or not
l
Allows you to turn on or turn off connectors
l
Allows you to configure new connectors
Node: All Events Widget
Lists all events generated by the selected node and displays statistics of the events in a graph. Click
an event to see the Event Details page for the selected event.
The Node:All Events menus provide several presentation options:
88
Chapter 7: Ops Center
l
Filter events by event group
l
Switch between Grid and Details views
l
Select by time
Color-coding allows you to easily pick out events that might need attention. A green line on a graph
represents informational events, a yellow line represents warning events, and a red line represents
critical events.
Ops Center Widget Manager
In the Ops Center, master widgets reside in the Widget Manager’s Categories list. Dashboard
widgets reside on the dashboard. Dashboard widgets cannot be saved in the Widget Manager.
Name
Description
Filters
Widgets are organized by filter. You can use the Filters pane to view, add, and edit
pane
the master widgets that are associated with each filter, and to create dashboard
widgets from each master widget.
The Name column lists each filter that has one or more master widgets. The Count
column states how many master widgets are associated with each filter. You can
also sort the columns of the Filters pane.
Opens the Widget Builder, so you can add a new master widget to the selected
category.
Opens the Widget Builder for the widget that is currently selected in the Widgets
pane. The Widget Builder lets you edit the widget’s settings.
89
Using the Widget Builder
Name
Description
Widgets
The Widgets pane is used to view the master widgets that are associated with each
pane
filter. You can also use this pane to create dashboard widgets and to delete master
widgets from the selected filter.
Add to
This button adds a copy of the master widget that is currently shown in the Widgets
Dashboard pane to the dashboard.
Delete
This button deletes the master widget that is currently shown in the Widgets pane.
Widget
Deleting a master widget does not delete any of the dashboard widgets that came
from that widget.
Using the Widget Builder
This topic explains how to use the Widget Builder, which is used to add a new widget or edit the
configuration of an existing widget.
The following table explains each field on the Widget Builder.
Field
Description
Name
Type a name for the widget. This name will appear in the widget’s title bar.
Filter
Select the filter that is to be the widget's data source. If a filter name appears in
italics, it means the filter is currently turned off.
When creating a widget from the Monitor view, this field defaults to the filter that is
currently active. If you select a different filter, the widget will be associated with
that filter, not the active filter.
When creating a widget from the Ops Center, this field defaults to the first option in
the list.
Note: If you create a widget from a filter that is turned off, the widget will not display
any chart information until the filter is turned back on.
Description
Type a brief description of the information this widget is reporting. You may use up
to 80 characters.
90
Chapter 7: Ops Center
Field
Description
Visual Configuration
Visualization Select the type of chart or graph you want—Pie, Bar, Line, Table, etc. Select
Type
Table for those times when a table of values is a useful way to view the data. You
can display a widget with any of these display types at any time. However, some
display types may not make sense for some widgets, depending on the widget’s
content.
Color/
Select a color palette for the chart or graph.
Color Palette
X-Axis Label If desired, type a label for the chart or graph’s horizontal axis.
Y-Axis Label If desired, type a label for the chart or graph’s vertical axis.
Preview
The Preview section shows what the widget will look like, based on the options you
have selected in the Visual Configuration section.
Data Configuration
Field
Select a data field you want reported from those that are available in the selected
data source.
Show
Select how you want the frequency reported:
n
Count: (default) This option counts each occurrence of the selected Field value.
For example, if the Field you select is EventID, you are counting the number of
events. As a practical matter, no matter which field you select, you are counting
events. But it is best to think of the widget as counting occurrences of the field.
n
Distinct Count: This option does not count repeating Field values. Instead, it
counts each time a distinctly different event occurs. For example, if you select a
Field value like Event Name or Detection IP, the widget will count each
specific value only once.
When used in a single-dimension chart, the Distinct Count option reports all
values as 1, so this option is best used with multi-dimensional charts.
91
Using the Widget Builder
Field
Sort
Description
Select how you want the data Show data sorted:
n
Descending (default) order is from highest to lowest (Z to A, or 0 to 1, etc.).
n
Ascending order is from lowest to highest (A to Z, or 1 to 0, etc.).
Sorting only applies when your Versus value is something other than Time.
Versus
If you want a second dimension in the chart, select another data field from those
that are available in the selected data source.
This field’s sort order is ascending.
Split By
If you want a third dimension in the chart, select another data field from those that
are available in the selected data source.
This field’s sort order is ascending.
Limit
Most filters contain a data span that exceeds what is practical to chart. The Limit
value limits the number of items that will be seen.
Select a limit for the number of items that are to be charted. The default value is 5.
For example, this can represent your Top 5 or Bottom 5, depending on how you sort
the data.
Scope
Select a value for the scope. This is the time frame reported by the chart or graph.
The scope is always measured backward from the moment the chart is refreshed.
For example, a scope of 30 minutes means “the last 30 minutes.”
The scope can be measured in Seconds, Minutes (default), Hours, or Days. For
events that happen frequently, choose a narrow scope. For events that happen
rarely, choose a large scope.
Resolution
Select the time value that defines the “tick marks” that are to be used on the chart’s
horizontal X-axis. This field is required when Versus is a Time Field.
For example, if you are looking at 30 minutes of data, a Resolution of 5 Minutes
means the bars or line chart data points are drawn in 5 minute increments. In charts
with wider scope, the resolution could be hours or even days.
This option is disabled for widgets that are not reporting time-based data.
92
Chapter 7: Ops Center
Field
Refresh
Description
Select the rate at which you want the widget to refresh its visual display. This is
necessary because the Console is monitoring real-time data. Therefore, you need
to periodically refresh the chart.
Save and cancel
Save to
Select this option to save the new or updated widget to the bottom of the Ops
Dashboard
Center dashboard.
Save
Click Save to save the new or revised master widget.
Upon saving, the new widget configuration immediately appears in the Op
CenterWidget Manager and in the Monitor view's Widget pane.
Cancel
Click Cancel to cancel your changes close the Widget Builder.
Widgets act as shortcuts to the event filters that are their data sources. This means you can open the
source filter directly from a widget. You do this by clicking the specific line, bar, or pie wedge of chart
that interests you. The corresponding filter then opens in the Monitor view. The filter lists only the
events that correspond with the chart item selected.
To open a filter from a dashboard widget:
1. Open the Ops Center view.
2. In the dashboard, locate the widget you want to work with.
3. On the widget, click the specific line, bar, or pie wedge that interests you.
93
Using the Widget Builder
4. The Monitor view appears, with the event grid showing the filter that is the widget’s
data source. Note that the event grid lists only those events that correspond to the line,
bar, or pie wedge that you clicked. Also note that the filter is paused. Click Resume on
the event grid toolbar to begin running the filter again.
Note: It is possible for you to select an item in the widget that is no longer shown in the Monitor's
event grid. That is, the filter may actually show fewer events than appear in the widget. This can
happen if the widget's scope is broader than the filter's scope. In this case, the filter may no longer
have some of the data shown by the widget, because the filter has had to make room for new data.
Remember, the widget's scope can be different than the filter's scope. The widget tracks statistics
about events that occurred over time (and perhaps a very large time frame). The filter tracks only a
certain quantity of events for a time frame that may be much smaller than the widget's scope.
To think about it another way: the Console filters are aware of 10,000 events at a time. With every
refresh interval, a widget looks at those 10,000 events to draw a line, bar, or wedge that matches the
right count for that time. Those 10,000 events are also displayed in the corresponding filter. But when
the Console gets to 10,000 events, the widget doesn't "erase" any data points it has already drawn,
but the filter has to remove the oldest events from the grid to make room for new data.
The following table describes the function of each button on a widget toolbar. All of these buttons are
on the widget toolbar, except for the “legend” button, which appears in the lower-left corner of the
widget.
94
Chapter 7: Ops Center
Button
Function
Opens the widget in the Widget Builder, so you can edit its settings.
“Flips” the widget, so you can configure its presentation format.
Refreshes the widget’s data.
Expands (maximizes) the widget to fill the desktop.
Restores the widget from its maximized size to its default size.
This button has two functions:
n
In normal dashboard mode, this button deletes the widget from the dashboard.
n
When you are editing a “flipped” widget, this button closes the widget’s edit mode, and
returns it to its normal desktop view.
Opens the widget’s legend.
Viewing Specific Widget Data
Widget graphs and charts display basic high-level information. However, each widget includes
ToolTips that show specific data about each bar, line, or wedge in the chart. Typically, this
information is the reported event, Event Group, or event field, and its number of occurrences.
To view specific chart data:
Point to the specific bar, line, or wedge you want to know about and a ToolTip appears, showing
specific data about the item you are pointing to.
95
Refreshing a Widget’s Data
Refreshing a Widget’s Data
On the widget toolbar, click the refresh
button to show the latest data from your network.Widgets
automatically refresh themselves according to the Refresh rate that was set when the widget was
created. If a widget has a slow refresh rate, you can refresh it whenever you want. Refreshing a
widget immediately updates it to show the most current real-time data from your network traffic.
Opening a Filter From a Widget
Widgets act as shortcuts to the event filters that are their data sources. This means you can open the
source filter directly from a widget. You do this by clicking the specific line, bar, or pie wedge of chart
that interests you. The corresponding filter then opens in the Monitor view. The filter lists only the
events that correspond with the chart item you selected.
To open a filter from a dashboard widget:
1. Open the Ops Center view.
2. In the dashboard, locate the widget you want to work with.
3. On the widget, click the specific line, bar, or pie wedge that interests you.
4. The Monitor view appears, with the event grid showing the filter that is the widget’s
data source. Note that the event grid lists only those events that correspond to the line,
bar, or pie wedge that you clicked. Also note that the filter is paused. Click Resume on
96
Chapter 7: Ops Center
the event grid toolbar to begin running the filter again.
Note: It is possible for you to select an item in the widget that is no longer shown in the Monitor's
event grid. That is, the filter may actually show fewer events than appear in the widget. This can
happen if the widget's scope is broader than the filter's scope. In this case, the filter may no longer
have some of the data shown by the widget, because the filter has had to make room for new data.
Remember, the widget's scope can be different than the filter's scope. The widget tracks statistics
about events that occurred over time (and perhaps a very large time frame). The filter tracks only a
certain quantity of events for a time frame that may be much smaller than the widget's scope.
To think about it another way: the Console filters are aware of 10,000 events at a time. With every
refresh interval, a widget looks at those 10,000 events to draw a line, bar, or wedge that matches the
right count for that time. Those 10,000 events are also displayed in the corresponding filter. But when
the Console gets to 10,000 events, the widget doesn't "erase" any data points it has already drawn,
but the filter has to remove the oldest events from the grid to make room for new data.
97
Editing a Widget’s Chart Presentation
Editing a Widget’s Chart Presentation
On the back of each widget there is a form that lets you change how the data is presented on the
widget. However, your options are limited to the type of widget you are working with and the type of
data it is reporting. For example, widgets that only report data in one dimension may be limited to a pie
chart, while information in two dimensions can be reported in a bar chart or a line chart.
To edit a widget’s presentation from the dashboard:
1. In the Ops Center dashboard, locate the widget you want to work with.
2. Click the configure
button on the widget toolbar.
3. The widget flips over to display its configuration options, as shown here.
4. Configure the widget, according to its configuration options. These options are a subset of the fields on the Widget Builder.
To arrange widgets on the dashboard:
1. Open the Ops Center view.
2. If needed, click Widget Manager to close the Categories and Widgets panes. This
provides the most space for arranging your widgets.
3. In the dashboard, drag a widget’s title bar to move that widget into a new position on the
dashboard. As you move the widget around the dashboard, the other widgets rearrange
98
Chapter 7: Ops Center
themselves and make room for your widget. Upon releasing the mouse button, the
widget snaps into place.
Resizing a Widget
You can view widgets in “full-screen” mode or in their normal size. You can also change the size of a
widget to make it taller or wider. However, the widget’s different sizes must conform to the
dashboard’s standard geometry.
To resize a widget:
In the Ops Center dashboard, drag the lower-right corner of the widget in any direction. As you resize
the widget, the surrounding widgets rearrange themselves to make room for the larger one. Upon
releasing the mouse button, the widget snaps to the closest size allowed by the desktop’s geometry.
To show a widget in full-screen mode:
In the Ops Center dashboard, click the Maximize
button on the widget’s toolbar. The widget
takes up the entire dashboard.
To restore a widget to its normal size:
In the Ops Center dashboard, click the Minimize
button on the widget’s toolbar. The widget
returns to its normal size.
Viewing a Widget’s Legend
Each widget bar chart, graph, and pie chart has a legend that explains what each bar, line, or wedge in
the chart represents.
To view a widget’s legend:
Click the widget’s legend
button. The chart legend appears, as shown here.
99
Widget Storage
Widget Storage
Widgets appear in two areas—the Ops Center and in the Monitor view’s Widgets pane:
l
In the Ops Center, master widgets always reside in the Widget Manager’s
Categories list. Dashboard widgets always reside on the dashboard. Dashboard
widgets cannot be saved in the Widget Manager.
l
In the Monitor view, each master widget appears in the Widgets pane for the filter that
acts as its data source. Dashboard widgets do not appear in the Monitor view’s
Widgets pane.
100
Chapter 8: Monitor
The Monitor view is the heart of the LEM Console. As the name implies, it is used for monitoring your
network activity. In Monitor, you create filters and widgets that group and display different events
that come from your Agents, Managers, and network devices.
Events are messages created from Agent, Manager, and network device log entries. These log
entries are processed (or normalized) to extract information and display the data in a common
column/field-based format, rather than the often convoluted format you see in the source data. These
normalized events are sent from the Agent to the Manager for processing. At the Manager, the events
are processed against your Rules, sent to your Database for archiving, and sent to the LEM Console
for monitoring.
Monitor View Features
The following table describes the key features of the Monitor view.
Name
Description
Filters button
Click the Filters button to alternately show and hide the Filters pane.
Filters pane
Stores all of the filters that you can apply to the Console’s event messages.
n
Click a filter name to apply that filter to the events grid. The events grid
refreshes to show only the incoming events allowed by the filter’s conditions.
n
Use the plus
button to create your own custom filters and filter groups.
n
Use the pane’s gear
button to edit, pause, resume, turn on, turn off,
import, export, or delete filters.
101
Chapter 8: Monitor
Name
Events grid
Description
Agents monitor each configured data source on your network. The Agents then
send events to your Managers. The Console's events grid displays every event
that is logged to each Manager the Console is connected to.
The grid’s title bar displays the name of that filter that is currently applied. By
default, incoming events always appear at the top of the grid. This allows the
Console to always show the most recent event activity first.
Respond menu Use this menu to actively respond to a particular event message. For example,
you can choose to block an IP address, or restart or shut down machine that is
the source of the event activity.
Explore menu
Use this menu to explore a particular event message or one of its specific data
elements with an explorer. The menu is context-sensitive. The contents of the
selected cell (called a string) determines which explorers you may choose from.
Pause/Resume This button toggles to pause or resume the event traffic that is currently being
reported by the filter.
This button lets you “highlight” rows in the events grid with a particular color.
Highlighting can serve as a helpful visual reference point for marking and locating
specific events in the grid.
The gear button in each row opens a menu of commands that you can perform on
the item that is currently selected in the grid. You can use these commands to
mark messages as read or unread, to remove messages, or to copy event
information.
Sort (▼ ▲)
When a filter is paused, you can click the column headers to sort the grid in
ascending (▲) or descending (▼) order by each of its columns
Filter
The Filter Notifications pane summarizes the event activity from each of your
Notifications
active notification filters—these are filters that use blink, popup, or sound
pane
notifications. Click a filter name in this tab to view the events associated with
that filter. This pane behaves exactly like the status bar's Notifications tab.
102
Filters and Filter Groups
Name
Widgets pane
Description
This pane displays the widgets associated with the filter that is currently applied
to the events grid. Widgets automatically refresh themselves to reflect changes
in events grid filtering.
You can use this pane view the different widgets associated with the filter,
change a widget’s visualization type (bar chart, pie chart, line graph, etc.), create
a new widget, edit an existing widget, or save a widget to the Ops Center
dashboard.
Event Details
Event Details and Event Description are two views of the same pane. This
and
pane displays detailed information about the last event to be selected in the grid.
Description
n
The Event Details view displays specific technical details about the event.
You can also use this view to create a filter based on the selected event, or to
scroll through the contents of the events grid.
n
The Event Description view displays a written description of the event that is
currently selected.
Notifications
The Notifications tab summarizes the event activity from each of your active
notification filters—these are filters that use blink, popup, or sound notifications.
Click a filter name in this tab to view the events associated with that filter.
Filters and Filter Groups
On a busy network, there can be millions of events each day. Therefore, the LEM Console uses event
filters to manage events. A filter is a subset of your events that focuses on a particular type or group
of events and hides all others. When configuring a filter, you can examine and use individual event
properties to determine precisely which events are to appear in that filter.
Filters apply at the LEM Console level. This means they apply to all data sent from every Manager
monitored by the LEM Console. Filters also display events in real time.
You can turn filters on and off, pause filters to sort or investigate their events, perform actions to
respond to events, and configure filters to notify you when they capture a particular event. Filters can
also display widgets, which are charts and graphs that visually represent the event data. Widgets are
described in more detail below.
103
Chapter 8: Monitor
LEM ships with many commonly used filters that support best practices in the security industry.
However, you can create your own custom filters, or modify existing filters to meet your needs. There
is no limit to the number of filters a LEM Console can contain.
Filters are managed in the Filters pane. The Filters pane stores all of
the filters that can be applied to the Console’s events grid.
Filter Attributes
The number next to each filter shows the total number of events that are
currently associated with that filter. Positioning your pointer over a filter
displays a Tooltip that briefly describes the purpose of each filter, when
such a description is available. Any filters that appear in italics are
currently turned off.
You can use the Filters pane to do any of the following tasks:
l
Create your own custom filters and reconfigure existing
filters to meet your needs.
l
Create filter groups for storing and organizing your filters.
l
Turn filters on and off, and pause them to stop the flow of event traffic.
l
Move filters from one filter group to another.
l
Copy filters.
l
Rename filters and filter groups.
l
Import and export filters.
l
Delete obsolete filters and filter groups.
Standard LEM Filters
LEM ships with some commonly used filters that support best practices in the security industry. Each
of these filters is described in the following table. They are listed alphabetically for easy reference.
The Default status column indicates if the filter is On (visible) or Off (hidden) by default.
104
Standard LEM Filters
To add your own custom filters, see "Utilizing the Console" on page 210.
Note: If you are installing an upgrade, LEM automatically converts your existing filters into the new
graphical format described in see "Utilizing the Console" on page 210.
Default
Filter
Description
status
Admin Account
Displays events for authentication to administrative-level
Off
Authentication
accounts.
All Events
Displays all events from all sources.
On
Change Management
Displays events for changes made to users, groups, and
On
devices.
Denied ACL Traffic
Displays events for network traffic that has been
Off
administratively denied.
Domain Controllers (all)
Displays all events from domain controller devices.
Off
Failed Logons
Displays failed logon attempts.
On
File Audit Failures
Displays FileAuditFailure events, which show failed
Off
attempts to access audited files.
Firewall
Displays all events from firewall devices.
On
FTP Traffic
Displays TCP Traffic to and from ports 20 and 21, indicating
On
file transfer activity on the network.
IDS
Displays all events from network intrusion detection devices.
On
Incidents
Displays all Incident Events.
On
Network Events
Displays all events in the NetworkAudit category of the
On
event tree.
105
Chapter 8: Monitor
Default
Filter
Proxy Bypassers
Description
Displays WebTrafficAudit events that are not from a proxy
status
Off
server. This can indicates an internal machine attempting to
access the Web directly, rather than by using the proxy
server.
Rule Activity
Displays InternalRuleFired and InternalTestRule events,
On
which indicate that Rules have been triggered.
Security Events
Displays all events in the SecurityEvent category of the
On
event tree.
Security Processes
Displays ProcessStart and ProcessStop events related to
On
critical security processes running on machines. These
processes include anti-virus, anti-spyware, and firewall
processes.
SMTP Traffic
Displays TCP traffic to and from port 25. It can also identify
On
potentially infected hosts.
SNMP Traffic
Displays network traffic to and from port 161. This filter can be On
used to discover network scan attempts and normal network
monitoring tools.
Subscriptions
Displays events from user rule subscriptions.
On
Events
Displays all events in the InternalEvent category of the event On
tree.
Unusual Network Traffic Displays events in the NetworkSuspicious branch of the
On
event tree, which indicate that potentially suspicious or
unusual network activity may be occurring.
USB File Auditing
Displays file-related events from Agents with USB-Defender
On
installed.
USB-Defender
Displays events from USB-Defender technology that are
related to insertion and removal of USB devices.
106
On
Filter Creation
Default
Filter
Description
status
User Logon
Displays UserLogon events where the logon type indicates a On
(interactive)
user physically logging on at a machine, or interactively
logging on to a remote desktop.
User Logons
Displays all UserLogon events from all sources, indicating
On
varying types of user authentication and access.
Virus Attacks
Displays all VirusAttack events. VirusAttack events are
Off
created when virus scanners detect potentially malicious
virus activity.
Web Traffic for
Displays WebTrafficAudit events that match a specific
Source Machine
source machine. This filter can be used to track a single
Off
machine’s web activity to discover potentially abusive
activity.
Web Traffic – Spyware
Displays WebTrafficAudit activity to and from URLs that are Off
indicated by the Spyware Sites User-Defined Group to be
potentially malicious websites.
Filter Creation
The Monitor view has a Filter Creation tool where you create and edit your own custom event
filters, as well as edit any existing filters. Use this form to name, describe, configure, and verify your
filters.
Event filters are based on specific Events or Event Groups. You configure them by dragging and
dropping the filter’s Event attributes into configuration boxes. When an Agent or Manager reports an
event that conforms to the event filter’s conditions, the event message appears in the events grid,
whenever that filter is active.
Each filter created is added to the Filters pane. Selecting the filter causes it to become the active
filter in the events grid. As with other filters, the events grid show only those event messages that
meet your filter’s requirements.
107
Chapter 8: Monitor
The possibilities for event filters are endless, so this section describes how to create filters in general
terms. This section is not intended to be a tutorial, but rather a reference for you to fall back on if you
are unclear about how any of the custom filter form’s elements, commands, or functions perform.
The tools in Filter Creation are very similar to those found in Rule Creation. Filters report event
occurrences, so there is no harm if you create a filter that is unusual or has logic problems. But this is
not the case when building rules—creating an incorrect rule can have unpleasant consequences.
Therefore, creating filters with Filter Creation is an excellent way to familiarize yourself with the
logic and tools needed to create well crafted rules.
Features of Filter Creation
Each element of the form is described in the following table.
Name
List pane
Description
This “accordion” pane is called the list pane. It contains categorized lists of the
events, event groups, event variables, groups, profiles, and constants that you can
use when creating conditions for your filters
If more than one Manager is linked to the Console, each item in the list pane lists
the Manager it is associated with. Therefore, some list items may appear to be
listed multiple times. But in reality, they are listed once for each Manager. Events
are universal to all Managers,so they do not show a Manager association.
Filter
Use the top part of the form to name and describe the filter, so you can quickly
identification identify it.
section
Filter Status
The Filter Status bar lists warnings and error messages about your filter’s current
bar
configuration logic.
n
Click >to view a list of warning and error messages.
n
Click a message flag to provide detailed information about the nature of that
problem.
n
Click a message to highlight the specific area or field that is the source of that
problem.
108
Features of Filter Creation
Name
Description
Conditions
Use this box to define the conditions for the data that is to be reported by the filter.
box
You configure conditions by dragging items from the list pane into the Conditions
box.
Notifications Use this box to define how the Console is to event users of event events, such as
box
sound, pop-up message, etc.
Undo/Redo
Click the Undo button to undo your last desktop action. You can click the Undo
button repeatedly to undo up to 20 steps.
Click the Redo button to redo a step that you have undone. You can click the Redo
button repeatedly to redo up to 20 steps.
You can only use Undo or Redo for any steps you made since the last time you
clicked Save.
Save/Cancel Click Save to save your changes to a filter, close Filter Creation, and return to the
events grid.
Click the Cancel button to cancel any changes you have made to a filter since the
last time you clicked Save, exit Filter Creation, and return to the events grid. If you
have any unsaved changes, the system prompts you to confirm that you want to
cancel.
109
Chapter 8: Monitor
Events
The topics in this section explain how to use the events grid to apply filters to incoming event traffic. It
also explains how to use the events grid to pause, sort, highlight, copy, read, remove, explore, and
respond to events to take preventive or corrective action.
Applying a Filter to the Events Grid
In the Monitor view, each item listed in the Filters pane represents a different event filter. You can
filter the events coming into the Console by selecting any of these items.
To apply a filter:
1. Open the Monitor view.
2. In the Filters pane, click the title bar of the filter group you want to work with. The filter
group opens to list the filters that are available for that group.
3. Select the filter you want to apply to the events grid.
The events grid title bar displays the name of the filter you have selected, and the grid
refreshes to display only those events that meet the special conditions of that filter.
Sorting the Events Grid
You can sort the events grid by any of its columns by clicking its column headers. Doing so also
changes how the graph is sorted. However, you must pause the events grid before you can sort it.
Pausing the grid temporarily stops the incoming flow of event traffic.
For example, if you click the Event Name column header, the grid becomes sorted by event names
in ascending order. If you click the column header again, it sorts the grid by that column in descending
order.
110
Highlighting Events
To sort the events grid:
1. On the events grid toolbar, click Pause.
2. Sort the grid as you normally would. You can also sort the grid by more than one
column.
3. When you are finished working with the sorted grid, click Resume to continue receiving
the filter’s unsorted event traffic.
Highlighting Events
In the Monitor view’s events grid, you can highlight events to call attention to them or mark them for
future reference. This allows the events to really stand out as you scroll through the contents of the
grid. You can highlight multiple events at the same time. You can also choose the color you want for
each set of events you are highlighting.
To highlight events:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with. The events grid
displays the filter you have selected.
3. On the events grid toolbar, click Pause to temporarily stop any incoming events.
Note: It is not required to pause a filter to highlight its events; however, it is convenient.
Pausing temporarily stops the flow of event traffic (freezing any event movement in the
grid) so you can easily select each item.
4. In the events grid, click to select the events you want highlighted.
5. On the events grid toolbar, click the ▼ arrow next to the “highlight”
button.
6. Use the color picker to select the highlight color you want. You can also type the
hexadecimal value of any color in the Web-safe color palette. In the grid, the selected
events become highlighted in the color you chose.
111
Chapter 8: Monitor
7. Click Resume to continue the flow of incoming event traffic.
To highlight more events with the same color:
1. In the events grid, click to select the events you want highlighted.
2. Click the "marker" part of the events grid’s “highlight”
button. The selected events
become highlighted with the marker color.
To turn an event’s highlighting off:
1. (Optional) On the events grid toolbar, click Pause to temporarily stop any incoming
events.
2. In the events grid, select the events for which you want to remove highlighting.
3. On the events grid toolbar, click the ▼ arrow next to the “highlight”
click the No Color
button. Then
button. The highlighting is removed from the events.
4. Click Resume to continue the flow of incoming event traffic.
Copying Event Data to the Clipboard
When needed, you can copy event data from the Monitor view's events grid or Event Details pane to
your clipboard. This allows you to paste the data into another application, such as Microsoft Excel, for
comparison or analysis, to share the data with someone who does not have a Console, or to send to
SolarWinds for technical support. You can copy the data for a single event or for multiple events.
112
Marking Events as Read and Unread
To copy event data from the events grid:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with. The events grid
displays the filter you have selected.
3. In the events grid, click to select the events you want to copy.
4. Click the events grid’s gear
button and then click Copy.The event data is now
copied to your clipboard (as text), where it can be pasted into another application.
To copy event data from the Event Details grid:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with. The events grid
displays the filter you have selected.
3. In the events grid, click to select the event you want to work with.
4. In the Event Details pane, click to select the rows you want to copy.
5. Click the events grid’s gear
button and then click Copy. The selected event
details are now copied to your clipboard (as text), where it can be pasted into another
application.
Marking Events as Read and Unread
You may want to mark the events in event filter as being unread and read. A read event is one that
you have already looked at. An unread event is one you have not looked at yet. By marking events
this way, you can easily track which events you have already examined.
To mark events as read and unread:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with.The events grid
displays the filter you have selected.
113
Chapter 8: Monitor
3. In the events grid, select the events you want to mark as read or unread. Skip this step
if you are going to mark all of the events as read or unread.
4. Click the events grid’s gear
button, and then select one of the options listed in the
following table.
Command
Description
Mark
Select this command to mark the selected events as unread. This
Unread
means you have not looked at them yet. Unread events appear in bold
text. When a filter has the “read/unread” feature turned on, any of its
events that are captured by other filters will appear as unread in those
filters, too.
Mark
Select this command to mark the selected events as having been read.
Read
Events marked as “read” appear in normal text, rather than bold text.
Mark All
Select this command to mark all of the events in the active filter as
Unread
unread. This means you have not looked at them yet. Unread events
appear in bold text.
Mark All
Select this command to mark all of the events in the active filter as
Read
having been read. Events marked as “read” appear in normal text, rather
than bold text.
The grid refreshes to show each row’s read/unread status.
Removing Events
When needed, you can remove individual events from a filter, or all of the events from a filter. You
may want to do this to clean a filter of historical information that is no longer important to you.
To remove individual events:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with. The events grid
114
Using the Event Details/Event Description Pane
displays the filter you have selected.
3. In the events grid, select the events you want to remove.
4. Click the events grid’s gear
button, and then click Remove. The selected events
are removed from the grid.
To remove all events:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to work with. The events grid
displays the filter you have selected.
3. Click the events grid’s gear
button, and then click Remove All. All of the filter’s
existing events are removed from the grid. The filter will now show only new incoming
events.
Using the Event Details/Event Description Pane
In the Monitor view, the right half of the lower pane has two different views to show the properties of
the event that is currently selected in the events grid: l
The Event Details view displays detailed information about the event that is currently
selected in the grid. If more than one event is selected, it shows the properties of the
last event to be selected.
l
The Event Description view displays a written description of the last event to be
selected in the grid.
You can also use this pane to create a filter based on the selected event, or to scroll through the
contents of the events grid.
115
Chapter 8: Monitor
The Event Details view
Button
The Event Description view
Description
Click this button to create a new filter that captures the currently selected event type.
Upon doing so, the Monitor view opens, with the new filter open in the events grid. The
new filter appears in the Filters pane, under the last selected filter. If needed, you can edit
the filter so it captures events of an even more specific nature.
Click these buttons to move up and down among the events in the event event grid. The
pane shows detailed technical information about each event that is selected. This lets you
view the technical details and written descriptions of each event in the grid.
Remember, you can also use your keyboard's up (↑) and down (↓) arrow keys: n
To cycle through the events in the events grid, click anywhere in the event event grid.
Then use your up and down arrow keys.
n
To cycle through the fields in the Event Details pane, click anywhere in the Event
Details grid. Then use your up and down arrow keys.
116
Event Severity Levels
Button
Description
Click this button to open the pane’s Event Details view. This view shows detailed
information about each of the selected event's data fields. The actual fields that appear
here vary, according to the event type that is currently selected. For example, networkoriented events show fields for IP addresses and ports. Account-oriented events show
account names and domains.
Click this button to open the pane’s Event Description view, which provides a detailed
written description of the event type that is currently selected.
Click the Print button to print this information from either view.
Event Severity Levels
Each event is assigned a number that indicates its severity. The following table explains each
severity level.
Level
0
Name
Debug
Description
Designates detailed event information used for debugging by SolarWinds
engineers.
1
System
Indicates that part of the system is unusable.
Error
2
Informational Indicates SolarWinds informational messages only.
3
Normal Audit Indicates normal behavior, but could be part of a signature attack.
4
Normal
Indicates normal behavior that should be monitored.
Notice
5
Suspicious
Indicates normal behavior under some circumstances, but should be
investigated.
6
Threatening
Indicates that investigation is needed and possibly an action.
7
Critical
Indicates that immediate action is needed.
117
Chapter 9: Explore
The Console's Explore area has two views: l
The nDepth view contains a powerful search engine that lets you search all of the
event data or the original log messages that pass through a particular Manager. The log
data is stored in real time, as it originally occurs from each host (network device) and
source (application or tool) that is monitored by the Manager.
nDepth summarizes and displays search results with several different visual tools that
can also be combined into a customizable dashboard. The tools are intuitive and
interactive—you can point and click to view information or refine your searches. Each
graphical tool provides an alternative view of the same data, so you can examine your
data from several perspectives. You can also view and explore a text-based view of the
actual data.
nDepth employs drag-and-drop tools that let you configure simple or even complex
search criteria. You can use these tools to dig deeper into your findings by adding
search conditions, or by appending text to existing search strings. nDepth also includes
a tool called Search Builder that lets you configure complex search criteria using the
same sort of drag-and-drop interface found in Filter Creation.
Many of the explorers are utilities used for finding out more about event specific details,
such as looking up IP addresses, domain names, and host names. The Event explorer
lets you view all of the events related to an event message. It is designed to help you
visualize how the event occurred and the system's response to that event. You can
follow the chain of events that caused the event, and help determine its root cause.
l
The Utilities view contains several utilities, called explorers. You can think of this view
as a center for investigating events and their details.
nDepth
nDepth is a powerful search engine that lets you search all of the event data or the original log
messages that pass through a particular Manager. The log data is stored in real time, as it originally
occurs from each host (network device) and source (application or tool) that is monitored by the
118
Chapter 9: Explore
Manager. You can use nDepth to conduct custom searches, investigate your search results with a
graphical tools, investigate event data in other explorers, and take action on your findings.
nDepth's Visual Tools
nDepth summarizes and displays search results with several different visual tools that can also be
combined into a customizable dashboard. The tools are intuitive and interactive—you can point and
click to refine your searches. Each graphical tool provides an alternative view of the same data, so
you can examine your data from several perspectives. You can also view and explore a text-based
view of the actual data.
nDepth employs drag-and-drop tools that let you configure simple or even complex search criteria.
You can use these tools to dig deeper into your findings by adding search conditions, or by appending
text to existing search strings. nDepth also includes a tool called Search Builder that lets you
configure complex search criteria using the same sort of drag-and-drop interface found in Filter
Creation.
nDepth's Primary Uses
You can use nDepth to do any of the following:
l
Search either normalized event data or the original log messages. You can also use
nDepth to explore log messages that are stored on a separate nDepth appliance.
l
Intuitively view, explore, and search significant event activity. nDepth summarizes
event activity with simple visual tools that you can use to easily select and investigate
areas of interest.
l
Use existing filter criteria from the Monitor view to quickly create similar searches.
l
Create your own custom widgets for the nDepth Dashboard.
l
Conduct custom searches. You can also create complex searches with the Search
Builder, which is a tool that behaves just like the Filter Builder. You can also save any
search, and then reuse it at any time by clicking it.
l
Save and reuse custom searches.
119
Exploring Events vs. Log Messages
l
Schedule saved searches
l
Export your findings to a printable report in PDF format, or your search results to a
spreadsheet file in CSV format.
l
Use the Explore menu to investigate nDepth search results with other explorers.
l
Use the Respond menu to take action on any of your findings.
l
Export your findings to a report in PDF format.
Exploring Events vs. Log Messages
LEM has two data storage areas — one to store the messages from the original event logs, and one to
store the normalized event data that the Console reports in the Monitor view. You can use nDepth to
explore either one of these sources:
l
In Events mode, nDepth summarizes and explores your event data. This is the
normalized data that appears in the Monitor view and is stored in the LEM database.
l
In Log Messages mode, nDepth summarizes and explores the raw log messages that
are going into nDepth Log Storage from the original event logs. This mode is intended
for customers who have specific data analysis needs, and who fully understand how to
interpret the raw log messages that are generated by their network devices and tools.
Note: The virtual appliance must be configured to store log message data. For more information, see
the following KB article, "Configuring Your LEM Appliance for Log Message Storage."
Be aware that data storage is limited. If you have not configured a CMC option for archiving data,
LEM will delete the oldest data to make room for new data.
The topics in this chapter explain how to perform a basic searches with nDepth, how to use nDepth's
graphical tools, how to use nDepth with other explorers, and how to respond to your findings.
Opening nDepth
You can open nDepth several ways. You can open the Explore >nDepth view directly to conduct
custom searches. Or you can open nDepth from an existing data source, such as an event field or
another explorer (NSLookup, Whois, and Traceroute, and Flow), to search for similar events or data.
120
Chapter 9: Explore
By default, the nDepth search time is for the last 10 minutes (the end time is now, and the start time is
10 minutes ago).
Opening nDepth From Another Data Source
1. Do one of the following:
l
In the Monitor view’s event grid, select the event row or field you want to
explore.
l
In the Event explorer’s Event Details pane, event map, or event grid,
click the item or field you want to explore.
l
In an explorer, select the data source you want to explore.
2. In the Explore menu on the Event grid, click nDepth.
The Explore >nDepth view appears, and the nDepth search box contains the event or
event field you are exploring.
When you initiate an nDepth search from the Monitor view, nDepth automatically
searches all hosts and sources for every instance of the selected event field that has
occurred within a ten-minute period around the event you are exploring. This way, you
can identify similar events that occurred before and after the event you are exploring.
The following table describes the key features of the Explore >nDepth view.
Name
Description
History button
Alternately hides and opens the History and Saved Searches panes.
History pane
Shows recent Explore activity. This pane is shared between the Utilities view
and the nDepth view.For more information, see "Using the History pane" on
page 1.
121
Opening nDepth From Another Data Source
Name
Description
Saved Searches Lists any searches that you have saved. To begin using one of these searches,
pane
click it to run that search. You can edit, schedule, and save changes to your
saved searches. You can also save variations on these searches as new
searches.
nDepth explorer Use this window to create and run your searches, and to view, explore, and
respond to your search results.
Undo/Redo
Click the Undo button to undo your last action. You can undo up to 20 actions.
Click the Redo button to redo a step that you have undone. You can redo up to
20 actions.
Respond
Use this menu to initiate a response to a particular event, event, or data field.
Explore
Use this menu to explore a particular data field with another explorer.
Click the gear
button to do any of the following:
n
Click Save to save any changes to the current search.
n
Click Save As to save the search for later use.
n
Click Schedule to create a scheduled search.
n
Click Delete Schedule to delete a scheduled search.
n
Click Export to export nDepth's current search results to a PDF document.
122
Chapter 9: Explore
Name
Search bar
Description
Use the search bar to:
n
Select the type of data you want to explore—event data (default) or the
original log messages.
n
Select the mode for configuring searches—drag and drop, or text entry.
n
Configure and select the search's time frame.
n
Run the search.
n
Stop a search that is in progress.
or detailed information on the search bar, see nDepth's Search Bar
List pane
The list pane is the “accordion” list on nDepth's left side. It contains categorized
lists of items that you can use when configuring search conditions. To use a list
item as a search condition, double-click it, or drag it from the list into the search
bar. You can also drag these items into the Search Builder to quickly configure
complex searches.
Two of these lists appear only in nDepth:
n
The Refine Fields list categorizes and lists the primary data details that are
found in your nDepth search results. You can use these details to create,
refine, or append nDepth searches.
n
The Managers list includes each Manager and appliance that can be used
with nDepth for searching data.
Histogram
Shows the number of events or log messages that were reported within a particular period. You can expand or reduce this period, as needed. You can also
zoom in to a period to take a closer look, or zoom out to see high-level activity.
123
Scheduled Saved Searches
Name
Explorer
Description
Shows different graphical and text-based views of your search results, as well
as a Dashboard view and the Search Builder. You can click items in each
graphical view to search for those specific items. The title bar states which view
is open, and the icon on the title bar indicates which type of data you are
exploring:
means you are exploring event data.
means you are exploring log messages.
Toolbar
Use to select the nDepth explorer view you want to work with.
Scheduled Saved Searches
Saved searches can be scheduled to run automatically whenever you want. Scheduled Searches can
also be shared between users.
To schedule a Saved Search:
1. Select a Saved Search from the Saved Searches pane .
2. Click the gear
button and select Schedule.
3. Select the Run Search option you desire.
4. Select the Start Date of the search.
5. Select the Create an event checkbox.
6. If you wish to send email, select the Send email checkbox, and then select the
recipients from the drop-down list.
7. Click OK.
124
Chapter 9: Explore
Note: If the virtual appliance is offline for some time (such as more than a day or two),
the schedules that are run when the virtual appliance first comes back online may not
run at the expected time. The schedules run at the next expected time after the
appliance has been back online for a time.
nDepth's Search Bar
You can use the nDepth search bar to search all of the event data or the original log messages that
pass through a particular Manager. You can use the search bar to perform simple searches and to
append searches with basic search strings
Tip: You can use the search bar to configure highly specific or complex searches; however, this is
more easily done with Search Builder. To open Search Builder, click the search bar. The searches
you configure in Search Builder automatically appear in the search bar.
The following table describes the key features of nDepth's search bar.
Name
Description
Mode
Use this toggle switch to select how you intend to enter the search string for your
selector
queries:
n
Select Drag & Drop Mode (upper position) to drag items from the list pane or the
Result Details view directly into the search box. This is the recommended position,
as it is it the easiest to use.
n
Select Text Input Mode (lower position) to type a search string directly in the search
box. In this mode, the search box also shows the text version (or search string) of any
search that is being run or configured in Search Builder or the Saved Searches pane.
Search
This box contains your search conditions. You can enter search conditions a number of
box
different ways.
Click a delete button next to a condition or a group to remove that condition or group from
the current search configuration.
125
nDepth's Search Bar
Name
Description
AND The search bar includes AND and OR operators. These operators let you include AND
and OR relationships between conditions and groups of conditions, when you have
OR
multiple conditions in your search string. Click the operator icon to toggle between
AND and OR relationships.
Group
When you have a group of conditions, the search bar displays the conditions as a sum-
summary mary. To see the actual conditions, point to them. A ToolTip appears that shows each
condition in the group.
Click this Delete All button to delete the entire contents of the search box, so you can
begin a new search.
Click this button to begin a search, or to stop a search that is in progress.
n
Click
to begin searching.
n
If the search button turns red
n
Click
, it means the current search configuration is invalid.
to stop a search that is in progress.
Time
In the time selector, select a time frame for the search. If needed, you can create your
selector
own custom time frame
Data
Use this toggle switch to choose the data you want to nDepth to explore:
selector
n
Select Events (left position) to search LEM's normalized event data. This is the event
data that appears in the Monitor view.
n
Select Log Messages (right position) to search the actual log entries that are
recorded on your network products' log files. If Log Messages is disabled, it means
your equipment is either disabled, or it does not have the capacity to store and search
the original log messages. However, you can still search the data in the Events
position.
126
Chapter 9: Explore
nDepth Explorer Toolbar
nDepth explorer toolbar
The following table describes the function of each option on the nDepth explorer toolbar. Each option
provides a different view of the data from nDepth's most recent search.
Tool
View
Description
Dashboard Opens the nDepth Dashboard. This is nDepth's default view. It shows each
nDepth view of the current search data as a small widget. You can minimize
and maximize each widget, as needed. You can also edit the chart widgets to
change their appearance.*
Word
Opens the Word Cloud, which shows keyword phrases that appear in your
Cloud
event data. Phrases appear in a size and color that relates to their frequency.
You can filter this view to zero in on a range of activity. You can also click a
phrase to create or append a search based on that phrase.
Tree Map
Opens the Tree Map, which shows the items that appear most often in the data
as a series of categorized boxes. The box categories correspond with the
those data categories found in the Refine Fields list.
The size of a box within each category is associated with its relative
frequency. The more often an item occurs, the larger its box appears. If a box
is small, you can point to it to open a ToolTip that shows its contents. You can
also click a box to create or append a search based on that item.
Bar Charts Opens the Bar Charts* view, which is a group of widgets that shows your most
frequent data items as a series of bar charts. The size of each bar corresponds
with the item's relative frequency. The more often an item occurs, the larger its
bar appears. You can point to a bar to show information about it. You can also
click a bar to create or append a search based on that item.
127
nDepth's History Pane
Tool
View
Description
Line
Opens the Line Charts* view, which is a group of widgets that shows your
Charts
most frequent data items as a series of line graphs. The height of point on the
graph corresponds with the item's relative frequency. The more often an item
occurs, the higher the point appears on the graph. You can point to a item on
the graph to show information about it. You can also click a point on the graph
to create or append a search based on that item.
Pie Charts Opens the Pie Charts* view, which is a group of widgets that shows your most
frequent data items as a series pie charts. The size of each pie wedge corresponds with the item's relative frequency. The more often an item occurs, the
larger its wedge appears. You can point to a wedge to show information about
it. You can also click a wedge to create or append a search based on that item.
Bubble
Opens the Bubble Charts* view, which is a group of widgets that shows your
Charts
most frequent data items as a series of circles or "bubbles." The size of each
bubble corresponds with the item's relative frequency. The more often an item
occurs, the larger its bubble appears. You can point to a bubble to show
information about it. You can also click a bubble to create or append a search
based on that item.
Result
Opens the Result Details view, which is a text-based view of all of the data
Details
you are investigating. This view also supports nDepth's search capabilities by
letting you create or refine searches by dragging and dropping search strings
from the data into the search box.
Search
Opens nDepth's Search Builder, which is a graphical interface used to create
Builder
and refine complex searches. You can drag items from the nDepth's list pane
directly into Search Builder's Conditions box to quickly configure complex
searches. With a few minor differences, Search Builder behaves just like the
Filter Creation tool.
*In any explorer view, if a particular chart configuration does not logically apply to the data you are
exploring, that chart will be disabled.
nDepth's History Pane
Each nDepth explorer search adds an item to the Explore view’s History pane.
128
Chapter 9: Explore
represents a search of event data.
represents a search of original log messages.
The history item shown below is for an nDepth search of event data. Pointing to the item's history
icon also displays the number of search results and the text of your search string.
A new search always adds a history item. If you click an earlier history item, the system takes you
back to that search; it does not make a new item. As soon as you change something in nDepth and
perform a new search, that search becomes a new history item.
Using the nDepth Histogram
nDepth's histogram shows the number of events or log messages that were reported within the
search's time frame. nDepth returns search results chronologically, so you can use the histogram to
investigate a particular interval, to move the search period, to zoom in to a period to take a closer
look, or zoom out to see high-level activity.
nDepth's histogram summarizes event activity within a particular period. This histogram is for a search of the last 10 minutes of
event activity. The bright zone shows the period that is currently being reported. The gray zones show activity outside of the
reported period.
129
Histogram Features
This example shows the histogram for a search that covers a recent 10-minute period of activity. For
this search, the bottom time bar is divided into one-minute intervals. The bar above that is divided into
half-minute (30-second) intervals. The histogram displays a separate bar for each 30-second interval.
Histogram Features
The histogram has the following features:
l
The title bar shows the total number of events that were reported by the search, as well
as the search's time frame.
l
The gray zones preview results that are outside the search's time frame.
l
Each vertical bar in the histogram shows the total number of events that happened
within the corresponding period.
l
Time is provided in 24-hour (military) time.
l
Pointing to a bar shows the total number of events in that interval, as shown above.
l
Clicking a bar opens a pop-up window that shows a histogram for that bar's interval.
Depending on range of the search's time frame, these intervals can be as little as 5seconds. Pointing to a bar shows the total number of events that occurred in that
interval.
Clicking a bar opens a pop-up window to show a histogram for that bar's interval
130
Chapter 9: Explore
l
When you are in the Result Details view, the histogram shows two dashed vertical
lines. These lines are markers that indicate where you are in the histogram for each
page of the search results. The lines show the times of the first and last event on the
current Result Details page.
By default, the ▲ pointer shows the time of the first result on the page. If you select an
event in the Result Details box, the pointer shows the time of that event.
Example: If you are looking at the search results of events number 1-200, the left line
shows the time of event number 1, and the right line shows the time of event number
200. If you click event number 150, the ▲ pointer shows the time that event occurred.
Searching the Activity Associated with a Particular Histogram Bar
You can use the histogram to search the event activity associated with a particular vertical bar in the
histogram.
To search activity for a bar:
l
In the histogram, double-click a vertical bar.nDepth automatically refines the search
and refreshes the data to show only the events from the time frame associated with
that bar.
Moving the Search Period
You can use the nDepth histogram to move the search period to an earlier or later start time. For
example, say you run a search for a 30 minute time frame. This procedure lets you search the data for
the same period (still 30 minutes), but from a different starting point (maybe with a starting point of 2
hours ago).
131
Changing the Period's Start and End Time
To move the search period:
1. Point to the histogram's time bar. A slider appears. You can use this slider to move the
same search period to an earlier or later starting point. For example, if the search period
is 10 minutes, this slider moves that 10-minute period to an earlier or later starting point.
This lets you search your data for the same period, but at some other starting point.
2. Drag the slider to move the search's period:
l
Drag the slider to the left to move the period to an earlier starting point.
l
Drag the slider to the right to move the period to a later starting point.
As you move the slider, a ToolTip displays the period's midpoint time.
3. Click
to run the search for the new time frame.nDepth automatically refines the
search and refreshes the data to show only the events from the new time frame.
Moving the period automatically changes the search bar's time selector to Custom.
4. If desired, click
to restore the previous time frame.
Changing the Period's Start and End Time
You can use the nDepth histogram to change the search period by changing its start time and end
time. For example, say you run a search for a 30 minute period. This procedure lets you expand the
time frame (say to 40 minutes) or reduce the time frame (say to 23 minutes).
132
Chapter 9: Explore
To change a period's start or end time:
1. Point to anywhere on the histogram's vertical bars. Two sliders appear between the
active time and the gray zones. You can use these sliders to expand or reduce the
search time frame by changing its start time or end time.
2. Drag the sliders to change the search's time frame:
l
Drag the left slider to change the time frame's start time. When you
release the slider, a ToolTip shows the new start time.
l
Drag the right slider to change the time frame's end time. When you
release the slider, a ToolTip shows the new end time.
3. Click
to run the search for the new time frame.nDepth automatically refines the
search and refreshes the data to show only the events from the new time frame.
Changing the time frame automatically changes the search bar's time selector to
Custom.
4. If desired, click
to restore the previous time frame.
Using Result Details
Whenever you use nDepth, you can view the actual data the graphical views are based on by opening
the Result Details view. Result Details is a text-based view of all of the data you are investigating.
However, Result Details also supports nDepth's search capabilities, by letting you create or refine
searches by dragging and dropping search strings from the search data into nDepth's search box.
You can use Result Details in Events mode to view and search the normalized event data found in
133
Interpreting Search Results in Events Mode
the Monitor view, or in Log Messages mode to view and search the original log message data that is
collected and stored on the LEM (or some other dedicated nDepth appliance, as applicable).
You can use nDepth's search results to refine your nDepth searches, to explore event details with
other explorers, or to initiate an active response to event details.
The following topics describe the key features of the Result Details view, as well as how to perform
the primary tasks associated with this view.
Interpreting Search Results in Events Mode
In Events mode, you can use nDepth to search all of the normalized event data that is reported in the
Monitor view. This data always comes from LEM.
The following table explains how to interpret search results of data in Events mode.
Name
Event number
Description
The number to the far left is a counter for each event that is reported in the nDepth
search results. Each event gets its own number.
Each row represents a different event. To make viewing easier, each event
appears with an alternating gray or white background. The number of events that
appear depend entirely on your search conditions.
Data and time
The time and date the event occurred.
stamp
Event name
The name of the event that occurred.
Event details
The rest of the information in the box is made up of event details. You can select
these details to refine your nDepth search, to explore them with other explorers,
or to respond to them with an active response.
Interpreting Search Results in Log Messages Mode
In Log Messages mode, you can use nDepth to search all of the original log messages that pass
through a particular network appliance (or host).
134
Chapter 9: Explore
nDepth Result Details view, showing original log message data
The following table explains how to interpret search results of data in Log Messages mode.
Item
Name
Event number
Description
The number to the far left is a counter for each log message (or event)
that is reported in the nDepth search results. Each event gets its own
number.
Each row represents a different event.To make viewing easier, each
event appears with an alternating gray or white background. The number
of events that appear depend entirely on your search conditions.
Data and time
The time and date the event occurred.
stamp
Log message
The first line of event displays the actual log message that matched your
search criteria.
Host
The network device the message came from (that is, the Manager or
appliance that is storing the message).
ToolId
The actual product or tool that generated the message.
ToolType
SolarWinds's tool category for the tool that generated the message.
Note: Tool IDs and Tool Types match SolarWinds’s tool configuration
categories.
135
Adding Search Strings from Result Details
Adding Search Strings from Result Details
When using the Result Details view, use the following procedures to highlight and select character
strings, and to create new search conditions from the data.
To
Do this
Selecting data
Highlight a continuous
Point to the character string.
character string
Select a continuous character
string
Point to the character string to highlight it; then click to select it.
Upon selecting a character string, an orange box surrounds the
string. In addition, every matching character string in the search
results becomes selected, too.
Select a phrase (two or more
Click the first character in the string, then drag across the string
character strings separated by
to select the rest of it.
spaces)
Upon selecting a character string, an orange box surrounds the
string. In addition, every matching character string in the search
results becomes selected, too.
Select a data row
Click the row's event number (the far left column of the row).
When the row is selected, an orange highlight bar appears to the
left of the row.
Creating search conditions from Result Details data
Clear the search box to add a
new search condition
1. On the search bar, click
to clear the search box.
2. Add a new search condition by using any of the
techniques in this table.
136
Chapter 9: Explore
To
Do this
Add a search condition from
Select a character string in the data. Then double-click the
Result Details data
selected string to add it to the search box.
Select a character string in the data; then drag it into the search
box.
Copy and paste a character
string from Result Details data
1. Change the search bar to Text Input Mode.
2. Select a character string in the data.
into the search box
3. Press Ctrl+C to copy the search string.
4. Click the search box, and then press Ctrl+V to
paste the character string in the text box.
Type a search string in the
search box
1. Change the search bar to Text Input Mode.
2. Type the search string directly in the search box.
Add conditions to an existing
1. In the data, select the character string you want to
search
append to the existing search conditions.
2. Do either of the following: n
Double-click the selected string.
n
Drag the string into the search box.
In either case, your selection is appended to the
existing conditions.
Using Explorers with Result Details
You can use nDepth's Result Details view to access other explorers. This allows you to use other
explorers to investigate specific details that you find in your nDepth search results.
l
You can select specific values, and pass them into the value-based explorers, such as
Whois, NSLookup, and Traceroute. For example, you could investigate a suspicious
IP address with these explorers to learn more about that IP address.
137
Responding to Result Details
l
When you are viewing data in Events mode, each row in the search results represents
the data for an individual event. You can select the row for an event you want to
explore, and then pass the row into the Event Explorer to explore that event.
To explore details in search results:
1. In the Result Details view, select the item you want to explore: l
Select the character string you want to investigate. When selected
properly, the character string is surrounded by an orange box.
l
If you are viewing data in Events mode, you can select the row that you
want to explore in the Event Explorer. When you select a row, an orange
highlight bar appears to the left of the row.
2. In the Explore menu, select the explorer you want to use.
The Explore >Utilities view appears, and the system “passes” the selected data to the
explorer you selected.
3. Click Search or Analyze, as applicable, to explorer the string.
Responding to Result Details
As with other explorers, you can respond to any item that is reported in nDepth's search results. If
you see something unusual, you may want to take some kind of corrective action. For example, you
could send a user account a popup message, or block a hostile IP address. Use the following
procedure to initiate a response or corrective action to a particular event or event detail.
To respond to a search result:
1. In the Result Details view, select the character string you want to respond to. When
selected properly, the character string is surrounded by an orange box.
2. In the Respond menu, select which response you want to take.
If nDepth is in Events mode, the event or the selected text appears in the Respond
138
Chapter 9: Explore
form.
3. Complete the Respond form, as applicable for the response.
Exporting Result Details Data to a Spreadsheet
Use the following procedure to export your nDepth search results to a spreadsheet. This lets you
open, view, manipulate, and analyze your data in a spreadsheet application, such as Microsoft Excel.
Spreadsheets are saved in comma-separated values (.csv) format.
To export nDepth search results to a spreadsheet:
1. In nDepth, run the search you want to export.
2. Open the Result Details view.
3. Click the gear
icon and then click Export to CSV. The Save Data As form
appears.
4. Select the folder in which you want to save the file.
5. In the File name box, type a name for the file, if you want one different from the default
name given.
6. Click Save. The Console exports the data to a .csv file, in the folder you selected. To
stop this operation, you can click Cancel at any time before the data export is
complete. Once exported, you may open the file in a spreadsheet application.
Common nDepth Data Fields
These categories frequently appear in the Refine Fields list, the Tree Map view, and the Result
Details view.
Common Data Fields Categories in Events Mode
This table describes the data fields that are most commonly seen when working with event data. The
139
Common Data Field Categories in Log Messages Mode
fields are listed here alphabetically.
Field
Description
Event Name
The name of the event.
Detection IP
The network node that is the originating source of the event data. This is
usually a Manager or an Agent and is the same as the Insertion IP field, but
can also be a network device such as firewall or an intrusion detection
system that may be sending log files over a remote logging protocol.
Inference Rule
The name of the correlation that caused the event. The Inference Rule field
will generally be blank, but in cases where the event was related to a rule, it
displays the rule name.
Insertion IP
The Manager or Agent that first created the event. This is the source that
first read the log data from a file or other source.
IP Address
The IP address associated with the event. This is a composite field, drawn
from several different event fields. It shows all the IP addresses that appear
in event data.
Manager
The name of the Manager that received the event. For data generated from
an Agent, this is the Manager the Agent is connected to.
Provider SID
A unique identifier for the original data. Generally, the Provider SID field
includes information that can be used in researching information on the
event in the originating network device vendor's documentation.
Severity
The severity (0–7) of the event
Tool Alias
The Alias Name entered when configuring the tool on the Manager or Agent.
User Name
The user name associated with the event. This is a composite field, drawn
from several different event fields. It shows all the places that user names
appear in event data.
Common Data Field Categories in Log Messages Mode
This table describes the data fields that are most commonly seen when working with log messages.
The fields are listed here alphabetically.
140
Chapter 9: Explore
Field
Host
Description
The node the log message came from (that is, the LEM or Agent that collected the
message for forwarding to nDepth).
HostFromData The originating network device (if different than the node) that the message came
from. Normally, Host and HostFromData are the same, but in the case of a
remote logging device (such as a firewall) this field reports the original remote
device's address.
ToolId
The actual tool that generated the log message.
ToolType
Tool category for the tool that generated the log message.
Using the Word Cloud
nDepth's Word Cloud. You can use the sliders on the lower bar to filter the items shown in the World Cloud.
nDepth's Word Cloud summarizes your event activity by showing the top 100 keyword phrases that
appear in your event messages. Phrases appear in a size and color that relates to their frequency:
l
Phrases that appear in warmer colors (red, orange, and yellow) and in larger print
represent the phases that occur most frequently. You can think of these as your "hot"
items.
l
Phrases that appear in cooler colors (green and blue) and in smaller print are those that
occur with the least frequency. You can think of them as "cool" items. Cool items may
still be important; they just occur far less frequently than "hot" items.
141
Opening the Word Cloud
Opening the Word Cloud
l
On the nDepth toolbar, click the
icon.
Viewing Statistics in the Word Cloud
Word Cloud includes statistics about each item that is listed in the cloud.
To see statistics:
l
Point to a phrase in the Word Cloud. A ToolTip appears showing the keyword phrase,
its count (the number of times it occurs in the reported period), and its percentage. The
percentage is based on the phrase's relative frequency, compared to the other reported
phrases.
Filtering the Contents of the Word Cloud
There are two horizontal bars at the bottom of the Word Cloud:
l
The top bar is a color gradient that goes from red (hot) to blue (cool). These colors
correspond with the colors of the phrases shown in the Word Cloud.
l
The lower bar controls which parts of the gradient the Word Cloud is allowed to show.
You can use this bar to filter the World Cloud so that it only shows that section of the
gradient you want to see. By default, the Word Cloud shows everything associated
with the entire gradient—all items that are hot, cool, and in between.
By default, the Word Cloud displays the top 100 phrases, and the sliders are automatically adjusted
to this width. If you manually adjust the sliders, nDepth remembers the left position and automatically
adjusts the right position so the Word Cloud displays up to 100 phrases between the left and right
positions. If all 100 phrases can be shown within the positions you've selected, the sliders will stay in
place.
142
Chapter 9: Explore
Slider settings are remembered with each Word Cloud. This means you can create Word Clouds for
the Dashboard that are adjusted differently from the primary Word Cloud view.
To filter the contents of the World Cloud: l
To hide hot items, drag the lower bar's left-hand slider to the right.
l
To hide cool items, drag the lower bar's right-hand slider to the left.
l
To restore the Word Cloud, drag the sliders back to their far-left and far-right positions.
Exploring Items in the Word Cloud
You can use the Word Cloud to explore a particular phase, by using as the basis for a new search, or
to append an existing search.
To explore an item in the Word Cloud: 1. In the Word Cloud, click the phrase you want to explore. The phrase appears in the
search bar.
2. On the search bar, click the search
button.After a moment, nDepth refreshes to
show the results associated with your search.
143
Using the Tree Map
Using the Tree Map
nDepth's Tree Map
The items that appear in nDepth's Tree Map view are the same data field categories and values that
are listed in the Refine Fields list (at the top of the list pane).
l
When you are working with events, the Tree Map organizes itself into categories based
on common event data fields. Most categories correspond with actual event fields, as
they appear in the Monitor view.
l
When you are working with log messages, the Tree Map organizes itself into categories
based on common log message data fields.
Note: Some data categories may not always be present. If there is no event activity associated with
a particular data category or field, it will not appear in the Tree Map.
The size of each box corresponds with the relative frequency of its occurrence. So the more often a
detail occurs, the larger its box appears.
Click to select an item from the Tree Map as a search condition. If a box is too small to show its
contents, point to it to open a ToolTip that shows its contents.
144
Chapter 9: Explore
Opening the Tree Map
l
On the nDepth toolbar, click the
icon.
Resizing Tree Map Categories
Use the following procedures to resize each category box in the Tree Map is associated with the
relative frequency of its occurrence.
To maximize a category:
l
Click the
icon on the box's toolbar.
Note: Even when maximized, a Tree Map category can show very small items within
it. Don't forget, if a box is too small to show its contents, you can point to it to open a
ToolTip that shows its contents.
To restore a category to its proportional size:
l
Click the
icon on the box's toolbar.
Exploring items in the Tree Map
You can use the Tree Map to explore a particular item, by using that item as the basis for a new
search, or to append an existing search.
To explore an item in the Tree Map: 1. In the Tree Map, click the item you want to explore. A search string for that item
appears in the search bar.
2. On the search bar, click the search
button. After a moment, nDepth refreshes to
show the results associated with your search.
145
Using nDepth widgets
Using nDepth widgets
nDepth comes with a series of commonly used widgets. These widgets behave very much like the
widgets in the Ops Center. Each widget represents a high-level graphical view of the specific
network activity associated with your nDepth search results. It shows the primary items that are
generating that activity, as well as the count (or number of incidents) for each item.
A typical nDepth widget
You can use nDepth's explorer views to create new widgets, change the look of existing widgets, add
widgets to the nDepth Dashboard, and remove widgets you no longer user.
Default nDepth Chart Widgets
On the widget toolbar, click the refresh
button. The widget refreshes to show the latest data from
your network.
nDepth Explorer and Widget Icons
The following table briefly describes the function of each icon you will find on nDepth explorer views
and widgets.
146
Chapter 9: Explore
Icon
Description
From a main nDepth view (such as Word Cloud, Tree View, or Result Details), this button
add the view to the nDepth Dashboard as a widget.
From the nDepth explorer toolbar, you can point to a chart view and then click this button to
add a specific chart widget to the nDepth Dashboard.
Adds a new widget to the current chart view.
This button adds the widget to the nDepth Dashboard. This button only appears on widgets
in their various chart views.
Refreshes the widget so it displays the latest data.
This button is only enabled when the chart properties have changed. If you edit a chart's
configuration, the Console does not have the data to draw the chart until you refresh its data.
Opens the nDepth Widget Builder so you can edit or reconfigure the widget.
Minimizes the widget to it appears as a title bar at the bottom of the view.
To restore the widget, scroll down to the bottom of the view, and then click the widget's title
bar.
Toggles the widget between being its normal size and being maximized to fill the current
view.
Deletes the widget from the view. Once deleted, the widget cannot be restored; you must recreate it.
147
Viewing a widget's details
Viewing a widget's details
To view a widget's details, just click or point to an item on the widget
nDepth widgets behave a lot like widgets in the Ops Center. To view a widget's details, point to that
widget, or click an item on that widget to view details and statistics about that item, like in the pie
chart widget show here.
Creating a search string from a widget item
You can use items in widgets, or any of nDepth's graphical tools, to create new search strings, or to
append existing search strings.
To create a new search string from a widget:
1. On the search bar, click
to delete the existing search string.
2. Click an item on a widget. A new search string associated with the widget item appears
in search box.
To append an existing search string with an item from a widget:
l
Click an item on a widget.
148
Chapter 9: Explore
In the search box, a new search string associated with the widget item is appended to
the existing search string.
Adding new nDepth Widgets
Use this procedure to add a new widgets to the nDepth explorer's Bar Charts, Line Charts, Pie
Charts, or Bubble Charts views.
To add new nDepth widgets:
1. Open the Explore >nDepth view.
2. Use the nDepth explorer toolbar to open the chart view you want to work with—Bar
Charts, Line Charts, Pie Charts, or Bubble Charts.
The corresponding view appears.
3. On the view's title bar, click the New Widget
icon.
The nDepth Widget Builder appears.
4. Complete the nDepth Widget Builder to configure the new widget. For completing
instruction on completing this form, see "Using the nDepth Widget Builder" on page 1.
The new widget appears at the bottom of the chart view. When configuring the widget,
if you chose the Save to Dashboard option, the new widget also appears at the bottom
of the nDepth Dashboard.
Editing nDepth Widgets
When needed, you can edit the configuration of any of the chart widgets. You can edit widgets from
the Dashboard or from any of the chart views.
149
Adding a Chart Widget to the nDepth Dashboard To edit a chart widget:
1. Open the Explore >nDepth view.
2. Use the nDepth explorer toolbar to open the Dashboard or the chart view you want to
work with.
The corresponding view appears.
3. On the widget you want to edit, click the Edit
icon.
The nDepth Widget Builder appears.
4. Use the nDepth Widget Builder to reconfigure the widget.
The updated widget appears at the bottom of the view. When configuring the widget, if
you chose the Save to Dashboard option, the new widget also appears at the bottom
of the nDepth Dashboard.
5. Click
to get the data for the widget's new configuration, so the Console can draw the
chart.
Adding a Chart Widget to the nDepth Dashboard
At any time, you can add a chart widget to the nDepth Dashboard. You can do this from any of the
chart views, or directly from the nDepth explorer toolbar.
To add a widget to the nDepth Dashboard from a chart view:
1. Open the Explore >nDepth view.
2. Use the nDepth explorer toolbar to open the chart view you want to work with.
3. In the view, locate the chart widget you want to add to the Dashboard.
4. On the widget, click the Add to Dashboard
button.
The widget is copied to the bottom of the nDepth Dashboard.
150
Chapter 9: Explore
Adding a main nDepth view to the nDepth Dashboard
Use this procedure to add a main nDepth view (such as Word Cloud, Tree View, or Result Details) to
the nDepth Dashboard. These views are there by default; but if you ever remove them from the
Dashboard, you can use this procedure to restore them.
To add a main nDepth view to the Dashboard:
1. Open the Explore >nDepth view.
2. On the nDepth explorer toolbar, click the view you want to add to the Dashboard.
3. On the view's title bar, click the gear
icon, and then click Add to Dashboard.
4. The view now appears as a widget at the bottom of the nDepth Dashboard.
Using Search Builder
Use Search Builder whenever you need to need to create complex search queries.
Search Builder is a visual tool that is used in conjunction with the options in nDepth's list pane. The
list pane lets you choose which elements you want to incorporate in your search, such as events,
event fields, specific event values, Tool Profiles, User-Defined Groups, constants, etc. You then
create the search by selecting the conditions you want to search for, and then dragging and dropping
those items into Search Builder's Conditions box.
For example, if you want to search for activity among your Admin Accounts, you don't have to type a
search with a long list of account names. Instead, you can just drag the appropriate User-Defined
Group or Directory Service Group into the Conditions box.
Search Builder lets you group search items, show AND/OR relationships between search items,
select specific values for search items, and select the appropriate operators for specific values.
151
Opening Search Builder
Opening Search Builder
1. Open the Explore >nDepth view.
2. On the nDepth explorer toolbar, click the Search Builder
icon.
Switching from the Search Bar to Search Builder
You can open Search Builder directly from the nDepth search bar by double-clicking it. This is handy
152
Chapter 9: Explore
if you have a complex search and the search box shows only a summary of the search, because it
lets you open Search Builder to see the search's complete configuration. Search Builder always
shows the configuration of the search that is currently in the search bar.
The search bar and the Search Builder show different views of the same search configuration
To switch from the search bar to Search Builder:
l
Double-click the search bar.
Search Builder appears, showing the configuration of the search that is in the search
bar.
153
Search Builder features
Search Builder features
This topic shows the main features of Search Builder.
Search Builder
154
Chapter 9: Explore
The following table describes each main features of Search Builder.
Item
Name
Description
Undo/Redo Click the Undo button to undo your last action. You can undo up to 50 steps.
Click the Redo button to redo a step that you have undone. You can redo up
to 50 steps.
Search bar
The search box shows the current state of the search you are building. If you
have a complex search, the search box shows its configuration as a
"summary." If you want to view the complete text of the search, switch the
search bar to Text Input Mode, which shows the current search configuration as a search string.
List pane
This “accordion” pane is called the list pane. It contains categorized lists of
the events, event groups, event variables, groups, profiles, and constants
that you can use when creating conditions for your filters.
Two of the lists apply only to nDepth:
n
The Refine Fields list summarizes all of the primary event details from
your search results. Rather than typing this information as a search string,
it is much easier (and less prone to error) to drag this information from the
Refine Fields list into the search box.
n
The Managers list includes each Manager and appliance that can be used
with nDepth for searching data.
Histogram
Use the histogram to investigate a particular interval, to move the period, to
pane
zoom in to a period to take a closer look, or zoom out to see high-level activity.
After configuring the search, click
155
to begin the search.
Search Builder features
Item
Name
Description
Conditions Use this box to define the conditions for the data that is to be reported by the
box
filter. You configure conditions by dragging items from the list pane into the
Conditions box. For more information, see "Configuring filter conditions" on
page 1.
This is the Add Group button. It appear at the top of every group box. Click it
to create a new group within the group box. A group within a group is called a
nested group.
Each group is subject to AND and OR relationships with the groups around it
and within it. By default, new groups appear with AND comparisons.
This is the Delete button. It appears at the top of every Group box. When you
point to a condition, it also appears next to that condition. Click this button to
delete a condition or a group. Deleting a group also deletes any groups that
are nested within that group.
Group
Individual groups (and the entire Conditions box) can be expanded or
collapsed to show or hide their settings:
n
Click to >expand a collapsed group.
n
Click to ▼ collapse an expanded group. The number that appears in
parentheses indicates how many conditions are contained in the group.
Once a group is properly configured, you may want to collapse it to avoid
accidentally changing it.
AND
The Conditions box includes AND and OR operators, so you can include
AND and OR relationships between your search conditions.
OR
n
Click the operator icon to toggle between AND and OR conditions.
156
Chapter 9: Explore
Configuring a Search with Search Builder
Use this basic procedure whenever you need to configure a search with Search Builder. The number
of possibilities are endless. They they all follow this basic procedure.
Feel free to experiment with these tools. Searches report information, so there is no harm done if you
create searches that are unusual or have logic problems. With a little practice, you will be able to
configure complex searches that report exactly the data you want.
To configure a search with Search Builder:
1. Open Search Builder.
2. In the list pane, locate the item you want to search for.
3. Do one of the following:
l
Drag the item from the list pane into the Conditions box.
l
Double-click the item to add it to the Conditions box.
Note: By default, the Conditions box includes a "this item exists" condition. To use it,
type or paste the search string you want to search for into the text box. Or you can
replace this condition by dragging an item from the list pane on top of it.
4. If the list item contains a variable field (such as a field for an IP address, a constant
value, or an empty text box), type the specific value you want to search for.
Note: Search Builder will show you if a particular configuration is invalid. If a condition
field is yellow (left), it means the search's current configuration is invalid. If a condition
field is red (right), it means the condition does not apply to the type of data you are
currently searching. For example, perhaps you are trying to search log messages with
conditions that are meant for event data.
157
Configuring a Search with Search Builder
A yellow condition field means the search
A red condition means the search configuration does
configuration is invalid.
not apply to the type of data you are searching.
5. Click
to create new groups, as needed.
6. Repeat Steps 2 and 3, dragging new items into the appropriate group boxes, as needed.
7. Select the appropriate AND and OR operators for each group to configure the search to
your needs.
8. When you are satisfied with the search conditions, click
You can click
to run the search.
at any time to stop a search that is in progress.
After a few moments, nDepth returns the search results. To see the search results, do
one of the following: l
Select an option from the nDepth explorer toolbar to view a graphical
version of the search results.
l
Open the Refine Fields list to see a categorized summary of the search
data.
l
Open the Result Details view to examine and explore the actual data.
158
Chapter 9: Explore
Utilities
The following table describes the key features of the Explore >Utilities view.
Name
History pane
Description
The History pane displays a record of your explorer viewing history. Selecting
an item in the history list displays the corresponding explorer event in the
Explorer pane.
Click the History button to alternately show and hide the History pane. When
needed, you can delete individual history items from the history list. The Reset
button lets you remove all items from the history list.
Utilities pane
The Utilities pane shows the explorers that are currently open. You can have
multiple explorers open at the same time.
Cascade button
This button arranges the open explorer windows so they appear in an
organized “cascade.” Their title bars are all visible, but the windows are all
stacked, one on top of another. The active explorer is at the front of the stack.
Respond menu
This menu lets you take action to respond to the event or event field that is the
subject of the active explorer. You can also use the Respond menu to take
action even when no explorer windows are open or active.
This menu behaves exactly as it does in the Monitor view’s event grid.
Explore menu
This menu contains options to open the other explorers. You can use it to
further explore the event message or event field that is the subject of the
active explorer. Or you can open a blank explorer to manually enter the item
you want to explore.
Explorer windows
The explorers you are working with appear as individual windows within the
Utilities pane. You can minimize, resize, and close each explorer window, as
needed.
Minimized
Any explorers that you have minimized appear at the bottom of the Utilities
explorers
pane as a title bar. Click a title bar to reopen that explorer.
159
Explorer Types
Name
◄>buttons
Description
Beginning from the active explorer window, you can use these buttons to cycle
through the other open explorer windows. Click ◄ to go to the previous
window. Click >to go to the next window.
Explorer Types
The Console contains the following explorers.
Explorer
Event
Description
The Event explorer, which can only be opened from the Monitor view, allows you to
view all of the events that are related to the event that is currently selected in the
Console. The Event explorer displays both sequential and concurrent events. That is,
you can view the events that occurred before, during, and after the event occurred. You
can also monitor events in real time, to see where they came from and where they are
going. Use this explorer when you need to know what caused the rule to fire.
Whois
The Whois explorer identifies the source of an IP address or domain name based on
how it is registered with domain and network authorities. It can tell you where
something is located physically in the world, and who actually owns the device you're
searching for. For example, use this explorer if you need to know who owns a domain
that corresponds to the IP that caused that rule to fire.
NSLookup The NSLookup explorer resolves IP addresses to host names, and host names to IP
addresses. Use this explorer to determine more information about a source or
destination IP address. For example, use this explorer when you need to know a name
that corresponds to that IP address that caused the rule to fire (it resolves a name like
“SolarWinds.com” to an IP address).
Traceroute The Traceroute explorer traces the network links from your host computer to the
destination you specify. That is, it shows you the “hops” between your computer and
the IP address of the destination. For example, use this explorer to determine the
network connections between yourself and an IP that caused the rule to fire.
160
Chapter 9: Explore
Explorer
Description
Flow
The Flow explorer lets you perform flow analysis to determine which IP addresses or
explorer
ports are generating or receiving the most network traffic. You can also analyze the
volume of data (in bytes or packets) that is transferring to or from a given IP address or
port number on your network. The explorer reports this information in easy-to-read
graphs and tables.
For example, if you see a strange IP address at the top of the Flow explorer’s activity
list, you can select the desired bar on the graph or a row in the table, and then choose
the Whois explorer from the Explore menu to find out what that the IP address is and
why it is transmitting so much data.
nDepth
nDepth is a powerful search engine that lets you search all of the event data or the original log messages that pass through a particular Manager. The log data is stored in
real time, as it originally occurs from each host (network device) and source (application or tool) that is monitored by the Manager.
Both Explore views have a Respond menu and an Explore menu that you can use with any of the
explorers:
l
The Respond menu lets you take corrective action on an event or other information
presented in an explorer, such as shutting down a workstation when you see a problem
reported in the Console.
l
The Explore menu lets you explore use any of the other explorers to investigate a
particular event, event detail, nDepth search result, or other explorer finding.
NSLookup Explorer
The NSLookup explorer is a network utility that is designed to resolve IP addresses to host names,
and host names to IP addresses. Use this explorer whenever you need to know a name that
corresponds to the IP address that caused the rule to fire. For example, it resolves a name like
“SolarWinds.com” to an IP address.
161
Traceroute Explorer
In the example shown here, we opened the NSLookup explorer for an event field that has an IP
address of 192.168.168.10 (which appears in the Search field). The explorer retrieved the
corresponding host name, which is grendel.corp.SolarWinds.com.
Opening the NSLookup explorer adds an item to the Explore view’s History pane. The new item has
a NSLookup explorer
icon.
Traceroute Explorer
The Traceroute explorer is a network utility that is designed to trace the network links from your host
computer to the destination you specify. Use this explorer whenever you need to determine the
network connections between yourself and the IP address that caused the rule to fire.
162
Chapter 9: Explore
In the example shown here, we used the Traceroute explorer on the IP address of 192.168.167.1. It
shows you the “hops” between your computer and that IP address. In this example, connecting to that
IP address required two “hops.”
Opening the Traceroute Explorer adds an item to the Explore view’s History pane. The new item has
a Traceroute explorer
icon.
Whois Explorer
The Whois explorer is a network utility that is designed to identify the source of an IP address or
domain name based on how it is registered with domain and network authorities. This explorer
contacts the central databases for IP addresses and domain names and returns the results of any of
your searches. It can tell you where something is located physically in the world, and who actually
owns the device you’re searching for. For example, use this explorer if you need to know who owns a
domain that corresponds to the IP address that caused a rule to fire.
163
Whois Explorer
The example on the left shows the results for an IP address. The example on the right shows the
results for the SolarWinds domain name, SolarWinds.com. From these, you can find out who owns
the IP address and where the server is hosted.
Opening the Whois Explorer adds an item to the Explore view’s History pane. The new item has a
Whois explorer
icon.
164
Chapter 9: Explore
Manually Exploring an Item
At any time, you can manually explore an IP address, host name, or domain name. To do this, open a
new, empty explorer, or by typing directly into the Search box of an explorer that is already open.
165
Chapter 10: Build
The Build menu contains three views: Groups, Rules, and Users. Use these views to configure the
related components on the LEM appliance. Since these components reside on the appliance, they are
universal and available to all console users from any computer. The sections in this chapter address
the features of each Build view in detail.
Groups
The Build >Groups view is used to create, name, configure, and organize groups of parameters. You
may then choose from these Groups when configuring filters (in Filter Creation) and rules (in Rule
Creation) to include or exclude the specific elements defined within each Group.
Each Group you create only applies to the Manager that is selected when you create the Group. If you
need a similar Group for another Manager, you must create it separately with that other Manager; or
you must export the Group, and then import it from the other Manager’s Groups grid.
Group types
You can use the Build >Groups view to create any of the Groups listed in the following table.
Group type
Description
EventGroups Event Groups are custom families of events that you can save as a Group. You can
then associate the Event Group with your rules and filters. For example, you might
create an Event Group made up of similar events that all need to trigger the same
response from the Console. When you apply the Event Group to a rule, the Console
implements the same rule when any one of the events in the Group occurs.
166
Chapter 10: Build
Group type
Description
Directory
If you use a directory service, such as Active Directory, you can connect LEM to
Service
the server that stores your existing directory service (DS) Groups. Once
Groups
connected, you can synchronize your DS Groups with LEM and apply them to your
rules and filters. DS Groups allow you to match, include, or exclude events to
specific users or computers, based on their DS Group membership.
In most cases, DS Groups are used in rules and filters as a type of white list or
blacklist for choosing which users or computers to include or to ignore. When used
by a filter, a DS Group lets you limit the scope of the events included in the filter to
those users or computers that have membership in a particular Group.
Email
Email Templates allow you to create pre-formatted email messages that your rules
Template
can use to notify you of an event.
State
State Variables are used in rules. They represent temporary or transitional states.
Variables
For example, you can create a State Variable to track the “state” of a particular
system, setting it to a different value depending on whether the system comes
online or goes offline.
Time of Day
Time of Day Sets are specific groups of hours that you can associate with rules and
Sets
filters. Time of Day Sets allow them to take different actions at different times of
day.
For example, if you define two different Time of Day Sets for “Working Hours” and
“Outside Working Hours,” you can assign different rules to each of these Time of
Day Sets. For instance, you may want a rule that automatically shuts down the
offending computer and events your system administrator via email.
Connector
Connector Profiles are groups of Agents that have common connector
Profiles
configurations. Most Agents in a network have only a few different network security
connector configurations. Connector Profiles allow you to group Agents by their
common connector configurations. You can then have your rules and filters include
or exclude the Agents associated with a particular profile.
167
Groups View Features
Group type
Description
User-Defined User-Defined Groups are groups of preferences that are used in rules and filters.
Groups
They allow you to match, include, or exclude events, information, or data fields
based on their membership in a particular Group. In most cases, User-Defined
Groups are used in rules and filters as a type of white list or blacklist for choosing
which events to include or to ignore.
Groups View Features
The topics in this section describe the key features of the Groups view, including its major sections,
the meaning of its grid columns, and how to refine its grid.
The following table describes the meaning of each column in the Groups grid.
Column
Description
The gear button in each row opens a menu of commands that you can perform on
the item that is currently selected in the grid. It has commands for editing,
cloning, exporting, and deleting the selected Group.
Type
Displays the type of the Group—Connector Profile, User-Defined Group, Time of
Day Set, etc.
Name
Displays the name of the Group.
Description
Displays a description of the Group. Pointing to this field displays the complete
description as a ToolTip.
Created By
Displays the name of the Console user who created the Group.
Created Date
Displays the date the Group was created.
Modified By
Displays the name of the Console user who last modified the Group.
Modified Date
Displays the date on which the Groups was last modified.
Manager
Displays the name of the Manager the Group is associated with.
168
Chapter 10: Build
Refining the Groups Grid
By default, the Groups grid shows every Group associated with each Manager the Console is
connected to. If the same Group is configured for more than one Manager, it appears in the grid
multiple times—once for each Manager it is associated with. To help you work more efficiently with a
long list of Groups, the Refine Results pane lets you apply filters to the Groups grid to reduce the
number of Groups it shows.
When you select options in the Refine Results pane, the grid refreshes to show only those items that
match the refinement options you have selected. The other items in the grid are still there; however,
they are hidden. To restore them, click the Reset button or select All in the refinement lists you are
using.
The following table explains how to use the Refine Results form.
Field
Reset
Search
Description
Click Reset to return the form and the Groups grid to their default settings.
Use this field to perform keyword searches for specific Groups. To search,
type the text you want to search for in the text box. The grid displays only
those Groups that match or include the text you entered.
Type
Select the type of the Group you want to work with (Connector Profile, UserDefined Group, Time of Day Set, etc.) to have the grid display only Groups of
that type.
Manager
Select a Manager to have the grid display only the Groups that are associated
with that Manager.
Created By
Select the name of the Console user who created the Group to have the grid
display only Groups from that user.
Created Date
Type or select a date range to have the grid display only Groups that were
Range
created on or within that date range.
Modified By
Select the name of the Console user who last modified the Group to have the
grid display only Groups modified by that user.
Modified Date
Type or select a date range to have the grid display only Groups that were
Range
modified on or within that date range.
169
Rules
Rules
The Console’s Build > Rules view is used to create, configure, and manage your rules. Rules are
used to monitor and respond to event traffic. They allow you to automatically notify or respond to
security events in real time, whether you are monitoring the Console or not. When an event (or a
series of events) meets a rule's conditions, the rule automatically prompts the Manager to take
action, such as notifying the appropriate users, or performing a particular active response (such as
blocking the IP address or stopping a particular process).
The Console ships with a set of pre-configured rules that you can begin using immediately. However,
you can use the view's Rule Creation connector to create your own custom rules and your own
variations on any existing rules.
Rules View Features
This topic describes the key features of the Rules view and the Rules grid, and explains how to
refine the Rules grid.
Rules Grid Columns
The Rules grid contains all policy rules that are configured for all Managers that are connected to the
Console. The Manager column indicates which Manager each rule applies to.
By default, the view shows the rules from the Custom Rules folder in the Folders pane. If you do not
have any custom rules, then click the Rules folder to list the rules that the Console ships with.
The following table describes the meaning of each column in the Rules grid. Columns are listed in
their default order, from left to right.
Column
Description
The gear button in each row opens a menu of commands that you can perform on
the item that is currently selected in the grid. These commands let you edit,
enable, disable, test, clone, and delete the selected rule.
170
Chapter 10: Build
Column
Enabled
Description
Indicates whether or not the rule is enabled and ready for use with your policies.
means the rule is enabled and is in active use.
means the rule is disabled, and is not in use.
Test
Indicates whether or not the rule is in test mode. When a rule is in test mode, it
causes events to appear in the Console, but it cannot perform any active
responses. This lets you see how the rule would behave when it is fully enabled,
but without risking any negative unintended consequences.
means the rule is in test mode.
means the rule is not in test mode.
Note: A rule must be Enabled before you can test it.
Name
The name of the rule.
Description
A description of the rule. Pointing to this field displays the complete description
as a ToolTip.
Folder
The name of the folder (in the Folders pane) in which the rule is stored.
Created By
The name of the Console user who created the rule.
Created Date
The date the rule was created.
Modified By
The name of the Console user who last modified the rule.
Modified Date
The date and time on which the rule was last modified.
Manager
The Manager the rule is associated with.
Refine Results Form
You can use the Refine Results form to refine the Rules grid. The form behaves like a search
engine, letting you apply filters to the Rules grid to reduce the number of rules it shows.
When you select options in the Refine Results pane, the grid refreshes to show only those items that
match the refinement options you have selected. The other items in the grid are still there; however,
171
Refine Results Form
they are hidden. To restore them, click the Reset button or select All in the refinement lists you are
using.
The following table explains how to use the Refine Results form.
Field
Reset
Description
Click Reset to clear the form. This returns the form and the Rules grid to their
default settings.
Search
Use this Search field to perform keyword searches for specific rules. To search,
type the text you want to search for in the text box. The grid displays only those
rules whose Name fields match or include the text you entered.
Enabled
Click this check box to show only those rules that are Enabled. Clear this check
box to show both Enabled and Disabled rules.
Test
Click this check box to show only those rules that are in test mode. Clear this
check box to show rules that are both in and out of test mode.
Manager
Select a Manager to have the grid display only the rules that are associated with
that Manager.
Created By
Select the name of the Console user who created the rule to have the grid display
only rules created by that user.
Created Date Type or select a date range to have the grid display only rules that were created
Range
within that date range.
Modified By
Select the name of the Console user who last modified the rule to have the grid
display only rules modified by that user.
Modified
Type or select the begin and end date range to have the grid display only rules that
Date Range
were modified on or within that date range.
The connectors in Rule Creation are very similar to those found in Filter Creation. However, filters
report event occurrences; rules act on them. There is no harm if you create a filter that is unusual or
has logic problems. But this is not the always case with rules. Rules can have unexpected and
sometimes unpleasant consequences if they are not configured exactly as you intend them to be.
Inexperienced users should use caution when creating rules. Creating filters is an excellent way to
familiarize yourself with the logic and connectors needed to create well crafted rules. You should only
172
Chapter 10: Build
begin configuring rules after you are at ease with configuring filters. Even then, always test your rules
before implementing them.
Rule Categories and Tags
The Rule Categories & Tags is the list of default rules categories and tags. To make it easier to find
and categorize, rules that apply to multiple purposes appear in more than one category and/or tags.
l
There are a default set of Rule Categories & Tags, and you can also create your own
customizable ones. New rule categories and tags that are created can be added or
removed from your list of categories/tags at any time.
l
Activity Types, Authentication, Change Management, Compliance, Devices, Endpoint
Monitoring, IT Operations and Security categories are available pre-defined categories
l
Rule templates have been separated into their own view and categorized into all of the
appropriate categories and tags, making them much easier to find and use
Rule Tagging
The Rule Tagging feature allows you to add, change, or remove tags from existing or newly created
rules. Rules may have several different categories and tags.
If you have a rule that you want to appear in several different category locations, you can use the tag
feature to have it display in those locations.
To tag a rule:
1. Select an existing Rule Template or create a new Rule.
2. Click the Add Tags... link
3. Select the categories and tags.There are many default tags or you can create a custom
tag to suit your needs.
4. Click OK
173
Users
Users
The Users view is used to manage the system users who are associated with each Manager. By
adding email addresses for each user, the Console can notify users of event conditions by email.
This topics in this section describe the key features of the Users view, the meaning of each column in
the Users grid, and how to refine the Users grid.
Users View Features
The following table describes the key features of the Users view.
Name
Description
Refine
This form behaves like a search engine. It lets you apply filters to the Users grid to
Results
reduce the number of users it shows.
Users grid
The Users grid displays all of the system users who are associated with each
Manager throughout your network.
174
Chapter 10: Build
Name
Description
Click this button to add a new user.
User
This pane displays detailed information about the user who is currently selected in
Information the grid, including the user’s role, password information, and contact information.
When editing a user, the User Information pane turns into an editable form.
Users Grid Columns
By default, the Users grid shows all users who are configured for all Managers that are monitored by
the Console. However, you can use the Refine Results form to refine the grid’s contents.
Column
Status
Description
n
Use the Edit command to edit the user’s settings and contact information.
n
Use the Delete command to delete the user.
Indicates if the user is currently logged on to the Console:
means the user is logged on.
means the user is not logged on.
User Name
Displays the name the user uses to log on to the Manager.
First Name
Displays the user’s first name.
Last Name
Displays the user’s last name.
Role
Displays the user role that has been assigned to the user.
Description
Displays a brief description of the user’s job function or responsibility.
Manager
States which Manager the user is associated with.
Last Login
States the date and time the user last logged on to the system.
175
Refining the Users Grid
Refining the Users Grid
By default, the Users grid shows all users for all Managers. The Refine Results form behaves like a
search engine, letting you apply filters to the grid to reduce the number of users it shows.
Field
Description
Reset
Click Reset to return the form and the Users grid to their default settings.
Manager
Select the Manager you want to work with. By default, the grid displays All
Managers.
Role
Select the user role you want to work with. By default, the grid displays All
roles.
Last Login
Type or select the begin and end date range to display the users who have
Date Range
logged in within that date range.
Viewing a User’s System Privileges
After selecting a user role, you can use the View Role button to view the system privileges that are
associated with the user’s assigned role.
To view a user’s system privileges:
1. Open the Build >Users view.
2. In the Users grid, double-click to user you want to work with. Below the grid, the User
Information pane displays the user’s current settings.
176
Chapter 10: Build
3. Click the View Role button. The Privileges form appears, showing the user’s system
privileges for his or her assigned role. This information is provided here for reference
purposes and cannot be changed.
4. When you are finished viewing the role’s privileges, click Close to return to the
Console.
177
Chapter 11: Manage
The Manage >Appliances view (also called the Appliances view) is used to add, configure, and
maintain each virtual appliance that is associated with and monitored by the LEM system.
Throughout this chapter, we will use appliances as a generic term to include:
l
Managers
l
Database servers
l
Logging servers
l
Network sensors
l
nDepth servers
This is primarily concerned with Managers, even though other appliances may appear in your
appliance list. Once a Manager is in place, you can use the Appliances view to do the following:
l
Use the Console to connect to and disconnect from a particular Manager.
l
Add a Manager’s Agents.
l
Configure rules, policies, and network security connectors that apply to each Manager.
Note: Commands in the Appliances view can take a while to execute, because they
must remotely access the Manager or network appliance.
Appliances View Features
This topic describes the key features of the Appliances view, the Details pane, the Appliances grid,
and its Status icons.
The following table describes the key features of the Manage >Appliances view.
178
Chapter 11: Manage
Name
Description
Appliances This grid lists all of the Managers and other network appliances that are monitored by
grid
LEM. You can use this grid to add, configure, or remove appliances, to configure
Manager connectors and Manager policy, and to connect to and disconnect from
Managers.
Click this button to add a new Manager or network appliance to the Console.
The gear button at the top of the grid opens commands that you can perform on multiple selections in the grid, and commands that do not require a grid selection. Click
this button to copy the grid's information about your Managers to the clipboard, so you
can paste it elsewhere, such as Microsoft Excel for analysis or the Remote Agent
Installer for updates.
Details
The Details pane displays an image of the appliance, as well as basic properties
about that appliance, such as its name, connection status, etc.
LEM provides the images for the last few (and next) generation of appliances. When
you add or configure a Manager, one of the options is to identify the model. Your
choice determines which picture, if any, is shown.
Properties
The Properties form is used to configure each Manager. It records the Manager’s
configuration settings, such as its login options, Agent licenses, its password
settings, and its ability to automatically send software updates to Agents.
Note: This form is only used for Managers. It is disabled for other types of
appliances.
Appliances Grid Columns
The following table briefly describes the meaning of each column in the Manage >Appliances view’s
Appliances grid.
179
Appliances Grid Columns
Column
Description
The gear button in each row opens a menu of commands that you can perform on
the appliance that is currently selected in the grid, such as Login, Logout,
Configure, Connectors (for connecting products to the appliance), Policy (for
assigning event distribution policy), and Delete.
The Login, Logout, Connectors, and Policy options apply only when you have a
Manager selected. If you have a Manager selected but are not connected, only the
Login, Configure, and Delete commands are available.
Status
The appliance’s current connection status:
means Connected/Logged In.
means Disconnected/Logged Off.
Icon
Used to differentiate between multiple Managers in the nDepth view.
Name
The name of the Manager or the appliance.
Type
The type of appliance—Manager, Database, Logging Server, or Network Sensor.
Version
States the version of the LEM Manager software.
Level
The model number for the appliance. It is directly related to the capacity and
performance of the appliance, ranging from Level to Level 4.
IP Address
States the Manager’s or the appliance’s IP address.
Port
The port number the Console is using to communicate with the Manager, the
network appliance, or the database.
Service Tag
The Dell serial number or registration number for this appliance. It uniquely identifies
this piece of equipment and its specific configuration properties.
Model
For Managers, states the model number.
User
For Managers, this column displays the user name that is currently logged on to that
Manager.
180
Chapter 11: Manage
Details Pane
The Details pane displays essential information about an appliance, such as its name, connection
status, IP address, etc. The image area can also display an image for each appliance, if you choose
to provide them.
To view an appliance’s details:
1. Open the Manage >Appliances view.
2. If needed, log into the Manager you want to work with.
3. In the Appliances grid, click to select the Manager or appliance you want to work with.
4. If the Details/Properties pane is not already open, click the “open pane” ▲ button at
the bottom of the window.
181
Configuring a Manager's Properties
The Details pane displays information about the Manager or appliance you have selected.
Field
Image area
Description
Displays an image of the Manager that is currently selected in the Appliances
grid, if the model number is known and an image is available.
Status
Displays the Manager’s or the appliance’s current connection status.
Name
Displays the Manager’s or the appliance’s name.
Type
Indicates the appliance type—Manager, Database Server, nDepth, Logging
Server, or Network Sensor.
Version
Displays the version of the Manager software.
Level
Displays the specific Manager appliance configuration level you have purchased.
IP Address
Displays the Manager’s or the appliance’s IP address.
Port
Displays the port number that the Console uses to communicate with the Manager
or the appliance.
Service Tag
Displays Dell’s assigned serial number for the Manager appliance. You can find
this number on the Manager information sheet that is provided with the appliance.
Model
When applicable, this field displays the Manager’s model number. If the model is
unknown, the model may be Other. If the appliance is not a Manager, this field is
empty.
Configuring a Manager's Properties
In the Properties pane, the Properties form is used to configure Managers. It records the Manager’s
configuration settings, such as its login options, Agent licenses, its password settings, its ability to
automatically send software updates to Agents.
Note: The Properties form is only used for Managers. It is disabled for other types of appliances.
1. At the top of the Console, click Manage >Appliances.
2. In the Appliances grid, click to select the Manager you want to work with.
182
Chapter 11: Manage
3. If the Details/Properties pane is not already open, click the “open pane” ▲ button at
the bottom of the window.
4. Complete Properties form. The following sections describe how to complete each tab.
Note: The Properties form automatically refreshes to display any changes that may
have occurred with the Manager since you opened the form. This ensures that you are
looking at the most current information.
The Login Tab
The Login tab has two main uses:
l
If the Login on console startup option is checked, the system uses this data to
automatically connect to the Manager whenever the Console is opened.
l
If you manually log in to a Manager from the Appliances grid, the system uses this
data to connect the Manager so you don’t have to complete the log in dialog box.
Use the following table to complete the Properties pane’s Login tab.
Option
Description
Username
Type your user name for logging into LEM.
Password
Type your password for logging into the Manager.
Login on
Select this check box to have LEM automatically log you into the Manager
console startup
upon opening the LEM Console. If you prefer to manually log on, then clear
this check box.
183
The Login Tab
Option
Description
Save Credentials
Select this check box to have the Console save the Manager’s user name
and password locally. The Console can then automatically provide them
whenever you log on to a Manager.
n
If you also select the Login on console startup check box, the Console
will automatically log on to the Manager whenever the Console is started.
n
If the Login on console startup check box is not selected, then the
Console automatically supplies the user name and password whenever
you manually log on to the Manager.
Reconnect on
Select this check box to have the Console automatically attempt to
disconnection
reconnect with the Manager, if the Manager becomes disconnected.
Try to reconnect
Type the number of seconds the Console is to wait before attempting a new
every xx seconds
connection with the Manager.
Timeout
Select this check box to have the Console quit its reconnection attempts
reconnection
with the Manager after a given number of tries, if the previous connection
attempts after xx
attempts have been unsuccessful.
tries
Then type the number of tries the Console is to attempt to reconnect with
the Manager before giving up.
Save
Click Save to save the configuration settings.
Cancel
Click Cancel to discard any configuration settings you may have entered
since the last time you saved.
184
Chapter 11: Manage
The License Tab
The License tab summarizes your available and allocated licenses.It is also used to activate your
SolarWinds LEM license.
The following table explains the License tab's remaining reference information.
Field
Total Nodes
Description
Displays the total number of nodes allowed by your SolarWinds LEM
license.
Total Unused
Displays the number of nodes that have not yet been allocated.
Nodes
Total Agent
Displays the number of nodes that have been allocated to LEM Agent
Nodes
devices such as workstations or servers.
Total Non-Agent
Displays the number of nodes that have been allocated to non-Agent
Nodes
devices such as firewalls or switches.
Maintenance
Displays the date your current maintenance contract with SolarWinds
Expiration Date
Support expires.
For more information on activating your SolarWinds LEM license, see "Going from evaluation to
production" on page 1.
License Recycling
Each time a VM desktop is created, an agent connects to LEM and a license is used. This continues
to happen as desktops are created and destroyed, eventually causing all licenses to be used up.
License recycling allows you to collect and reuse licenses from nodes that have not sent an event to
the LEM manager within a specified amount of time.
185
The Settings Tab
To enable license recycling:
1. Select the Enable license recycling checkbox.
2. Select a defined time frame from the options shown for when to recycle license if a
node has not sent an event.
3. Select when you would like the system to check for recyclable licenses.
4. Select the nodes to be checked.
The Settings Tab
The Settings tab defines the Manager’s password policy settings and global automatic update
settings. Global automatic updates allow the Manager to automatically send software updates to
Agents as new software becomes available.
Use the following table to complete the Properties pane’s Settings tab.
Option
Description
Password Policy
Minimum
Type or select the minimum number of characters that must be used on
Password Length
passwords for user account that are to connect to the Console and its
Managers. Passwords must have at least six characters, but no more than
40 characters.
186
Chapter 11: Manage
Option
Description
Must meet
Select this check box if passwords must meet the following complexity
complexity
requirements:
requirements
n
Passwords must not match or contain part of the user’s user name.
n
Passwords must be at least six characters long.
n
Passwords must contain characters from three of the following four
categories:
n
English uppercase characters (A through Z).
n
English lowercase characters (a through z).
n
Base 10 digits (0 through 9).
n
Non-alphanumeric characters (!, $, #, %, ^, etc.).
Remote Updates
Enable Global
This check box indicates whether or not the Manager can automatically
Automatic
update its Agents with new software.
Updates
n
Select this check box to have the Manager automatically issue the latest
software updates to qualifying Agents as they become available.
n
If this check box is not selected, then global automatic updates for this
Manager are Disabled. This means its Agents will not automatically
receive new software updates from the Manager.
Note that each Agent is also controlled by itsAutomatic Updates setting
on the Agents grid (see "Changing an Agent’s Remote Updates setting" on
page 1). The Agent’s Automatic Updates setting will not work if you do not
also select this Enable Global Automatic Updates check box.
Here is how it works. If you do not select this check box, but you have an
Agent set to automatically receive updates, nothing will happen. The Agent
will not receive its updates. But if you do select this check box and if you
have an Agent set to automatically update, the Agent will automatically
receive updates when they become available.
187
Configuring Event Distribution Policy
Option
Description
Maximum
Select how many Agents the Manager can update at one time. The default
Concurrent
value is 10.
Updates
If the number of Agents that require updates is greater than the value you
have entered here, the remaining Agents will be queued for updating as
soon as an update slot becomes available.
Explorer Command Agent
Current Default
Select the default Agent for performing SolarWinds explorer functions, such
Agent
as NSLookup and Whois. For best results, choose an Agent that is
normally online and will return the expected results.
Connection
Set the value for the amount of time before a timeout request is initiated.
Requests
Configuring Event Distribution Policy
The topics in this section explain how to configure event distribution policy for Managers. Event
distribution policy lets you control how events are routed through the LEM system. With the Event
Distribution Policy window, you can choose—at the event level—which events are to go to the
LEM Console, and to the local LEM database.
Practical Uses for Event Distribution Policy
Event distribution policy has several practical uses that are explained in the following examples.
l
Many data sources generate events that are difficult to control at a granular level; or,
they generate events of little or no value. You are better off removing these events from
the system to reduce the volume and noise being sent to your Console and database.
By configuring event distribution policy, you can disable (exclude) specific event types,
at the event level, from being sent to any or all of these destinations. The data sources
will continue to generate these events, so you can always enable them at any time.
Until then, the selected system destinations will ignore them.
188
Chapter 11: Manage
l
There may be events that you want to monitor in the LEM Console, but do not need for
long-term storage and reporting. In this case, you can use event distribution policy to
disable database storage for certain events, while enabling processing by the Console.
Opening the Event Distribution Policy Window
1. At the top of the LEM Console, click Manage >Appliances.
2. In the Appliances grid, click the gear
button for the Manager you want to work
with, and then click Policy. The Event Distribution Policy for [Manager] window
appears.
If you open the Event Distribution Policy window while another user is currently
using it, a Policy Locked message appears. You can choose to take over the window,
or to view it in read-only mode. Any Full User can unlock any other user.
189
About the Event Distribution Policy Window
About the Event Distribution Policy Window
The following table describes the key features of the Event Distribution Policy window.
Item
Event/Field
Description
The window’s grid is a hierarchical node tree. The Event/Field column lists event
categories and event types. Opening an event category node displays the lowerlevel event types that are associated with that category. Click a node ▼ to open
it, showing its lower-level event type nodes. Click the node again to close it,
hiding its lower-level event type nodes.
Check Boxes
The check boxes in the grid’s Console, Database, Warehouse, and Rules
columns indicate whether or not a particular event type (or entire event category)
is to be sent to the LEM Console, or to the local database. A check mark means
the event type will be routed to that particular destination. An empty check box
means the event type will not be routed to that destination.
190
Chapter 11: Manage
Item
Description
Export Button The Export button exports a Manager’s event policy to a spreadsheet file.
Click the gear
button to use the
Apply State to Branch
command. This
command pushes, or propagates, the selected event node’s check box settings
down to the related, lower-level event types in the node tree hierarchy.
Description
The Description box provides a description of the event type or event category
that is currently selected in the grid.
Configuring Event Distribution Policy
The Event Distribution Policy window makes configuring your event distribution policy a
straightforward matter. First, you find the event types you want to work with, and then you select
check boxes to determine whether or not those events types are to be routed to a particular
destination.
To configure event distribution policy:
1. Open the Event Distribution Policy window for the Manager you want to work with.
2. In the Event/Fields grid, locate the event type you want to work with. You can do this
several different ways:
l
In the Event/Field list, click any node to show its lower-level event type
nodes.
l
In the Event/Field list, double-click any event type row to show its lowerlevel event type nodes.
3. Once you have found the event type you want, configure it as follows:
l
Select the row’s Console check box to have that event type appear in
the LEM Console.
l
Select the row’s Database check box to have that event type stored in
the local database.
191
Pushing event policy to lower-level event types
l
Clear a check box to exclude the event type from that particular
destination.
4. To save or cancel your changes, do one of the following:
l
Click OK to save your event distribution policy changes, close the
window, and return to the Console.
l
Click Apply to save your changes, but keep the window open so you can
continue working.
l
Click Cancel to close the window without saving your changes and
return to the Console.
Upon saving, the Applying Changes status bar appears. Updating the Manager with
the new event policy configuration changes can take anywhere from 30 seconds to
several minutes.
Pushing event policy to lower-level event types
With the Apply State to Branch command, you can propagate or “push” event distribution policy
settings from a high-level event type to each of its lower-level “child” event types in the event
hierarchy.
For example, let’s say you select the topmost Security Event row and then select its Console and
Warehouse check boxes. Clicking Apply State to Branch assigns the same Console and
Warehouse check box settings to every child item that is associated with Security Event. Upon
saving, this policy causes all event types that are child items of Security Event to begin sending
events to all user’s Consoles and your data warehouse.
To push policy configure event distribution policy downward:
Open the Event Distribution Policy window for the Manager you want to work with.
1. In the Event/Field grid, locate the event type that is a “parent” to the event types you
want to configure.
192
Chapter 11: Manage
2. In the parent row, define the policy by selecting or clearing the Console, Database,
Warehouse, and Rules check boxes.
3. Click the row’s gear
button and then click Apply State to Branch.
The Console pushes, or propagates, the parent row’s check box settings down to each
of its lower-level event types in the node tree hierarchy.
l
If you select one or more of the parent row’s check boxes, the Console
selects the same check box settings for each related lower-level event
type in the node tree. Upon saving, the policy begins sending the “child”
event types to the selected destinations.
l
If you clear any of the parent row’s check boxes, the Console disables
the same check box settings from each related lower-level event type in
the node tree. Upon saving, the policy stops sending those event types
to those destinations.
4. Click OK to save your changes. The Console implements the new policy.
Exporting a Manager’s Event Policy
When needed, you can export a Manager’s event policy to a spreadsheet file. You may want to do
this for any of the following reasons:
l
You can view and manipulate the policy information in a spreadsheet application, such
as Microsoft Excel.
l
You can provide SolarWinds with a copy of your policy information for technical support
or troubleshooting purposes.
To export a Manager’s policy:
1. Open the Event Distribution Policy window for the Manager you want to work with.
2. At the top of the window, click Export. The Save As form appears.
3. In the Save In box, select the folder you want to export to.
193
Nodes
4. In the File Name box, type a name and file type for the exported file. In the file name,
include a file type of .xls to save the file as a Microsoft Excel spreadsheet.
5. Click Save to save the file. The Console saves the file to the folder and with the file
name you specified. You may now view the Manager’s policy information in a
spreadsheet file, such as Excel.
Nodes
The Manage >Nodes view displays the Agents that are monitored by each of your Managers.
Once you have installed the Agents on your client PCs, you can use the Nodes view to do the
following:
l
Add a new Node or Scan for a New Node.
l
Integrate the Agent’s network security connectors with the LEM system. You are
actually integrating the Agents themselves, but the Agents forward messages from the
network security connectors to the Manager for event processing.
l
Connect an Agent to a Manager.
l
View the name, connection status, event status, and IP address of each Agent.
l
Determine whether or not the Agent is using USB-Defender.
l
View an Agent’s properties.
l
Control an Agent’s automatic update settings for installing new software from the
Manager.
l
Actively respond to events that affect Agents.
l
Copy Agent information to the clipboard for use with the Remote Agent Installer, or for
analysis with programs such as Microsoft Excel.
l
Remove an Agent from a Manager.
Nodes View Features
This topic describes the key features of the Nodes view and the Nodes grid, and how to refine the
Nodes grid.
194
Chapter 11: Manage
The following table describes the key features of the Manage >Nodes view.
Name
Description
Sidebar
Click the Sidebar button to alternately hide and open the Refine Results pane.
Refine
By default, the Nodes grid shows all Nodes that are associated with all of your
Results
Managers. The Refine Results pane lets you apply filters to the Nodes grid to reduce
pane
the number of Nodes it shows. This way, you can show only those Nodes that are
associated with a particular Manager, Connector Profile, status, etc.
Nodes
The Nodes grid lists all of the Agent and Non-Agent nodes that are associated with
grid
each Manager and appliance that is monitored by the LEM Console. You can also Add a
New Node and Scan for a New Node with the buttons in the toolbar.
Respond Use the Respond menu to perform an action on a particular Agent. For example, you
menu
can send an Agent a pop-up message, or shut the computer down.
This menu behaves exactly as it does in the Monitor view’s event grid.
Remote
This menu lets you control the Agent’s automatic update status. Remote updates are a
Updates
way for the Agent to automatically accept updated Agent software from the Manager
menu
when new software becomes available.
The gear button at the top of the grid opens commands that you can perform on multiple
selections in the grid, and commands that do not require a grid selection. It includes commands for copying Agent information and for deleting Agents.
195
Nodes Grid Columns
Nodes Grid Columns
The following table briefly describes the meaning of each column of the Nodes grid.
Column
Description
Add Node
Displays a wizard to assist you in adding Nodes.
Scan for New Nodes
Scans syslog data that has been sent to LEM.
The gear button in each row opens a menu of commands that you can
perform on the item that is currently selected in the grid.
n
The Connectors command lets you configure the Agent’s connectors.
n
The Delete command lets you delete Agent licenses from a Manager.
n
The Copy command lets you copy Agent information to the clipboard
for use with the Remote Agent Installer, or for analysis in another
program, such as Microsoft Excel.
Status
The Agent’s current connection status:
Icon
Status
Description
Enabled
Agent is Connected to a Manager.
Disabled
Agent is Not Connected to a Manager (that is, it is
an open license).
Node IP
The Node’s IP address.
Node Name
The name of the system where the Node is installed. Typically, this is the
computer name or host name assigned to the Note.
Agent Node
The LEM Manager or Agent on which the node's logs are stored.
Note: This column is blank for LEM Agents.
196
Chapter 11: Manage
Column
USB
Description
The Nodes’s current USB-Defender status. An icon ( ) means USB Defender is installed on the Node. If no icon is present USB Defender is
not installed on the Node.
Note: This column is blank for non-Agent nodes.
Version
The version number of the Node software.
Note: This column is blank for non-Agent nodes.
OS
The operating system of the computer where the Node is installed.
Note: This column is blank for non-Agent nodes.
Profile
The Connector Profile associated with the Node, if applicable.
Note: This column is blank for non-Agent nodes.
FIM
The Nodes current FIM status.
Icon
Status
Description
Operational At least 1 FIM Connector for this Node has been created and is running. Connector is configured and running.
No
Non-oper-
At least 1 FIM Connector or FIM Connector Profile
ational
configured for this Node and driver disabled
Not con-
Node is not assigned to a FIM Connector or FIM Con-
icon figured
nector Profile. Connector is not configured and not
running.
Updates Enabled
This field indicates whether or not the Node is enabled for receiving
remote updates.
Icon
Status
Description
Enabled The Node is enabled for receiving remote updates.
Disabled The Node is disabled from receiving remote updates.
197
Adding a Syslog Node
Column
Update Status
Description
This field indicates the Agent’s current software update status.
Icon
Status
Current
Description
The Agent's software is current.
Outdated The Manager has an update newer than the version
being used by this Agent.
Updating The Manager is currently sending an update to this
Agent.
Queued
The Agent is waiting to be updated while other Agents
get updated. The number of Agents that can be
updated at one time is determined by the Maximum
Concurrent Updates setting in the Appliances
view's Settings tab.
Unknown The Manager does not yet know the Agent’s software
status.
Canceled The user canceled updating during update process.
Error
An error has occurred while updating.
ID
The Agent’s unique identification number.
Manager
The Manager that this Agent is connected to. An Agent can only be
connected to one Manager.
Install Date
The time and date the Agents was first installed and connected to the
Manager.
Last Connected
The time and date the Agent was last connected to the Manager.
Adding a Syslog Node
The Add Node button displays a wizard that walks you through adding a Node to monitor a network
device. The wizard locates the new node and then recommends an appropriate connector.
198
Chapter 11: Manage
1. Click the Add Node button.
2. Select Syslog node.
3. Enter the IP Address of the node.
4. Select the Node Vendor from the list.
5. Configure the node so LEM can receive syslog messages. If you need help, click the
links provided for enabling specific vendor devices.
6. Select the I have configured this node so that LEM can receive its Syslog
messages check box.
7. Click Next and LEM then scans for new devices.
Scan for New Nodes
The Scan for New Nodes button scans the syslog data that has been sent to LEM and detects new
nodes. You can use this if you have enabled many devices to send syslog to LEM and want to add
and configure them all at once.
To scan for a new node:
1. Click the Scan for New Nodes button.
Note: Scanning for new nodes may take a few minutes. If it does, you'll get a message
that the scan is continuing in the background.
2. A New Connector(s) Found message displays as data is found from new devices.
3. Click View Now to add the recommended connectors for these devices.
4. Click Next.
Note: Click the Summary tab to display a summary of the nodes and connectors that
will be added or updated to LEM as a result of the Scan for New Nodes.
5. Click Finish. Events from the new nodes appear in the LEM console as they are
received from the devices.
199
Adding Nodes Manually
Adding Nodes Manually
1. To configure additional nodes, navigate to Manage > Nodes to see a listing of all the
nodes being monitored by LEM.
2. Select the desired node, then click the gear button next to it and select Connectors.
Here you can search agent nodes by category or use the search box to find a node by
keyword, such as DNS.
3. Click the gear
icon next to the search result and select New to create a new
node.
4. Configure the new node and select Start to start the node.
Refining the Agents Grid
By default, the Agents grid shows every Agent that is associated with every Manager that is
monitored by the LEM Console. To help you work more efficiently with a long list of Agents, the
Refine Results pane lets you apply filters to the Agents grid to reduce the number of Agents it
shows.
When you select options in the Refine Results pane, the grid refreshes to show only those items that
match the refinement options you have selected. The other items in the grid are still there; however,
they are hidden. To restore them, click the Reset button or select All in the refinement lists you are
using.
The following table explains how to use the Refine Results form.
Field
Reset
Description
Click Reset to clear the form. This returns the form and the Agents grid to their default
settings (showing all Agents for all Managers.)
Search
Use this field to perform a keyword search for a specific Agent in the Name field. To
search, type the text you want to search for in the text box. The grid displays only those
Agents that match or include the text you entered.
200
Chapter 11: Manage
Field
Description
Manager Select the Manager you want to work with. Select All to include Agents from every
Manager.
Profile
Select the Connector profile you want to work with. Select All to include Agents from
every Connector Profile.
Node
Select whether you want to view Agent or Non-Agent nodes.
Status
Select the connection status of the Agents you want to work with (Connected or Not
Connected). Select All to include both.
Version
Select the version of the software on the Agent. Select All to include Agents of every
version.
OS
Select the operating system (OS) of the computer the Agent is installed on. Select All to
include all operating systems.
USB
Select the Agent’s USB-Defender status (Installed or Not Installed). Select All to
include both.
201
Chapter 12: Access Controls
This chapter discusses procedures for working with users and managing restrictions for LEM Reports
and the LEM desktop console.
Adding New Users
The following procedure explains how to add and configure new users. You add each new user by
opening and completing the User Information form. This form records each user’s individual
settings. It also allows you to record a user’s email addresses, which the Manager can use to notify
the user when an appropriate alert event occurs.
Starting with LEM version 5.4, the Build > Users component of the LEM console integrates with
Microsoft Active Directory. Import domain users or groups to create LEM console users with domain
credentials.
Note: Before you import any user into LEM, be sure the account in Active Directory includes a valid
email address if you plan to send that user email messages for LEM rules. After you import a user,
you cannot change or add the email address for the LEM user account.
To add a new user:
1. Open the Build >Users view.
2. At the top of the Users grid, click Add User. Below the grid, a blank User Information
form appears. A completed form is shown here for reference purposes.
202
Chapter 12: Access Controls
3. Complete the User Information form, as described in the following table.
Field
Manager list
Description
In the upper-right corner of the form, select the Manager this user will
be associated with.
User Name
Type the user’s system user name. This is the name the user will
use when logging into the Manager.
Note: User names admin_role,audit_role, and reports_role
cannot be used.
First Name
Type the user’s first name.
Last Name
Type the user’s last name.
Password
Type the user’s system password. This is the password the user will
use when logging into the Manager. This can be an initial system
password or a temporary password that is assigned to replace a
forgotten password.
If you have the Must Meet Complexity Requirements option
checked in the Appliances view's Settings tab, the Console
enforces the following password policy: n
Passwords must have a minimum of six characters. Spaces
are not allowed.
n
Passwords must have two of the following three attributes: n
At least one special character
n
At least one number
n
A mix of lowercase and uppercase letters.
Confirm
Type the password a second time to verify that you entered it
Password
correctly.
203
Adding New Users
Field
Role
Description
Select the appropriate role for this user:
n
Administrators are users who have full access to the
system, and can view and modify everything.
n
Auditors are users who have extensive view rights to the
system, but cannot modify anything other than their own
filters.
n
Monitors are users who can access the Console, but cannot
view or modify anything, and must be provided a set of
filters.
n
Contacts are users who cannot access the Console, but do
receive external notification.
n
Guests are users who have extensive view rights to the
system, but cannot modify anything other than their own
filters.
View Role
After selecting a user role, you can click the View Role button to
open the Privilegesform, which shows the system privileges for that
role. This information is provided here for reference purposes and
cannot be changed.
Description
Type a brief description (up to 50 characters) of the user’s title,
position, or area of responsibility.
204
Chapter 12: Access Controls
Field
Description
Contact
Use this section to record the user’s email addresses, so the
Information
Manager can notify users of network security events by email. You
can add as many email addresses as you need for each user.
It is always a good idea to test each email address to confirm that it
has been entered correctly and that it works properly.
To add the user’s email address:
1. Click the “add” button.
2. In the box that appears (shown here), type the user’s
email address and then click Save.
3. The email address appears in the Contact
Information section.
4. Repeat this procedure as needed, to record each email
address that applies to the user.
To test an email address:
In the User Information form’s Contact Information area, click the
test
button for the email address you want to test.
Verify that the user has received the email test message. If the
message was not received, you may need to edit email address.
Note: In order for the Manager’s notification system to work, you
must have the Manager’s Email Connector Settings set up
properly..
4. When you are finished, click Save to save the new user; otherwise, click Cancel.
To create a user from an Active Directory user:
1. Open your LEM console and log in to your LEM appliance.
205
Adding New Users
2. Configure the Directory Service Query connector on your LEM appliance if you
haven't already. For additional information, see the KB article "How to Configure the
Directory Service Query Tool".
3. Click Build and then select Users.
4. Click the plus
button, and then select Directory Service User.
5. Select the Organizational Unit and Group where you want to add the user.
6. Select the user you want to add from the Available Users column, and then click Select
User.
7. Select a LEM Role in the User Information form. Click View Role to see details about
each role.
8. Enter a user description. If you change the Description field, your changes only apply to
the LEM user account, not the Active Directory account.
9. Click Save.
To create users from an Active Directory group:
1. Open your LEM console and authenticate to your LEM appliance.
2. Configure the Directory Service Query connector on your LEM appliance if you
haven't already. For additional information, see the KB article "How to Configure the
Directory Service Query Connector".
3. Click Build , and then select Users.
4. Click the plus
button, and then select Directory Service Group.
5. Select the Organizational Unit to which the group you want to add belongs.
6. Select the group you want to add from the Available Groups column, and then click
Select Group.
7. Select a LEM Role in the User Information form. Click View Role to see details about
each role.
Note: If you want members of this group to have different LEM user roles, change their roles
individually after you complete this procedure.
206
Chapter 12: Access Controls
8. Enter a description for these users if you want. If you change the Description field, your
changes only apply to the LEM user accounts, not the Active Directory accounts.
9. Click Save.
Editing User Settings
Follow this procedure to edit an existing user’s configuration settings. You can also edit the user’s
email addresses to make corrections or keep them current. If an email address becomes obsolete,
you can also easily remove it.
Only the description and the role can be edited for Active Directory users.
To edit a user’s settings:
1. Open the Build >Users view.
2. In the Users grid, do one of the following: l
Double-click the user you want to work with.
l
Click to select the user you want to work with. Then click the row’s gear
button and click Edit.
Below the grid, the User Information pane displays the user’s current settings and
becomes an editable form.
3. Make the necessary changes to the User Information form.
4. Click Save.
To delete a user’s email address:
1. Open the Build >Users view.
2. In the Users grid, click to select the user you want to work with.
3. Click the row’s gear
button and then click Edit.
4. In the User Information form’s Contact Information section, click the delete
button next to each email address you want to delete. The system removes that
207
Deleting Users
particular contact information.
5. Click Save.
Deleting Users
Follow this procedure to delete a user from a Manager.
To delete a user:
1. Open the Build >Users view.
2. In the Users grid, click to select the user you want to delete.
3. Click the gear
button and then click Delete.
Note: You cannot delete the admin user from the system.
4. At the Confirmation prompt, click Yes to delete the user; otherwise, click No. The
user is removed from the Users list. This user is no longer authorized to use the
Manager.
Restricting LEM Reports
Access to LEM Reports is completely restricted by default. In order to run reports in LEM Reports for
the first time, complete one of the procedures to specify which computers have access to your LEM
database. Add the computer on which you want to run reports to the list of "allowed" computers on
your LEM Manager, or remove all LEM Reports restrictions.
To configure your LEM Manager to allow specific computers to run LEM Reports:
1. Log in to your LEM virtual appliance using either the vSphere "console" view, or an
SSH client such as PuTTY.
2. At the cmc> prompt, enter service.
3. At the cmc::scm# prompt, enter restrictreports.
4. Press Enter.
5. Separate each IP address of the computers you want to run LEM Reports with a space.
208
Chapter 12: Access Controls
Note: Your entry overrides any previous entries, so ensure the list you provide is complete.
6. Enter y to confirm your entry.
7. Enter exit to return to the cmc> prompt.
8. Enter exit to log out of your LEM virtual appliance.
To remove all LEM Reports restrictions:
1. Log in to your LEM virtual appliance using either the vSphere "console" view, or an
SSH client such as PuTTY.
2. At the cmc> prompt, enter service.
3. At the cmc::scm# prompt, enter unrestrictreports.
4. Press Enter.
Note: Unrestricting LEM Reports make the LEM database accessible on any computer on your
network running LEM Reports.
5. Enter exit to return to the cmc> prompt.
6. Enter exit to log out of your LEM virtual appliance.
209
Chapter 13: Utilizing the Console
The LEM console displays normalized information about the events on your monitored devices in real
time. The sections in this chapter address how to use the LEM console to view, respond to, and
search for these events on a day-to-day basis. Unless otherwise stated, the functionality described in
this chapter is identical between the web and desktop consoles.
Filters
The topics in this section explain how to create and manage event filters.
Creating Filters for Real-time Monitoring
You can create custom filters from the Monitor view in your LEM Console to display real-time traffic
from your monitored computers and devices.
To create a filter in your LEM Console:
1. Open the LEM Console and log in to your LEM Manager as an administrator or auditor.
2. Click the Monitor tab.
3. Click the
button at the top of the Filters pane, and then select New Filter to open
Filter Creation.
4. Enter a Name and Description (optional) at the top of the Filter Creation view.
5. To modify the number of events your filter can store in memory, edit the Lines
Displayed value next to the Name field. The default value is 1000.
6. Drag one of the following elements into the Conditions box.
l
Events: Drag a single Event into your Conditions to filter for any instance of the
Event you specify. This type of Condition does not require a value.The field at
the top of the Events list is a search box.
l
Event fields: Drag an Event field into your Conditions to filter for any Event that
210
Chapter 13: Utilizing the Console
contains the value you specify.
Features of the List Pane
The list pane is the “accordion” list on the left side of Filter Creation, Rule
Creation, and the nDepthexplorer.It contains categorized lists of events,
Event Groups, event fields, Groups (from the Groups grid), profiles, and
constants that you can use when creating conditions for your filters, rules, and
search queries.
If more than one Manager is linked to the Console, each item in the list pane
lists the Manager it is associated with. Therefore, some list items may appear
to be listed multiple times. But in reality, they are listed once for each
Manager. Events are universal to all Managers, so they do not show a
Manager association.
The following table describes the contents of each list in the list pane. They
are listed in the order in which they appear. If a list does not apply to a
particular view, then it will not appear in that view.
211
Filters
List
Description
Refine
This list only appears with nDepth. It categorizes and lists the top 100 data details
Fields
for each listed field found within your nDepth search results. The details change,
depending on whether you are searching event data or log messages. You can use
these details to create, refine, or append nDepth search conditions.
n
The data categories are expanded by default.
o
Click ▼ All to collapse all of the category nodes.
o
Click >All to open all of the category nodes.
o
Click >next to a category to open that category.
o
Click ▼ next to a category to close that category.
o
The number in parentheses next to each category indicates how many
unique details are in that category.
o
The number next to each detail indicates how many times that detail is
reported in the search result's data.
n
Click the ABC button to sort the details within each category alphabetically.
n
Click the 321 button to sort the details within each category by frequency—the
items that occur most often appear first within each category.
n
Double-click a detail to add that detail to the search string.
n
Drag a detail into the search bar to include that item in the search string.
n
When using Search Builder, drag a detail into the Conditions box to add that
item to the search string.
212
Chapter 13: Utilizing the Console
List
Managers
Description
This list only appears in nDepth. It includes the various appliances that are being
monitored by the Console.
Use this list to select the Manager on which you want to perform an nDepth search.
If you are storing the original event log data on a separate nDepth appliance, then
you would select that appliance here when you want to search that data.
n
In Drag & Drop Mode, you can drag an item from this list into the search box to
include that item in the search string.
n
When using Search Builder, you can drag an item from this list into the
Conditions box.
Events
The Events list includes all of the Console’s event types. You can show the events
either of two ways—as a hierarchical node tree, or as an alphabetized list. Both
views contains the same events—they are just presented differently.
You can search either view. To do so, begin typing a word or phrase in the box at
the top of the list. The Events list will refresh to show any event types that include
your word or phrase. Then use the list to select each event type that you want to
include as a filter condition or a rule correlation.
In the Events list, click this button to display the list as a hierarchical node tree.
This is the Events list's default view. This view also has the following attributes:
n
Lower-level event types are hidden by nodes in the event tree. To open a node,
click the >icon. This displays the node’s next level of events.
n
Using the search box displays the event and its parent event types, so you can
see how the event appears in the event hierarchy.
In the Events list, click this button to list event types alphabetically, regardless of
their position in the hierarchy.
Event
The Event Groups list displays pre-configured groups of events that can be used to
Groups
initiate a particular event filter condition or rule correlation. The top box lists the
names of Event Groups. The Fields list displays those fields that apply to the
Event Group that is currently selected.
213
Filters
List
Fields
Description
The Fields list displays those data fields that apply to whichever event is selected
in the Events or Event Groups list.
User-
This list displays the different preconfigured User-Defined Groups that apply to the
Defined
Managers. User-Defined Groups are groups of preferences used in rules and event
Groups
filters that allow you to match, include, or exclude events, information, or data fields
based on their membership with a particular Group. In most cases, User-Defined
Groups are used in rules as a type of white list or blacklist for choosing which
events to include or to ignore.
User-Defined Groups are created in the Group Builder.
Connector
This list displays all the different Connector Profiles that apply to the Managers.
Profiles
Connector Profiles are groups of Agents that have common Connector
configurations. You can use them to have your rules and filters include or exclude
the Agents associated with a particular profile.
Connector Profiles are created in the Groups grid.
Directory
This list displays the Directory Service Groups that are synchronized with the
Service
Managers. Directory Service Groups are preconfigured groups of network
Groups
computers and system users that you can use in rules and filters. They allow you to
match, include, or exclude events to specific users or computers based on their
Group membership.
Directory service groups are synchronized to LEM through the Groups grid. .
Time Of Day This list displays all of the different Time Of Day Sets that apply to the Managers.
Sets
Time Of Day Sets are specific groups of hours that you can associate with rules
and event filters. You can use them to have your filters include or exclude
messages that occur during the hours associated with a particular Time of Day Set,
or to have your rules take different actions at different times of day.
Time of Day Sets are created in the Groups grid.
Note: This list does not appear in nDepth.
214
Chapter 13: Utilizing the Console
List
Description
State
This list displays all of the different State Variables that apply to this Manager. The
Variables
upper box lists the names of State Variables. The lower box lists the various fields
that apply to whichever State Variable is selected in the upper box.
State Variables are created within the Groups grid.
Note: This list only applies to rules.
Subscription This list displays all of the Console user names, and the Manager each user is
Groups
currently associated with. Each name in the list represents the list of rules that each
individual user is subscribed to. By adding a Subscription Group to a filter, you can
build the filter so that it only displays events messages that are related to specific
rules that a particular user is interested in (or “subscribed to”).
Note: This list only applies to filters and nDepth searches.
Constants
This list displays the three types of constants that rules and filters can use for
comparing event data—text, number, or time.
Actions
This list displays all of the active responses that a rule can initiate, such as sending
an email message, sending a pop-up message, blocking an IP address, etc.
Note: This list only applies to rules.
Notifications This list includes the various notification methods the Console can use to announce
an event message for the filter. You can have the Console display a pop-up
message, display the new event as “unread,” play a sound, or have the filter name
blink. If needed, you can configure multiple notification methods for the same filter.
Note: This list only applies to filters.
Features of the Conditions Box
Use the Conditions box to configure the conditions that determine which events a filter is to report.
Conditions are the various rules that state when the filter is to display an event message.
To define conditions, you drag event variables from the Events, Event Groups, and Fields lists into
the Conditions box. Then use the Conditions connectors (described below) to configure how these
215
Features of the Conditions Box
variables are to compare to other items, such as Time Of Day sets, Connector Profiles, User-defined
Groups, Constants, and other event fields.
You can also compare groups with AND/OR conditions. AND conditions state which events must all
occur together before the filter shows an event. OR conditions state that if any one of several
conditions occur, the filter shows the event.
The combined conditions dictate when the event filter is to display an event. The filter ignores (and
does not display) any events that do not meet these conditions.
The Conditions Connectors allow you to configure relationships between events in the Conditions
box, and to establish conditions for when the event filter is to display the event message. The
following table describes each item condition connector.
The Conditions box
The following table describes each feature of the Conditions box.
216
Chapter 13: Utilizing the Console
Item
Name
►
▼
Description
Individual groups (and the entire Conditions box) can be expanded or collapsed
to show or hide their settings:
n
Click to >expand a collapsed group.
n
Click to ▼ collapse an expanded group. The number that appears in
parentheses indicates how many conditions are contained in the group.
Once a group is properly configured, you may want to collapse it to avoid
accidentally changing it.
This is the Add Group button. It appear at the top of every group box. Click it to
create a new group within the group box. A group within a group is called a nested
group.
Each group is subject to AND and OR relationships with the groups around it and
within it. By default, new groups appear with AND comparisons.
This is the Delete button. It appears at the top of every Group box. When you
point to a condition, it also appears next to that condition. Click this button to
delete a condition or a group. Deleting a group also deletes any groups that are
nested within that group.
Event
From the Events, Event Groups, or Fields list, drag an event, Event Group, or
variable
event field into the Conditions box. This is called the event variable.
You can think of an event variable as the subject of each group of conditions. As
event messages stream into the Console, the filter analyzes the values
associated with each event variable to determine if the event message meets the
filter’s conditions.
217
Features of the Conditions Box
Item
Name
Description
Operators Whenever you drag a list item or a field next to event variable, an operator icon
appears between them. The operator states how the filter is to compare the event
variable to the other item to determine if the event meets the filter’s conditions.
n
Click an operator to cycle through the various operators that are available for
that comparison. Just keep clicking until you see the operator you want to use.
n
Ctrl+click an operator to view all of the operators that are available for that
comparison. Then click to select the specific operator you want to use.
List item
List items are the various non-event items from the list pane. You drag and drop
them into groups to define conditions based on your Time Of Day Sets,
Connector Profiles, User-Defined Groups, Constants, etc.
Some event variables automatically add a blank Constant as its list item. You
can overwrite the Constant with another list item, or you can click the Constant
to add a specific value for the constant. For example, clicking a text Constant
turns the field into an editable text box so you can type specific text. The text
field also allows wildcard characters.
Note that each list item has an icon that corresponds to the list it came from.
These icons let you to quickly identify what kinds of items are defining your
filter’s conditions.
Nested
A group within a group is called a nested group. You may drag event variables
group
and other items from the list pane into the nested group boxes. By using nested
groups, you can refine conditions by combining or comparing one group of
conditions to another. This allows you to create the logic for highly complex and
exact conditions.
This example above shows one nested group. It represents a set of conditions
within a higher-level group.
Conditions (and groups of conditions) are subject to AND and ORcomparisons.
AND
If you click an AND operator, it changes to an OR, and vice versa.
OR
218
Chapter 13: Utilizing the Console
Creating a New Filter
Use the following procedure whenever you need to create a new filter. You will configure the filter with
the Filter Creation connector.
To create a new filter:
1. Open the Monitor view.
2. In the Filters pane, click the title bar of the filter group you want the new filter to reside
in. If you change your mind later, you can always move the filter to a different group.
The filter group opens to list the filters that are available for that group.
3. On the Filters pane, click the plus
button and then click New Filter. The Monitor
view changes from showing the event grid to showing the Filter Creation connector.
The connector shows a new filter with the name of [New Filter].
4. In the Name box, type a name for the filter. This is the name that will be used to identify
the filter in the Filters pane.
5. In the Lines Displayed box, type or select the total number of events that are to be
displayed in this filter. You can use the up and down arrow buttons to the right of the
box to select a value. The default value is 1000 lines. You can select up to a maximum
of 2000 lines.
6. In the Description box, type a brief description of what the filter does, or the situation
for which the filter is intended.
7. Use the list pane and the Conditions box to configure the conditions that define the
filter. These are conditions between events, Event Groups, event fields, and other
components.
8. If you want special notification whenever the filter captures an event event, drag an
option from the Notifications list to the Notification box. Then configure the
notification method.
9. Click Save to save the filter’s settings.
10. If applicable, use the Filter Status section to verify, troubleshoot, and resolve any
219
Editing an Existing Filter
problems with the filter’s logic. When finished, the new filter appears in the filter group
you selected in Step 2.
Editing an Existing Filter
Use the following procedure whenever you need to edit or rename an existing filter. Once the filter is
open for editing, you can change its name, description, configuration, or notification settings, as
needed.
To edit an existing filter:
1. Open the Monitor view.
2. In the Filters pane, open the filter group that contains the filter you want to edit.
3. Select the filter you want to edit.
4. On the Filters pane, click the gear
button and then click Edit. The Monitor view
changes from showing the event grid to showing the Filter Creation connector.
5. Click Save to save the filter’s settings.
6. If applicable, use the Filter Status section to verify, troubleshoot, and resolve any
problems with the filter’s logic.
Cloning an Existing Filter
Cloning a filter lets you copy an existing filter, but save it with a new name. Cloning allows you to
quickly create variations on existing filters.
To clone a filter:
1. Open the Monitor view.
2. In the Filters pane, select the filter you want to clone.
3. On the Filters pane, click the gear
button and then click Edit.
220
Chapter 13: Utilizing the Console
4. Click the row’s gear
button and then click Clone. The newly cloned filter appears
in the filter group, just below the original filter. A clone always uses the same name as
the filter it was cloned from, followed by the word Clone. For example, a clone of the
Virus Attacks filter would is called Virus Attacks Clone. A second clone of the Virus
Attacks filter is called Virus Attacks Clone 2, and so on.
5. Edit the cloned Group, as needed, to give it its own name and to assign its own specific
settings.
Pausing Filters
At any time, you can pause a filter to stop the stream of event messages that are appearing on that
filter. This allows you to inspect a set of event messages without being interrupted by new incoming
messages. You can pause each filter independently, or you can pause every filter on the Console.
To pause a filter:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to pause.
The event grid changes to display the filter you selected.
3. Do either of the following:
l
On the event grid’s title bar, click Pause.
l
On the Filters pane, click the gear
button and then click
Pause/Resume.
In the Filters pane, the word Paused appears next to the filter.
To pause all filters:
1. Open the Monitor view.
2. On the Filters pane, click the gear
221
Resuming Paused Filters
button and then click Pause All.
In the Filters pane, the word Paused appears next to every filter, except those that
have been turned off.
Resuming Paused Filters
When a filter is paused, it ceases to receive any event traffic. To begin receiving event traffic again,
you must resume the filter. You can resume each filter independently, or you can resume every
paused filter on the Console.
To resume running a filter:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to resume. The event grid changes
to display the filter you selected.
3. Do either of the following:
l
On the event grid’s title bar, click Resume.
l
On the Filters pane, click the gear
button and then click
Pause/Resume.
In the Filters pane, the word Paused is replaced by the number of events that are
currently associated with the filter.
To resume running all filters:
1. Open the Monitor view.
2. On the Filters pane, click the gear
button and then click Resume All. In the
Filters pane, the word Paused is replaced by the number of events that are currently
associated with each filter.
222
Chapter 13: Utilizing the Console
Turning Filters On and Off
Perhaps you only use a few filters on a regular basis. If so, you can turn off any unused filters. If you
later decide you need the filter, you can easily turn it back on again. This “on/off” feature lets you
conserve resources and not monitor a filter without taking the drastic measure of deleting the filter.
When you turn a filter back on, it starts from that moment in time—it does not pull prior events from
memory.
Filters are turned on and off from the Filters pane. Filters that are off appear in italic type and show a
status of Off. Filters that are on appear normal.
To turn a filter off:
1. Open the Monitor view.
2. In the Filters pane, select the filter you want to turn off.
3. On the Filters pane, click the gear
button and then click Turn Off. In the Filters
pane, the filter title is now italicized and reads Off in its status column. While the filter is
no longer in use now, it remains available for later use.
To turn on filter back on:
1. Open the Monitor view.
2. In the Filters pane, select the filter you want to turn on.
3. On the Filters pane, click the gear
button and then click Turn On. The filter
appears in the event grid and begins processing data. In the Filters pane, the filter’s
status column changes from Off to showing the total number of events associated with
the filter.
Copying a Filter
You can copy a filter. This allows you to quickly create variations on existing filters, or the same the
223
Importing a Filter
same filter in multiple filter groups.
To copy a filter:
1. Open the Monitor view.
2. In the Filters pane, open the filter group that contains the filter you want to copy.
3. Now open the filter group that is to receive the copied filter.
4. In the first folder, click the filter you want to copy. Then press Ctrl while dragging the
filter to the group that is to receive the copy. A copy of the filter appears in the new filter
group.
To create a variation of the original filter:
1. In the Filters pane, click the select the newly copied filter.
2. Click the Filters pane gear
button and then click Edit.
3. In Filter Creation, rename and reconfigure the filter, as desired.
4. Click Save.
Importing a Filter
Event filters are saved on the workstation that is running the Console. If you move to another
workstation, the filters will not follow. However, you can export the filters from one workstation and
import them into another workstation. This allows you to move filters from one Console to another, so
that another user can use the same filters on their Console, too. It also allows you to import filters that
are provided by SolarWinds You may import more than one filter at a time.
To import a filter:
1. Open the Monitor view.
2. In the Filters pane, select the filter group that is receive the new filters.
3. On the Filters pane, click the gear
button and then click Import Filters.The
224
Chapter 13: Utilizing the Console
Select Filter File(s) to Import form appears.
4. In the Look In box, browse to the folder that contains the filters you want to import.
5. Select the filter files you want to import, and then click Open. To select multiple files,
press Ctrl key while clicking each file you want to import.
The imported filters appears in the filter group you selected in Step 2.
Exporting a Filter
When needed, you can export a filter. Exporting does not remove the filter; it copies the filter to
another location. Exporting filters is useful for the following reasons:
l
You can move filters from one Console workstation to another, so that another Console
users can use the same filters.
l
You can save a export your filters to a computer folder or network folder for archival
purposes.
l
You can provide SolarWinds with a copy of a filter for technical support or
troubleshooting purposes.
Filters are exported from the Filters pane. You may export only one filter at a time.
To export a filter:
1. Open the Monitor view.
2. In the Filters pane, select the filter you want to export.
3. On the Filters pane, click the gear
button and then click Export Filter.
4. In the Browse For Folder form, browse to the folder in which you want to save the
exported file. If needed, you can click Make New Folder to create a new folder for the
file.
5. Click OK. The system exports the folder file to the folder.
Deleting a Filter
When needed, you can delete a filter, which removes the filter from the both the event grid and the
225
Managing Filter Groups
Filters pane. Deleting a filter also deletes all of the widgets associated with that filter.
Use caution when deleting a filter. The only way to restore it and its widgets is to recreate them.
To delete a filter:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter you want to delete.
3. Do either of the following:
l
Click the selected filter’s delete
l
Click the pane’s gear
button.
button, and then click Delete.
4. At the confirmation prompt, click Yes. The filter is deleted and no longer appears in the
Filters pane.
Managing Filter Groups
The topics in this section explain how to create and manage filter groups in the Filters pane.
Adding a New Filter Group
1. Open the Monitor view.
2. Click the Filters pane plus
button and then click New Group.
3. A new filter group appears, and its title bar is an editable text box.
4. Type a name for the new group and then press Enter.
5. The new filter group appears in the Filters list. Filter groups are listed in the order in
which you create them. However, you can rearrange them, as desired.
Renaming a Filter Group
1. Open the Monitor view.
226
Chapter 13: Utilizing the Console
2. In the Filters pane, do one of the following: l
Double-click the title bar of the filter group you want to rename.
l
Click to select the title bar of the filter group you want to rename. Click
the Filters pane gear
button and then click Edit.
The filter group’s title bar changes to an editable text box.
3. Type a new name for the filter group and then press Enter.
Rearranging Filter Groups
By default, new filter groups appear at the bottom of the Filters pane. However, you can rearrange
your filter groups so they appear in the different order. For example, you may want to put your most
frequently used filter groups toward the top of the pane, and your lesser used groups toward the
bottom.
To move a filter group:
1. Open the Monitor view.
2. In the Filters pane, click the title bar of the filter group you move, and then drag it to its
new position.
Moving a Filter From One Group to Another
Once you have created your filter groups, you can organize your filters to them by dragging them from
one group to another.
To move a filter from one group to another:
1. Open the Monitor view.
2. In the Filters pane, open the filter group that contains the filter you want to move.
227
Deleting a Filter Group
3. Do either of the following:
l
Click the filter you want to move; then drag and drop it just below the title
bar of the group that is to receive the filter.
l
Open the filter group that is to receive the filter. Then drag the filter from
its original group into position in the new group.
The filter appears in its new filter group.
Deleting a Filter Group
When needed, you can delete an entire filter group. Deleting a filter group deletes all of the filters that
are stored within that group and all of the widgets that are associated with those filters. Before
deleting a filter group, be sure to move any filters you want to save into another filter group.
To delete a filter group:
1. Open the Monitor view.
2. In the Filters pane, click to select the filter group you want to delete.
228
Chapter 13: Utilizing the Console
3. Do either of the following:
l
Click the filter group’s delete
l
Click the pane’s gear
button.
button, and then click Delete.
4. At the confirmation prompt, click Yes. The filter group and all of its filters are deleted
and no longer appear in the Filters pane.
Responding to Events
The event grid’s Respond menu lets you take direct action on a particular event message. Each
Respond command opens the Respond form. The Respond form includes data from the field you
selected and options for customizing the action, just as you would configure a rule’s active response
in Rule Creation.
The Respond menu is context-sensitive. The event type or cell that is currently selected in the event
grid determines which responses you may choose from.
1. In the Monitor view’s event grid, click the specific cell of the event message you want
to respond to.
2. Click the event grid’s Respond menu, and then select the type of response you want to
make. You can choose between All Actions and a list of commonly used actions. The
Respond form appears, which has three main sections:
3. In the middle of the form, complete the action’s configuration fields. You can do this by
typing text into each field, by dragging and dropping information from the form’s event
information section, or some combination of the two.
4. Click OK to execute the action. Otherwise, click Cancel.
Using the Respond Form’s Drag and Drop Functionality
In the Respond form, you can drag and drop information from the form’s event information section (at
the bottom of the form) into its action configuration fields (in the middle of the form). You can use this
method to do any of the following:
229
Using the Respond Form’s Drag and Drop Functionality
l
add content to a blank field
l
replace the content of a field
l
add to the content that is already in a field.
You can also use a combination of typing and drag and drop to configure an action.
To place event information into a field:
Follow this procedure to add content to a blank configuration field or to replace the content of an
existing configuration field.
1. In the Respond form’s event information grid, scroll to locate the field that contains the
data element needed to configure the action.
2. Click the data and then drag it into the appropriate action configuration field (in the
middle of the Respond form). The the new data element appears in the configuration
field.
230
Chapter 13: Utilizing the Console
To add to the contents of a field from the event information:
Follow this procedure to add new field information to a configuration box, rather than replace it.
Typically, you will use this procedure to add multiple data elements to the Message box.
1. In the Respond form’s event information section, scroll to locate the field that contains
the data element you want to add to the configuration field.
2. Select the information field’s contents by clicking its data in the Information column.
3. Press Ctrl, then drag the data into the appropriate action configuration field (in the
middle of the form) to add the new data element to the configuration field.
Event Explorer
The Event explorer, which can only be opened from the Monitor view, lets you view all of the events
that are related to the event message currently selected in the Console. The Event explorer displays
both sequential and concurrent events. That is, you can view the events that occurred before, during,
and after the event message occurred. You can also monitor events in real time, to see where they
came from and where they are going.
You can explore events for any event in the Console. When you explore an event, the Console makes
a request to the Manager to determine which events are related to that event. The Event explorer then
displays a summary of events that occurred before, during, and after the system issued the event.
The Event explorer shows only those events that relate to the event that you selected. That is, it
shows the event that triggered the event, and any events that occurred because of that event (such
as a response, notification, other event, etc.).
With its straightforward graphical display, the Event explorer can help you visualize how an event
occurred and the system’s response to that event. You can follow the chain of events that caused the
event, and help determine its root cause.
Opening the Event Explorer
You can only open the Event explorer from the Monitor view’s event grid. You may explore any event
that appears in the grid.
231
Event Explorer Features
To open the Event explorer:
1. In the Monitor view’s event grid, click to select the event you want to explore.
2. In the event grid’s Explore menu, click Event. The Explore view opens, showing the
Event explorer. The Event explorer shows all of the events that are associated with the
event you are exploring. The event that you are currently focusing on appears in the
History pane. In this case, it is the event itself.
Event Explorer Features
The Event explorer has three main sections – the information pane, the event map, and the event grid.
The following table describes the key features of each section. The following topics explain how to
use each feature in detail.
Name
Description
Event Details
Click this button to alternately open and close the Event Details pane.
Event Details
The Event explorer's Event Details displays information about the event is
pane
currently selected in the event map or the event grid.
n
It provides detailed information about the event.
n
It displays a written definition of the event.
n
It allows you to create a new filter based on the event.
n
You can also copy text from this pane and paste it into explorers to explore
specific data.
This pane works exactly like Event Details pane in the Monitor view.
Event map
The event map displays a graphical view of the event you are exploring, as well as
the related events that came before and after the central event. The event you are
exploring appears in the middle. Prior events appear to the left. Events that follow
appear to the right. You can double-click any event to move that event to the
middle, which allows you to view its relationship with other events.
232
Chapter 13: Utilizing the Console
Name
Stop
Description
Click Stop to cancel an explorer lookup at any time.
Next/Previous You can step through the events in the map by clicking the Next and Previous
buttons.
Pane divider
Drag this bar up or down to resize the event map and event grid panes.
Event grid
The event grid provides a tabular version of the event map. The events are listed
chronologically, from earliest to latest.
Clicking an event in the grid highlights the corresponding item in the event map.
The information pane also changes to show information about the event you have
selected.
You can sort the event grid by each of its columns, so long as you click Pause
first.
Scroll bars
The vertical and horizontal scroll bars let you quickly scroll through the information
pane, larger event maps, and the event grid. For example, you can use the event
grid’s scroll bars to view the full range of events and all of the data associated with
each event.
Exploring Events
The event grid’s Explore menu lets you use an explorer to investigate a particular event or one of its
data fields.For example, if you select an InsertionIP cell, your explorer options include the Whois,
Traceroute, and NSLookup explorers. If you click the EventInfo cell, your only explorer options is
nDepth, because only that explorer can search the raw data for a random string.
To explore an event:
1. Open the Monitor view.
2. In the Filters pane, select the filter you want to work with. The event grid displays the
filter you have selected.
3. In the event grid, click the row (or cell) you want to explore.
233
Using the Event Map
4. In the filter's Explore menu, select the explorer you want to work with. The Explore
view appears, showing the explorer you selected. The explorer contains the data for the
cell you selected.
Using the Event Map
The top section of the Event explorer is called the event map. The event map displays a graphical
view of the event you are exploring, as well as related events that came before and after the central
event. Each event in the map can be thought of as a node that links to other events.
When you first open an event in the Event explorer, that event is always the central event in the event
map. However, you can double-click any related event to move that event to the center of the map.
This lets you see the events that came before and after that event. In this way, you can move through
the entire chain of events to analyze the relationships between them.
Reading an Event Map
l
Read the map from left to right.
l
The Event explorer always places the event you are currently exploring in the middle of
the map.
l
Related events prior to the central event appear to the left. These events “caused” the
event you are exploring. If there are no prior events, this appears as a box labeled
None.
l
Related events that follow the central event appear to the right. These events followed
or were “caused by” the central event. These are the various system responses (if any)
that were triggered by the central event. If there are no events that follow, this appears
as a box labeled None.
l
If the same event occurs multiple times, they appear together in a box, like the one
shown above for the prior events. In this example, WebTrafficAudit occurred 10 times
before triggering the rule, so they are grouped together. You can use the scroll bar to
view each event. You can also select each event in the box to view information about it
in the information pane.
234
Chapter 13: Utilizing the Console
l
Double-click an event in the event map to move that event to the center position. The
map then displays the related events that came before and after the new central event.
As before, events prior to the central event appear to the left; events that follow the
central event appear to the right.
When you select a new central event, the information pane changes to show
information about that event. The event grid also refreshes to reflect the new central
event.
l
Click Prev (previous) to move the previous event in the map to the center
position.
l
Click Next to move the next event in the map to the center position.
l
Click Stop to cancel an explorer lookup at any time.
l
Click an event in the event map to highlight the corresponding item in the
event grid.
Event Map Legend
Events that appear in the event map can be events, rules, or commands (system responses to an
event). Each type of event in the map has its own icon. The following table explains each icon.
Icon
Meaning
An event from the Audit Events tree.
An event from the Security Event tree.
An event from the Asset Event tree.
An event from the Incident event tree.
An event from the Internal Event tree that is not related to rules or active response activity.
An internal command that indicates the system has taken action to respond to an event.
Rule activity, either from a rule in test mode, or from a rule that has initiated an actual active
response.
235
Using the Event Grid
Using the Event Grid
The event grid lists all of the events that appear in the event map in a tabular form. Events are listed
chronologically, from the earliest event (top) to the latest event (bottom). The grid is useful for
comparing events and for exploring event data.
The event grid’s Order column icons indicate when each event occurred, as described in the
following table.
Icon
Meaning
The event occurred before the central event shown in the event map.
The event occurred during (as part of) the central event.
The event occurred after the central event shown in the event map.
The columns in the event grid show detailed information about the event. The columns vary,
depending on the event you are viewing. For a description of each data field that can appear in the
grid, see "Table of event data fields" on page 1.
Viewing information in the event grid
l
Click an event in the grid to highlight the corresponding item in the event map. The
information pane also changes to show information about the event you have selected.
l
When needed, you can use the vertical scroll bar to view all of the events.
l
Use the horizontal scroll bar to view all of the data fields associated with a particular
event. This same data also appears in the information pane, but as text.
l
Click an individual cell in the grid to explore that field.
l
Point to an individual cell in the grid to see a ToolTip that displays the complete
contents of the cell.
236
Chapter 13: Utilizing the Console
Exploring From the Event Grid
1. In the event map or the event grid, select the event you want to explore.
2. In the event grid, select the specific field you want to explore.
3. In the Explore menu, select the explorer you want to work with. Only those explorers
that are valid for the selected fields are available.The explorer appears, with the field
data you selected appearing in the Search box.
4. If you are using the nDepth Explorer, click Search. The other explorers begin searching
automatically.
To respond from the event grid:
1. In the event map or the event grid, select the event you want to respond to.
2. In the event grid, select the specific field you want to respond to.
3. In the Respond menu, select the response you want.
4. Complete the Respond form. See the "Actions table" on page 1 for details on
configuring each response.
Using the Event Details Pane
In the Event explorer, the upper-left pane is called the Event Details pane. It has two different views
to show the properties of the event that is currently selected in the event map or the event grid: l
The Event Details view displays detailed information about the event that is currently
selected in the grid. If more than one event is selected, it shows the properties of the
last event to be selected.
l
The Event Description view displays a written description of the last event to be
selected in the grid.
You can also use this pane to create a filter based on the selected event, to scroll through the
contents of the event grid, or to explore specific event data with other explorers.
237
Opening and Closing the Event Details Pane
Opening and Closing the Event Details Pane
You can open and close the Event explorer’s Event Details pane of two ways:
l
Click the event map’s Event Details button.
l
Position your pointer over two thin lines next to the Event Details pane (or if the pane is
closed, next to the left side of the event map). When the pointer turns into a doubleheaded arrow, double-click to open or close the pane. When the Event Details pane
opens, it shows information about the event that is currently selected in the event map
or event grid.
Viewing an Event’s Event Details
To view details information about a particular event or event:
l
Click the event in the event map.
l
Click the event in the event grid.
The Event Details pane displays information about the event you selected.
Exploring From the Event Details Pane
1. The following table explains how to use the toolbar at the top of the Event Details
pane.
Button
Description
Click this button to create a new filter that captures the currently selected
event type. Upon doing so, the Monitor view opens, with the new filter open
in the event grid. The new filter appears in the Filters pane, under the last
selected filter. If needed, you can edit the filter so it captures events of an
even more specific nature. See "Editing an existing filter" on page 1.
238
Chapter 13: Utilizing the Console
Button
Description
Click these buttons to move up and down among the events in the event
event grid. The pane shows detailed technical information about each event
that is selected. This lets you view the technical details and written
descriptions of each event in the grid.
Remember, you can also use your keyboard's up (↑) and down (↓) arrow
keys: n
To cycle through the events in the event grid, click anywhere in the
event event grid. Then use your up and down arrow keys.
n
To cycle through the fields in the Event Details pane, click
anywhere in the Event Details grid. Then use your up and down
arrow keys.
Click this button to open the pane’s Event Details view. This view shows
detailed information about each of the selected event's data fields. The
actual fields that appear here vary, according to the event type that is
currently selected. For example, network-oriented events show fields for IP
addresses and ports. Account-oriented events show account names and
domains.
Click this button to open the pane’s Event Description view, which provides
a detailed written description of the event type that is currently selected.
2. In the event map or the event grid, select the event you want to explore.
3. In the Event Details pane's Information column, click the event field you want to
explore.
4. In the Explore list, select the explorer you want to work with. The explorer appears,
with the field data you selected appearing the Search box.
5. If you are using the nDepth Explorer, click Search. The other explorers begin searching
automatically.
Performing nDepth Searches
Data searches are at the heart of nDepth. For that reason,SolarWinds has invested a lot of effort to
239
Performing nDepth Searches
provide you with useful search results with the least amount of effort. Mastering a few basic
techniques can provide you with most of the information you will ever need.
The topics in this section explain the most common procedures you need to get the most out of your
nDepth searches.
Data searches are at the heart of nDepth. For that reason,SolarWinds has invested a lot of effort to
provide you with useful search results with the least amount of effort. Mastering a few basic
techniques can provide you with most of the information you will ever need.
The topics in this section explain the most common procedures you need to get the most out of your
nDepth searches.
Use the following procedure to perform an nDepth search. This method is the same, regardless of
which nDepth view you are using.
To perform a search:
1. Open the Explore >nDepth view.
2. Use the search bar's far-right toggle switch to choose the type of data you want to
explore:
l
Select Events (left position) to search the normalized event data that
appears in the Monitor view.
l
Select Log Messages (right position) to search the actual log entries that
are recorded on your network products' log files. If this position is
disabled, it means your equipment does not have the capacity to store
and search the original log messages.
3. Use the search bar's far-left toggle switch to select how you want to enter the search
string:
l
Select Drag & Drop Mode (upper position) to drag items from the list
pane or the Result Details view directly into the search box. This is the
recommended position, as it is it the easiest to use and the best way to
avoid mistakes.
l
Select Text Input Mode (lower position) to type search strings directly in
the search box.
240
Chapter 13: Utilizing the Console
4. In the search box, enter your search string. By default, the search box includes a "this
item exists" condition, so you can begin searching right away, without having to drag
and drop anything. To use this condition, click an item on one of nDepth's graphical
tools, or type or paste a search string directly in the text box.
In Drag & Drop Mode, the search box indicates when a particular configuration is
invalid:
l
If a condition field is yellow, it means the search's configuration is invalid.
l
If a condition field is red , it means the search conditions do not apply to
the type of data you are currently searching. For example, you are
searching log messages with conditions that are meant for event data.
5. If you select more than one condition, determine the AND/OR relationship between
each condition. Click the operator icon to toggle between AND and OR relationships.
By default, searches use AND operators for each condition in the search string. But
there is one exception—if you are selecting multiple items from a widget, it defaults to
an OR relationship for the group of items from that widget.
6. In the time selector, select the time frame for which you want to search the data. By
default, nDepth reports your network event activity over the last 10 minutes (the end
time is now, and the start time is 10 minutes ago).
See create your own custom time frame.Be aware that the longer the time frame, the
more numerous your search results will be.
7. Click the Search
any time by clicking
button to run the search. If needed, you can stop a search at
.After a moment, nDepth's graphical tools summarize your
search results. The Result Details view shows the actual data.
Creating Search Conditions
nDepth lets you create search conditions many different ways. The following table explains how to
241
Creating Search Conditions
add search conditions, both in Drag & Drop Mode and in Text Input Mode.
Mode
To
D&D Text
Do this
Clear a search from the
On the search bar, click the round Delete All
search box
(next to the
●
button).
1. On the search bar, click
Add a new search
button ●
to clear the
●
●
●
●
●
●
In the Refine Fields list, double-click an item.
●
●
In any list, select the item you want to work with, then
●
search box.
2. Add new search conditions by using any
of the techniques in this table.
Add conditions to an existing Use any of the techniques listed in this table. nDepth
search
automatically adds new search conditions to the search
string.
Add a search
Click an item in a graphical tool to add that item to the
condition from a widget or
search box.
other graphical tool
Add a search
condition
from the list pane
drag that item directly into the search box.
Add a search from
Configure a search with Search Builder. Search Builder ●
Search Builder
automatically populates the search bar with its search
configuration. This is because the search bar and the
Search Builder are different views of the same search.
242
●
Chapter 13: Utilizing the Console
Mode
To
Do this
Add a search
Select a character string from the data. Then double-
condition from the Result
click the string to add it to the search box.
Details view
D&D Text
●
●
Select a character string from the data, and then drag it ●
into the search box.
Select a character string from the data. Then copy
●
(Ctrl+C) the search string and paste (Ctrl+V) it in the
text box.
Type a search string
Type a search string directly in the search box.
Perform the search
On the search bar, click
.
●
●
●
Deleting Items From Search Strings
As with the Search Builder, you can use the search bar to delete search conditions from a search
string. There are buttons to delete individual conditions, groups of conditions, or the entire string.
The following table explains how to delete search conditions directly from the search bar. For the
examples in this table, suppose you have a set of search conditions that looks like this:
Severity = 4
AND
( InsertionIP = SolarWinds-demo50 OR
InsertionIP = intrepid )
243
Creating Custom time frames
To
Delete an individual search
Do this
Click the
button next to the condition in the search string.
condition
Example:
Use this method to delete Severity = 4.
To delete a group of con-
Click the
button at the far right of the search box
ditions
Example:
Use this method to delete the OR group containing the two Insertion
IPs.
Delete the entire search
Click the round Delete All
button (next to the Search) button.
string
Example:
Use this method when you want to delete the entire search string to
begin a new search.
Creating Custom time frames
Use the following procedure to create a custom time frame for your nDepth queries.
To create a custom time frame:
1. In the search bar's time selector list, click Custom range. You can use the calendars
that appear to set your From and To date and time range. By default, the custom time
frame shows the time frame of your last search.
2. Use the two calendars to select the start (From) date and time, and the end (To) date
and time, as described in the following table.
244
Chapter 13: Utilizing the Console
To
Pick a date in the
Do this
Click the date.
month shown
Go to an earlier
Click ◄.
month
Go to a later
Click ►.
month
Go to an earlier
Click ▼.
year
Go to a later year
Click ▲.
Select a different
Type a new time directly in the time box.
time
Or in the hour, minute, and second fields, click ▼ for an earlier
value, or click ▲ for a later value, respectively.
Note: You can use your keyboard’s up, down, right, and left arrows to move within the
calendar and to select a time.
3. To close the calendar, click anywhere outside of its boundary.
Saving a Search
You can save any search that you create so you can reuse it at any time. Saved searches include
your entire search string as well as the time frame you have selected.
To save a search:
1. In nDepth, perform a search as described above, until your results are satisfactory.
2. Click the gear
button and then click Save As. The Save This Search form
appears.
245
Using a Saved Search
3. In the Search Name box, type a name that will easily help you remember the focus of
this search. You can type up to 200 characters.
4. Click OK. Your search appears in the Saved Searches pane. Saved searches use the
following icons:
represents a search for event data. represents a search for original log messages.
Using a Saved Search
One of the great benefits of saving a search is that you can reuse it at any time. Saved searches are
stored in the Saved Searches pane. Saved searches are listed alphabetically.
To use a saved search:
1. Open the Explore >nDepth view.
2. If the Saved Searches pane is not visible, click the History button to open it.
3. On the search bar, select the type of data you want to search — Events or Log
Messages.
4. In the Saved Searches pane, click the search you want run. After a moment, nDepth
shows the search results.
Tip: Pointing to a search in the Saved Searches pane displays a ToolTip with the full
name of the search.
Making Changes to a Saved Search
When needed, you can make changes to any of your saved searches, and then save your changes as
the search's new configuration.
246
Chapter 13: Utilizing the Console
To save your changes to a search:
1. Open the Explore >nDepth view.
2. If the Saved Searches pane is not visible, click the History button to open it.
3. In the Saved Searches pane, click the name of the search you want to perform.
4. Use the search bar to reconfigure the search, as needed.
5. Click the gear
button and then click Save. The search is now saved with the new
configuration. The next time you run it from the Saved Searches pane, it will run with
this configuration.
Exporting nDepth Search Results to PDF
The results of any nDepth search can be exported to a full-color, printable report. The report is
exported as a PDF file for easy storage, printing, and e-mail attachment.
Note: PDF reports are limited to 25,000 events or log messages. If you need a larger report, you can
use the Result Details view to export your search results to a spreadsheet in CSV format.
To export nDepth search results to PDF:
1. In nDepth, perform a search so nDepth shows the information you want reported.
2. Click the gear
button and then click Export.
3. Customize your report in the nDepth Export window using the following options.
a. Use the navigation bar at the bottom to preview your search results in the default
format.
b. Use Insert Page Before Current Page on the navigation bar to add a blank
247
Exploring Search Results from Graphical Views
report page.
c. Use Toggle…orientation on the navigation bar or on an individual report page
thumbnail to switch between portrait and landscape page orientation.
d. Click Items on the left to open a list of report items that you can drag into your
report body.
e. Click Saved Layouts on the right to open a list of options related to saving and
applying report layouts.
f. Hover over report pages and other elements, such as titles, graphs, and text, to
access additional configuration options. Options to clear all page contents, enter
static text, and delete pages or other elements appear as you hover over each
element.
g. Drag charts and graphs to rearrange them in the report body.
4. Click Export to PDF to export the report in the Preview pane.
5. In the Save PDF As window, choose a destination and file name for your report.
6. Click Save.
Exploring Search Results from Graphical Views
When using nDepth's graphical views, you can explore event details with other explorers. This allows
you to use other explorers to investigate specific event details in your nDepth search results. For
example, you could investigate a suspicious IP address with the NSLookup, Traceroute, or Whois
explorers to figure out where that IP is.
Note: When using explorers with nDepth's graphical views, you must manually type the event detail
you want to explore. This information is not automatically "fed" into the explorer, like it is with
nDepth's Result Details view.
248
Chapter 13: Utilizing the Console
To explore details with other explorers:
1. From any of nDepth's graphical views, click the Explore menu. Then select the
explorer you want to use to explore the event detail.
The Explore >Utilities view appears.
2. Type the event detail into the appropriate explorer field.
3. Click Search or Analyze, as applicable to the explorer.
Taking Action on Event Details
When using nDepth's graphical views, you can respond to any item that is reported in nDepth's
search results. If you see something unusual, you may want to take some kind of corrective action.
For example, you could send a user account a popup message, or block a hostile IP address. Use the
following procedure to initiate a response or corrective action to a particular event or event detail.
To initiate a response:
1. From any of nDepth's graphical views, click the Respond menu. Then select the
response you want.
2. Complete the Respond form, as applicable for the response.
Deleting a Saved Search
When needed, you can easily delete any unwanted searches from your Saved Searches pane.
Deleting a saved search is permanent. If you want to restore the search, you will have to recreate it
and save it.
To delete a saved search:
1. Open the Explore >nDepth view.
2. If the Saved Searches pane is not visible, click the History button to open it.
249
Creating Search Conditions
3. In the Saved Searches pane, point to the search you want to delete; then click the
icon next to the search.
4. At the confirmation prompt, click Yes.
Creating Search Conditions
nDepth lets you create search conditions many different ways. The following table explains how to
add search conditions, both in Drag & Drop Mode and in Text Input Mode.
Mode
To
D&D Text
Do this
Clear a search from On the search bar, click the round Delete All
the search box
Add a new search
the
button (next to
●
●
to clear the search box. ●
●
button).
1. On the search bar, click
2. Add new search conditions by using any of the
techniques in this table.
Add conditions to
Use any of the techniques listed in this table. nDepth auto-
●
●
an existing search
matically adds new search conditions to the search string.
Add a search
Click an item in a graphical tool to add that item to the search box. ●
●
In the Refine Fields list, double-click an item.
●
●
In any list, select the item you want to work with, then drag that
●
condition from a
widget or other
graphical tool
Add a search
condition
from the list pane
item directly into the search box.
Add a search from
Configure a search with Search Builder. Search Builder
Search Builder
automatically populates the search bar with its search
configuration. This is because the search bar and the Search
Builder are different views of the same search.
250
●
●
Chapter 13: Utilizing the Console
Mode
To
Do this
Add a search
Select a character string from the data. Then double-click the
condition from the
string to add it to the search box.
Result Details
view
Select a character string from the data, and then drag it into the
D&D Text
●
●
●
search box.
Select a character string from the data. Then copy (Ctrl+C) the
●
search string and paste (Ctrl+V) it in the text box.
Type a search
Type a search string directly in the search box.
●
string
Perform the search On the search bar, click
.
251
●
●
Deleting Items From Search Strings
Deleting Items From Search Strings
As with the Search Builder, you can use the search bar to delete search conditions from a search
string. There are buttons to delete individual conditions, groups of conditions, or the entire string.
The following table explains how to delete search conditions directly from the search bar. For the
examples in this table, suppose you have a set of search conditions that looks like this:
Severity = 4
AND
( InsertionIP = SolarWinds-demo50 OR
InsertionIP = intrepid )
Item
To
Delete an individual
Do this
Click the
button next to the condition in the search string.
search condition
Example:
Use this method to delete Severity = 4.
To delete a group of con-
Click the
button at the far right of the search box
ditions
Example:
Use this method to delete the OR group containing the two
Insertion IPs.
Delete the entire search
Click the round Delete All
string
button.
button (next to the Search)
Example:
Use this method when you want to delete the entire search
string to begin a new search.
252
Chapter 13: Utilizing the Console
Creating Custom time frames
Use the following procedure to create a custom time frame for your nDepth queries.
To create a custom time frame:
1. In the search bar's time selector list, click Custom range. You can use these
calendars to set your From and To date and time range. By default, the custom time
frame shows the time frame of your last search.
2. Use the two calendars to select the start (From) date and time, and the end (To) date
and time, as described in the following table.
To
Pick a date in the
Do this
Click the date.
month shown
Go to an earlier
Click ◄.
month
Go to a later
Click ►.
month
Go to an earlier
Click ▼.
year
Go to a later year
Click ▲.
Select a different
Type a new time directly in the time box.
time
Or in the hour, minute, and second fields, click ▼ for an earlier
value, or click ▲ for a later value, respectively.
Note: You can use your keyboard’s up, down, right, and left arrows to move within the
calendar and to select a time.
3. To close the calendar, click anywhere outside of its boundary.
253
Managing Connectors
Managing Connectors
Use the following procedure whenever you need to open the Connector Configuration form. This
form is used for the following reasons:
l
To configure and manage a Manager’s sensor, actor, and notification connectors.
l
To configure and manage an Agent’s sensor and actor connectors.
l
To change the connectors configured in an Agent’s Connectors Profile.
Note: To change a Connector Profile's membership and properties, edit the Connector
Profile in the Build >Groups view.
Opening a Manager’s Connector Configuration form:
1. On the LEM Console, click Manage >Appliances.
2. In the Appliances grid, click to select the Manager you want to work with.
3. If needed, log in to the Manager. To do so, click the gear
button and then click
Login.
4. Click the gear
button and then click Connectors. The Connector Configuration
for [Manager] form appears. You may now add the connector instances for each
network security product or device this Manager is to monitor or interact with on the
Manager computer.
Opening an Agent’s Connector Configuration form:
1. If needed, log in to the Manager you want to work with.
2. On the LEM Console, click Manage >Agents.
3. In the Agents grid, click to select the Agent you want to work with.
254
Chapter 13: Utilizing the Console
4. Click the gear
l
button and then click Connectors.
If the Agent is not in a Connector Profile, the Connector Configuration
for [Agent] form appears. You may now add the connector instances for
each network security product or device this Agent is to monitor or
interact with on the Agent’s computer.
l
If the Agent is in a Connector Profile, the Agent Connector
Configuration prompt appears. A prompt warns you that the Agent
belongs to a Connector Profile.
You can choose to edit the Connector Profile, which affects every Agent
in that profile; or you can remove the Agent from the profile to configure
the Agent separately.
5. Do one of the following:
l
To edit the connector Profile, click Connector Profile.
The Connector Configuration for [Connector Profile] form appears.
You may now begin adding, editing, or deleting the connector instances
associated with that Connector Profile.
l
To remove the Agent from the Connector Profile and configure its
connectors separately, click Agent Connector Configuration.
The Connector Configuration for [Agent] form appears. You may now
add the connector instances for each network security product or device
this Agent is to monitor or interact with on the Agent’s computer.
Adding New Connector Instances
In this procedure, use the Connector Configuration form to do the following:
l
Configure the connector settings for each sensor that is to gather data from a network
security product’s event logs.
255
Adding New Connector Instances
l
Configure the connector settings for each actor that is to initiate an active response
from a network security product or device.
Each configuration of a sensor or actor connector is called a connector instance. Most products
typically write to only one log source. For these products, a single connector instance will suffice.
However, some products write to more than one log. For these products, create separate connector
instances—one instance for each log source. When a product requires more than one instance, you
can differentiate between them by assigning each instance a unique name, called an alias.
To add a new connector instance:
1. Open the Connector Configuration form for the Manager or Agent you want to work
with.
2. If desired, use the Refine Results pane to select the connector Category you want to
work with.
3. In the Connectors grid, click to select the connector to be configured.
l
The
icon means the connector is for a sensor.
l
The
icon means the connector is for an actor.
4. Do either of the following:
l
At the top of the Connectors grid, click New.
l
Click the connectorrow’s gear
button and then click New.
The Properties pane opens as an editable form. The fields on the form vary from one
connector to another, in order to support the product or device you are configuring. For
new instances, the form displays the default connector settings needed to configure the
associated product or device. In most cases, you can save the connector with its
default settings; however, you can change the settings, as needed.
5. Complete the Properties form, as needed. To assist you, we have prepared some
reference tables that explain the meaning of each field you may encounter in the
Properties form.
256
Chapter 13: Utilizing the Console
6. Click Save to save the connector configuration as a new connector instance;
otherwise, click Cancel. Upon saving, the following things happen in the connectors
grid:
l
If you configured a sensor, a sensor connector instance
icon appears
below the connector you are working with.
l
If you configured an actor, an actor connector instance
icon appears
below the connector you are working with.
l
The
icon in the Status column means the connector instance is
stopped. All new connector instances automatically have a status of
Stopped. To begin using the connector, you must start it.
7. To start the connector instance, click its gear
button and then click Start. After a
moment, the system starts the connector instance. Upon starting, the connector’s
Status icon changes to
. The selected connector instance is now running.
8. If needed, repeat Steps 3–7 for each additional connector instance that is required to
fully integrate this product or device with the LEM.
Starting a Connector Instance
Whenever you finish adding or reconfiguring a connector instance, you must start it so it can begin
running. Starting a connector instance enables that particular connector configuration. If the
connector instance is for a sensor, starting it enables the sensor to begin monitoring the product’s
event log. If the connector instance is for an actor, starting it enables the actor to begin initiating
active responses on that product when requested to do so by policy.
To start a connector instance:
1. Open the Connector Configuration form for the Manager or Agent you want to work
with.
2. In the Connectors grid, click to select the connector instance you want to start.
3. Click the connector instance’s gear
257
button and then click Start.
Stopping a Connector Instance
After a moment, the system starts the connector instance. Upon starting, the
connector’s Status icon changes to
. The selected connector instance is now
running.
Common problems with starting connector instances
If the connector fails to start, the Console will display a Warning or a Failure event that states the
problem. Normally, connectors fail to start for either of the following reasons:
l
The network security device’s log file does not exist.
l
The Agent does not have permission to access the file.
Stopping a Connector Instance
Use this procedure to stop a connector instance. You must always stop a connector instance before
you can edit or delete that connector instance. However, you can also stop a connector instance to
prevent the connector from gathering data for the Console, or to prevent it from initiating active
responses on a network security product or notification system.
To stop a connector instance:
1. Open the Connector Configuration form for the Manager or Agent you want to work
with.
2. In the Connectors grid, click to select the connector instance you want to stop.
3. Click the connector instance’s gear
button and then click Stop.
After a moment, the system stops the connector instance. When the connector’s
Status icon changes to
, it means the connector has stopped.
Once a connector instance has been stopped, it can be edited, deleted, or restarted, as
needed. The connector instance will remain stopped until you restart it.
258
Chapter 13: Utilizing the Console
Editing a Connector Instance
When needed, you can edit an existing connector instance’s configuration settings. However, you
cannot edit its name (alias). If you need to rename a connector instance alias, you must delete the
current connector instance and create a new one with the new name. Also, you cannot edit the Log
File value for some Windows event log sensors.
Use this procedure whenever you need to correct or change a connector’s configuration.
To edit a connector instance:
1. Open the Connector Configuration form for the Manager or Agent you want to work
with.
2. In the Connectors grid, click to select the connector instance you want to edit.
3. Click the connector instance’s gear
button and then click Stop. After a moment,
the system stops the connector instance. When the connector’s Status icon changes
to
, it means the connector has stopped.
4. To edit the connector, click the gear
button and then click Edit.
5. In the Properties form, update the connector settings, as needed:
To assist you, we have prepared some reference tables that explain the meaning of
each field you may encounter in the Properties form.
6. Click Save to save your changes.
7. When you are finished, restart the connector instance by clicking the gear
and then clicking Start.
Deleting a Connector Instance
When needed, you can delete an obsolete or incorrect connector instance.
259
button
Creating Connector Profiles to Manage and Monitor LEM Agents
To delete a connector instance:
1. Open the Connector Configuration form for the Manager or Agent you want to work
with.
2. In the Connectors grid, click to select the connector instance you want to delete.
3. Click the connector instance’s gear
button and then click Stop.After a moment,
the system stops the connector instance. When the connector’s Status icon changes
to
, it means the connector has stopped.
4. Click the connector instance’s
button and then click Delete.
5. At the confirmation prompt, click Yes to delete the connector instance. After a moment,
the connector instance disappears from the Connectors grid.
Note: Do not recreate this connector until it has been completely removed. It may take
up to two minutes for the connector to be deleted from your system.
Creating Connector Profiles to Manage and Monitor LEM Agents
Use Connector Profiles to manage and monitor similar LEM Agents across your network. The
following two use cases are the most common for this type of component.
l
Configure and manage connectors at the profile level to reduce the amount of work you
have to do for large LEM Agent deployments.
l
Create filters, rules, and searches using your Connector Profiles as Groups of LEM
Agents. For example, create a filter to show you all Web traffic from computers in your
Domain Controller Connector Profile.
Complete the two procedures below to create a Connector Profile using a single LEM Agent as its
template.
To create a Connector Profile using a LEM Agent as a template:
1. Configure the Connectors on the LEM Agent to be used as the template for the new
Connector Profile. These connectors are applied to any LEM Agents that are later
260
Chapter 13: Utilizing the Console
added to the Connector Profile.
2. Click Build , and then select Groups.
3. Click the
button, and then select Connector Profile.
4. Enter a name and description for the Connector Profile.
5. Select the desired LEM Agent template from the Template list next to the Description
field.
6. Click Save.
To add LEM Agents to your new Connector Profile:
1. Locate the new Connector Profile in the Build > Groups view.
2. Click the gear
button next to your Connector Profile, and then select Edit.
3. Move LEM Agents from the Available Agents list to the Connector Profile by clicking
the arrow next to them.
4. If you are finished adding LEM Agents to your Connector Profile, click Save.
5. The connector configurations set for the template agent will be applied to any agent
added to the Connector Profile.
Using an Agent to edit a Connector Profile
You can use an Agent that is a member of a Connector Profile as a vehicle for editing that profile’s
connector settings. You can add new connector instances to the profile, or edit or delete its existing
instances. Use caution when editing a Connector Profile. The changes you make will apply to every
Agent that is a member of that profile.
You can also edit a Connector Profile's connector settings from the Manage > Agents view.
To use an Agent to edit a Connector Profile’s connector settings
1. Open the Manage >Agents view.
2. In the Agents grid, click to select the Agent that is in the Connector Profile you want to
edit.
261
File Integrity Monitoring Connectors
3. Click the gear
button and then click Connectors. The Agent Connector
Configuration prompt appears to warn you that the Agent belongs to a Connector
Profile.
4. Click Connector Profile. The Connector Configuration for [Connector Profile]
form appears. You may now begin adding, editing, or deleting the Connector instances
that are associated with that Connector Profile.
File Integrity Monitoring Connectors
File Integrity Monitoring (FIM) provides the ability to monitor files of all types for any unauthorized
changes that may lead to a data breach by a malicious attack. Using FIM, you can detect changes to
critical files, both to ensure systems are free of compromise and to ensure critical data is not being
changed by unauthorized modifications of systems, configurations, executables, log and audit files,
content files, database files, and web files. If FIM detects a change in a file you are monitoring, it is
logged. LEM then takes those logs and performs the configured action. Correlation rules can be built
to act as a second-level filter to only actively send an alert to certain patterns of activity (not just
single instances), and when an alert is triggered, the data is in context with your network and other
system log data With a SIEM like LEM, you can also respond with administrative action.
Features of FIM
l
On Windows (XP, Vista, 7, 8, Server 2003, 2008, 2012), monitors for real-time access
and changes to files and registry keys and WHO changed them
l
Allows you to configure the logic of files/directories and registry keys/values to monitor
for different types of access (create, write, delete, change permissions/metadata)
l
Provides the ability to standardize configurations across many systems
l
Provides monitoring templates which can be used to monitor the basics. Also allows
the option of creating and customizing your own monitors.
l
Provides templates for rules, filters, and reports to assist in including FIM events
quickly
262
Chapter 13: Utilizing the Console
What can FIM detect?
l
Insider abuse by auditing files directly through intelligent correlation rules. Active
integration with active directory settings can disable accounts, change user groups and
rights.
l
If a critical registry key is changed (if registry is supported). For example, a new service
is installed, software is installed, a key gets added to "hide" data in an unexpected
area.
l
If a new driver or a similar device is installed. Adds a layer of defense to anti virus
software for detecting viruses that mask as "similarly" named files (like ntkernl.sys vs.
ntkernI.sys).
l
If critical business files are accessed and who is accessing them. Detects potential
abuse, unexpected access, or changes to sensitive data.
l
If files are moved. Usually when users move directories into other directories.
l
Zero-day exploits, which is an attack that takes advantage of security vulnerabilities
the same day the vulnerability becomes known. FIM can trigger an alert letting you
know there has been a file change by a potential malware or Trojan and can
automatically stop the running malware process.
l
Advanced Persistent Threats by inserting a granular, file-based auditing into the
existing event stream to pinpoint attacks and help block them in progress.
Adding a FIM Connector
To add a FIM connector:
1. Navigate to Manage > Nodes to see a listing of all the nodes being monitored by LEM.
2. Select the desired node, then click the gear
icon next to it and select
Connectors.
3. Enter FIM in the Refine Results pane. The search results in FIM Registry and also FIM
File and Directory.
4. Select either a FIM file and Directory or a FIM Registry.
263
Monitors
5. Click the gear
icon next to the FIM Connector profile you want to work with, then
select New to create a new connector. The Connector Configuration window displays.
6. Select a Monitor from the Monitor Templates pane, and then click the gear
icon
and select Add to selected monitors. The Monitor Template then moves to the
Selected Monitor pane.
7. Click Save, or click Add Custom Monitor to modify the monitor to your requirements.
Monitors
Monitors allow you to configure rules for which files to watch, and which actions to watch for those
files. Different monitoring templates have been provided to use right away, and to assist in creating
custom templates or configurations.
Adding Custom Monitors
1. Click Add Custom Monitor in the Connector Configuration window.
2. Enter a Monitor Name.
3. Enter a Description for the monitor.
4. Click Add New. The Add Condition window displays. See Adding Conditions for more
information on how to add conditions to monitors.
Editing Monitors
1. Select a Monitor from the Selected Monitors pane.
2. Click the gear
icon and select Edit monitor
Promoting a Monitor to a Template
1. Select the Monitor to be promoted.
2. Click the gear
icon and select Promote monitor to template.
264
Chapter 13: Utilizing the Console
3. Click Yes to promote this monitor to a template. The monitor is now available in the
Monitor Templates pane.
Deleting a Monitor
1. Select the monitor to be deleted.
2. Click the gear
icon and select Delete.
3. Click Remove. The monitor is then removed from the Selected Monitors pane.
Adding Conditions
1. Click Add New in the Conditions window.
2. Click Browse to select a File and Directory or a Registry key to watch.
3. Click OK.
4. Select whether the files are recursive or non-recursive. Refer to the table below for
more information.
Recursive
The folder selected and all its sub-folders which
match the given mask will be monitored for
corresponding selected operations.
Non-recursive
Only the files in the selected folders will be
monitored.
5. Enter a Mask. For example, *exe or directory*.
6. For a FIM File and Directory, select Create, Read, Write, and Delete for Directory,
File, Permissions, and Other operations. For a FIM Registry, select Create, Read,
Write, and Delete for Key and Value operations. For more information on Other, refer
to the Microsoft MSDN information.
7. Click Save.
265
Editing Conditions
Editing Conditions
1. Select the condition to be edited in the Conditions window.
2. Click Edit.
3. Click Browse to select a File and Directory or a Registry key to watch.
4. Click OK.
5. Select whether the files are recursive or non-recursive. Refer to the table below for
more information.
Recursive
The folder selected and all its sub-folders which
match the given mask will be monitored for
corresponding selected operations.
Non-recursive
Only the files in the selected folders will be
monitored.
6. Enter a Mask. For example, *exe or directory*.
7. For a FIM File/Directory, select Create, Read, Write, and Delete for Directory, File,
Permissions, and Other operations. For a FIM Registry, select Create, Read, Write,
and Delete for Key and Value operations. For more information on Other, refer to the
Microsoft MSDN information.
8. Click Save.
Deleting Conditions
1. Select the condition to be deleted in the Conditions window.
2. Click Delete.
3. Click Remove.
FIM Connector Advanced Settings
1. Complete the Advanced Connector Settings form according to the device you're
configuring. The following fields/descriptions are common for most connectors:
266
Chapter 13: Utilizing the Console
Log Directory
When you create a new alias for a connector, LEM automatically places a
default log file path in the Log Directory field. This path tells the connector
where the operating system stores the product’s event log file.
In most cases, you should be able to use the default log file path that is
shown for the connector. These paths are based on the default vendor
settings and the product documentation for each product. If a different log
path is needed,
To manually change the log file location:
1. Enter or paste the correct path in the Log Directory field.
2. Stop the Agent.
3. Manually update the Agent's spop.conf property
o
com.solarwinds.lem.fim.minifilter.fsLogLocation for a
file and directory connector. This appears as
%SystemDrive%\\Mylocation\\FileSystem in the config
file.
o
com.solarwinds.lem.fim.minifilter.registryLogLocation
for a registry connector . This appears as C:\\My other
log location\\Registry in the config file.
4. Restart the Agent.
Log Data Type to
Select either nDepth, Alert, or Alert, nDepth. To store a copy of the original
Save
log data in addition to normalized data, change the Log Data Type to Save to
Alert, nDepth. Storage for original log data must also be enabled on the appliance.
nDepth Host
If you are using a separate nDepth appliance (other than LEM), type the IP
address or host name for the nDepth appliance. Generally, the default setting
is correct. Only change it if you are advised to do so.
nDepth Port
If you are using a separate nDepth appliance (other than the SolarWinds
LEM), type the port number to which the connector is to send nDepth data.
Generally, the default setting is correct. Only change it if you are advised to
do so.
267
Managing Widgets
Sleep Time
Type or select the time (in seconds) the connector sensor is to wait between
event monitoring sessions. The default (and minimum) value for all
connectors is one (1) second. If you experience adverse effects due to too
many rapid readings of log entries, increase the Sleep Time for the
appropriate connectors.
Windows NT-based connectors automatically notify Windows Event Log
sensors of new events that enter the log file. Should automatic notification
stop for any reason, the Sleep Time dictates the interval the sensor is to use
for monitoring new events.
Wrapper Name
This is an identification key that the SolarWinds LEM uses to uniquely
identify the properties that apply to this particular connector. This is read-only
information for SolarWinds reference purposes.
Tool Version
This is the release version for this connector. This is read-only information for
reference purposes.
Enable Connector
When this option is selected, the connector starts when you click Save.
Upon Save
7. After completing the form, click Save.
8. If you did not select the Enable Connector Upon Save option, navigate to the
Connectors list and click the gear
button next to the new connector (denoted by
an icon in the Status column), and then select Start.
9. After starting the connector, verify that it is working by checking for events on the
Monitor tab.
Managing Widgets
The topics in this section explai n how to use the Widget Manager to create and manage your
widgets.
268
Chapter 13: Utilizing the Console
Opening and Closing the Widget Manager
l
At the top of the Ops Manager view, click Widget Manager to alternately open and
close the Widget Manager.
The Widget Manager includes the Filters pane and the Widgets pane.
Creating New Master Widgets
In the Ops Center, you can use the Widget Manager to create a new master widget for any of your
filters. Widgets are created with a tool called the Widget Builder, which allows you to define the new
widget’s foundational and aesthetic settings. It also allows you to save a copy of the new widget to
the Ops Center dashboard.
To create a new master widget from the Ops Center:
1. Open the Ops Center view.
2. If needed, click Widget Manager to open the Filters and Widgets panes.
3. Click the
button. The Widget Builder appears.
4. Complete the Widget Builder.
5. Select the Save to Dashboard check box if you want to save a copy of the new widget
to the Ops Center dashboard.
6. When you are finished, click Save. Upon saving the new widget, several things
happen:
l
In the Filters pane, the Count value of the associated filter increases by
one to account for the new widget.
l
The new widget appears in the Widgets pane for the associated filter.
l
The next time you open the widget’s source filter in the Monitor view, the
new widget will appear in the Widgets pane’s widget list.
269
Editing Master Widgets
l
If you selected the Save to Dashboard option, a copy of the widget also
appears in the Ops Center dashboard.
Editing Master Widgets
In the Ops Center, you can use the Widget Manager to edit any of the master widgets that are
associated with a filter. Typically, you will edit a master widget when you want to change a master
widget’s name, behavior, or appearance, or whenever you want to use the master widget as a
template to create a new dashboard widget based on the master widget’s current configuration.
Once saved, an updated master widget appears with its new configuration in the Ops Center’s
Widget Manager and in the Monitor view’s Widgets pane.
Once created, each dashboard widget operates independently of the master widget it was created
from. Therefore, editing a master widget does not affect any previous copies (dashboard widgets) that
were created from that master. This independence lets you use a master widget as a template for
creating variations of the same widget for the Ops Center dashboard.
To edit a master widget in the Ops Center:
1. Open the Ops Center view.
2. If needed, click Widget Manager to open the Filters and Widgets panes.
3. In the Filters pane, select the filter you want to work with.The widgets associated with
this filter appear in the Widgets pane.
4. Drag the pane’s scroll bar left or right to browse the filter's widgets.
5. When you find the widget you want to edit, click the Filters pane gear
button. The
Widget Builder appears.
6. Use the Widget Builder to reconfigure the widget, as needed.
7. Select Save to Dashboard if you want to save a copy of the reconfigured master
widget to the Ops Center dashboard.
8. Click Save to save your changes to the widget. The master widget’s new configuration
appears in the Widgets pane. If you selected the Save to Dashboard option, a copy of
the newly configured widget also appears in the Ops Center dashboard.
270
Chapter 13: Utilizing the Console
Adding Widgets to the Dashboard
Use either of the following procedures to add a copy of a master widget to the Ops Center
dashboard. The original remains with its filter. Once a copy is on the dashboard, you may edit its
graphical presentation, as needed.
To add a widget from the Widgets pane to the dashboard:
1. Open the Ops Center view.
2. Click Widget Manager to open the Filters and Widgets panes.
3. In the Filters pane, select the filter you want to work with.The widgets associated with
this filter appear in the Widgets pane.
4. To preview the widgets in the Widgets pane, do one of the following: l
Drag the pane’s scroll bar left or right to browse the filter's widgets.
l
Click any widget to move it to the front of the pane.
5. When you find the widget you want to add to the dashboard, do either of the following:
l
Click Add to Dashboard.
l
Click anywhere on the widget. Drag it to the dashboard, and then drop it
in the position you want.
To add a widget to the dashboard from the Widget Builder:
1. When creating or editing a master widget with the Widget Builder, configure the form
so the widget appears the way you want it to on the dashboard.
2. Select the Save to Dashboard check box.
3. Click Save. A copy of the widget appears at the bottom of the Ops Center dashboard.
Deleting Master Widgets
Widgets can only be deleted from the Ops Center, and master widgets can only be deleted from the
271
Editing a Dashboard Widget
Widget Manager. Deleting a master widget does not delete any of the dashboard widgets that came
from that master.
To delete a master widget:
1. Open the Ops Center view.
2. If needed, click Widget Manager to open the Filters list and the Widgets pane.
3. In the Filters list, select the filter that contains the widget you want to delete.
4. In the Widgets pane, use the scroll bar to select the widget you want to delete.
5. Click Delete Widget.
6. At the confirmation prompt, click Yes.
Editing a Dashboard Widget
In the Ops Center dashboard, you can edit any dashboard widget. Editing a dashboard widget does
not affect the master widget it came from, or any other widget. You are editing only that particular
widget.
When editing a dashboard widget, the Save to Dashboard option is disabled, because dashboard
widgets can only be created from a master widget.
To edit a dashboard widget:
1. In the Ops Center dashboard, locate the widget you want to work with.
2. Click the gear
button on the widget toolbar. The Widget Builder appears.
3. Make the necessary changes to the Widget Builder.
4. When you are finished, click Save. The widget appears in the dashboard with its new
configuration.
Deleting Dashboard Widgets
Widgets can only be deleted from the Ops Center. You can delete dashboard widgets directly from
272
Chapter 13: Utilizing the Console
the dashboard.
To delete a widget from the dashboard:
1. Open the Ops Center view.
2. In the dashboard, locate the widget you want to delete.
3. Click the delete
button on the widget toolbar.
4. At the confirmation prompt, click Yes. The widget is deleted from the dashboard.
Note: If needed, you can readily recreate the dashboard widget, so long as you do not
delete the master widget it came from.
273
Chapter 14: Advanced Configurations
Setting up an Appliance
If you are setting up a Manager for the first time, you should follow this order of events:
l
On the Console, open the Manage > Appliances view.
l
Add a Manager to the Console.
l
Log on to the Manager through the Console.
l
Configure the Manager’s properties with the Properties form.
l
Configure the Manager’s connectors with the Connector Configuration window.
l
(Optional) Assign the Manager’s alert distribution policy with the Event Distribution
Policy window.
Adding Appliances to the Console
Use this procedure whenever you want to add a new Manager or other network appliance to the LEM
Console.
To add a new appliance:
1. At the top of the LEM Console, click Manage and then click Appliances.
2. At the top of the Appliances grid, click the
symbol.
3. Enter the IP Address of the virtual appliance.
4. Click
to display the Advance Properties form. The following table describes the form
fields:
274
Chapter 14: Advanced Configurations
Field
Description
Username
Enter the username used to connect to the virtual appliance.
Password
Enter the password for the virtual appliance.
Appliance
Select the appliance type you are adding—Manager, Database
Type
Server, nDepth, Logging Server, or Network Sensor.
Connection Type the port number the Console must use to communicate with the
Port
Manager network appliance or the database. The secure port number is
8443. This value will default to 8080 for virtual appliances in the
evaluation phase.
Note: This field only applies when the Appliance Type field is set to
Manager.
Model
Select the appliance's appropriate model. If you are uncertain which
model you have, select Unknown. If you know your model but it is not
listed, select Other. Your selection here has no affect on the
Manager’s operation.
If you selected any of the specific models, a picture of the appliance
appears at the top of the Details pane.
Level
The appliance’s level. Its level is directly related to the appliance's
capacity and performance, ranging from Level 1 to Level 4. If you are
uncertain which level the Manager belongs to, select Unknown. If you
are adding a Database Server, Level 4 is automatically selected. This
option is disabled if you are using a virtual appliance.
Service
Type the Dell serial number or registration number found on the
Tag
appliance. It uniquely identifies this piece of equipment and its specific
configuration properties.
Icon Color
Select the desired color for your icon.
Reset
At any time, you can click Reset to reset the form to its default
settings.
275
Copying Appliance Data
5. Click Connect to add the appliance and close the form. Otherwise, click Cancel to
return to the Console without adding the appliance.
6. Enter the IP Address of the virtual appliance and then click Connect.
Note: The LEM desktop software requires that you change your LEM password after
installation. This password must be between 6 and 40 characters, and must contain at
least one capital letter and one number. The default username/password is
Admin/Password.
7. Click OK.
Copying Appliance Data
If needed, you can copy your the data from the Appliances grid to your clipboard. This allows you to
page the data into another application, such as Microsoft Excel for analysis or the Remote Agent
Installer for updates. You can copy the data for a single appliance, multiple appliances, or for every
appliance in the grid.
To copy data for a single appliance:
1. Open the Manage >Appliances view.
2. In the Appliances grid, select the appliances you want to copy.
3. Click the
button, and then do one of the following: l
Click Copy Selected to copy the data for the selected appliances.
l
Click Copy All to copy the data for every appliance in the grid.
The appliance data is now copied to your clipboard, where it can be pasted into another
application.
Removing an Appliance
When needed, you can remove a Manager or other network appliance from the Console.
276
Chapter 14: Advanced Configurations
To remove an appliance:
1. At the top of the Console, click Manage, and then click Appliances.
2. In the Appliances grid, click to select the appliance you want to remove.
3. Click the gear
button and then click Delete.
4. At the confirmation prompt, click Yes to remove the appliance. Otherwise, click No to
return to the Console without removing the appliance. The appliance disappears from
the Appliances grid.
Managing Connectors
Configuring Manager Connectors (general procedure)
Follow this procedure to configure a Manager’s connectors (sensors and actors). It lets the Manager
monitor and interact with the supported security products or devices that are installed on or remotely
logging to the Manager computer.
To configure a Manager’s connectors:
1. Start the LEM Console.
2. Open the Manage >Appliances view.
3. If you have not already done so, add and configure each Manager you will be using with
your network.
4. Log on to the Manager you want to work with.
5. Open the Connector Configuration for [Manager] form.
6. Add a connector instance for each of the product’s event log sources.
7. When you are finished, start the Connector instance. See Advanced Configurations
8. Repeat Steps 6 and 7 for each product or device that is logging to the Manager
computer.
277
Configuring Agent Connectors (general procedure)
9. Repeat Steps 4–8 for each Manager, until you have configured Connectors for each
point on your network.
Configuring Agent Connectors (general procedure)
Follow this procedure to configure the connectors (sensors and actors) the Agent uses to monitor and
interact with each network’s security product and device that is running on the Agent computer.
To configure an Agent’s connectors:
1. Open the Manage > Agents view.
2. Open the Connector Configuration for [Agent] form.
3. Add a connector instance for each of the product’s event log sources.
4. When you are finished, start the connector instance.
5. Repeat Steps 3 and 4 for each product or device the Agent is monitoring on the Agent’s
computer.
6. If you are not using Connector Profiles, repeat Steps 2–5 for each Agent, until you have
configured the connectors for each point on your network. If you are using Connector
Profiles, you can use a configured Agent as a template for a Connector Profile.
Using Connector Profiles to Configure Multiple Agents
Most Agents in a network have only a few different connector configurations. Therefore, you can
greatly speed up the connector configuration process by creating Connector Profiles. A Connector
Profile is a group of Agents that share the same connector configuration. It allows you to configure a
set of standardized connector settings, and then apply those settings to all of the Agents that are
assigned to that profile. Once applied, every Agent in the profile will then have the exact same
connector settings.
One of the great benefits of using Connector Profiles is that you can maintain all of the Agents in a
profile at once by updating only the Connector Profile’s connector configuration. The system then
propagates your changes to all of the Agents in the profile.
By using Connector Profiles, you can greatly speed up the process of connecting your network
security products to LEM. If you do not use Connector Profiles, you will have to create at least one
278
Chapter 14: Advanced Configurations
connector instance for every product that you intend to integrate with LEM, and then repeat this
process for every one of your Agents.
A well-planned set of Connector Profiles provides you with a versatile and efficient method for
configuring and maintaining your Agents’ connector configurations.
Managing Groups
The topics in this section explain how to create and manage Groups.
Adding a New Group
1. Open the Build >Groups view.
2. In the Groups grid, click
and then click the Group type you want to create.
The Group Details pane opens to show an editable form for the Group type you have
selected.
3. In the Name box, type a name for Group.
4. In the Description box, type a brief description of the Group and its intended use.
5. In the Manager list, select the Manager on which the Group is to reside.
6. When you are finished, click Save. The new Group appears in the Groups grid.
Editing a Group
Editing a Group is very much like creating a new one. The only difference is that you are reconfiguring
an existing item.
279
Cloning a Group
To edit a Group:
1. Open the Build >Groups view.
2. In the Groups grid, do one of the following:
l
Double-click the Group you want to edit.
l
Click the gear
button for the Group you want to edit and click Edit.
The Edit pane opens as an editable form, showing the selected Group’s current
configuration.
3. Make any necessary changes to the Edit form to reconfigure the Group.
4. When you are finished, click Save.
The revised Group is applied to the Manager and appears in the Groups grid.
Cloning a Group
Cloning a Group lets you copy an existing Group, but save it with a new name. Cloning allows you to
quickly create variations on existing Groups for use with your rules, filters, and Agents.
Cloned Groups must be for the same Manager as the original Group. That is, you cannot clone a
Group from one Manager for use with another Manager.
To clone a Group:
1. Open the Build >Groups view.
2. In the Groups grid, click to select the Group you want to clone.
3. Click the row’s gear
button and then click Clone. The newly cloned Group
appears in the Groups grid in the row just below the original Group.
A clone always uses the same name as the Group it was cloned from, followed by the
word Clone. For example, a clone of the Disk Warning Group would be called Disk
280
Chapter 14: Advanced Configurations
Warning Clone. A second clone of the Disk Warning Group would be called Disk
Warning Clone 2, and so on.
4. Edit the cloned Group, as needed, to give it its own name and to assign its own specific
settings.
Importing a Group
You can import Groups from a remote source into the Groups grid. You can import a Group that you
have exported from another Manager, or you can import Groups that are provided by SolarWinds. You
may import only one Group at a time.
To import a Group:
1. Open the Build >Groups view.
2. On the Groups grid connector bar, click the gear
button and then click
Import.The Open form appears.
3. In the Look In box, browse to the folder that contains the Group file you want to import.
4. Do either of the following:
l
Double-click the file to open it.
l
Click to select the file you want to import, and then click Open.
The Group appears in the Groups grid and in the Group Details form for editing.
5. In the Group Details form, select the Manager this Group is to be assigned to.
6. Make any other desired changes in the Group Details form.
7. Click Save to send the Group to the Manager.
8. If you are working with Email Templates or State Variables, drag the new Group from
the Groups grid into the folder (in the Folders pane) that is to store the Group.
281
Exporting a Group
Exporting a Group
When needed, you can export Groups. Exporting Groups is useful for three reasons:
l
Once exported, you can import the Group into another Manager.
l
You can save a copy off of the Manager for any reason.
l
You can provide SolarWinds with a copy of your Group for technical support or
troubleshooting purposes.
You may export only one Group at a time.
To export a Group:
1. Open the Build >Groups view.
2. In the Groups grid, click to select the Group you want to export.
3. Click the row’s gear
button and then click Export.
4. After a moment, the Save As form appears.
5. Use the Save As form to select the folder in which you want to save the exported
Group.
6. In the File name box, type a name for the exported Group.
7. Click Save to export and save the Group; otherwise, click Cancel. You can now import
the Group for use with another Manager.
Deleting a Group
When needed, you can delete any of your Groups.
282
Chapter 14: Advanced Configurations
To delete a Group:
1. Open the Build >Groups view.
2. In the Groups grid, select the Group you want to delete.
3. Click the row’s gear
button and then click Delete.
4. At the confirmation prompt, click Yes to delete the Group. The item disappears from the
Groups grid.
Configuring Event Groups
Whenever you create or edit an Event Group, the Build >Groups view’s Edit pane opens and
becomes the Event Group form. The Event Group form lets you create custom families of alerts
that you can save as a Group. You can then associate the Event Group with your rules and filters.
For example, you might create an Event Group made up of similar alerts that all need to trigger the
same response from the Console. When you apply the Event Group to a rule, the Console
implements the rule when any one of the alerts in the Group occurs.
Each Event Group you create only applies to the Manager that is selected when you create the
Group. If you need a similar Event Group for a different Manager, you must create it separately for the
other Manager.
Configuring an Event Group
1. Open the Build >Groups view.
2. On the Groups grid, click
and then click Event Group. The Edit pane opens,
showing the Event Group form.
3. In the Name box, type a name for the new Event Group.
4. In the Description box, type a brief description of the Event Group’s contents.
5. In the Manager list, select the Manager on which this Group is to reside. If you are
283
Event List Features
editing an existing Group, this field shows the Manager on which it resides.
Now you will configure the Event Group by selecting the alerts you want in the Group.
The Events box lists alerts in a hierarchical tree. You may need to open the nodes in
the alert tree to see the alert you are looking for.
6. In the Events list, select each alert that you want to include in this Group.
l
To choose an alert, click its check box.
l
To remove an alert, clear its check box.
Note: In the node-tree view, you can Ctrl+Click to select (or clear) an alert and all of
the alerts below that item (that is, its child alerts). For example, press Ctrl and click
Security Event to select Security Event and all of its child alerts.
7. Click Save. The new Event Group appears in the Groups grid.
Event List Features
The following table explains how to use each feature of the Events list.
284
Chapter 14: Advanced Configurations
Icon
Description
Click this button to display the Events list as a hierarchical node tree. Then use the list to
select each alert type that you want to include in this Group. This is the default view.
This view also has the following attributes:
n
Lower-level alert types are hidden by nodes in the alert tree. To open a node, click the
>icon. This displays the node’s next level of alerts.
n
Using the search box displays the alert and its parent alert types, so you can see how the
alert appears in the alert hierarchy.
n
You can Ctrl+Click to select (or clear) an alert and all of the alerts below that item (that is,
its child alerts). For example, if you press Ctrl and click Security Event, you will select
Security Event and all of its child alerts.
Click this button to list alert types alphabetically, regardless of their position in the hierarchy.
Then use the list to select each alert type that you want to include in this Group.
You can use this box to search either view of the Events list. To do so, type a word or phrase
in the text box. The Events list will refresh to show any alerts that include your word or
phrase.
►
This icon represents a closed (or collapsed) alert node in the alert tree hierarchy. Each time
you see this icon, it means the alert node contains lower-level alerts.
To open a node, click it. Opening the node expands the alert tree, displaying the next level of
related alerts.
▼
This icon represents an open (or expanded) alert node in the alert tree hierarchy. Each time
you see this icon, the node is displaying its related lower-level alerts.
To close (or collapse) the node, click it. This collapses the alert tree at that level, hiding its
lower-level alerts.
This item has not been selected; nor have any of its lower-level items.
This item has been selected; but not any of its lower-level items.
This item has not been selected, but one or more if its lower-level items has been selected.
This item has been selected, and so have one or more of its lower-level items.
285
Configuring Directory Services Groups
Configuring Directory Services Groups
Many companies use a directory service, such as Active Directory, to organize and administer their
network’s computers and system users. This computer and user information is organized into
Directory Service Groups (DS Groups) that are managed with the directory service.
If you use such a directory service, you can connect LEM to the server that stores your existing DS
Groups, synchronize your Groups with LEM, and apply your Groups to your rules and filters.
Once your directory service is connected, your DS Groups become seamlessly integrated with the
LEM. Whenever you make a change to a Group in the directory service, LEM automatically updates
your rules and filters to reflect the change.
The topics in this section explain how to retrieve and synchronize information from your directory
service for use with LEM.
How to Use Directory Services Groups
DS Groups allow you to match, include, or exclude events to specific users or computers based on
their Group membership, to determine if a particular alert event is relevant or not.
In most cases, DS Groups are used in rules and filters as a type of white list or blacklist for choosing
which users or computers to include or to ignore. When used by a filter, a DS Group lets you limit the
scope of the alerts included in the filter to those users or computers that have membership in a
particular Group.
For example, you may want to use a DS Group that you created in your directory services that
contains the names of high-risk network users. You can then refer to this Group in a rule or filter. For
instance, your rule may dictate to always disable these users if you detect malicious activity.
Synchronizing Directory Service Groups with LEM
This procedure explains how to retrieve Group data from your directory service and select which DS
Groups are to be synchronized with LEM. This procedure ensures that you capture the most current
information from any Groups that are not currently synchronized with LEM.
286
Chapter 14: Advanced Configurations
You can also use this procedure to remove DS Groups that no longer require synchronization.
Note: To use DS Groups, first make sure the Directory Service Query Connector is configured and
running on the LEM Manager for which you want to use DS Groups.
DS Groups only apply to Managers that are connected to them. If you need a similar DS Group for
another Manager, you must connect to the directory service with the other Manager.
To retrieve DS Group data from your directory service:
1. Open the Build >Groups view.
2. On the Groups grid, click
and then click Directory Services Group. The Select
Directory Services Group form appears. You will use this form to select which
directory service Groups you want to synchronize for use with LEM.
3. In the Manager list (the upper-right drop-down list), select the Manager that is going to
use the DS Groups.
4. In the other drop-down list, select the directory services domain you want to work with.
The form displays the actual contents (folders and Group categories) of your directory
service system:
l
Each folder to the left contains the Group categories that are associated
with that area of your directory service. You can click a folder node (►) to
display the Group categories contained within that folder.
287
Viewing a Directory Services Group Members
l
The Available Groups box lists a different set of Group categories with
each folder you select. For example, clicking the Users folder shows a
different set of Group categories than if you click the Laptops folder.
5. In the folder list, click the Group category you want to work with.
6. In the Available Groups list, do the following:
l
Click the check box for each Group you want to synchronize with LEM.
l
Clear the check box for each Group you want to remove from
synchronization.
7. Repeat Steps 5 and 6 until you have selected all of the DS Groups you want
synchronized with LEM.
8. Click Save.
The system synchronizes the DS Groups to LEM and adds them to the Groups grid.
The DS Groups are now ready for use with your rules and filters.
Viewing a Directory Services Group Members
The Groups grid shows each DS Group that is synchronized with LEM. When you select a DS Group
in the Groups grid, the Directory Service Groups pane appears to show the members of that DS
Group.
To view a DS Group:
1. Open the Build >Groups view.
2. In the Groups grid, select the DS Group you want to view. The Edit pane opens,
showing the Directory Services Group form. The form displays the contents of the
Group,.
Directory Services Group Grid Columns
The grid in the Directory Services Group form provides information on each specific computer
account and user account that is currently associated with the DS Group. The following table
describes the meaning of each grid column.
288
Chapter 14: Advanced Configurations
Column
Type
Description
Displays an icon that shows if the group member is a User or a Computer. The
computer icon represents a computer account. The person icon represents a user
account.
Name
Displays the display name of the group member.
Description Displays the description associated with the group member in directory services.
SAM Name Displays the account name of the member.
Principal
Displays the principal name of the member.
Name
Distinguish Displays the complete distinguished name of the member.
Name Date
Email
Displays the email address of the member.
Deleting DS Groups
You can delete DS Groups from the Console, just as you would any other Group. Deleting a DS
Group does not remove the Group from your original directory service. You can restore a DS Group at
any time if you ever need to use it again.
Configuring Email Templates
Email templates allow you to create pre-formatted email messages that rules can use to notify you of
an alert event. These templates become available in the Actions component list, whenever you drag
Send Email Message or Send Pager Message to the Actions box. You will then be prompted to fill
in the message variables from the Events or Event Groups lists.
You create and manage templates in the Build >Groups view’s Email Template form. As with
rules, you can add, edit, clone, and delete templates, and you can organize them in folders.
Step 1: Creating the Email Template
This section describes how to create the actual email template. Email templates allow you to report
specific information about an alert event, because you can include variables that capture specific
289
Step 1: Creating the Email Template
parameters about that event. For example, you can report which server is affected, what time the
event occurred, or which Agent was shut down. The possibilities for message templates are endless.
To create an email template:
1. Open the Build >Groups view.
2. In the Groups grid, do one of the following:
l
Click
and then click Email Template to add a new email
template
l
Double-click the email template you want to edit.
The Email Template form appears. If you are editing an existing template, the form
shows any parameters that have already been configured for the template.
3. In the Manager list, select the Manager on which this template resides. If you are
editing an existing template, this field shows the Manager this template is associated
with.
4. In the Name box, type a name for the template. This should be a name that makes it
easy to identify the type of event that has occurred, or where or to whom the email
message is going.
5. In the From box, type whom the message is from. Typically, this is “SolarWinds” or
“Manager.”
290
Chapter 14: Advanced Configurations
6. In the Subject line, type a subject for the message. Typically, you will want a subject
that indicates the nature of the alert event.
7. Click Save to save the template.
Step 2: Adding Message Parameters
In the Parameters list, you will add variables that are placeholders for specific items within the
message text. When the Manager sends the message, it will complete the message by filling in the
variable parameters with the appropriate text. You can add as many parameters as you like.
For example, you may want a message to tell you which Agent or server was affected. Or you may
want to know the time the event occurred. So you can create a variables for Agents, servers, or time.
In the previous example, there are parameters for the server and for the destination computer.
If you add too many or unnecessary parameters, you can easily delete the ones you don’t need.
To add message parameters:
1. In the Name box, type the name of the parameter you want to capture in the email
message.
2. Click the Add
button. The new parameter appears in the Parameters list.
3. Repeat Steps 1 and 2 for each parameter you want to capture in this message.
4. Click Save so save your changes to the template.
To delete a parameter:
1. In the Parameters list, select the parameter you want to delete.
2. Click the Delete
button.
3. The parameter disappears from the Parameters list.
4. Click Save to permanently delete the parameter.
291
Step 3: Creating the message
Step 3: Creating the message
Now, in the Message box, you will create the actual text of the email message.
To create an email template message:
1. In the Message box, type the email message that the Manager is to send when an
event occurs, like in the example shown here.
2. In the Parameters list, select a parameter. Then drag it to the appropriate spot in the
message text. The parameters serve as placeholders for information that the Manager
will fill in.
3. Repeat Step 2 for each parameter.
4. When you have finished with the template, click Save. The new template appears in
Groups grid.
Managing email template folders
As with rules and State Variables, you can use the Folders pane to organize your email templates
into folders and sub-folders. You can add, rename, move, and delete template folders.
292
Chapter 14: Advanced Configurations
Configuring State Variables
You can use the Groups grid to add, edit, and delete State Variables and the number, text, and time
fields associated with each State Variable.
State Variables are used in rules. They represent temporary or transitional states. For example, you
can create a State Variable to track the “state” of a particular system, setting it to a different value
depending on whether the system comes online or goes offline.
You can also configure rules to monitor the contents of a State Variable to validate or invalidate a rule.
For example, you can set a DEFCON value and ensure that the DEFCON value is over 3 before
notifying on-call staff.
Note: If you require permanent lists of data that can be preserved over long periods of time, you can
use User-Defined Groups in a similar manner.
Adding new State Variable fields
1. Open the Build >Groups view.
2. In the Groups grid, do one of the following:
l
To add a new State Variable, click
and then click State Variable.
l
Double-click the State Variable you want to edit.
l
Click the gear
icon for the State Variable you want to edit, and then
click Edit.
The State Variables pane opens as an editable form. If you are editing an existing
State Variable, the form shows any fields that have already been configured.
293
Adding new State Variable fields
3. In the Name box, type a name for the State Variable.
4. In the Manager list, select the Manager on which this State Variable is to reside. If you
are editing an existing Group, this field shows the Manager on which it resides.
Now add the State Variable fields that make up the Group. Adding State Variable fields
is a straightforward process. You name the field, and then select what the variable
represents—text, a number, or time.
5. Click the Add
button. The Add Variable Field form becomes active.
6. In the Name box, type a name for the State Variable field.
7. In the Type list, select the type of State Variable the field represents—Text, Number,
or Time.
8. Click the left Save button to save the field; otherwise, click Cancel. The new State
Variable field appears in the State Variables grid, showing the field’s name and
comparison type.
9. Repeat Steps 5–8 for each field you want to add to the State Variable.
10. Click the rightmost Save button to save the State Variable settings.The new State
Variable appears in the Groups grid and the Rule Builder’s State Variables list. You
can now incorporate this State Variable whenever you add or edit a rule.
294
Chapter 14: Advanced Configurations
Editing State Variable fields
1. Open the Build >Groups view.
2. In the Groups grid, do either of the following:
l
Double-click the State Variable you want to edit.
l
Click the gear
icon for the State Variable you want to edit, and then
click Edit.
The State Variables pane opens as an editable form.
3. In the fields grid, select the State Variable field you want to edit. The Add Variable
Field form becomes active, showing the field’s current configuration.
4. Make the necessary changes to the field’s Name or Type.
5. Click the form’s Save button to apply your changes to the field. The updated field
appears in the fields grid.
6. Click the rightmost Save button to save your changes to the State Variable.
Deleting State Variable fields
1. Open the Build >Groups view.
2. In the Groups grid, do either of the following:
l
Double-click the State Variable you want to edit.
l
Click the gear
icon for the State Variable you want to edit, and then
click Edit.
The State Variables pane opens as an editable form.
3. In the fields grid, select the field you want to delete.
4. Click the Delete
295
Managing State Variable Folders
button. The field disappears from the fields grid.
5. Click Save to save the changes to the State Variable.
Managing State Variable Folders
As with rules and email templates, you can use the Folders pane to organize your State Variables
into folders and sub-folders. You can add, rename, move, and delete State Variable folders.
Configuring Time of Day Sets
Time of Day Sets are Groups of hours that you can associate with rules and filters. Time of Day Sets
allow your rules and filters to take different actions at different times of day.
For example, if you define two different Time of Day Sets for “Business Hours” and “Outside
Business Hours,” you can assign different rules to each of these Time of Day Sets. For instance, you
may want your rules to alert your system administrator via email and pager during working hours.
Outside of business hours, you may want your rules to alert your administrator by pager only, and
automatically shut down the offending PC.
You can easily create as many Time of Day Sets as you needed, to reflect all of your business needs.
A well-planned group of Time of Day Sets provides you with versatile and responsive rules that
perform the way you want, when you want.
Each Time of Day Set you create only applies to the Manager that is selected when you create it. If
you need a similar Time of Day Set for another Manager, then you must create it separately with that
other Manager.
Configuring a Time of Day Set
1. Open the Build >Groups view.
296
Chapter 14: Advanced Configurations
2. In the Groups grid, do either of the following:
l
To add a new Time of Day Set, click
and then click Time of Day
Set.
l
Double-click the Time of Day Set you want to edit.
The Edit pane opens, showing the Time of Day Set form.
3. In the Name box, type a name for the new Time of Day Set.
4. In the Description box, type a brief description of the Time of Day Set and its intended
use.
5. In the Manager list, select the Manager on which this Time of Day Set is to reside. If
you are editing an existing Group, this field shows the Manager on which it resides.
The form has a time grid that lets you define a Time of Day Set for the Manager. The
time grid is based on a one-week period, and is organized as follows:
l
It has seven rows, where each row represents one day of the week.
l
It has 24 numbered columns, where each column represents one hour of
the day. The white column headers represent morning hours (midnight to
297
Selecting periods in the time grid
noon). The shaded column headers represent evening hours (noon to
midnight).
l
Each column has two check boxes that divide each hour into two halfhour (30-minute) periods.
Together, the rows, columns, and check boxes divide an entire week into 30-minute
periods.
6. In the time grid, click to select the half-hour periods that are to define this Time of Day
Set. For assistance, see the table in the topic, below.
7. Click Save. The new Time of Day Set appears in the Groups grid.
Selecting periods in the time grid
1. In the Connectors grid, click to select the connector instance you want to delete.
2. Click the gear
button and then click Delete.
3. At the confirmation prompt, click Yes.
4. Do one of the following:
l
Click Activate to apply your changes to every Agent associated with the
Connector Profile.
l
Click Discard to discard your changes and reload the previous
configuration.
5. Click Close to return to the Groups grid.
Configuring User-Defined Groups
User-Defined Groups are groups of preferences that are used in rules and filters. User-Defined
Groups allow you to match, include, or exclude events, information, or data fields based on their
membership in a particular Group.
298
Chapter 14: Advanced Configurations
Examples of User-Defined Groups
In most cases, User-Defined Groups are used as a type of white list or blacklist for choosing which
events to include or to ignore. When used by a filter, a User-Defined Group lets you limit the scope of
the alerts included in the filter to those items that have membership in a particular Group.
Each User-Defined Group is made up of one or more elements that define the Group. The elements
can be almost anything: IP addresses, user names, email addresses, web site URLs, etc. Because
of their versatility, the possibilities of User-Defined Groups are almost endless.
For example, you may want to create a Group of trusted IP addresses that you can use in rules and
filters. You can then refer to this Group in a rule. For instance, your rule may dictate to never block
these IP addresses.
Or you may want to create a Group of trusted accounts for the local administrator. You could then
format your rules so that they never block these accounts. Or, because these accounts are trusted,
you may want to watch them more carefully so that you are notified whenever they log on or make
changes.
You can create as many User-Defined Groups as you need to reflect all of your different rule and
filtering needs. Well-planned User-Defined Groups can provide you with the precise feedback active
responses you need to manage and maintain your network security.
Each User-Defined Group you create only applies to the Manager that is selected when you create it.
If you need a similar User-Defined Group for another Manager, then you must create it separately with
that other Manager.
Configuring a User-Defined Group
1. Open the Build >Groups view.
2. In the Groups grid, do one of the following:
l
To add a new User-Defined Group, click
and then click User-
Defined Group.
l
Double-click the User-Defined Group you want to edit.
299
Adding data elements to a User-Defined Group
The Edit pane opens, showing the User-Defined Group form. If you are editing an
existing User-Defined Group, the form shows any parameters that have already been
configured for the Group.
3. In the Name box, type a name for the Group.
4. In the Description box, type a brief description of the Group and its intended use.
5. In the Manager list, select the Manager on which this Group resides. If you are editing
an existing Group, this field shows the Manager on which it resides.
6. Make any necessary additions, changes, or deletions to the Group’s Element Details
grid,
7. Click Save to save your changes to the User-Defined Group.
Adding data elements to a User-Defined Group
Once you have created a User-Defined Group, you can add the data elements that make up the
Group.
300
Chapter 14: Advanced Configurations
To add a User-Defined Group’s data elements:
1. Open the Build >Groups view.
2. In the Groups grid, double-click the User-Defined Group you want to work with.
The Edit pane opens, showing the Group’s current configuration.
3. At the bottom of the Edit pane, click the Add
button.
The Element Details form becomes active.
4. Complete the Element Details form as described in the following table.
Field
Description
Name
Type a name for the data element.
Data
Type the specific data element that you want to include or ignore in
your rules and filters. You can use an asterisk ( * ) as a wild card to
include all similar data elements.
Description Type a detailed description of the data element and its intended use, if
appropriate.
In this example, the data elements are a list of anti-virus firewall processes.
5. Click Save.
The new element appears in the data element grid. Note that the table displays each
element’s name, data element, and description.
301
Editing a data element in a User-Defined Group
6. Repeat Steps 3–5 for each data element you want to add to the Group.
Editing a data element in a User-Defined Group
1. Open the Build >Groups view.
2. In the Groups grid, double-click the User-Defined Group you want to work with.The
Edit pane opens, showing the Group’s current configuration.
3. In the form’s data element grid, select the data element you want to edit. The Element
Details form displays the data element’s current configuration.
4. Make the necessary changes to the Element Details form.
5. Click Save to save your changes to the Group. The revised data element appears in the
data element grid.
Deleting a data element from a User-Defined Group
1. Open the Build >Groups view.
2. In the Groups grid, double-click the User-Defined Group you want to work with.The
302
Chapter 14: Advanced Configurations
Edit pane opens, showing the Group’s current configuration.
3. In the form’s data element grid, select the data element you want to delete.
4. Click the Delete
button. The element is removed from the Group’s data element
grid.
5. Click Save to save the changes to the Group.
The following table explains how to select periods in the Time of Day Sets time grid.
To
Select a
Do this
Click an individual check box to select that period.
period
Select a
Click and drag to select a range of periods. You can drag up, down, or diagonally.
group of
periods
Move a
Click the block of hours you want to move, holding down the mouse button so the
block of
pointer turns into a “grabbing” hand. Then drag the hour block into its new position.
selected
hours
Duplicating Press the Ctrl key. Then click the block of hours you want to copy, holding down the
a block of
mouse button so the pointer turns into a “grabbing” hand. Then drag a copy of the hour
selected
block into position.
hours
303
Configuring Connector Profiles
To
Do this
Invert your Click the Invert button to select the opposite hours of the ones you have manually
selection
selected
This feature is useful when you want to select all but a few hours of the day. You can
select the hours that do not apply to the Time of Day Set, and then click Invert to
automatically select all of the hours that do apply to the Time of Day Set. For example,
if you have your business hours selected, clicking Invert would select everything
outside of your business hours.
Delete a
Click the check box to clear that selection. You can also click and drag over a range of
selected
selected periods to clear those selections.
period
Configuring Connector Profiles
Most Agents in a network have only a few different connector configurations. Because of this, the
Group Builder lets you group Agents that share the same configurations into Connector Profiles.
Once you define a Connector Profile, your rules and filters can use it to include or exclude the Agents
associated with that profile.
You can create as many Connector Profiles as you need to reflect each of your common network
security connector configurations. For example, you might set up a standard user workstation profile,
a web sever profile, etc. SolarWinds provides several default Connector Profiles that address
common configurations.
One of the great benefits of using Connector Profiles is that you can maintain all of the Agents in a
profile at once by updating only the Connector Profile’s connector configuration. The Group Builder
then propagates your changes to all of the Agents in the profile.
A well-planned set of Connector Profiles provides you with a versatile and efficient method to update
and maintain your Agents’ connector configurations.
304
Chapter 14: Advanced Configurations
Connector Profile Rules
l
An Agent can only be a member of one Connector Profile. It cannot be in multiple
profiles.
l
Each Connector Profile you create only applies to the Manager that is selected when
you create it. If you need a similar Connector Profile for another Manager, you must
create it separately for the other Manager.
Creating a Connector Profile (general procedure)
Connector Profiles are created in the Build >Groups view. Creating a Connector Profile is a twostep process:
1. Select the Agent that is to act as a template for the profile.
2. Add the Agents that are to be members of the profile. Upon saving, the system applies
the template Agent’s connector configuration to every other Agent that you added to the
profile.
When you select an Agent for use as a template, select one that has a very similar configuration to
how you want profile’s final connector configuration to look.
One trick is to prepare a template Agent in advance, by manually configuring an Agent that you know
will be a member of the new profile. Edit them exactly how you want them. Then use the Agent as the
template for the new profile. This minimizes your need to edit the profile’s connector configuration
later on.
The complete procedure for creating at Connector Profile is given below.
Step 1: Selecting a template for the profile
In this procedure, you will create, name, describe, and select a template for the new Connector
Profile.
305
Step 1: Selecting a template for the profile
To create a Connector Profile:
1. Open the Build >Groups view.
2. On the Groups grid connector bar, click
and then click Connector Profile. The
Connector Profile form appears.
3. In the Name box, type a name for the Connector Profile.
4. In the Description box, type a brief description of the Connector Profile and its
intended use.
5. In the Manager list, select the Manager on which this Connector Profile is to reside. If
you are editing an existing Group, this field shows the Manager on which its resides.
Note: If the Manager you want is not listed, go to Manage >Appliances and log on to
that Manager. You must be logged on to a Manager before you can create Groups for it.
6. In the Template list, select the Agent with the connector configuration this profile is to
be based on. If you do not want to use a template, select None.
Note: For best results, always select a template when creating a new Connector
Profile. Otherwise, the profile will delete the connectors on every Agent in the profile.
If you do not want to use a template, then be sure click Edit Connectors and add
connectors to the profile before you add Agents and save the profile. If you do not, there
306
Chapter 14: Advanced Configurations
will be no connectors in the profile; and upon saving, any Agents in that profile will have
theirs deleted.
7. Click Save. The new Connector Profile appears in the Groups grid.
Step 2: Selecting the Agents that are members of the profile
Now you will select the Agents that are to be members of the Connector Profile. These Agents are
governed by the Connector Profile’s connector configuration.
The Connector Profile form contains two list boxes. The Available Agents box lists each Agent
that is associated with the Manager but is not in the Connector Profile. The Selected Agents box
lists those Agents that are in the Connector Profile.
To add Agents to a Connector Profile:
1. In the Groups grid, locate the new Connector Profile you just created.
2. Double-click the Connector Profile to re-open it. The profile appears in the Connector
Profile form. As you can see, the Agent you selected as a template appears in the
Selected Agents list, by default.
3. In the Available Agents list, select an Agent that you want to add to the Connector
Profile. Or, in the Selected Agents list, select an Agent that you want to remove from
the Connector Profile.
4. Use the appropriate arrow button to add or remove Agents to or from the profile, as
described in the following table.
Button
Function
Moves the selected Agent from the Available Agents list to the Selected
Agents list (and into the profile).
Moves all Agents from the Available Agents list to the Selected Agents
list (and into the profile).
307
Editing a Connector Profile’s Connector Settings
Button
Function
Removes the selected Agent from the Selected Agents list to the
Available Agents list (and out of the profile).
Removes all Agents from the Selected Agents list to the Available Agents
list (and out of the profile).
5. Click Save to save the Connector Profile. Upon saving, the system applies the
template Agent’s connector configuration to every other Agent that you added to the
profile.
Note: If you remove an Agent from a Connector Profile (that was previously saved with
that profile), the Agent retains the profile's connector configuration, but will no longer
have membership in the profile.
Troubleshooting tip
At times, not all of the Agents in a Connector Profile will use the same logging path for a particular
connector. You can verify this by checking the Agent’s configured connector status. If a connector
has a status of
(Not Running), it is likely that connector has a different logging path.
To correct this problem, you may want to add another connector instance to the profile’s connector
catalog that points to the alternative logging path. Or, you can create a new profile that has the
alternative logging path.
Editing a Connector Profile’s Connector Settings
When editing a Connector Profile, you can use the Connector Profile form’s Edit Connectors
command to add, edit, or delete the connector instances associated with the profile. When doing this,
be aware that when you change a Connector Profile, you change the connector configuration of every
Agent that is associated with that Connector Profile.
When editing an individual Agent, you have to stop and start each connector instance, because you
are making direct changes to the running configuration of the Agent. But when editing a Connector
308
Chapter 14: Advanced Configurations
Profile’s configuration, you do not need to stop or start each connector instances. However, you must
still activate the changes.
This difference is because any time you edit a Connector Profile’s connector configuration, you are
working on the profile’s configuration data, not an actual Agent. When editing a Connector Profile, you
do not actually change the Agents that are members of the profile until you click Activate. Upon
activating, the system automatically sends the changes out to every Agent that is a member of that
profile, stops each connector instance, makes the changes, and then restarts each connector
instance.
Opening a Connector Profile’s Settings
1. Open the Build >Groups view.
2. In the Groups grid, locate the Connector Profile you want to edit.
3. Do one of the following:
l
Double-click the Connector Profile you want to edit.
l
Click the gear
button and then click Edit.
The Connector Profile pane opens, showing the Agents that are in the profile.
4. At the bottom of the Connector Profile pane, form, click Edit Connectors.The
Connector Configuration for [Connector Profile] form appears. The form’s
Connectors grid contains all of the connector instances that define the Connector
Profile.
Adding a New Connector Instance
1. On the Connectors grid, select the connector you want to configure.
2. Click New.
3. Update the connector settings using the Properties form:
309
Editing a Connector Profile’s Connector Settings
4. Click Save.
5. Do one of the following:
l
Click Activate to apply your changes to every Agent associated with the
Connector Profile.
l
Click Discard to discard your changes and reload the connectors
previous configuration.
6. Click Close to return to the Groups grid.
Editing a Connector Profile’s Connector Settings
1. In the Connectors grid, select the connector instance you want to edit.
2. Click the row’s gear
button and then click Edit.
3. In the Properties form, update the connector settings, as needed:
4. Click Save.
5. Do one of the following:
l
Click Activate to apply your changes to every Agent associated with the
Connector Profile.
l
Click Discard to discard your changes and reload the previous
connectors configuration.
At times, not all of the Agents in a profile will use the same logging path for a particular
connector. You can verify this by checking the Agent’s configured connector status. If
a connector has a status of
(Not Running), it is likely that connector has a different
logging path.
To correct this problem, you may want to add another instance to the connector
profile’s connector catalog that points to the alternative logging path. Or, you can create
a new profile that has the alternative logging path.
310
Chapter 14: Advanced Configurations
6. Repeat this procedure for each connector instance you want to reconfigure.
7. Click Close to return to the Groups grid.
Managing Rules
The topics in this section explain how to manage your rules. Many management tasks can be done
from the Rules grid, or in Rule Builder as you are configuring a rule.
Rule Creation
In the Build > Rules view, the Rule Creation tool is used to configure new rules and to edit existing
rules.
Like filters, you create rules by configuring conditions between alert variables other components,
such as Time of Day Sets, User-Defined Groups, Constants, etc. However, rules go a step further.
They let you correlate alert variables with other alerts and their alert variables.
By correlate, we mean you can specify how often and in what time frame the correlations must be
met before the rule is triggered. The combined correlations dictate when the rule is to initiate an active
response.
You can configure rules to fire after multiple alerts occur. The Manager will remember alerts if they
meet the rule's basic conditions. It waits for the other conditions to be met, too. If they are, the
Manager fires the rule. The rule does not take action until the alerts meet all of the conditions and
correlations defined for that rule.
The possibilities for rules are endless. Therefore, this section describes how to create rules only in
very general terms. This section is not intended to be a tutorial, but rather a reference for you to fall
back on if you are unclear about how any part of Rule Creation works.
(missing or bad snippet)
Caution: Practice with filters before creating rules
The connectors in Rule Creation are very similar to those found in Filter Creation. However, filters
report event occurrences; rules act on them. There is no harm if you create a filter that is unusual or
311
Rule Creation Features
has logic problems. But this is not the always case with rules. Rules can have unexpected and
sometimes unpleasant consequences if they are not configured exactly as you intend them to be.
Inexperienced users should use caution when creating rules. Creating filters is an excellent way to
familiarize yourself with the logic and connectors needed to create well crafted rules. You should only
begin configuring rules after you are at ease with configuring filters. Even then, always test your rules
before implementing them.
Rule Creation Features
The topics in this section describe the key features of the Rule Creation view, the rule window, and
the Correlations box, which are all used to configure and edit policy rules.
l
The Rule Creation view is a different view of the Rules view that allows you to
configure and edit policy rules.
l
The rule window is the window that you will use to view, configure, and edit your policy
rules.
l
The Correlations box is a component of the rule window that is used to configure the
specific correlations that define the rule.
The following table descries the key features of the Rule Creation connector. The topics that follow
discuss some of these features in greater detail.
Name
Description
Back to
Click this button to hide Rule Creation and return to the Rules grid. Rule Creation
Rules
remains open in the background, so you can return to it to continue working on your
Listing
rules.
In the Rules grid, clicking Back to Rule Creation will return you to Rule Creation.
List pane
The list pane is the “accordion” list to the left. It contains categorized lists of the
components you can use when configuring policy rules.
It behaves exactly like the list pane in Filter Creation. To view the contents of a
component list, click its title bar. To add a component to a rule, select it from its list and
then drag it into the appropriate correlation box.
312
Chapter 14: Advanced Configurations
Name
Description
Rule
Each rule you create or edit appears in its own rule window. This is where you configure
window
name, describe, configure, edit, test, verify, and enable each rule.
You can have multiple rule windows open at the same time. You can also minimize,
maximize, resize, and close each window, as needed.
Minimized Any minimized rule windows appear in the bar at the bottom of the Rule Creation
rule
pane, behind the active rule window. Each minimized window shows the name of its
window
rule. Clicking a minimized rule opens that rule in the Rule Creation pane.
bar
Advanced Thresholds
Whenever a Group threshold or the Correlation Time form’s Events within box has a value greater
than 1, the Set Advanced Thresholds
button becomes enabled. This button opens the Set
Advanced Thresholds form, so you can define an alert event threshold and the re-inference period
for that threshold. The threshold tells the Manager which specific alert fields to monitor to determine if
a valid alert event has occurred (i.e., when to “count” the alert).
For example:
l
Threshold event x must occur multiple times on the same destination computer with the
frequency defined in the Correlation Time box.
l
Or, threshold event y must occur on different destination computers with the frequency
defined in the Correlation Time box.
When the threshold event counter increases to the number shown in the Events box, the threshold
itself becomes true and triggers the next set of conditions in the rule.
Opening the Set Advanced Threshold form
l
In the Correlations box, click the
button on the nested group you want to work with.
l
In the Correlation Time box, click the
313
button.
Setting an advanced threshold
Setting an advanced threshold
1. Open the Set Advanced Thresholds form.
2. Select the Re-Infer (TOT) check box if you want to define a second threshold. Then
use the adjacent fields to type or select the threshold’s time interval and unit of
measure.
The Re-Infer (TOT) option defines the period in which an alert must remain above the
threshold before the system issues a new notification and/or active response.
For example, suppose an alert has exceeded the threshold, and the alert’s Re-Infer
(TOT) period is 1 Hour. If the alert stays above the threshold for more than 1 hour, the
system will issue an additional notification or active response at the end of 1 hour.
Adding a Threshold Field
1. Click
to open the Set Advanced Thresholds form.
2. At the bottom of the form, click Add.
The Available Fields pane has two boxes. The top box lists all of the alerts that have
been applied to the rule’s Correlations box. The bottom box lists the alert fields
associated with whichever alert is currently selected in the top box.
3. In the top Available Fields box, select an alert. The fields associated with that alert
appear in the lower Available Fields box.
4. In the lower Available Fields box, select the alert field that is to help define the alert
threshold.
314
Chapter 14: Advanced Configurations
5. Below the Available Fields boxes, there is a drop-down list. It is called the Select
Modifier list. In the Select Modifier list, select the appropriate option:
l
Select Same if the threshold is to be defined by the selected field being
the same multiple times.
l
Select Distinct if the threshold is to be defined by the selected field being
different each time.
6. Click
.
The field and its modifier appear in the Selected Fields grid.
7. Repeat Steps 2 – 6 for any additional threshold fields.
8. Click OK to save the fields to the threshold and close the form; otherwise, click
Cancel.These fields now raise the threshold for the correlation event and its active
response to occur.
Editing threshold fields
You cannot actually edit a threshold field. Instead, you must delete it, and then replace it with a
corrected field configuration.
To replace a threshold field:
1. Click
to open the advanced threshold you want to work with.
2. In the Selected Fields list, click
to remove the field you want to change.
3. In the Available Fields list, select the appropriate alert, and then the alert field.
4. in the Select Modifier list, select the new modifier for the field (Same or Distinct).
5. Click
.
The corrected field and its modifier appear in the Selected Fields box.
6. Click OK to close the form.
315
Deleting a threshold field
Deleting a threshold field
1. Click
to open the advanced threshold you want to work with.
2. In the Selected Fields list, select the field you want to delete.
3. Click the Delete
button.
The threshold field disappears from the Selected Fields list.
4. Click OK to close the form.
Using the Actions box
In Rule Creation, the Actions box defines which action response the Manager is to take whenever
the correlation events specified by the rule occurs. You can assign more than one action to a rule. For
example, you may want to shut down an Agent, and then notify your system administrator of the
event via email.
The fields in the Actions box indicate where the action is to be performed, what the action is
supposed to do, and to whom it is supposed to happen. For example, if you want a rule to disable a
user, you could select the action called Disable Domain User Account. For the action to apply, you
must specify which account you want to disable, and where you want to disable it (that is, which
Agent).
Using constants and fields to make actions flexible
When configuring an action, you can assign constants that define fixed parameters for a rule. Or you
can assign alert fields (from the alerts in the Correlations box). Fields determine a rule’s parameters
when some degree of flexibility is required. Constants and fields both have their uses. But fields can
provide actions with a great deal of flexibility.
Say you have two network users: Bob and Jane. To disable Bob’s user account, you could assign a
constant to the rule that explicitly represents Bob’s account. But doing so limits the rule to Bob's
account.
316
Chapter 14: Advanced Configurations
Now if you assign a field to the rule, the rule can be interpreted as follows: “When user activity meets
the conditions in the Correlations box to prompt the Disable Domain User Account action, use the
alert's UserDisable.SourceAccount field to determine which user account to disable.”
If Bob triggered the rule, the Manager disables Bob’s account. But if Jane also triggers the rule, the
Manager can disable her account, too.
Configuring a Rule’s Actions
Use the following high-level procedure to configure a rule’s actions.
To configure a rule's actions:
1. In the list pane, click the Actions list to open it.
2. Select the action you want, then drag it to the rule window’s Actions box.
The top left of the Actions box shows the name the action that is to be taken. In most
cases, the Actions form will prompt you for specific parameters about the computer, IP
address, port, alert, user, etc., that is to receive the action.
3. Use the list pane to assign the appropriate alert field or constant to each parameter:
l
In the Events or Event Groups lists, select an appropriate alert field for
each parameter, and drag it to the appropriate parameter box in the
Actions form.
l
When needed, in the Constants list, select a constant for a parameter,
and then drag it to the appropriate parameter box in the Actions form.
317
Adding a New Rule
Typically, you will select a text constant. Once the constant is in place,
double-click the parameter box to edit the constant.
4. Click Save to save your changes.
Adding a New Rule
Follow this general procedure whenever you want to create a new rule. Be sure to test your rules
before fully implementing them. Testing helps ensure that your rules do not cause any unpleasant
consequences.
To add a new rule:
1. Open the Build >Rules view.
2. On the Rule grid connector bar, click
. The Rule Creation connector appears.
Note: At any time while you are configuring a rule, you can click the Back to Rules
Listing button to return to the Rules grid. Rule Creation remains open in the
background.
3. In the Name box, type a name for the rule. Note that the name also appears on the
form’s title bar.
4. In the on list, select the Manager on which this rule is to reside.
5. In the in list, select the folder and sub-folder in which this rule is to be stored in the
Folders pane.
6. In the Description box, type a complete description of the rule, such its use, purpose,
or behavior.
7. Configure the rule's correlations.
8. If needed, configure the rule's correlation time and advanced threshold.
9. Configure the rule's active response.
318
Chapter 14: Advanced Configurations
10. Apply the appropriate Enabled, Test, and Subscription settings.
l
To assign rule subscribers, click the Subscribe list, and then click the
check box for each user who is to subscribe to the rule.
l
If you want to use the rule immediately upon saving it, select the
Enabled check box.
l
If you want to operate the rule in test mode before fully activating it,
select the Test check box. It is highly recommended that you operate
each new rule in test mode to confirm that the rule behaves as expected.
11. When you are satisfied with the rule’s configuration, click Save.
Note: You can also click Apply to save your changes without closing the form.
The Rules grid appears. The new rule appears in the Rules grid and in the Folders
pane, in the folder you designated for the rule.
12. To begin using (or testing) the revised rule, click Activate Rules.
Rule Window Features
Each rule you create or edit appears in its own rule configuration window. You will use these windows
to design and edit custom policy rules. You can use the rule window to name, describe, configure,
edit, enable, and test your custom rules.
319
Rule Window Features
320
Chapter 14: Advanced Configurations
The following table describes each key feature and field of a rule window.
Item
Name
Title bar
Description
Each rule you create or edit appears in its own configuration window.
Upon naming a rule, the window’s title bar displays the name of the rule.
You can also use the title bar to minimize, maximize, and resize rule
window. Minimized rule windows appear at the bottom of the Rule
Creation pane.
Name
Type a name for the rule.
on
When creating a new rule, use this list to select which Manager the rule
is to be associated with. Otherwise, when editing a rule, this field
displays which Manager the rule is associated with.
in
Select the folder (in the Folders pane) in which the rule is to be stored.
Description
Type a description of what the rule does, or the situation for which the
rule is intended.
If the description extends beyond the visible area of the text box, a
larger text box appears, so you can type a detailed description of the
rule, its logic, its expected behavior, and its active response. When you
are done typing, either press Tab or click anywhere outside the text box
to close it.
Enable
Select this check box to enable the rule. Clear this check box to disable
the rule.
Test
Select this check box to place the rule in test mode. Clear this check
box to take the rule out of test mode.
Note: You must enable a rule before you can test it.
Subscribe
Use this list to select which Console users are to subscribe to the rule.
This means the system will notify the subscribing users Consoles each
time one of the subscribed-to rules triggers an alert. The alerts will
appear in their alert grid.
321
Rule Window Features
Item
Name
Rule Status
Description
The Rule Status bar lists warnings and error messages about your
rule's current configuration logic.
n
Click >to view a list of warning and error messages.
n
Click a message flag to provide detailed information about the nature
of that problem.
n
Click a message to highlight the specific area or field that is the
source of that problem.
Correlations
Use the Correlations box to configure correlations between groups of
alert events. You can coordinate multiple alert events into a set of
conditions that will prompt the Manager to issue a particular active
response.
You set up correlations by dragging items from the Events and Event
Groups lists into this box, and then setting the specific conditions or for
the alert that are to prompt action.
The Correlations connector bar lets you group alert conditions, and
determine if they must all apply (an AND correlation) or if any of them
may apply (an OR correlation) to prompt a response.
Correlation Time Use the Correlation Time box to establish the allowable frequency and
time span in which the correlation events must occur before the rule
applies.
The Advanced section lets you define an alert event threshold, and to
define the re-inference period for the threshold. The threshold tells the
Manager which specific fields to monitor to determine if a valid alert
event has occurred (i.e., when to “count” the alert).
The box’s Advanced section lets you define a Response Window that
lets the rule ignore any events that occur outside (past or future) of the
established period.
322
Chapter 14: Advanced Configurations
Item
Name
Actions
Description
Use the Actions box to dictate which actions the rule is to execute
when the events described in the Correlations and Correlation Time
boxes occur. Examples of actions include sending an email message to
your system administrator, or blocking an IP address.
Undo/Redo
Click the Undo button to undo your last desktop action. You can click
the Undo button repeatedly to undo up to 20 steps.
Click the Red button to redo a step that you have undone. You can click
the Redo button repeatedly to redo up to 20 steps.
You can only use Undo or Redo for any steps you made since the last
time you clicked Apply.
Save/Cancel/
Apply
Use these commands to save or cancel your work:
n
Click Save to save your changes to a rule and close the rule window.
n
Click the Cancel button to cancel any changes you have made to a
rule since the last time you clicked Save, and close the rule window.
If you have any unsaved changes, the system will prompt you to save
or discard them.
n
Click Apply to save your changes to a rule, but keep the rule window
open so you can continue working. You can click Apply at any time.
323
Correlations Box Features
Correlations Box Features
To create a rule, you drag items from the list pane into the rule window’s Correlations box to
configure the relationships (or correlations) that define the rule. These correlations define the events
that must occur for the rule to take effect.
Creating rule correlations is a lot like configuring conditions for custom filters, so the Correlations
box in Rule Creation behaves a lot like the Conditions box in Filter Creation. The following table
describes each item shown in the Correlations box, above.
Name
Description
►
Groups can be expanded or collapsed to show or hide their settings:
▼
n
Click to >expand a collapsed group.
n
Click to ▼ collapse an expanded group.
Once a group is configured properly, you may want to collapse it to avoid accidentally
changing it.
This is the Group button. It appear at the top of every group box. Click it to create a new
group within the group box. A group within a group is called a nested group. You may
then drag alert variables and other items from the list pane into the nested group box.
By using nested groups, you can refine correlations by combining or comparing one
group of correlations to another to create the logic for complex correlations.
Each group is subject to AND and OR relationships with the groups around it and within
it. By default, new groups appear with AND comparisons.
This is the Threshold button, which opens the Threshold form for a group. The
Threshold form is described below.
This is the Delete button. It appears at the top of every Group box and every
correlation. Click this button to delete a correlation or a particular group. Deleting a
group also deletes any groups that are nested within that group.
324
Chapter 14: Advanced Configurations
Name
Description
Event
From the Events, Event Groups, or Fields list, drag an alert, Event Group, or alert field
variable
into the Correlations box. This is called the alert variable. A rule can have multiple
alerts and Event Groups in its correlation configuration.
You can think of an alert variable as the subject of each group of correlations. As alerts
stream through the Manager, the rule analyzes the values associated with each alert
variable to determine if the alert meets the rule’s conditions. If so, the Manager either
initiates an active response, or stores the alert for comparison with other alerts that may
occur within the rule's allotted time frame.
Operators Whenever you drag a list item or a field next to alert variable, an operator icon appears
between them. The operator states how the filter is to compare the alert variable to the
other item to determine if the alert meets the rule’s conditions.
n
Click an operator to cycle through the various operators that are available for that
comparison. Just keep clicking until you see the operator you want to use.
n
Ctrl+click an operator to view all of the operators that are available for that
comparison. Then click to select the specific operator you want to use.
List item
List items are the various non-alert items from the list pane. You drag and drop them into
groups to define rule correlations based on your Time Of Day Sets, Connector Profiles,
User-Defined Groups, Constants, etc.
Some alert variables automatically add a blank Constant as its list item. You can
overwrite the Constant with another list item, or you can click the Constant to type or
select a specific value for the constant.
Note that each list item has an icon that corresponds to the list it came from. These
icons let you to quickly identify what kinds of items are defining your rules’s
correlations.
Threshold The Threshold section lets you define a threshold for the correlations in a Group box.
You can think of a threshold as a correlation frequency for the grouping; that is, the
number of times the events defined by the group must occur within a specified period
before the rule takes effect.
325
Editing Rules
Name
Description
This is the Set Advanced Threshold button. Whenever a group threshold’s number of
Events within [time] is greater than 1, this button becomes enabled so you can open
the Set Advanced Thresholds form. This form lets you specify advanced threshold
fields and define an advanced response window for the alert fields within the grouping.
Rule correlations and groups of correlations are subject to AND and OR comparisons.
AND
If you click an AND operator, it changes to an OR, and vice versa.
OR
Editing Rules
Whenever you need to edit a rule’s name or configuration, you use the Rule Creation connector to
make the necessary changes to the rule. When needed, you can edit multiple rules at the same time.
It is not necessary to disable a rule before editing it. When you edit a rule, you are editing a local copy
until you save and activate it. If the rule was enabled when you began editing it, it will continue to be
enabled while you work on the new version. When you save the new version and then click Activate
Rules, the Manager replaces the original rule with the new version.
To open rules for editing:
1. Open the Build >Rules view.
2. In the Folders pane, click the folder that contains the rules you want to edit.
The Rules grid displays the rules associated with the selected folder and its subfolders.
3. In the Rules grid, click to select the rule (or rules) you want to edit.
326
Chapter 14: Advanced Configurations
4. Open the rules for editing as follows: l
To edit a single rule, either double-click the rule, or click the row's gear
button and then click Edit.
l
To edit multiple rules, click the grid's gear
button and then click and
then click Edit.
Rule Creation appears, showing the rule’s current configuration. If you opened
multiple rules, they all appear as "cascaded" windows. You may now edit the rules.
Locked rules
If a prompt like the one shown here appears, it means another user is already editing one of the
selected rules and has those rules "locked."
In this case, you can do either of two things:
l
You can proceed in a read-only fashion, which allows you to see the details of a rule.
l
You can break the lock and take control over the rule, which means the other person
will not be able to save any changes he or she makes to the rule.
To edit the rule:
1. Use Rule Creation to make any necessary changes to the rule’s name, Manager,
folder, description, enabled status, test-mode state, correlations, correlation time, or
actions.
l
If you want to use the rule immediately upon saving it, select the Enable
check box.
l
If you want to try the rule in test mode, select the Test check box.
2. Click Save.
The Rules grid appears.
3. To begin using (or testing) the rule’s new configuration, click Activate Rules.
327
Subscribing to a rule
Subscribing to a rule
You can assign rules to specific Console users, which means those users will subscribe to those
rules. This means the system will notify the subscribing users' Consoles each time one of the
subscribed-to rules triggers an alert. The alerts will appear in their Monitor view’s alert grid.
Rule subscriptions can be used in conjunction with filters and reports to monitor activity for specific
rules. Each user can subscribe to as many different rules as needed.
You can assign subscriptions in Rule Creation while you are creating the rule, or anytime later
directly from the Rules grid.
To manage rule subscribers from the Rules grid:
1. Open the Build >Rules view.
2. In the Folders pane, click the folder that contains the rule you want to work with.
3. In the Rules grid, select the rules you want to work with.
4. On the Rules grid connectorbar, click Subscribe.
The Subscribe list opens. It only includes those Console uses who are associated
with the same Manager as the selected rule.
A check box with a gray background means the user already subscribes to one or more
of the selected rules, but not all of them.
5. Select the check box for each Console user who is to subscribe to the selected rules: l
Select an empty user's check box to have that user subscribe to all of the
selected rules.
l
Clear a gray user's check box to remove the user's subscription to all of
the selected rules.
l
Clear a gray user's check box and then select it again, to have that user
subscribe to all of the selected rules. Remember, these users are already
328
Chapter 14: Advanced Configurations
subscribed to some rules, but not all of them. This procedure assigns all
of the selected rules to that user.
As you can see, if you have multiple rules selected, each subscription change affects
every selected rule.
6. Click Subscribe again to close the list. The selected Console users now subscribe to
the selected rules.
To add rule subscribers from Rule Creation:
1. With a rule open in Rule Creation, click Subscribe.
The Subscribe list opens. It only includes those Console uses who are associated
with the same Manager as the selected rule.
2. Manage the rule's subscribers as follows: l
Select the check box for each Console user who is to subscribe to this
rule.
l
Clear the check box for each subscriber who is no longer to subscribe to
this rule.
3. Click Subscribe again to close the list.
4. Click Save.
The selected Console users now subscribe to the rule.
Enabling a rule
The Manager only uses rules that are enabled. It ignores all other rules. Therefore, the Manager
cannot use rules until you enable them. You can enable rules from the Rules grid, or directly from
Rule Creation. In either case, the Enable check box lets you turn a rule on and off.
329
Enabling a rule
Note: In the Rules grid, you can enable multiple rules at the same time. However, this command
acts as a toggle on each individual rule that is selected. For example, if one rule is disabled and
another is enabled, performing this command on both rules at the same time will invert the settings of
both rules. So the first rule would become enabled, and the second would become disabled.
Therefore, when performing this command on multiple rules, you will typically want to select only
those rules that already have the same Enabled/Disabled state.
To enable rules from the Rules grid:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rules you want to enable.
3. In the Rules grid, select the rule (or rules) you want to enable.
4. Enable the rules as follows:
l
To enable a single rule, click the row's gear
button and then click
Enable.
l
To enable multiple rules, click the grid's gear
button and then click
Enable.
In the Rules grid, the rules’ Enabled
icons become active, which means the rules
are now enabled. However, the Manager cannot begin using these rules until you
activate them.
5. Click Activate Rules to begin using the rule.
To enable a rule from Rule Creation:
1. With a rule open in Rule Creation, select the Enable check box.
2. When you are finished configuring the rule, click Save.
The Rules grid appears, with the
icon appearing in the rule's Enabled column. This
icon means the rule is now enabled. However, the Manager cannot begin using the rule
330
Chapter 14: Advanced Configurations
until you activate it.
3. Click Activate Rules to begin using the rule.
Placing rules in test mode
Before fully enabling a rule, you can try it out in test mode. In test mode, the Manager processes the
rule’s alert messages as it normally would, but without performing any of the rule’s actions. This lets
you see how the rule will behave when it is activated, without any possible disruption to your network.
Note: In the Rules grid, you can change the test mode of multiple rules at the same time. However,
this command acts as a toggle on each individual rule that is selected. For example, if one rule is in
test mode and another isn't, performing this command on both rules at the same time will invert the
settings of both rules. So the first rule would move out of test mode, and the second would move into
test mode. Therefore, when performing this command on multiple rules, you will typically want to
select only those rules that already have the same Test On/Test Off state.
To place rules in test mode in the Rules grid:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rules you want to test.
3. Check the rules' Enabled status. If any of the rules you want to test show a "disabled"
icon), then they need to be enabled. You can do this by clicking the row's gear
button and then clicking Enable.
In the Rules grid, the
icon appears in the rule’s Enabled column to indicate that the
rule has been enabled.
4. In the Rules grid, select the rule (or rules) you want to test.
331
Placing rules in test mode
5. Place the rules in test mode as follows: l
To put a single rule in test mode, click the row's gear
button and
then click Test On.
l
To put multiple rules in test mode, click the grid's gear
button and
then click Test On.
In the Rules grid, the
icon appears in the rules’ Test column to indicate that the
rules are in test mode.
6. Click Activate Rules.
The rules are now functional, but in test mode.
To remove a rule from test mode in the Rules grid:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rules you want to work with.
3. In the Rules grid, select the rule (or rules) you want to work with.
4. Remove the rules from test mode as follows: l
To remove a single rule from test mode, click the row's gear
button
and then click Test Off.
l
To remove multiple rules from test mode, click the grid's gear
button and then click Test Off.
In the Rules grid, the "disabled"
icon appears in the rules’ Test column to indicate
that the rules are no longer in test mode.
5. Click Activate Rules. The rules are now fully functional.
332
Chapter 14: Advanced Configurations
To place a rule in test mode from Rule Creation:
1. Open the Build >Rules view.
2. In the Folders pane, click the folder that contains the rule you want to test.
3. In the Rules grid, click to select the rule you want to test.
4. On the Rules grid connectorbar, click Edit.Rule Creation appears, showing the rule’s
current configuration.
5. Select the Enable check box.
6. Select the Test check box.
Note: To test a rule, you must have both Enable and Test checked. If only Enable is
checked, the rule is completely enabled (that is, it is fully in use). If only Test is
checked, the rule will not be enabled, which means the Manager will not be able to use
it for testing.
7. Click Save. The Rules grid appears.
8. Click Activate Rules.The rule is now in test mode.
To fully activate a rule from in Rule Creation:
1. Open the rule in Rule Creation, as described above.
2. Clear the Test check box.
3. Click Save.
4. On the Rule Builder connectorbar, click Activate Rules. The rule is now fully
functional.
Activating rules
Whenever you create a new rule or change an existing rule, you are working on a “local copy” of the
rule. The Manager has no way of using the rule change until you activate it. Activating a rule tells the
333
Disabling a rule
Manager to reload the enabled rules it is working on, which allows it to upload up the changes you just
made. You must activate rules whenever you create a new rule, edit an existing rule, or make
changes to a rule’s Enabled/Disabled or Test On/Test Off status. Otherwise, the Manager will not
recognize the change.
To activate rule changes, both the Rules grid and Rule Creation have an Activate Rules command.
This command sends any new rule changes to the Manager for immediate use. In Rule Creation, the
Activate Rules command leaves Rule Creation open so you can continue working.
To activate rules from the Rules grid:
1. Open the Build >Rules view.
2. Many any necessary changes to your rules.
3. On the Rules grid connectorbar, click Activate Rules.
The Manager activates any new rule changes and begins processing all enabled rules.
To activate rules from Rule Creation:
l
At any time, in Rule Creation, click Activate Rules.
The Manager activates any new rule changes and begins processing all enabled rules.
However, Rule Creation stays open so you can continue working. The rule you are
currently working on is not activated. It cannot be activated until it is first saved.
Disabling a rule
The Manager will continue to use any active rules, so long as they are enabled. If needed, you can
easily turn off rules by disabling them. However, the Manager will continue to use those rules until
you activate their new “disabled” status with the Activate Rules command.
Note: In the Rules grid, you can disable multiple rules at the same time. However, this command
acts as a toggle on each individual rule that is selected. For example, if one rule is disabled and
another is enabled, performing this command on both rules at the same time will invert the settings of
both rules. So the first rule would become enabled, and the second would become disabled.
334
Chapter 14: Advanced Configurations
Therefore, when performing this command on multiple rules, you will typically want to select only
those rules that already have the same Enabled/Disabled state.
To disable rules from the Rules grid:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rules you want to disable.
3. In the Rules grid, select the rule (or rules) you want to disable.
4. Disable the rules as follows: l
To disable a single rule, click the row's gear
button and then click
Disable.
l
To disable multiple rules, click the grid's gear
button and then click
Disable.
In the Rules grid, the Enabled column for each rule shows a “disabled”
icon to
indicate the rules are now inactive.
5. Click Activate Rules. The Manager stops processing the disabled rules.
To disable a rule from Rule Creation:
1. Open the rule you want to disable in Rule Creation.
2. Clear the Enable check box.
3. Click Save. The Rules grid appears.
4. Click Activate Rules. The Manager stops processing the disabled rule.
Cloning rules
The Clone command lets you copy any existing rule, make changes to the copy, and then save the
335
Importing a rule
copy with a new name in one of your Custom Rules sub-folders.
The benefit of cloning is that you can quickly create variations on existing rules. You clone a
preconfigured rule, such as a rule from the Rules or NATO5 Rules folder, and then adjust the cloned
copy to suit your specific needs.
Note: A cloned rule must be for the same Manager as the original rule. That is, you cannot clone a
rule from one Manager and save it for another Manager.
To clone rules:
1. Open the Build >Rules view.
2. In the Folders pane, click the folder that contains the rule you want to clone.
3. In the Rules grid, click to select the rule you want to clone.
4. Click the row's gear
button and then click Clone. The Clone Rule form appears.
5. In the Clone Name box, type a name for the cloned rule.
6. In the Folders list, select which Custom Rules folder is to store the cloned rule.
7. Click OK to save the cloned rule; otherwise, click Cancel.
The newly cloned copy of the rule automatically opens in Rule Creation so you can
begin making changes.
Importing a rule
You can import a rule from a remote source into a particular rule folder. For example, you may want to
import a rule from one Manager to another. Or you can import a rule that is provided by SolarWinds.
You may only import one rule at a time.
336
Chapter 14: Advanced Configurations
To import a rule to a rule folder:
1. Open the Build >Rules view.
2. On the Rules grid connectorbar, click
and then click Import. The Open form
appears.
3. In the Look In box, browse to and open the folder that contains the rule you want to
import.
4. Select the rule file you want to import.Rrule files are always .xml files.The file you
selected appears in the File Name box.
5. Click Open to import the file; otherwise, click Cancel. The Import Rules form
appears.
6. In the Manager list, select which Manager the imported rule is to be associated with.
7. In the Folders list, click to select the rule folder that is to store the imported rule. You
will need to click a folder’s >icon to view its sub-folders.
8. Click Import. The system imports the rules into the designated rule folder.
Exporting rules
Exporting rules is useful for three reasons:
l
You can export a rule from one Manager and import it into another Manager.
l
You can export rules to save archived copies in a safe place.
l
You can export rules to provide SolarWinds with a copy of your rule for technical
support or troubleshooting purposes.
You can export multiple rules at the same time. The rules will be saved to a new folder that contains
each rule.
337
Deleting Rules
To export rules:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rule you want to export. The
Rules grid displays the rules in that folder.
3. In the Rules grid, select the rules you want to export.
4. On the Rules grid connectorbar, click
and then click Export.The Select
Directory to Export Rule to form appears.
5. In the Save in box, locate the general area in which you want to save the exported rule
folder.
6. In the File name box, type a name for the folder that is to contain the exported rules.
Note: Rules are saved as .xml files.
7. Click Save.
The rules are exported and saved in the folder you specified. Each exported rule retains
its name and the date and time on which it was exported.
If an Export Error message appears, it means one or more of the rules failed to export.
If you are exporting multiple rules, the system exports as many as it can, and the
message lists which rules failed to export and which ones succeeded. Click OK to
close the form.
Deleting Rules
When needed, you can easily delete rules. You can delete one rule at a time, or you can delete
multiple rules. Deleting a rule is permanent. Once a rule is deleted, it can only be restored by recreating it or by importing a previously exported rule.
338
Chapter 14: Advanced Configurations
To delete rules:
1. Open the Build >Rules view.
2. In the Folders pane, select the folder that contains the rule you want to delete.The
Rules grid displays the rules in that folder.
3. In the Rules grid, select the rule (or rules) you want to delete.
4. Delete the rules as follows: l
To delete a single rule, click the row's gear
button and then click
Delete.
l
To delete multiple rules, click the grid's gear
button and then click
Delete.
5. At the Confirm Delete prompt, click Yes to delete the rules; otherwise, click No. The
rules disappear from the Rules grid.
6. Click Activate Rules to notify the Manager that the rules were deleted.
Connector Configuration Features
The topics in this section describe key features of the Connector Configuration form, its grid
columns, its icons, and how to use its Refine Results form.
After configuring a Manager’s connectors, you must configure the sensor and actor connectors for
each Agent that is associated with that Manager. The Connector Configuration form lets you
connect the Agent’s connectors to any supported products that are installed on or remotely logging to
the Agent’s computer. After the Agent connectors are configured, the Manager can monitor and
interact with the products and devices on that computer.
Agents connectors run locally to monitor data on the Agent’s computer. An Agent’s sensors generally
monitor log files, as well as data that is logged to the Agent’s computer from remove devices that
cannot have their own Agents. An Agent’s active response connectors (actors) allow the Agent to
receive instructions from the Manager and perform active responses locally, on the Agent’s
computer, such as sending pop-up messages or detaching USB devices.
339
Connector Configuration Features
Once you understand how the connectors work, the following procedures guides you through the
configuration process needed to integrate LEM with your network security products and devices.
The Connector Configuration form has similar features, whether you are configuring or editing a
Manager, an Agent, or a Connector Profile.
The following table describes the key features of the Connector Configuration form.
Name
Description
Sidebar
Click the Sidebar button to alternately hide and open the form’s Refine Results
button
pane.
Refine
By default, the Connectors grid shows all of the products that are supported. The
Results
Refine Results pane lets you apply filters to the grid to reduce the number of
pane
products it shows. This way, you can show only those products that are configured
for use with this Agent, or that are associated with a particular product category or
status (Running or Stopped).
Connectors The Connectors grid lists all of the sensor and actor connectors that are available to
grid
each Agent. These connectors are what allow LEM to monitor and interact with your
network security products and devices.
Connectors are organized by category and product name. Each connector is named
after the third-party product it is designed to configure for use with LEM.
Click this button to create a new connector instance the sensor or actor that is
currently selected in the Connectors grid.
Properties
This pane displays detailed information about the connector that is currently selected
pane
in the Connectors grid.
n
If the connector is not configured, this pane displays a description of the
connector.
n
If the connector is configured, this pane displays the configuration settings as
read-only information.
Whenever you add or edit a connector , this pane turns into an editable form for
recording the configuration settings.
340
Chapter 14: Advanced Configurations
Connectors Grid Columns
The following table briefly describes the meaning of each column in the Connector Configuration
form’s Connectors grid.
Column
Description
The gear button opens a menu of commands that apply to the connector that is currently
selected in the grid.
Status
Shows the connector’s current connection status:
means the connector is connected and running.
means the connector is disconnected and not running.
Category The high-level connector category, such as anti-virus connectors, firewall connectors,
operating system connectors, etc..
Name
The name of the actor, sensor, or connector instance. Typically, connectors are named
after the third-party products they are designed to configure for use with LEM.
Connectors Grid Icons
The following table describes the icons used in the Connector Configuration utility’s node tree.
Icon
Description
A blue connector icon represents a sensor for a particular product. The sensor displays the
name of the product it is designed to monitor.
Each connector instance (or alias) that is currently configured to monitor that product is listed
below the connector. If no connector instances are listed, it means the product, on this Agent
computer, has not been configured for use with LEM.
Whenever you select a sensor in the grid, the lower pane displays the connector’s name and
a description of the sensor, when available.
341
Refining the Connectors Grid
Icon
Description
The orange connector icon represents an actor for a product that can perform an active
response. The actor displays the name of the product it is designed to interact with.
Each connector instance (or alias) that is currently configured to initiate an active response
on that product is listed below the connector. If no connector instances are listed, it means
the product, on this Agent computer, has not been configured for use with LEM.
Whenever you select an actor in the grid, the lower pane displays the connector’s name and a
description of the actor, when available.
This icon represents a configured instance of a sensor connector. Each sensor can have
more than one instance, where each configuration is identified by a different name, called an
alias. In the grid, each configured connector instance appears below its connector.
Whenever you select a sensor connector instance in the grid, the lower pane displays the
sensor connector’s name, and the connector instance’s name (or alias) and configuration
settings. The Status column displays each instance’s current status—Stopped ( ) or
Running (
).
This icon represents a configured instance of an actor connector. Each actor can have more
than one instance, where each configuration is identified by a different name, called an alias.
In the grid, each configured connector instance appears below its connector.
Whenever you select an actor connector instance in the grid, the lower pane displays the
actor connector’s name, and the connector instance’s name (or alias) and configuration
settings. The Status column displays each instance’s current status—Stopped ( ) or
Running (
).
Refining the Connectors Grid
By default, the Connectors grid shows every connector (sensor and actor) that can be configured for
use with a particular Agent or Manager. To help you work more efficiently with a long list of
connectors, the Refine Results pane lets you apply filters to the Connectors grid to reduce the
number of connectors it shows.
342
Chapter 14: Advanced Configurations
When you select options in the Refine Results pane, the Connectors grid refreshes to show only
those sensor and actors that match the options you have selected. The other connectors are still
there; however, they are hidden. To restore them to the grid, click the Reset button or select All in the
refinement lists you are using.
The following table explains how to use the Refine Results pane.
Field
Reset
Description
Click Reset to clear the form and return the Connectors grid to its default state
(showing all connectors).
Search
Use this field to perform keyword searches for specific products, such as “Cisco” or
“McAfee.” To search, type the text you want to search for in the text box. Then press
Enter or click the magnifying glass symbol. The grid displays only those products
that match or include the text you entered.
Configured Select this check box to have the Connectors grid show only those connector
Connectors instances that are currently configured for the Manager or Agent you are working
with.
Clear this check box to have the grid list both configured and unconfigured
connectors.
Category
Select a high-level category to list the connectors that are available to support thirdparty products in that category. Each connector is named after the product it is
designed to configure for use with LEM.
Note: If you cannot find a particular product, it is either not supported, or it is in a
different category.
Status
Select Running to list all of the connectors that are currently running on the Manager
or Agent you are working with.
Select Stopped to list all of the connectors that are currently stopped on the Manager
or Agent you are working with.
343
Chapter 15: Scalability
Setting up an Addition nDepth Appliance
The topics in this section are about configuring nDepth to store and access your original log
messages:
l
Setting up the nDepth Appliance (if you are using a separate nDepth Appliance to store
original log messages).
l
Configuring your network connectors (sensors) for use with nDepth to store original log
messages.
Using a separate nDepth appliance
If needed, you can use a separate nDepth appliance for long-term storage and retrieval of your
network's original event log messages. In this configuration, each Manager has its own dedicated
nDepth appliance. The appliance stores all of the original log file source data that passes through a
particular Manager. The log data is stored in its entirety, in real time, as it originally occurs from each
host (network device) and source (application or connector) that is monitored by the Manager. Even when you use a separate appliance, you can still access and explore this information from the
Console's nDepth view.
The primary advantage of using a separate nDepth appliance is that it provides you with the capacity
for long-term storage and retrieval of the original log messages. If long-term storage of this information
is a high priority, then you will want to consider a separate appliance; otherwise, a separate appliance
is probably unnecessary. If you have questions, contact your SolarWinds sales representative or
SolarWinds Technical Support.
344
Chapter 15: Scalability
Installing a Separate nDepth Appliance
If you would like to use a separate nDepth appliance for long-term storage and retrieval of the original
log messages, then you must install that appliance before you begin using nDepth. Contact
SolarWinds Technical Support for instructions on installing a separate appliance.
If you are not using a separate appliance, this procedure is not required, because short-term log
messages are stored directly on LEM.
Configuring Network Connectors for Use with nDepth
To use nDepth to explore your network's original log messages, you must configure each connector
(sensors) for use with nDepth with the Console's Connector Configuration form.
First, decide which network devices, applications, and connectors that are monitored by the Manager
are to also send their log messages to nDepth. Then configure each of these connectors for use with
nDepth. You can choose to route a connector’s log messages to LEM, directly to nDepth, or to both.
SolarWinds recommends that you configure each connector so it routes its log messages to both
nDepth and LEM. This allows you to receive events on these connectors, and to search log
messages stored on the separate nDepth appliance.
l
How many days of live data will the LEM database store?
l
The number of days' worth of live data that the LEM database will store varies for every
implementation. The information below should help you determine this number for your
environment, while also promoting a more detailed understanding of how the database
works in general.
l
This article contains the following sections.
l
What the LEM Database Stores
l
Where to Find the Numbers
Alternate Storage Methods
By default, the LEM database is allowed 230 GB of the 250 GB allocated to the LEM virtual appliance.
This partition consists of three data stores:
345
Where to Find the Numbers
l
Syslog/SNMP data from devices logging to the LEM appliance;
l
Normalized Event data; and
l
Original, or "raw," log data, if enabled.
For the sake of this article, we'll call #1 the Syslog store. The Syslog store consists of all
Syslog/SNMP log data that is sent to the LEM appliance. The LEM appliance reads and processes
the data in real time, and then sends it to the Event store for long-term storage. The LEM appliance
stores the original data for 50 days in its original format, just in case you need to review it, and
compresses and rotates the data in the Syslog store daily, maintaining a consistent 50 days' worth of
data. The amount of data being stored here should level off at around the 50-day mark.
The Event store, #2 above, consists of all of the normalized Events generated by the LEM Manager
and LEM Agents. Data in this store is compressed at a ratio of 40:1 to 60:1, which equates to an
average compression rate of about 95-98%. LEM Reports and nDepth query this store for Event data
whenever they're run.
Finally, the original log store, #3 above, is an optional store for original, or "raw," log messages, which
is searchable using Log Message queries in nDepth. The data in this store can come from LEM
Agents or other devices that are logging to the LEM appliance. You can define whether data is sent to
this store at the connector level, so not all devices have to log in this manner. For more information,
see Configuring Your LEM Appliance for Log Message Storage and nDepth Search in the SolarWinds
Knowledge Base.
Where to Find the Numbers
There are three primary sources for statistics related to how your LEM database is being used: the
Disk Usage summary in the CMC, the Database Maintenance Report, and the Log Storage
Maintenance Report.
Disk Usage Summary
When you initially log into your LEM virtual appliance using the vSphere "console" view or an SSH
client such as PuTTY, the LEM appliance automatically generates a Disk Usage summary. You can
also generate an ad hoc Disk Usage summary by running the diskusage command from the
cmc::acm# (cmc > appliance) prompt. The two lines to note here are:
346
Chapter 15: Scalability
Logs/Data: This figure represents the total space being utilized by your LEM database. This value is
presented in the percent% (usedG/allocatedG) format, where percent is the percent of the allocated
space that is currently being used, used is the actual amount of space that is currently being used,
and allocated is the total amount of space that is currently allocated to the LEM database.
Logs: This figure represents the amount of space being utilized by the Syslog store. This figure is
included in the used figure noted above.
To figure out how much space is currently being utilized by your Event store, subtract the Logs value
from the used value.
Note: If you are storing original log messages in your LEM database, the calculation above will show
you the combined space being utilized by both your Event and original log stores.
Database Maintenance Report
Run the Database Maintenance Report in LEM Reports to see a snapshot of your current database
utilization. For the sake of this discussion, note the following sections:
Disk Usage Summary: This section provides disk usage figures as percentages of the space
allocated to the LEM database.
Disk Usage Details: This section provides the actual amounts related to the percentages in the Disk
Usage Summary section.
Database Time Span (days): Note the Event DB value in this section. This value tells you how many
days' worth of live Event data is currently stored on your LEM database. For detailed information
about this value, see the second page of the Database Maintenance Report.
Note: The Other Files figure in the Database Maintenance Report consists primarily of the data in the
Syslog store noted above.
Log Storage Maintenance Report
Run the Log Storage Maintenance Report in LEM Reports to get detailed information about the
original log store noted above. If you have not enabled your LEM appliance and connectors to store
original log messages, this report will be blank.
347
Alternate Storage Methods
Alternate Storage Methods
Depending on the needs of your environment, you might want to utilize one or more of the alternate
storage methods listed below. For more details or assistance with any of these methods, please open
a ticket with Support.
l
Backup your LEM virtual appliance on a regular basis. This will give you "offline"
storage for all of your LEM data stores and configuration settings. For instructions and
recommendations, see the Log & Event Manager > Backup section of the SolarWinds
Knowledge Base.
l
Decrease the number of days for which Syslog/SNMP data is stored on your LEM
virtual appliance.
l
Deploy another LEM virtual appliance to be used as a Syslog server.
l
Deploy another LEM virtual appliance to be used as a database server.
l
Increase the space allocated to your LEM virtual appliance.
348
Chapter 16: Enabling Transport Layer Security
The Transport Layer Security (TLS) option introduces an extra level of security for data transfers
between a LEM database and the Reports application. By default, TLS is disabled on both newly
deployed 6.0.1 and LEM appliances updated from previous versions. The enabling procedure differs
depending on your LEM configuration (standalone or with dedicated database appliance).
Note: During the process, the LEM certificate for accessing the Web or AIR Console needs to be
rebuilt. This means that machines used to access LEM Web or AIR Console need to have the
certificate re-imported.
Enabling Standalone LEM Appliance
1. Access the cmc prompt, either from the vSphere/Hyper-V Client console or via the
SSH client.
Note: The following steps are mandatory for upgraded LEM Appliances. If you have a
freshly deployed 6.0.1 appliance, proceed to step 7, the default hostname is swi-lem.
2. At the cmc> prompt, enter appliance.
3. At the cmc::acm# prompt, enter hostname.
4. Enter the name of your manager at the prompt “Please enter the new hostname…”
Note: Enter the currently used hostname if you do not want the LEM manager name to
change
5. At the cmc::acm# prompt, enter exit.
6. At the cmc> prompt, enter manager.
7. At the cmc::cmm# prompt, enter exportcert.
8. Follow the prompts to export LEM Manager CA certificate.
349
Chapter 16: Enabling Transport Layer Security
Note: An accessible network share is required. Once the export is successful, you will
see the following message: Exporting CA Cert to \\server\share\SWICAer hostname.crt ... Success.
9. At the cmc::cmm# prompt, enter enabletls.
11. At the cmc::cmm# prompt, enter restart.
This concludes the TLS configuration of standalone LEM Manager. Follow Setting up a Dedicated
LEM User for Reports Accessing to set up a user for accessing Reports and Configuring Reports
Application to configure the Reports application itself.
Setting up a Dedicated LEM User for Reports Accessing
Note: LEM 6.0.1 requires authorization to access LEM from the Reports application. This means that
a user with Reports role has to be created in the LEM Console. If you already have a suitable user,
proceed to Configuring Reports Application
1. Login to the LEM Web or AIR Console as a user with Administrator rights.
2. Navigate to Build > Users page.
3. Click + to create new LEM User.
4. Fill in the text fields. Username and Password are mandatory.
5. Select the Reports option form the LEM Role dropdown.
Note: Other roles that cay query LEM via Reports are Administrator and Auditor.
6. Save the new user.
Note: If you have an Active Directory Connector configured, you can utilize a directory Service user
as a Reports user instead of in-built LEM one.
Configuring Reports Application
1. Start the LEM Reports 6.0.1 application.
2. Select Managers – Credentials and Certificates option under the Configure button.
3. Click the green button.
350
Enabling TLS on a LEM Manager with a Dedicated Database Appliance
4. Specify the manager IP or hostname.
5. Fill in the credentials of the user created previously in Web Console.
6. Check the Use TLS connection? box.
Note: You can also ping the address you specified by pressing Test Connection button. This option
does not perform credentials validation or TLS availability check.
7. Click the green button again to add a new Manager.
8. Select the Certificates tab.
9. Click the Import Certificate button.
10. Browse and Open LEM certificate (e.g. the network share folder specified during
certificate export).
11. Use the certificate from the Database Appliance in case you have LEM configured with
a dedicated Database.
12. Close the Manager Configuration window.
Note: There is no need to import the LEM CA certificate again if the LEM changed its hostname.
Enabling TLS on a LEM Manager with a Dedicated
Database Appliance
1. Access the cmc prompt (either from vSphere/Hyper-V Client console or via SSH
client).
2. At the cmc> prompt, enter appliance.
3. At the cmc::acm# prompt, enter hostname.
4. At the prompt “Please enter the new hostname…” specify desired name of your
manager.
Note: If you don’t want your LEM manager name to change, enter the currently used
hostname.
5. At the cmc::acm# prompt, enter exit.
351
Chapter 16: Enabling Transport Layer Security
6. At the cmc> prompt, enter manager.
7. At the cmc::cmm# prompt, enter exportcert.
8. Follow the prompts to export LEM CA certificate.
Note: An accessible network share is required. Once the export is successful, you will
see the following message: Exporting CA Cert to \\server\share\SWICAerthostname.crt ... Success.
9. At the cmc::cmm# prompt, enter enabletls.
Enabling TLS on LEM Database
1. Access the cmc prompt (either from vSphere/Hyper-V Client console or via SSH
client).
2. At the cmc> prompt, enter appliance.
3. At the cmc::acm# prompt, enter hostname.
4. At the prompt “Please enter the new hostname…” specify desired name of your
manager.
Note: If you don’t want your LEM manager name to change, enter the currently used
hostname.
5. At the cmc::acm# prompt, enter exit.
6. At the cmc> prompt, enter manager.
7. At the cmc::cmm# prompt, enter exportcert.
8. Follow the prompts to export LEM CA certificate.
Note: An accessible network share is required. Once the export is successful, you will
see the following message: Exporting CA Cert to \\server\share\SWICAerthostname.crt ... Success.
9. At the cmc::cmm# prompt, enter enabletls.
352
Importing Certificates into the Manager and Database
Note: To use the custom CA to sign Database or Manager certificate, it is necessary to
generate and sign the certificate after changing the hostname. This is used
Importing Certificates into the Manager and Database
Manager and Database nodes need to trust each other’s certificates. This can be done by importing
certificates from both sides.
Note: It is not required to perform steps of this chapter on any appliance in these two cases:
l
You have upgraded from 6.0.0 or earlier.
l
A clean 6.0.1 or newer was deployed and CA used to sign both LEM certificates.
1. Access the cmc prompt of LEM Manager.
2. At the cmc> prompt, enter manager.
3. At the cmc::cmm# prompt, enter importl4ca.
4. Choose the network share location specified during certificate export of Database.
5. When prompted for a file name, specify the name of Database certificate.
6. Enter the full filename required including the file extension.
7. Access the cmc prompt of LEM Database.
8. At the cmc> prompt, enter manager.
9. At the cmc::cmm# prompt, enter importl4ca.
10. Choose the network share location specified during certificate export of Manager.
11. When prompted for a file name, specify the name of Manager certificate.
Note: Full filename required including the file extension.
This concludes the TLS configuration of a LEM Manager with a dedicated database appliance. Follow
the instructions for Setting up a Dedicated LEM User for Reports Accessing to set up a user for
accessing reports, and Configuring Reports Application to configure the Reports application.
353
Chapter 17: Troubleshooting
If you do not see the events you expected to see in the LEM Console, use the following procedures to
troubleshoot your LEM Agents and network devices.
Troubleshooting the LEM Agent
Start by determining whether the LEM Agent is connected to the LEM appliance:
1. Open the LEM Console and log in to your LEM appliance.
2. Click the Manage tab, and then select Nodes.
3. To filter this list to show just LEM Agents, select Agent from the Nodes menu on the
Refine Results pane.
Note: Refer to the icon in the Status column to determine which procedures to use.
Disconnected or Missing LEM Agents
Complete these procedures for LEM Agents that show in the LEM Console as "Disconnected," or do
not show in the LEM Console at all.
To troubleshoot LEM Agents that you cannot see in the LEM Console:
1. Verify you have installed the LEM Agent on the host computer.
2. If you have installed the LEM Agent, complete the procedure for how to troubleshoot
LEM Agents that show as "Disconnected" in the LEM Console.
To troubleshoot LEM Agents that show as "Disconnected" in the LEM Console:
1. Verify the LEM Agent service is running on the host computer.
2. Verify you can ping the LEM appliance by hostname from the LEM Agent computer.
3. If you can ping the appliance by hostname, clear the LEM Agent certificate.
4. If you cannot ping the appliance by hostname, try pinging the appliance by IP address.
5. If you can ping the appliance by IP address, do one of the following:
354
Chapter 17: Troubleshooting
l
Edit spop.conf so the LEM Agent calls the LEM appliance by its IP address
instead of its hostname. For instructions, see the spop.conf procedure later in
this section.
l
Change your DNS settings so the LEM Agent computer can resolve the LEM
appliance's hostname (recommended).
6. If you cannot ping the appliance by IP address, resolve any network or firewall issues
between the LEM Agent and appliance.
To edit spop.conf so the LEM Agent calls the LEM appliance by its IP address (Windows):
1. Stop the SolarWinds Log and Event Manager Agent service.
2. Delete the spop folder (do not delete the ContegoSPOP folder):
l
32-bit computers: C:\Windows\System32\ContegoSPOP\spop
l
64-bit computers: C:\Windows\SysWOW64\ContegoSPOP\spop
3. In the ContegoSPOP folder, open and modify the spop.conf file by replacing
the ManagerAddress value with the LEM appliance's IP address.
4. Save and close the file.
5. Start the SolarWinds Log and Event Manager Agent service.
Connected LEM Agents
Complete the following procedures for LEM Agents that show in the LEM Console as Connected.
To troubleshoot LEM Agents that show as "Connected" in the LEM Console:
1. Verify you have configured the appropriate connectors on the LEM Agent. For example,
the LEM Agent for Windows runs the connectors for the Windows Application and
Security Logs by default, but you must configure the connector for the DNS server role.
2. Verify the connectors you have configured are running.
3. If the necessary connectors are configured and running, delete and recreate the
connectors that are not working.
355
Troubleshooting Network Devices Logging to LEM
Contacting Support
If you still do not see events from your LEM Agents after completing these procedures, send the
following files to SolarWinds Support (default paths):
32-bit Windows OS:
l
C:\Windows\System32\ContegoSPOP\spoplog.txt (the most recent version)
l
C:\Windows\ System32\ContegoSPOP\tools\readerState.xml
64-bit Windows OS:
l
C:\Windows\SysWOW64\ContegoSPOP\spoplog.txt (the most recent version)
l
C:\Windows\SysWOW64\ContegoSPOP\tools\readerState.xml
Troubleshooting Network Devices
Start by determining whether the device is sending data to the LEM appliance:
1. Connect to your LEM appliance using the VMware "console" view, or an SSH client
such as PuTTY.
2. If you're connecting to your appliance through SSH, log in as the CMC user, and
provide the appropriate password.
3. If you're connecting to your appliance using VMware, select Advanced
Configuration on the main console screen, and then press Enter to get to the
command prompt.
4. At the cmc> prompt, enter appliance.
5. At the cmc::acm# prompt, enter checklogs.
6. Enter an item number to select a log file to view.
7. Check each log file that is not empty for evidence that the device is logging to the
appliance, such as the device's product name, device name, or IP address.
Troubleshooting Network Devices Logging to LEM
To monitor a network device with LEM, you must first configure the device to send its log messages
356
Chapter 17: Troubleshooting
to the LEM appliance. Determine whether or not the device you are troubleshooting is logging to LEM
prior to completing the following troubleshooting procedures.
To determine whether the LEM appliance is receiving data from the device:
1. Connect to your LEM appliance using a virtual console or SSH client.
2. Access the CMC prompt:
l
Virtual Console: Arrow down to Advanced Configuration, and then press
Enter.
l
SSH Client: Log in using your CMC credentials.
3. At the cmc> prompt, enter appliance.
4. At the cmc::acm# prompt, enter checklogs.
5. Enter an item number to select a log file to view.
6. Check each log file that is not empty for evidence that the device is logging to the
appliance, such as the device's product name, device name, or IP address.
Devices Not Logging to a Log File on the Appliance
1. Complete the following procedures for network devices that do not show data on the
LEM appliance.
2. To troubleshoot network devices that have not sent logs to the LEM appliance:
3. Verify you have configured the device to log to the LEM appliance.
4. Verify the device is logging to the correct IP address for the LEM appliance.
5. If the device is sending SNMP traps to the LEM appliance, verify you have configured
the LEM appliance to accept SNMP traps.
6. Verify a firewall is not blocking communication between the device and the LEM
appliance.
To configure your LEM Manager to accept SNMP traps:
1. Connect to your LEM appliance using a virtual console or SSH client.
357
Devices Logging to a Log File on the Appliance
2. Access the CMC prompt:
l
Virtual Console: Arrow down to Advanced Configuration, and then press
Enter.
l
SSH Client: Log in using your CMC credentials.
3. At the cmc> prompt, enter service.
4. At the cmc::scm# prompt, enter enablesnmp.
5. Press Enter to confirm your entry.
6. After you see the message, Done starting the SNMP service, enter exit to return to
the cmc> prompt.
Devices Logging to a Log File on the Appliance
Complete the following procedure for network devices that show data on the LEM appliance.
To troubleshoot network devices that have sent logs to the LEM appliance:
1. Verify you have configured the appropriate connector on the LEM appliance. For
information about how to troubleshoot connectors that are out of date, see
Troubleshooting "Unmatched Data" or "Internal New Tool Data" events in your LEM
Console.
2. Verify the connector you have configured is running.
3. If the necessary connector is configured and running, delete and recreate the connector
instance.
Contacting Support
If you still do not see events from your network device after completing these procedures, send a
screenshot of your device's logging configuration screens to SolarWinds Support.
358
Appendix A: Standard Widget Tables
The following table briefly describes the widgets that ship with the LEM Console.
Widget name/Filter
Description
All Events
Displays all events from all filters.
Events by Event Type
Displays a count of the top 10 events by event type (event name).
Events by Connector
Displays the number of events being captured by each configured con-
Name
nector, over time.
Events per Minute
Displays the total count of events per minute for the last 15 minutes.
Change Management
Displays events related to changes occurring on the network.
Change Management
Displays the top 10 Agents generating change management events
Events by Agent
Change Management
Displays the top 10 change management events by event type.
Events by Type
Failed Logons
Displays all user account failed logon attempts.
Failed Logons by User
Displays the top 5 Failed Logons by User Account name.
Account
File Audit Failures
Displays FileAuditFailure events, which show failed attempts to
access audited files.
File Audit Failures by File Displays the top 10 file names generating file audit failures.
Name
File Audit Failures by
Displays the top 10 source accounts generating file audit failures.
Source Account
Firewall
Displays all events from firewall devices.
Firewall Events by Fire-
Displays the top 5 firewalls generating firewall events
wall
359
Appendix A: Standard Widget Tables
Widget name/Filter
Description
Firewall Events by Type
Displays the top 5 firewall events by event type.
Incidents
Displays all Incident events.
Incidents by Rule Name
Displays the top 5 incidents by the name of the rule that generated the
Incident.
Interactive Logons by
Displays the top 10 user logons by user account name.
User Account
My Rules Fired by Rule
Displays the top 5 subscribed events by the name of the rule that gen-
Name
erated them.
Network Events
Displays all Network events.
Network Events by
Displays the top 10 machines generating network events.
Source Machine
Network Event Trends
Displays the top 10 network-related events by event type.
Rule Activity
Shows all of the rules that have fired.
Rules Fired by Rule
Displays the top 5 rules fired by rule name.
Name
Security Processes
Displays process launches and exits from processes in the "Security
Processes" User-Defined Group, which is used to monitor critical security-related processes.
Security Processes by
Displays the top 10 Agents generating security process events.
Agent
Subscriptions
Displays events created by rules you are "Subscribed" to in the Rules
area.
SolarWinds Events
Displays all Internal events (events generated during operation of the
LEM).
Unusual Network Traffic
Displays events that indicate unusual or suspicious network traffic.
Unusual Network Traffic
Displays the top 5 destinations for unusual network traffic.
by Destination
360
Appendix A: Standard Widget Tables
Widget name/Filter
Unusual Network Traffic
Description
Displays the top 10 sources of unusual network traffic.
by Source
USD Defender
Displays all USB-Defender events.
USB-Defender Activity
Displays the top 5 Agents with the most USB-Defender events.
by Detection IP
USB File Auditing
Displays USB-Defender's File Auditing events.
USB File Auditing by
Displays the top 5 Agents with the most USB file auditing events.
Detection IP
User Logons
Displays all user account logons
User Logons by Agent
Displays the top 5 Agents reporting user logons.
User Logons by Source
Displays the top 5 user logons by source machine.
Machine
User Logons by User
Displays the top 10 user logons by user account name.
Account
User Logons (Interactive) Displays interactive user account logons.
Virus Attacks
Displays all virus attack events.
Virus Attacks by Source
Displays the top 5 sources of virus attacks or infections.
Machine
361
Appendix B: Events
This appendix describes every event type that is displayed in the Events Panel and that can be
configured with the Policy commands.
Types of Events
Note: LEM reports events in a hierarchical node tree, shown here. When you click a node to open it,
you will see that most nodes also have lower-level nodes. Each node that has lower-level nodes is
called a parent node. Similarly, all lower-level nodes below a particular parent node can be thought of
as child nodes or children to that parent node. Naturally, the term parent and child applies to the node,
relative to its position and role on the node tree. That is, a node can be a child to one node, and a
parent to others.
362
Appendix B: Events
LEM automatically assigns alerts to the nodes of the alert tree based on the specific nature of the
alert and its severity.
Event types
There are five types of alerts:
l
Security Events are generally related to network activity that is consistent with an
internal or external attack, a misuse or abuse of resources, a resource compromise,
resource probing, or other abnormal traffic that is noteworthy. Security Events indicate
aggressive behavior that may lead to an attack or resource compromise, or suspicious
behavior that may indicate unauthorized information gathering.LEM infers some
Security Events from what is normally considered audit traffic, but it escalates the
events to alert status based on thresholds that are defined by Rules.
l
Internal Events are related to the operation of the LEM system. Any events generated
by LEM relating to Active Response, LEM users, or LEM errors will appear under one of
the many children. These alerts are for informational purposes. They do not necessarily
reflect conditions that should cause alarm. Events that may reflect potential issues
within LEM are specifically marked for forwarding to SolarWinds.
l
Audit Events are generally related to normal network activity that would not be
considered an attack, compromise, or misuse of resources. Many of the audit alerts
have rules that can be used to threshold and escalate “normal” behavior into something
which may be considered a security event.
l
Incident alerts are used to raise global enterprise-wide visibility in response to any
issue detected by Rules. Incidents generally reflect serious issues that should be
addressed. Since Incidents are created by Rules, any combination of malicious or
suspicious traffic from any other single alert or combination of alerts can create an
Incident.
l
Asset alerts relate to the changing state of different types of enterprise assets,
including software, hardware, and users. These alerts can indicate changes made to
system configurations, software updates, patch applications, vulnerability information,
and other system events.
363
Asset Events
Asset Events
Asset Events deal with assets and asset scan results. They relate to the changing state of different
types of enterprise assets, including software, hardware, and users. Asset information can come
from centralized directory service connectors, or it can be scan information from security scan
connectors, including Vulnerability Assessment and Patch Management connectors. Therefore,
these alerts indicate changes made to system configurations, software updates, patch applications,
vulnerability information, and other system events.
Each Asset Event is described below. For your convenience, they are listed alphabetically.
AssetManagement
AssetManagement alerts are for gathering non-realtime data about system assets (computer,
software, users). The data will come from various sources, including Directory Service connectors.
AssetManagement > MachineAsset
MachineAsset is a specific type of AssetManagement alert that indicates additions, removals, and
updates (including software installation) of specific nodes that exist in the enterprise.
AssetManagement > MachineAsset > MachineAssetAdded
MachineAssetAdded alerts indicate a new presence of a node (host or network device) in the
enterprise.
AssetManagement > MachineAsset > MachineAssetRemoved
MachineAssetRemoved alerts indicate the removal of a node (host or network device) from the
enterprise.
AssetManagement > MachineAsset > MachineAssetUpdated
MachineAssetUpdated alerts indicate a change to an existing node (host or network device) in the
enterprise, including new software and software patch installations on the node.
AssetManagement > MachineAsset > MachineAssetUpdated > SoftwareAssetUpdated
SoftwareAssetUpdated alerts indicate an attempted software change (including application of a
software patch) to an existing node (host or network device) in the enterprise, successful or failed.
364
Appendix B: Events
AssetManagement > MachineAsset > MachineAssetUpdated > SoftwareAssetUpdated >
SoftwareAssetPatched
SoftwareAssetPatched alerts indicate a successful application of a software patch to an existing
node (host or network device) in the enterprise.
AssetManagement > MachineAsset > MachineAssetUpdated > SoftwareAssetUpdated >
SoftwareAssetPatchFailed
SoftwareAssetPatchFailed alerts indicate a failed application of a software patch to an existing node
(host or network device) in the enterprise.
AssetManagement > SoftwareAsset
SoftwareAsset is a specific type of AssetManagement alert that indicates additions, removals, and
updates of specific software and software versions that exist in the enterprise.
AssetManagement > SoftwareAsset > SoftwareAssetAdded
SoftwareAssetAdded alerts indicate a new presence of an installation of specific software
applications or operating systems in the enterprise.
AssetManagement > SoftwareAsset > SoftwareAssetAdded > SoftwareAssetVersionAdded
SoftwareAssetVersionAdded alerts indicate a new version installation of specific known software
applications or operating systems in the enterprise.
AssetManagement > SoftwareAsset > SoftwareAssetRemoved
SoftwareAssetRemoved alerts indicate removals of specific software applications or operating
systems from the enterprise.
AssetManagement > UserAsset
UserAsset is a specific type of AssetManagement alert that indicates additions, removals, and
updates to users and user groups that exist in the enterprise.
AssetManagement > UserAsset > GroupAssetAdded
GroupAssetAdded alerts indicate a new presence of a user group in the enterprise.
365
Asset Events
AssetManagement > UserAsset > GroupAssetRemoved
GroupAssetRemoved alerts indicate the removal of a user group from the enterprise.
AssetManagement > UserAsset > GroupAssetUpdated
GroupAssetUpdated alerts indicate a change to a user group that exists in the enterprise, including
group member additions and deletions.
AssetManagement > UserAsset > GroupAssetUpdated > GroupAssetMemberAdded
GroupAssetMemberAdded alerts indicate an addition of a user member to a user group that exists in
the enterprise.
AssetManagement > UserAsset > GroupAssetUpdated > GroupAssetMemberRemoved
GroupAssetMemberRemoved alerts indicate a removal of a user member from a user group that
exists in the enterprise.
AssetManagement > UserAsset > UserAssetAdded
UserAssetAdded alerts indicate a new presence of a user in the enterprise.
AssetManagement > UserAsset > UserAssetRemoved
UserAssetRemoved alerts indicate the removal of a user from the enterprise.
AssetManagement > UserAsset > UserAssetUpdated
UserAssetUpdated alerts indicate a change to a user that exists in the enterprise.
AssetScanResult
AssetScanResult contains alerts useful for data gathered from security scan results (reports). These
alerts are commonly gathered from Vulnerability Assessment and Patch Management connectors.
AssetScanResult > ExposureFound
ExposureFound alerts indicate scan results that are not high risk but demonstrate configuration
issues or potential risks. These alerts may indicate exposures that can potentially cause future
366
Appendix B: Events
exploits or have been common sources of exploits in the past, such as common open ports or host
configuration issues.
AssetScanResult > VulnerabilityFound
VulnerabilityFound alerts indicate scan results that demonstrate high risk vulnerabilities. These alerts
can indicate the presence of serious exposures that should be addressed and can represent
significant risk of exploit or infection of enterprise assets.
GeneralAsset
GeneralAsset alerts are generated when a supported product outputs data that has not yet been
normalized into a specific alert, but is known to be asset issue-related.
Audit Events
Events that are children of AuditEvent node are generally related to normal network activity that
would not be considered an attack, compromise, or misuse of resources. Many of the audit alerts
have rules that can be used to threshold and escalate “normal” behavior into something which may be
considered a security event.
Each Audit Event is described below. For your convenience, they are listed alphabetically.
AuthAudit
Events that are part of the AuthAudit tree are related to authentication and authorization of accounts
and account ''containers'' such as groups or domains.
These alerts can be produced from any network node including firewalls, routers, servers, and clients.
AuthAudit > DomainAuthAudit
DomainAuthAudit events are authentication, authorization, and modification events related only to
domains, subdomains, and account containers. These alerts are normally operating system related,
however could be produced by any network device.
AuthAudit > DomainAuthAudit > NewDomainMember
NewDomainMember events occur when an account or account container has been added to a
domain. Usually, these additions are made by a user account with administrative privileges, but
367
Audit Events
occasionally a NewDomainMember alert will also happen when local system maintenance activity
takes place.
AuthAudit > DomainAuthAudit > DeleteDomainMember
DeleteDomainMember events occur when an account or account container has been removed from a
domain. Usually, these changes are made by a user account with administrative privileges, but
occasionally a DeleteDomainMember alert will also happen when local system maintenance activity
takes place.
AuthAudit > DomainAuthAudit > ChangeDomainMember
A ChangeDomainMember alert occurs when an account or account container within a domain is
modified. Usually, these changes are made by a user account with administrative privileges, but
occasionally a ChangeDomainMember alert will also happen when local system maintenance activity
takes place.
AuthAudit > DomainAuthAudit > ChangeDomainMember > DomainMemberAlias
DomainMemberAlias events happen when an account or account container within a domain has an
alias created, deleted, or otherwise modified. This event is uncommon and is used to track links
between domain members and other locations in the domain where the member may appear.
The alias for a domain member has been changed.
AuthAudit > DomainAuthAudit > NewDomain
NewDomain events occur upon creation of a new trust relationship between domains, creation of a
new subdomain, or creation of new account containers within a domain. Usually, these creations are
done by a user account with administrative privileges.
AuthAudit > DomainAuthAudit > ChangeDomainAttribute
ChangeDomainAttribute events occur when a domain type is changed. These events are uncommon
and usually provided by the operating system. Usually, these changes are made by a user account
with administrative privileges, but occasionally a ChangeDomainAttribute alert will also happen when
local system maintenance activity takes place.
AuthAudit > DomainAuthAudit > DeleteDomain
368
Appendix B: Events
DeleteDomain events occur upon removal of a trust relationship between domains, deletion of a
subdomain, or deletion of account containers within a domain. Usually, these changes are made by a
user account with administrative privileges.
AuthAudit > GroupAudit
GroupAudit events are authentication, authorization, and modification events related only to account
groups. These alerts are normally operating system related, however could be produced by any
network device.
AuthAudit > GroupAudit > ChangeGroupAttribute
ChangeGroupAttribute events occur when a group type is modified. Usually, these changes are made
by a user account with administrative privileges, but occasionally a ChangeGroupAttribute alert will
also happen when local system maintenance activity takes place.
AuthAudit > GroupAudit > DeleteGroup
DeleteGroup events occur upon deletion of a new group of any type. Usually, these deletions are
made by a user account with administrative privileges.
AuthAudit > GroupAudit > DeleteGroupMember
DeleteGroupMember events occur when an account or group has been removed from a group.
Usually, these changes are made by a user account with administrative privileges, but occasionally a
DeleteGroupMember alert will also happen when local system maintenance activity takes place.
AuthAudit > GroupAudit > NewGroup
NewGroup events occur upon creation of a new group of any type. Usually, these additions are made
by a user account with administrative privileges.
AuthAudit > GroupAudit > NewGroupMember
NewGroupMember events occur when an account (or other group) has been added to a group.
Usually, these additions are made by a user account with administrative privileges, but occasionally
a NewGroupMember alert will also happen when local system maintenance activity takes place.
A new user, machine, or service account has been added to the group.
AuthAudit > MachineAuthAudit
369
Audit Events
MachineAuthAudit events are authentication, authorization, and modification events related only to
computer or machine accounts. These alerts can be produced from any network node including
firewalls, routers, servers, and clients, but are normally operating system related.
AuthAudit > MachineAuthAudit > MachineAuthTicketFailure
MachineAuthTicketFailure alerts reflect failed computer or machine account ticket events from
network devices that use a ticket-based single-sign-on system (such as Kerberos or Windows
domains). Each alert will reflect the point on the network where the computer or machine was
attempting logon. In larger quantities, these alerts may reflect a potential issue with a computer or set
of computers, but as individual events they are generally not a problem.
AuthAudit > MachineAuthAudit > MachineAuthTicket
MachineAuthTicket alerts reflect computer or machine account ticket events from network devices
monitored by Contego that use a ticket-based single-sign-on system (such as Kerberos or Windows
domains). Each alert will reflect the type of device the logon was intended for along with all other
relevant fields.
AuthAudit > MachineAuthAudit > MachineDisable
MachineDisable events occur when a machine account is actively disabled and/or when an account
is forcibly locked out by the operating system or other authentication connector. These events are
usually operating system related and could reflect a potential issue with a computer or set of
computers.
AuthAudit > MachineAuthAudit > MachineEnable
MachineEnable alerts reflect the action of enabling a computer or machine account. These events are
normally OS-related and will trigger when a machine is 'enabled', normally by a user with
administrative privileges.
AuthAudit > MachineAuthAudit > MachineLogoff
MachineLogoff alerts reflect computer or machine account logoff events from network devices
(including network infrastructure devices, where appropriate). Each alert will reflect the type of device
from which the user was logging off. These alerts are usually normal events but are tracked for
consistency and auditing purposes.
AuthAudit > MachineAuthAudit > MachineLogonFailure
370
Appendix B: Events
MachineLogonFailure alerts reflect failed computer or machine account logon events from network
devices (including network infrastructure devices, when appropriate). Each alert will reflect the point
on the network where the computer or machine was attempting logon. In larger quantities, these
alerts may reflect a potential issue with a computer or set of computers, but as individual events they
are generally not a problem.
AuthAudit > MachineAuthAudit > MachineLogon
MachineLogon events reflect computer or machine account logon events from network devices
monitored by Contego (including network infrastructure devices, when appropriate). Each alert will
reflect the type of device that the logon was intended for along with all other relevant fields. These
events are normally operating system related.
AuthAudit > MachineAuthAudit > MachineModifyAttribute
MachineModifyAttribute events occur when a computer or machine type is changed. These events
are uncommon and usually provided by the operating system.
AuthAudit > MachineAuthAudit > MachineModifyPrivileges
MachineModifyPrivileges events are created when a computer or machine's privileges are elevated or
demoted based on their logon or activities they are performing. These events are uncommon.
AuthAudit > UserAuthAudit
UserAuthAudit events are authentication, authorization, and modification events related only to user
accounts. These alerts can be produced from any network node including firewalls, routers, servers,
and clients.
AuthAudit > UserAuthAudit > UserAuthTicketFailure
UserAuthTicketFailure alerts reflect failed user account ticket events from network devices that use
a ticket-based single-sign-on system (such as Kerberos or Windows domains). Each alert will reflect
the point on the network where the user was attempting logon. In larger quantities, these alerts may
reflect a potential issue with a user or set of users, but as individual events they are generally not a
problem.
AuthAudit > UserAuthAudit > UserAuthTicket
UserAuthTicket alerts reflect user account ticket events from network devices monitored by Contego
371
Audit Events
that use a ticket-based single-sign-on system (such as Kerberos or Windows domains). Each alert
will reflect the type of device that the logon was intended for along with all other relevant fields.
AuthAudit > UserAuthAudit > UserDisable
UserDisable events occur when a user account is actively disabled and/or when a user is forcibly
locked out by the operating system or other authentication connector. These events are usually
operating system related and could reflect a potential issue with a user or set of users.
AuthAudit > UserAuthAudit > UserEnable
UserEnable alerts reflect the action of enabling a user account. These events are normally OS-related
and will trigger both when an account is ''unlocked'' after lockout due to unsuccessful logons and
'enabled' in the traditional sense.
AuthAudit > UserAuthAudit > UserLogoff
UserLogoff alerts reflect account logoff events from network devices (including network infrastructure
devices). Each alert will reflect the type of device from which the user was logging off. These alerts
are usually normal events but are tracked for consistency and auditing purposes.
AuthAudit > UserAuthAudit > UserLogon
UserLogon alerts reflect user account logon events from network devices monitored by Contego
(including network infrastructure devices). Each alert will reflect the type of device that the logon was
intended for along with all other relevant fields.
AuthAudit > UserAuthAudit > UserLogonFailure
UserLogonFailure alerts reflect failed account logon events from network devices (including network
infrastructure devices). Each alert will reflect the point on the network where the user was attempting
logon. In larger quantities, these alerts may reflect a potential issue with a user or set of users, but as
individual events they are generally not a problem.
With SolarWinds policy, you can configure combinations of this event to escalate to
FailedAuthentication in the Security tree, reflecting the increase in severity of the event over several
occurrences.
AuthAudit > UserAuthAudit > UserModifyAttribute
372
Appendix B: Events
UserModifyAttribute events occur when a user type is changed. These events are uncommon and
usually provided by the operating system.
AuthAudit > UserAuthAudit > UserModifyPrivileges
UserModifyPrivileges events are created when a user's privileges are elevated or demoted based on
their logon or activities they are performing. These events are uncommon.
GeneralAudit
GeneralAudit alerts are generated when a supported product outputs data that has not yet been
normalized into a specific alert, but is known to be audit-related.
MachineAudit
MachineAudit alerts are used to track hardware or software status and modifications. These events
are generally acceptable, but do indicate modifications to the client system that may be noteworthy.
MachineAudit > SoftwareInstall
SoftwareInstall alerts reflect modifications to the system at a software level, generally an OS level (or
equivalent, in the case of a network infrastructure device). These alerts are generated when a user
updates a system or launches system-native methods to install third party applications.
MachineAudit > SoftwareInstall > SoftwareUpdate
SoftwareUpdate is a specific type of SoftwareInstall that reflects a more current version of software
being installed to replace an older version.
MachineAudit > SystemScan
SystemScan alerts reflect information related to scheduled or on-demand scans of systems. These
alerts are generally produced by Anti-Virus, Patch Management, and Vulnerability Assessment
connectors, and indicate the start, finish, and information related to a scan.
MachineAudit > SystemScanInfo
SystemScanInfo is a specific type of SystemScan alert that reflects information related to a system
scan. Most of these events can safely be ignored, as they are generally normal activity that does not
reflect a failure or abnormal state.
373
Audit Events
MachineAudit > SystemScanStart
SystemScanStart is a specific type of SystemScan alert that indicates initiation of a system scan.
MachineAudit > SystemScanStop
SystemScanStop is a specific type of SystemScan alert that indicates completion of a system scan.
This activity is generally normal, however, in the error or failure state a specific alert will be generated.
MachineAudit > SystemScanWarning
SystemScanWarning is a specific type of SystemScan alert that indicates a scan has returned a
'Warning' message indicating an issue. These alerts may indicate scan issues that should be
corrected for future scans.
MachineAudit > SystemStatus
SystemStatus alerts reflect general system state events. These events are generally normal and
informational, however, they could potentially reflect a failure or issue which should be addressed.
MachineAudit > SystemStatus > SystemReboot
SystemReboot is a specific type of SystemStatus alert that is used to audit system restarts. This
alert will only be generated if the system restart was normal and not a result of a crash or other failure
condition.
MachineAudit > SystemStatus > SystemReboot > SystemShutdown
SystemShutdown is a specific type of SystemStatus alert that is used to audit system shutdowns,
including both expected and unexpected shutdowns. In the event the shutdown was unexpected, the
event detail will note the information provided by the connector related to the abnormality.
PolicyAudit
PolicyAudit events are used to track access, modification, scope change, and creation of
authentication, domain, account, and account container policies. Many of these alerts reflect normal
system traffic. Most PolicyAudit alerts are provided by the Operating System.
PolicyAudit > NewAuthPolicy
NewAuthPolicy alerts occur when a new authorization or authentication package, process, or logon
374
Appendix B: Events
handler is applied to an item (usually an account or domain). In the operating system context, these
events will often occur on boot as the system initializes the appropriate authentication policies for
itself.
PolicyAudit > PolicyAccess
PolicyAccess alerts reflect all levels of access to policy, mostly targeting domain, account, access,
and logon policy modifications.
PolicyAudit > PolicyAccess > PolicyModify
PolicyModify alerts reflect all types of modifications to contained policies, both at a local and
domain/account container level. In the context of a network infrastructure device, this would be a
modification to access control lists or other similar policies on the device.
PolicyAudit > PolicyAccess > PolicyModify > DomainPolicyModify
DomainPolicyModify alerts are a specific type of PolicyModify alerts that reflect changes to domain
and account container level policies. These types of policies are generally related to the operating
system. Usually these modifications are made by a user with administrative privileges, but
occasionally these changes can also be triggered by the local system.
PolicyAudit > PolicyAccess > PolicyScopeChange
PolicyScopeChange alerts are a specific type of PolicyAccess alert that reflect a new scope or
assignment of policy to users, groups, domains, interfaces, or other items.
In the context of the operating system, these events are usually describing elevation of user
privileges according to predefined policies. The process of this elevation is considered a scope
change as the user is being brought under a new scope of privileges appropriate to the type of access
they are requesting (and being granted). These events may accompany or precede object or file
opens, including other policies.
PolicyAudit > PolicyAccess > GroupPolicyModify
GroupPolicyModify alerts are specific PolicyAccess alerts used to describe modifications to account
group policies. Usually these modifications are made by a user with administrative privileges, but
occasionally these changes can also be triggered by the local system.
ResourceAudit
375
Audit Events
Members of the ResourceAudit tree are used to define different types of access to network
resources. These resources may be network bandwidth/traffic, files, client processes or services, or
other types of shared security-related 'commodities'.
ResourceAudit > FileAudit
FileAudit alerts are used to track file activity on monitored network devices, usually through the
Operating System or a Host-Based IDS. These events will note success or failure of the requested
operation.
ResourceAudit > FileAudit > FileAuditFailure
FileAuditFailure alerts are used to track failed file activity on monitored network devices, usually
through the Operating System or a Host-Based IDS. These events will note what requested operation
failed.
ResourceAudit > FileAudit > FileRead
FileRead is a specific FileAudit alert generated for the operation of reading files (including reading
properties of a file or the status of a file). These alerts may be produced by any connector that is used
to monitor the activity of file usage, including a Host-Based IDS and some Operating Systems.
ResourceAudit > FileAudit > FileRead > FileExecute
FileExecute is a specific FileRead alert generated for the operation of executing files. These alerts
may be produced by any connector that is used to monitor the activity of file usage, including a HostBased IDS and some Operating Systems.
ResourceAudit > FileAudit > FileRead > FileDataRead
FileDataRead is a specific FileRead alert generated for the operation of reading data from a file (not
just properties or status of a file). These alerts may be produced by any connector that is used to
monitor the activity of file usage, including a Host-Based IDS and some Operating Systems.
ResourceAudit > FileAudit > FileWrite
FileWrite is a specific FileAudit alert generated for the operation of writing to a file (including writing
properties of a file or changing the status of a file). These alerts may be produced by any connector
that is used to monitor the activity of file usage, including a Host-Based IDS and some operating
systems.
376
Appendix B: Events
ResourceAudit > FileAudit > FileWrite > FileDataWrite
FileDataWrite is a specific FileWrite alert generated for the operation of writing data to a file (not just
properties or status of a file). These alerts may be produced by any connector that is used to monitor
the activity of file usage, including a Host-Based IDS and some Operating Systems.
ResourceAudit > FileAudit > FileWrite > FileCreate
FileCreate is a specific FileWrite alert generated for the initial creation of a file. These alerts may be
produced by any connector that is used to monitor the activity of file usage, including a Host-Based
IDS and some Operating Systems.
ResourceAudit > FileAudit > FileWrite > FileMove
FileMove is a specific FileWrite alert generated for the operation of moving a file that already exists.
These alerts may be produced by any connector that is used to monitor the activity of file usage,
including a Host-Based IDS and some Operating Systems.
ResourceAudit > FileAudit > FileWrite > FileDelete
FileDelete is a specific FileWrite alert generated for the deletion of an existing file. These alerts may
be produced by any connector that is used to monitor the activity of file usage, including a HostBased IDS and some Operating Systems.
ResourceAudit > FileAudit > FileWrite > FileAttributeChange
FileAttributeChange is a specific FileWrite alert generated for the modification of file attributes
(including properties such as read-only status). These alerts may be produced by any connector that
is used to monitor the activity of file usage, including a Host-Based IDS and some Operating
Systems.
ResourceAudit > FileAudit > FileWrite > FileLink
FileLink is a specific FileWrite alert generated for the creation, deletion, or modification of links to
other files. These alerts may be produced by any connector that is used to monitor the activity of file
usage, including a Host-Based IDS and some Operating Systems.
ResourceAudit > FileHandleAudit
FileHandleAudit alerts are used to track file handle activity on monitored network devices, usually
377
Audit Events
through low level access to the Operating System, either natively or with or a Host-Based IDS. These
events will note success or failure of the requested operation.
ResourceAudit > FileHandleAudit > FileHandleClose
FileHandleClose is a specific FileHandleAudit alert generated for the closing of file handles. These
alerts may be generated by a connector that has low-level file access, such as an Operating System
or some Host-Based IDS'.
ResourceAudit > FileHandleAudit > FileHandleCopy
FileHandleCopy is a specific FileHandleAudit alert generated for the copying of file handles. These
alerts may be generated by a connector that has low-level file access, such as an Operating System
or some Host-Based IDS'.
ResourceAudit > FileHandleAudit > FileHandleOpen
FileHandleOpen is a specific FileHandleAudit alert generated for the opening of file handles. These
alerts may be generated by a connector that has low-level file access, such as an Operating System
or some Host-Based IDS'.
ResourceAudit > FileSystemAudit
FileSystemAudit alerts reflect hardware to filesystem mapping events and usage of filesystem
resources. These events are generally normal system activity, especially during system boot.
ResourceAudit > FileSystemAudit > MountFileSystem
MountFileSystem alerts are a specific type of FileSystemAudit that reflect the action of creating an
active translation between hardware to a usable filesystem. These events are generally normal during
system boot.
ResourceAudit > FileSystemAudit > UnmountFileSystem
UnmountFileSystem alerts are a specific type of FileSystemAudit that reflect the action of removing
a translation between hardware and a usable filesystem. These events are generally normal during
system shutdown.
ResourceAudit > NetworkAudit
378
Appendix B: Events
Members of the NetworkAudit tree are used to define events centered on usage of network
resources/bandwidth.
ResourceAudit > NetworkAudit > ConfigurationTrafficAudit
ConfigurationTrafficAudit alerts reflect application-layer data related to configuration of network
resources. Included in ConfigurationTrafficAudit are protocols such as DHCP, BootP, and SNMP.
ConfigurationTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could
also be symptoms of misconfiguration, inappropriate usage, attempts to enumerate or access
network devices or services, attempts to access devices that are configured via these services, or
other abnormal traffic.
ResourceAudit > NetworkAudit > CoreTrafficAudit
CoreTrafficAudit alerts reflect network traffic sent over core protocols. Events that are children of
CoreTrafficAudit are all related to the TCP, IP, UDP, and ICMP protocols. Events of this type and its
children do not have any application-layer data.
Events placed in the parent CoreTrafficAudit alert itself are known to be a core protocol, but are not
able to be further categorized based on the message provided by the connector.
ResourceAudit > NetworkAudit > CoreTrafficAudit > TCPTrafficAudit
TCPTrafficAudit alerts are a specific subset of CoreTrafficAudit alerts where the protocol is known to
be TCP.
TCPTrafficAudit alerts may indicate normal traffic inside the network, normal traffic pass-through,
denied traffic, or other non-application TCP traffic that is not known to have any immediate attack
basis.
ResourceAudit > NetworkAudit > CoreTrafficAudit > IPTrafficAudit
IPTrafficAudit alerts are a specific subset of CoreTrafficAudit alerts where the protocol is known to be
IP.
IPTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of spoofs, routing issues, or other abnormal traffic. Generally, for the abnormal traffic that
379
Audit Events
is appropriate to escalate, a Contego Policy has been defined to escalate this to an alert in the
Security tree based on a threshold.
ResourceAudit > NetworkAudit > CoreTrafficAudit > UDPTrafficAudit
UDPTrafficAudit alerts are a specific subset of CoreTrafficAudit alerts where the protocol is known to
be UDP.
UDPTrafficAuditEvents may indicate normal traffic inside the network, normal traffic pass-through,
denied traffic, or other non-application UDP traffic that is not known to have any immediate attack
basis.
ResourceAudit > NetworkAudit > CoreTrafficAudit > ICMPTrafficAudit
ICMPTrafficAudit alerts are a specific subset of CoreTrafficAudit alerts where the protocol is known
to be ICMP.
ICMPTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of scans, floods, or other abnormal traffic. Generally, for the abnormal traffic that is
appropriate to escalate, a Contego Policy has been defined to escalate this to an alert in the Security
tree based on a threshold.
ResourceAudit > NetworkAudit > CoreTrafficAudit > IPSecTrafficAudit
IPSecTrafficAudit alerts are a specific subset of CoreTrafficAudit alerts where the traffic is known to
be related to non-application layer IPSec events (such as key exchanges).
IPSecTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of misconfigured IPSec peers, problems with IPSec communication, or other abnormal
traffic.
ResourceAudit > NetworkAudit > LinkControlTrafficAudit
LinkControlTrafficAudit alerts are generated for network events related to link level configuration.
LinkControlTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also
be symptoms of misconfiguration at the link level, inappropriate usage, or other abnormal traffic.
ResourceAudit > NetworkAudit > RoutingTrafficAudit
380
Appendix B: Events
RoutingTrafficAudit alerts are generated for network events related to configuration of network routes,
using protocols such as IGMP, IGRP, and RIP.
RoutingTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of misconfigured routing, unintended route configuration, or other abnormal traffic.
ResourceAudit > NetworkAudit > RoutingTrafficAudit > RIPTrafficAudit
RIPTrafficAudit alerts are a specific subset of RoutingTrafficAudit alerts where the protocol is known
to be RIP.
RoutingTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of misconfigured routing, unintended route configuration, or other abnormal traffic.
ResourceAudit > NetworkAudit > NamingTrafficAudit
NamingTrafficAudit alerts are generated for network events related to the naming of network
resources and nodes, using protocols such as WINS and DNS.
NamingTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of inappropriate DNS authority attempts, misconfiguration of naming services, and other
abnormal traffic. In several cases, for traffic that is appropriate to escalate, a Contego Policy has
been defined to escalate this to an alert in the Security tree based on a threshold.
ResourceAudit > NetworkAudit > FileSystemTrafficAudit
FileSystemTrafficAudit alerts are generated for network events related to requests for remote
filesystems, using protocols such as SMB and NFS.
FileSystemTrafficAudit alerts generally indicate normal traffic for networks that have remote
filesystem resources such as SMB and NFS shares; however, alerts of this type could also be
symptoms of attempts to enumerate shares or services, misconfiguration of such resources, or other
abnormal traffic. For networks that do not have remote filesystem resources, these alerts will
generally indicate abnormal traffic.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit
ApplicationTrafficAudit alerts reflect network traffic that is mostly or all application-layer data. Events
that are children of ApplicationTrafficAudit are also related to application-layer resources.
381
Audit Events
Events placed in the parent ApplicationTrafficAudit alert itself are known to be application-related, but
are not able to be further categorized based on the message provided by the connector or because
they are uncommon and rarely, if ever, imply network attack potential.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > EncryptedTraffic
EncryptedTraffic alerts reflect application-layer traffic that has been encrypted and is intended for a
secure host. Included in EncryptedTraffic alerts are client and server side application events, such as
key exchanges, that normally occur after the low-level session creation and handshaking have
completed.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > EncryptedTraffic > EncryptedTrafficError
EncryptedTrafficError alerts are a specific subnet of EncryptedTraffic alerts that reflect problems
while exchanging keys or data.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > MailTrafficAudit
MailTrafficAudit alerts reflect application-layer data related to mail services. Included in
MailTrafficAudit are client and server mail events from protocols such as IMAP, POP3, and SMTP.
MailTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of excessive mail usage, unintended mail traffic, abnormal command exchanges to a
server, or generally abnormal traffic.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > WebTrafficAudit
WebTrafficAudit alerts reflect application-layer data related to web services. Included in
WebTrafficAudit are client and server web events from web servers, web applications, content filter
related events, and other web services.
WebTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of inappropriate web usage, potential abuse of web services, or other abnormal traffic.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > TimeTrafficAudit
TimeTrafficAudit alerts reflect application-layer data related to network time configuration. Included in
TimeTrafficAudit are protocols such as NTP and activities, such as detection of client-side network
time updates.
382
Appendix B: Events
TimeTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also be
symptoms of misconfiguration, inappropriate usage, or other abnormal traffic.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > TimeTrafficAudit > NTPTrafficAudit
NTPTrafficAudit alerts are a specific type of TimeTrafficAudit related to the Network Time Protocol.
ResourceAudit > NetworkAudit > ApplicationTrafficAudit > FileTransferTrafficAudit
FileTransferTrafficAudit alerts reflect application-layer data related to file retrieval and send to/from
remote hosts. Included in FileTransferTrafficAudit are protocols such as TFTP and FTP.
FileTransferTrafficAudit alerts generally indicate normal traffic, however, alerts of this type could also
be symptoms of misconfiguration, inappropriate usage, attempts to enumerate or access file transfer
services, attempts to access devices that require file transfer services for configuration, or other
abnormal traffic.
ResourceAudit > NetworkAudit > PointToPointTrafficAudit
PointToPointTrafficAudit alerts reflect application-layer data related to point-to-point connections
between hosts. Included in PointToPointTrafficAudit are encrypted and unencrypted point-to-point
traffic.
ResourceAudit > NetworkAudit > PointToPointTrafficAudit > PPTPTrafficAudit
PPTPTrafficAudit alerts are a specific type of PointToPointTrafficAudit alerts that reflect applicationlayer encrypted Peer-to-Peer Tunneling Protocol activities. Included in PPTPTrafficAudit alerts are
tunnel creation, tunnel deletion, session creation, and session deletion, among other PPTP-related
events.
PPTPTrafficAudit alerts generally indicate normal traffic for networks that have PPTP-accessible
devices on the network; however, alerts of this type could also be symptoms of inappropriate access,
misconfiguration of the PPTP server or clients, other communications errors, or other abnormal
traffic. For networks that do not have remote filesystem resources, these alerts will generally indicate
abnormal traffic.
ResourceAudit > NetworkAudit > RemoteProcedureTrafficAudit
RemoteProcedureTrafficAudit alerts reflect application-layer data related to remote procedure
services. Included in RemoteProcedureTrafficAudit are the traditional RPC services used to service
383
Audit Events
remote logons and file shares, and other services which require remote procedure access to complete
authentication, pass data, or otherwise communicate.
RemoteProcedureTrafficAudit alerts generally indicate normal traffic for networks that have remote
procedure services on their network; however, alerts of this type could also be symptoms of
inappropriate access, misconfiguration of the remote procedure services, errors in the remote
procedure calls, or other abnormal traffic.
ResourceAudit > NetworkAudit > RemoteProcedureTrafficAudit > RPCTrafficAudit
RPCTrafficAudit is a specific subset of RemoteProcedureTrafficAudit related to traditional RPC
services, including portmapper.
ResourceAudit > NetworkConnectionAudit
NetworkConnectionAudit alerts are generated when a connection is initiated on a network client.
ResourceAudit > NetworkConnectionAudit > LANConnection
LANConnection is a specific type of NetworkConnectionAudit that reflects a successful connection
on a physical network interface such as an Ethernet card.
ResourceAudit > NetworkConnectionAudit > VPNConnection
VPNConnection is a specific type of NetworkConnectionAudit that reflects a successful connection
to a remote VPN.
ResourceAudit > NetworkConnectionAudit > DialupConnection
DialupConnection is a specific type of NetworkConnectionAudit that reflects a successful
connection through a traditional modem.
ResourceAudit > ObjectAudit
ObjectAudit alerts are used to track special object activity on monitored network devices, usually
through the Operating System or a Host-Based IDS. Generally, Objects are special types of system
resources, such as registry items or user account databases. These objects may be actual 'files' on
the system, but are not necessarily human readable. These events will note success or failure of the
requested operation.
ResourceAudit > ObjectAudit > ObjectAuditFailure
384
Appendix B: Events
ObjectAuditFailure alerts are used to track special object activity on monitored network devices,
usually through the Operating System or a Host-Based IDS. Generally, Objects are special types of
system resources, such as registry items or user account databases. These objects may be actual
'files' on the system, but are not necessarily human readable. These events will note a failure of the
requested operation.
ResourceAudit > ObjectAudit > ObjectDelete
ObjectDelete is a specific ObjectAudit alert generated for the deletion of an existing object. These
alerts may be produced by any connector that is used to monitor the activity of file and object usage,
including a Host-Based IDS and some Operating Systems.
ResourceAudit > ObjectAudit > ObjectLink
ObjectLink is a specific ObjectAudit alert generated for the creation, deletion, or modification of links
to other objects. These alerts may be produced by any connector that is used to monitor the activity
of file and object usage, including a Host-Based IDS and some Operating Systems.
ResourceAudit > ProcessAudit
ProcessAudit alerts are generated to track launch, exit, status, and other events related to system
processes. Usually, these events reflect normal system activity. Process-related activity that may
indicate a failure will be noted separately from normal activity in the alert detail.
ResourceAudit > ProcessAudit > ProcessStop
ProcessStop is a specific type of ProcessAudit alert that indicates a process has exited. Usually,
ProcessStop reflects normal application exit, however in the event of an unexpected error the
abnormal state will be noted.
ResourceAudit > ProcessAudit > ProcessStart
ProcessStart is a specific type of ProcessAudit alert that indicates a new process has been
launched. Usually, ProcessStart reflects normal system activity
ResourceAudit > ProcessAudit > ProcessWarning
ProcessWarning is a specific type of ProcessAudit alert that indicates a process has returned a
'Warning' message that is not a fatal error and may not have triggered an exit of the process.
385
Incident Events
ResourceAudit > ProcessAudit > ProcessInfo
ProcessInfo is a specific type of ProcessAudit alert that reflects information related to a process.
Most of these events can safely be ignored, as they are generally normal activity that does not reflect
a failure or abnormal state.
ResourceAudit > ServiceAudit
ServiceAudit alerts are generated to track information and other events related to system
components. Usually, these events reflect normal system activity. System service-related activity
that may indicate a failure will be noted separately from normal activity in the alert detail.
ResourceAudit > ServiceAudit > ServiceInfo
ServiceInfo is a specific type of ServiceAudit alert that reflects information related to a service. Most
of these events can safely be ignored, as they are generally normal activity that does not reflect a
failure or abnormal state.
ResourceAudit > ServiceAudit > ServiceStart
ServiceStart events are a specific type of ServiceAudit alert that indicates a new system service is
starting.
ResourceAudit > ServiceAudit > ServiceStop
ServiceStop events are a specific type of ServiceAudit alert that indicates a system service is
stopping. This activity is generally normal, however, in the event of an unexpected stop the abnormal
state will be noted.
ResourceAudit > ServiceAudit > ServiceWarning
ServiceWarning is a specific type of ServiceAudit alert that indicates a service has returned a
'Warning' message that is not a fatal error and may not have triggered an exit of the service.
Incident Events
Incident Events reflect global enterprise-wide issues that should be raised for system-wide visibility.
These alerts generally reflect serious issues that should be monitored and addressed. They are subcategorized into different types of Incidents Events that can provide more detailed information.
386
Appendix B: Events
Because Incident Events are created by Rules, any combination of malicious or suspicious traffic
from any other single alert or combination of alerts can create an Incident Event.
Each Incident alert is described below. For your convenience, they are listed alphabetically.
HostIncident
HostIncident alerts reflect global enterprise-wide host system issues that should be raised for
system-wide visibility. These alerts are used to indicate issues on hosts that should be tracked and
addressed, including security and administrative issues that apply specifically to host-based
information.
HybridIncident
HybridIncident alerts reflect global enterprise-wide combined network and host system issues that
should be raised for system-wide visibility. These alerts are used to indicate the combination of
network and host-based issues that should be tracked and addressed, including security and
administrative issues that span both network and host-based information.
NetworkIncident
NetworkIncident alerts reflect global enterprise-wide network system issues that should be raised for
system-wide visibility. These alerts are used to indicate network-based issues that should be tracked
and addressed, including security and administrative issues that apply specifically to network-based
information.
Internal Events
Events that are a part of the InternalEvent node are related to the operation of the LEM system. Any
events generated by the system relating to Active Response, Internal users, or Internal errors will
appear under one of the many children.
These alerts are for informational purposes and do not necessarily reflect conditions that should
cause alarm. Events that may reflect potential issues within the system are specifically marked for
forwarding to SolarWinds.
Each Internal Event is described below. For your convenience, they are listed alphabetically.
InternalAudit
InternalAudit alerts reflect attempted accesses and changes to components of the LEM system by
387
Internal Events
existing SolarWinds users. Both successful and failed attempts will generate alerts in this part of the
tree.
InternalAudit > InternalAuditFailure
InternalAuditFailure is a specific type of InternalAudit alert that indicates failed audit information.
These alerts are generated when a user fails to view or modify (including creation, update, and
deletion) anything within the SolarWinds system. The alert will include the user, type of access, and
item being accessed. InternalAuditFailure events are uncommon and can indicate an attempted
privilege escalation within the LEM system by unprivileged users.
InternalAudit > InternalAuditSuccess
InternalAuditSuccess is a specific type of InternalAudit alert that indicates successful audit
information. These alerts are generated when a user successfully views or modifies (including
creation, update, and deletion) anything within the LEM system. The alert will include the user, type of
access, and item being accessed.
InternalCommands
InternalCommands alerts are only used internally with few exceptions. These alerts are used for
sending Commands through the system to complete active responses.
InternalCommands > InternalAgentToolCommand
InternalAgentToolCommand alerts are internal only. They are fired between Managers and Agents to
manage connector settings.
InternalCommands > InternalAgentFastPack
InternalAgentFastPack alerts are internal only. They are fired between Managers and Agents to
configure updated connector signatures.
InternalFailure
Events that are a part of the InternalFailure tree reflect potential issues within the system. These
alerts could reflect configuration issues, issues that cannot be resolved without contacting
SolarWinds, and potential serious issues which also merit contacting SolarWinds.
InternalFailure > InternalError
388
Appendix B: Events
InternalError alerts reflect configuration or install issues that should be reported to SolarWinds. These
are generally internal errors related to connectors that may be producing unexpected log entries or
conditions that were not expected. These issues generally cannot be solved without contacting
SolarWinds, however they should not be fatal errors.
InternalFailure > InternalException
InternalException alerts reflect more serious problems within the system. These problems generally
lie within the product implementation and may require a software update to eliminate. These alerts
and their surrounding conditions should be reported to SolarWinds.
InternalFailure > InternalWarning
InternalWarning alerts are generally problems which can be solved by the user. Usually, these alerts
are configuration related and may assist in debugging the underlying issue.
InternalWarning alerts do not reflect internal problems within the system and thus should not be
immediately reported to SolarWinds, however they may assist with solving a technical support issue
should the need arise.
InternalGeneralEvent
InternalGeneralEvent events are uncommon events used to track Internal information that has not yet
been placed into a more specific InternalEvent. Events of the InternalFailure family providing more
information will be generated in addition to this event if the event is serious.
InternalInfo
Events within the InternalInfo family are related to events that are happening within the system.
Generally, these informational alerts are confirming or reporting normal activity such as user updates,
user logons, policy updates, and Agent connection-related events.
InternalInfo > InternalAgentOffline
InternalAgentOffline alerts reflect detection of disconnection of an Agent to its Manager. These alerts
will happen when the Manager has detected that the Agent closed the connection, whether that be
due to network down time of the Agent or due to a shut down of the Agent service.
InternalInfo > InternalAgentOnline
389
Internal Events
InternalAgentOnline alerts reflect successful connection of Agents to their respective Managers.
These alerts will happen when an Agent initiates successful communication with the Manager,
whether that be due to network down time of the Manager or Agent or due to an update of the Agent in
question.
InternalInfo > InternalDuplicateConnection
InternalDuplicateConnection alerts occur when an Agent has attempted to connect to their given
Manager more than once. Usually these alerts are triggered by network issues on the Agent end, due
to a possible asynchronous disconnection detection (for example, the Manager was not able to detect
the Agent went offline, but the Agent service was restarted).
Usually this issue can be resolved by stopping the Agent service, waiting for the InternalAgentOffline
alert, and then restarting the Agent service.
InternalInfo > InternalInvalidConnection
InternalInvalidConnection alerts occur when an Agent that the Manager recognizes, but cannot
communicate with, attempts to connect. These alerts usually reflect Agents that are missing an
update that has already been applied to the Manager.
Please ensure that the indicated Agent has been upgraded to the same release version of the system
that is installed on your Manager. If this alert persists: uninstall and reinstall the Agent triggering the
alert. This will force the Agent to re-initialize connection to the Manager.
InternalInfo > InternalInvalidInstallation
InternalInvalidInstallation alerts occur in the unlikely case that the Manager can communicate with
the Agent but there are errors detected in the Manager-to-Agent relationship. These alerts are very
uncommon, but may be triggered during an upgrade process.
Please ensure that the indicated Agent has been upgraded to the same release version of the system
that is installed on your Manager. If this alert persists: uninstall and reinstall the Agent triggering the
alert. This will force the Agent to re-initialize connection to the Manager.
InternalInfo > InternalLicenseMaximum
InternalLicenseMaximum alerts reflect an attempt to add more Agents to a Manager than that
Manager is licensed for. The number of Agents that can be added is a hard limit that the Manager
stores and this limit is also enforced by the Console.
390
Appendix B: Events
If more licenses are needed, this issue can be resolved by contacting SolarWinds Sales for an
update.
InternalInfo > InternalNewToolData
InternalNewToolData alerts generally reflect issues related to connectors with unexpected log entries
or other conditions that were not expected. These issues generally cannot be solved without
contacting SolarWinds, however they are not fatal.
InternalInfo > InternalPolicyConfiguration
InternalPolicyConfiguration alerts reflect successful or unsuccessful attempts to update Policy on a
given Manager. These alerts are generated after Policy has been successfully installed to the
Manager or after an error has been detected. Generally, an error in updating Policy will also produce
an alert from the InternalFailure family, providing more information.
InternalInfo > InternalToolOffline
InternalToolOffline alerts reflect successful stop of an Internal Tool. These alerts are generated after
a connector has stopped the log file reader that was created when the connector was brought online.
Generally, an error in an attempt to stop a connector will produce an alert from the InternalFailure
family providing more information.
InternalInfo > InternalToolOnline
InternalToolOnline alerts reflect successful startup of an Internal Tool. These alerts are generated
after a connector has successfully created a log file reader and has begun the reading process.
Generally, an error in an attempt to start a connector will produce an alert from the InternalFailure
family providing more information.
InternalInfo > InternalUnknownAgent
InternalUnknownAgent alerts occur when an Agent that the Manager does not recognize has
attempted to connect. Commonly, this alert is caused by removing the Agent from the Console before
removing the Agent service on the client. These alerts may also be triggered during an upgrade
process; in that case, they may reflect Agents that have not yet been brought up to date.
Usually this issue can be resolved by Uninstalling and Reinstalling the Agent triggering the alert. This
will force the Agent to re-initialize connection to the Manager.
391
Internal Events
InternalInfo > InternalUnsupportedAgent
InternalUnsupportedAgent alerts are generated when a valid Agent connects and has not been
upgraded to the same release version as the Manager. The Agent in question failed to properly
negotiate its connection or respond to a query and has been assumed to be missing a feature required
of it. Please ensure that the indicated Agent has been upgraded to the same release version of
SolarWinds that is installed on your Manager. If this alert persists: uninstall and reinstall the Agent
triggering the alert, this will force the Agent to re-initialize connection to the Manager.
InternalInfo > InternalUserLogoff
InternalUserLogoff alerts are generated when a user logs off or is disconnected from the Console.
InternalInfo > InternalUserLogon
InternalUserLogon alerts are generated when a user successfully completes the logon process to a
Manager via the Console. Failed log-on attempts are produced in a separate alert,
InternalUserLogonFailure.
InternalInfo > InternalUserLogonFailure
InternalUserLogonFailure alerts are generated when a user has completed initialization of a
connection to the Console, but enters an incorrect user name and/or password.
InternalInfo > InternalUserUpdate
InternalUserUpdate alerts are generated when a user is modified and the update has successfully
been sent to the Manager, or when the update has failed to apply. These updates include change or
addition of an email address, change or addition of a pager, and change or addition of blocked alerts
from selected Agents. Generally, an error in updating a user will also produce an alert from the
InternalFailure family.
InternalPolicy
InternalPolicy alerts reflect information related to correlation rules. These alerts are used to indicate
that a rule has been triggered, either in test mode or in normal operating conditions.
InternalPolicy > InternalTestRule
InternalTestRule alerts reflect rule activity where a correlation rule has triggered and is set in “Test”
392
Appendix B: Events
mode. It indicates the trigger of the rule and includes an enumeration of what actions would take
place, if any, if the rule were fully enabled. To remove a rule from Test mode, clear the “Test”
checkbox for the Rule in the Rule Builder.
InternalPolicy > InternalRuleFired
InternalRuleFired alerts reflect rule activity, specifically where a correlation rule has triggered. It
indicates the trigger of the rule and includes an enumeration of what actions were triggered in
response to the correlation.
Security Events
Events that are a part of the SecurityEvent node are generally related to network activity that is
consistent with an internal or external attack, a misuse or abuse of resources, a resource
compromise, resource probing, or other abnormal traffic that is noteworthy.
Security Event events indicate aggressive behavior that may lead to an attack or resource
compromise, or suspicious behavior that may indicate unauthorized information gathering. LEM infers
some Security Events from what is normally considered audit traffic, but it escalates the events to
alert status based on thresholds that are defined by Rules.
Each Security Event is described below. For your convenience, they are listed alphabetically.
AttackBehavior
Events that are children of AttackBehavior are generally related to network activity that may be
consistent of an attack, misuse or abuse of resources, a resource compromise, or other abnormal
behavior that should be considered indicative of a serious security event.
AttackBehavior > InferredAttack
InferredAttack alerts are reserved AttackBehavior alerts used for describing attacks that are a
composite of different types of alerts. These events will be defined and inferred by Contego Policy.
AttackBehavior > ResourceAttack
Members of the ResourceAttack tree are used to define different types of malicious or abusive
access to network resources, where these resources may be network bandwidth/traffic, files, client
processes or services, or other types of shared security-related 'commodities'.
393
Security Events
AttackBehavior > ResourceAttack > NetworkAttack
Members of the NetworkAttack tree are used to define events centered on malicious or abusive
usage of network bandwidth/traffic. These events include access to network resources, relaying
attacks via network resources, or denial of service behavior on network resources.
AttackBehavior > ResourceAttack > NetworkAttack > Access
Children of the Access tree define events centered on malicious or abusive usage of network
bandwidth/traffic where the intention, or the result, is inappropriate or abusive access to network
resources.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess
ApplicationAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources where the related data is mostly or all
application-layer. Generally, ApplicationAccess alerts will reflect attempted exploitation of
weaknesses in server or client software, or information that is restricted/prohibited by device access
control or policy.
These alerts are generally provided by network-based intrusion detection systems; in some cases,
network infrastructure devices such as firewalls or proxy servers may also provide them.
Events placed in the parent ApplicationAccess alert itself are known to be application-related, but not
able to be further categorized based on the message provided by the connector or because they are
uncommon.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
DataBaseAccess
DataBaseAccess alerts reflect malicious or abusive usage of network resources where the intention,
or the result, is gaining access to resources via application-layer database traffic. Generally, these
alerts will reflect attempted exploitation of weaknesses in database server or client software.
These alerts are generally provided by network-based intrusion detection systems, the database
server, or the client software itself. Appropriate response to these alerts may entail better access
control of database servers (e.g. restriction by IP address and/or user name to ensure only trusted
clients are connecting), applying updates or patches to database servers and/or clients, or the
possible removal of the database service or client application related to this event.
394
Appendix B: Events
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
FileTransferAccess
FileTransferAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer file transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in file transfer server or
client software.
These alerts are generally provided by network-based intrusion detection systems, the file transfer
server, or the client software itself. Appropriate response to these alerts may entail better access
control of file transfer servers (e.g. restriction by IP address and/or user name to ensure only trusted
clients are connecting), applying updates or patches to file transfer servers and/or clients, or the
possible removal of the file transfer service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
FileTransferAccess > FTPFileAccess
FTPFileAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to filesystems of resources via application-layer file transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in file transfer server or
client software with the intent of information gathering or low-level filesystem access of the server or
client.
These alerts are generally provided by network-based intrusion detection systems, the file transfer
server, or the client software itself. Appropriate response to these alerts may entail better access
control of file transfer servers (e.g. restriction by IP address and/or user name to ensure only trusted
clients are connecting), applying updates or patches to file transfer servers and/or clients, or the
possible removal of the file transfer service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
FileTransferAccess > FTPInvalidFormatAccess
FTPInvalidFormatAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer file transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in file transfer server or
client software with the intent of information gathering or low-level access to the server or client.
These attacks are always abnormal traffic that the file transfer server or client is not prepared to
respond to; attacks, such as buffer overflows, may also result in the server or client software or
system being halted.
395
Security Events
These alerts are generally provided by network-based intrusion detection systems, the file transfer
server, or the client software itself. Appropriate response to these alerts may entail better access
control of file transfer servers (e.g. restriction by IP address and/or user name to ensure only trusted
clients are connecting), applying updates or patches to file transfer servers and/or clients, or the
possible removal of the file transfer service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
FileTransferAccess > FTPCommandAccess
FTPCommandAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer file transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in file transfer server
software with the intent of information gathering or low-level access to the server or client. These
attacks are always abnormal command traffic that the file transfer server is not prepared to respond
to, but may provide access to (e.g. debug or legacy commands).
These alerts are generally provided by network-based intrusion detection systems, the file transfer
server, or the client software itself. Appropriate response to these alerts may entail better access
control of file transfer servers (e.g. restriction by IP address and/or user name to ensure only trusted
clients are connecting), applying updates or patches to file transfer servers and/or clients, restriction
of allowed commands, or the possible removal of the file transfer service or client application related
to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess
MailAccess alerts reflect malicious or abusive usage of network resources where the intention, or the
result, is gaining access to resources via application-layer mail transfer, retrieval, or service traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in mail-related server or
client software.
These alerts are generally provided by network-based intrusion detection systems or the mail server,
service, or client software itself. Appropriate response to these alerts may entail better access control
of mail servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to mail servers and/or clients, or possible removal of the
mail server, service, or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailTransferAccess
396
Appendix B: Events
MailTransferAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in SMTP server software.
These alerts are generally provided by network-based intrusion detection systems, or the SMTP
server software itself. Appropriate response to these alerts may entail better access control of the
SMTP server (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting, especially for SMTP servers that relay mail for external/remote entities), applying
updates or patches to SMTP servers, or the possible removal of the SMTP server related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailTransferAccess > SMTPInvalidFormatAccess
SMTPInvalidFormatAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in SMTP server software
with the intent of information gathering or low-level access to the server. These attacks are always
abnormal traffic that the SMTP server is not prepared to respond to; attacks, such as buffer
overflows, may also result in the server software or system being halted.
These alerts are generally provided by network-based intrusion detection systems, or the SMTP
server software itself. Appropriate response to these alerts may entail better access control of the
SMTP server (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting, especially for SMTP servers that relay mail for external/remote entities), applying
updates or patches to SMTP servers, or the possible removal of the SMTP server related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailTransferAccess > SMTPInvalidFormatAccess > SmailAccess
SmailAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources via application-layer mail transfer traffic. Generally, these
alerts will reflect attempted exploitation of weaknesses in SMTP server software with the intent of
information gathering or low-level access to the server. These attacks are always abnormal traffic
that the SMTP server is not prepared to respond to; they may also result in the server software or
system being halted. The smail attack specifically attempts to execute applications resulting in
compromise of the SMTP server system.
397
Security Events
These alerts are generally provided by network-based intrusion detection systems, or the SMTP
server software itself. Appropriate response to these alerts may entail better access control of the
SMTP server (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting, especially for SMTP servers that relay mail for external/remote entities), applying
updates or patches to SMTP servers, or the possible removal of the SMTP server related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailTransferAccess > SMTPCommandAccess
SMTPCommandAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail transfer traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in SMTP server software
with the intent of information gathering or low-level access to the server. These attacks are always
abnormal command traffic that the SMTP server is not prepared to respond to, but may provide
access to (e.g. debug or legacy commands).
These alerts are generally provided by network-based intrusion detection systems, or the SMTP
server software itself. Appropriate response to these alerts may entail better access control of the
SMTP server (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting, especially for SMTP servers that relay mail for external/remote entities), applying
updates or patches to SMTP servers, restriction of allowed commands, or the possible removal of the
SMTP server related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailDeliveryAccess
MailDeliveryAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail retrieval traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in mail retrieval related
server or client software - the MDA (mail delivery Agent) or MUA (mail user Agent).
These alerts are generally provided by network-based intrusion detection systems, or the mail server,
service, or client software itself. Appropriate response to these alerts may entail better access control
of mail servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to mail servers and/or clients, or the possible removal of the
mail server, service, or client application related to this event.
398
Appendix B: Events
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailServiceAccess
MailServiceAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail service traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in mail service-related
server or client software, including services such as mailing list software, spam filters, email
redirection software, and other mail filtering software.
These alerts are generally provided by network-based intrusion detection systems, the mail service,
or the client software itself. Appropriate response to these alerts may entail better access control of
mail services or servers (e.g. restriction by IP address and/or user name to ensure only trusted clients
are connecting), applying updates or patches to mail services and/or clients, or the possible removal
of the mail service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > MailAccess >
MailServiceAccess > MajordomoAccess
MailServiceAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer mail service traffic.
Generally, these alerts will reflect attempted exploitation of weaknesses in Majordomo, a specific
type of mailing list software.
These alerts are generally provided by network-based intrusion detection systems, or the mail service
itself. Appropriate response to these alerts may entail better access control of mail services or
servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to the mail service, or the possible removal of the mail
service related to this event. Generally, the most appropriate response will be updates or patches that
can be retrieved from the Majordomo web site (http://www.greatcircle.com/majordomo) or your
operating system vendor.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > NewsAccess
NewsAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources via application-layer news traffic (over protocols such as
NNTP). Generally, these alerts will reflect attempted exploitation of weaknesses in the news server
or client software.
These alerts are generally provided by network-based intrusion detection systems, the news server,
399
Security Events
or the client software itself. Appropriate response to these alerts may entail better access control of
news servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to news servers and/or clients, or the possible removal of
the news service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > PrinterAccess
PrinterAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources via application-layer remote printer traffic. Generally, these
alerts will reflect attempted exploitation of weaknesses in the remote printer server or client software.
These alerts are generally provided by network-based intrusion detection systems, the remote printer
server, or the client software itself. Appropriate response to these alerts may entail better access
control of remote printer servers (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote printer servers and/or clients,
or the possible removal of the remote printer service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess
WebAccess alerts reflect malicious or abusive usage of network resources where the intention, or the
result, is gaining access to resources via application-layer WWW traffic. Generally, these alerts will
reflect attempted exploitation of weaknesses in the web server or client software.
These alerts are generally provided by network-based intrusion detection systems, the web server, or
client software itself. Appropriate response to these alerts may entail better access control of web
servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to web servers and/or clients, or the possible removal of the
web service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPClientAccess
HTTPClientAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic where the
information flow is from server to client. Generally, these alerts will reflect attempted exploitation of
weaknesses in the client software or abuse and/or misuse of resources from clients.
These alerts are generally provided by network-based intrusion detection systems, the web client
software itself, proxy servers, content filters, and/or firewalls with capability to monitor incoming web
400
Appendix B: Events
traffic. Appropriate response to these alerts may entail applying updates or patches to web client
software, or restriction of incoming/outgoing web requests/responses to reflect inappropriate or
abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPClientAccess > FraudulentCertificateAccess
FraudulentCertificateAccess alerts reflect malicious or abusive usage of network resources where
the intention, or the result, is gaining access to resources via application-layer WWW traffic in which
the information flow is from server to client. Generally, these alerts will reflect attempted exploitation
of weaknesses in the client software through fraudulent certificates. The intent of these attacks may
be to forge certificates that convince the client that the site is trusted, when in fact it is not, passing
data along with those certificates that may be inappropriate and/or contain exploits.
These alerts are generally provided by network-based intrusion detection systems, the web client
software itself, proxy servers, content filters, and/or firewalls with capability to monitor incoming web
traffic. Appropriate response to these alerts may entail applying updates or patches to web client
software, or restriction of incoming/outgoing web requests/responses to reflect the abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPClientAccess > ProhibitedHTTPControlAccess
ProhibitedHTTPControlAccess alerts reflect malicious or abusive usage of network resources where
the intention, or the result, is gaining access to resources via application-layer WWW traffic in which
the information flow is from server to client. Generally, these alerts will reflect attempted exploitation
of weaknesses in the client software or abuse and/or misuse of resources from clients through client
controls such as ActiveX and Java.
These alerts are generally provided by network-based intrusion detection systems, the web client
software itself, proxy servers, content filters, and/or firewalls with capability to monitor incoming web
traffic. Appropriate response to these alerts may entail applying updates or patches to web client
software, or restriction of incoming/outgoing web requests/responses to reflect inappropriate or
abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess
HTTPServerAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic where the
401
Security Events
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in the server software or abuse and/or misuse of server resources.
These alerts are generally provided by network-based intrusion detection systems, the web server or
service software itself, and/or firewalls with the capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers (e.g. restriction
by IP address and/or user name to ensure only trusted clients are connecting), applying updates or
patches to web servers, services, and/or clients, or the possible removal of the web service or client
application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPApplicationAccess
HTTPApplicationAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic in which the
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in applications running on top of the server software, such as PHP, CGI, administrative
sites, and other application services.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers or the service
itself (e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
applying updates or patches to web servers, services, and/or clients, or the possible removal of the
web service application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPApplicationAccess > HTTPAdministrationAccess
HTTPAdministrationAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic in which the
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in applications run on top of server software that are related to remote administration of
sites, services, and/or systems.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers or the service
itself (e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
402
Appendix B: Events
applying updates or patches to web servers, services, administrative sites, and/or clients, or the
possible removal of the web service application or administrative site related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPApplicationAccess > HTTPDynamicContentAccess
HTTPDynamicContentAccess alerts reflect malicious or abusive usage of network resources where
the intention, or the result, is gaining access to resources via application-layer WWW traffic in which
the information flow is from client to server. Generally, these alerts will reflect attempted exploitation
of weaknesses in applications, running on top of the server software, that generate dynamic content
such as PHP, CGI, and ASP.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers or the service
itself (e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
applying updates or patches to web servers, services, dynamic content, and/or clients, or the
possible removal of the web service application or dynamic content related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPApplicationAccess > HTTPFileRequestAccess
HTTPFileRequestAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic in which the
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in applications running on top of server software that are related to remote administration
of sites, services, and/or systems with the intent of information gathering or low-level filesystem
access of the server or client.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers or the service
itself (e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
applying updates or patches to web servers, services, and/or clients, or the possible removal of the
web service application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPApplicationAccess > HTTPServiceAccess
403
Security Events
HTTPServiceAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer WWW traffic in which the
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in applications running on top of server software that are related to remote services such
as printing or console access.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of web servers or the service
itself (e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
applying updates or patches to web servers, services, and/or clients, or the possible removal of the
web service application or site related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > WebAccess >
HTTPServerAccess > HTTPInvalidFormatAccess
HTTPInvalidFormatAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer web traffic in which the
information flow is from client to server. Generally, these alerts will reflect attempted exploitation of
weaknesses in web server software with the intent of information gathering or low-level access to the
server. These attacks are always abnormal traffic that the web server is not prepared to respond to;
attacks, such as buffer overflows, may also result in the server software or system being halted.
These alerts are generally provided by network-based intrusion detection systems, the web server,
the service software itself, and/or firewalls with capability to monitor incoming/outgoing web traffic.
Appropriate response to these alerts may entail better access control of the web server (e.g.
restriction by IP address and/or user name to ensure only trusted clients are connecting), applying
updates or patches to web servers or services, or the possible removal of the web server related to
this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
NamingAccess
NamingAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources via application-layer naming service traffic (using protocols
such as DNS and WINS). Generally, these alerts will reflect attempted exploitation of weaknesses in
the naming server or client software.
404
Appendix B: Events
These alerts are generally provided by network-based intrusion detection systems, the naming
server, or the client software itself. Appropriate response to these alerts may entail better access
control of name servers (e.g. restriction by IP address and/or user name to ensure only trusted clients
are connecting), applying updates or patches to naming servers and/or clients, or the possible
removal of the naming service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess >
RemoteConsoleAccess
RemoteConsoleAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via application-layer remote console service
traffic (services such as telnet, SSH, and terminal services). Generally, these alerts will reflect
attempted exploitation of weaknesses in the remote console server or client software.
These alerts are generally provided by network-based intrusion detection systems, the remote
console server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote console servers (e.g. restriction by IP address and/or user name to ensure
only trusted clients are connecting), applying updates or patches to remote console servers and/or
clients, or the possible removal of the remote console service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ApplicationAccess > TimeAccess
TimeAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources via application-layer remote time service traffic (using
protocols such as NTP). Generally, these alerts will reflect attempted exploitation of weaknesses in
the remote time server or client software.
These alerts are generally provided by network-based intrusion detection systems, the time server, or
client software itself. Appropriate response to these alerts may entail better access control of remote
time servers (e.g. restriction by IP address and/or user name to ensure only trusted clients are
connecting), applying updates or patches to remote time servers and/or clients, or the possible
removal of the remote time service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > ConfigurationAccess
ConfigurationAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via resource configuration traffic (using
protocols such as DHCP, BootP, and SNMP). Generally, these alerts will reflect attempted
405
Security Events
exploitation of weaknesses in the configuration server or client software or attempts to gain systemlevel access to configuration servers themselves. In the case of SNMP and similar configuration
protocols, it could reflect an attempt to enumerate a device or devices on the same network for further
attack.
These alerts are generally provided by network-based intrusion detection systems, the configuration
server, or the client software itself. Appropriate response to these alerts may entail better access
control of configuration servers and services (e.g. restriction by IP address and/or user name to
ensure only trusted clients are connecting), applying updates or patches to configuration servers
and/or clients, or the possible removal of the configuration service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess
CoreAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources where the related data is mostly or all core protocols (TCP,
UDP, IP, ICMP). Generally, CoreAccess alerts will reflect attempted exploitation of weaknesses in
network protocols or devices with intent to gain access to servers, clients, or network infrastructure
devices.
These alerts are generally provided by network-based intrusion detection systems; in some cases,
network infrastructure devices such as firewalls or routers may also provide them. In some cases,
these events are escalated from the Audit tree via Contego Policy.
Events placed in the parent CoreAccess alert itself are known to be a core protocol-related but not
able to be further categorized based on the message provided by the connector or because they are
uncommon.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess >
ICMPRedirectAccess
ICMPRedirectAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is all
ICMP Redirects (ICMP type 5) and the intent is to redirect traffic to either enumerate devices or client
machines, or to gather information on devices or client traffic to further attack those or other
resources. ICMP Redirects are generally benign ICMP messages sent to hosts to redirect traffic
intended for a network that another gateway can control. In the cases where ICMP Redirects are
used for attacking, a host will generally feign themselves as a router, pass a redirect to a client
machine to modify it's routing table to send traffic to the false router instead of their normal network
gateway, and proceed to enumerate, gather information, or attack the redirected host. The false router
406
Appendix B: Events
will then send the traffic on to the correct gateway, and the host has no idea of what has occurred
(unless another device or connector detects it). This is one type of what is commonly referred to as a
man-in-the-middle attack.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers. Appropriate response to these alerts may entail
blocking or resetting the local or remote user's connection/IP address, updates to network
infrastructure devices, or restriction of incoming/outgoing ICMP redirect requests/responses to
reflect inappropriate or abusive access. Appropriate methods of prevention of ICMP redirect attacks
would be to limit hosts who can broadcast ICMP Redirects across network devices to correct routers
and gateways, limit ingress and egress ICMP traffic, and to make sure clients, servers, and network
infrastructure devices are current with regards to operating system or other networking software to
ensure that other attacks related to ICMP Redirect attacks of this type (such as denial of service
attacks) do not occur.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess >
IPFragmentationAccess
IPFragmentationAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is
all IP and the intent is to mask possible malicious or abusive data past an IDS or other detection
device by using many IP fragments (usually either much larger or smaller than normal fragments).
The network infrastructure devices handling the traffic will reassemble and pass on the traffic
correctly, however, an IDS on the network may not be able to detect the malicious traffic, only the
presence of fragments (if even that). The attack may be allowed to pass through the network either
incoming or outgoing, thereby eliminating one line of defense. Normal IP fragmentation (data that has
been taken apart because it is too large based on network parameters) should not trigger an
IPFragmentationAccess alert.
Fragmentation alerts themselves are generally provided by network-based intrusion detection
systems and network infrastructure devices such as firewalls or routers. Appropriate response to
these alerts may entail blocking or resetting the local or remote user's connection/IP address,
applying updates or patches to server and/or client software (especially the IDS), updates to network
infrastructure devices, or restriction of incoming/outgoing network requests/responses to reflect
inappropriate or abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess >
IPSourceRouteAccess
407
Security Events
IPSourceRouteAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is all
IP and the intent is generally to misrepresent the originating address to bypass detection.
IPSourceRouteAccess is a type of IP Spoofing where an attacker falsifies network information to
convince the destination that the given source is something other than the actual source, directing the
destination to return the traffic through an IP Source Route option that traces the traffic to the trusted
host and then on to the untrusted attacker. The trusted host receives the traffic from the destination
and because of the IP Source Route, it passes the traffic on to the untrusted attacker. The data is not
modified and the attacker has 'tricked' the network into passing the traffic on. Generally, while
spoofed, clients will attempt to gather information, perform actual attacks on internal or external
devices, or perform denial of service attacks.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers. Response to IP Spoofing itself is difficult as the
originating host may be alternating spoofed hostnames or IP addresses in order to continually
circumvent detection; however, response to IP spoofing which utilizes the IP source route could
entail removing the ability to pass traffic through routers or gateways that contains an IP Source
Route option. Initial appropriate response to these alerts may entail blocking or resetting the local or
remote user's connection/IP address, however this may prove ineffective or unrealistic. Other
responses may include applying updates or patches to server and/or client software, updates to
network infrastructure devices, or restriction of incoming/outgoing network requests/responses to
reflect inappropriate or abusive access. Unfortunately, it may prove difficult to derail an attempted
attack through IP Spoofing, however, routing and firewalling policies (including disallowing traffic with
the IP Source Route option) should prevent further access through spoofed addresses.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess > IPSpoofAccess
IPSpoofAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is all IP and
the intent is to misrepresent the originating address to either bypass detection or misdirect response
to attack activity. IP Spoofing is done by falsifying network information to convince the destination
(and any network hops in between) that the given source is something other than the actual source.
Generally, while spoofed, clients will attempt to gather information, perform actual attacks on internal
or external devices, or perform denial of service attacks.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers. Response to IP Spoofing is difficult as the
originating host may be alternating spoofed hostnames or IP addresses in order to continually
circumvent detection. Initial appropriate response to these alerts may entail blocking or resetting the
local or remote user's connection/IP address, however this may prove ineffective or unrealistic. Other
408
Appendix B: Events
responses may include applying updates or patches to server and/or client software, updates to
network infrastructure devices, or restriction of incoming/outgoing network requests/responses to
reflect inappropriate or abusive access. Unfortunately, it may prove difficult to derail an attempted
attack through IP Spoofing, however, routing and firewalling policies should prevent further access
through spoofed addresses.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess > TCPHijackAccess
TCPHijackAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is all
TCP and the intent is to hijack a user's connection. TCP Hijacking is done with the intent to take over
another network user's connection by sending malformed packets to 'confuse' the server into thinking
that the new user is the original user. In doing so, the original user gets removed from his connection
to the server and the new user has injected himself, taking over all attributes the server assumed from
the original - including levels of security and/or trust. TCP Hijacking can be used to place future
attack connectors on client systems, gather information about networks and/or client systems,
immediately attack internal networks, or other malicious and/or abusive behavior.
These alerts are generally provided by network-based intrusion detection systems; in some cases,
network infrastructure devices such as firewalls or routers may also provide them. Appropriate
response to these alerts may entail blocking or resetting the remote hijacker's connection/IP address,
applying updates or patches to server and/or client software, updates to network infrastructure
devices, or restriction of incoming/outgoing network requests/responses to reflect inappropriate or
abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > CoreAccess >
TCPTunnelingAccess
TCPTunnelingAccess alerts reflect a specific type of CoreAccess alert where the attack traffic is all
TCP and the intent is to tunnel a possible malicious or abusive connection through other TCP traffic.
TCP tunneling uses permitted TCP traffic to bypass access policies on network devices, content
filtering, monitoring, and other traffic shaping or behavior policies. TCP tunneling is done by initiating
a known 'acceptable' TCP connection through allowed policies and piggybacking an unacceptable
connection atop the granted one. On the new 'tunnel' that the user has built, they are allowed to pass
any traffic through that does not match other policies - often after the connection has been initiated, it
may be difficult to detect and prevent further malicious or abusive activity.
These alerts are generally provided by network-based intrusion detection systems; in some cases,
network infrastructure devices such as firewalls or routers may also provide them. Appropriate
409
Security Events
response to these alerts may entail blocking or resetting the local or remote user's connection/IP
address, applying updates or patches to server and/or client software, updates to network
infrastructure devices, or restriction of incoming/outgoing network requests/responses to reflect
inappropriate or abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > FileSystemAccess
FileSystemAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via remote filesystem traffic (using protocols
such as SMB and NFS). Generally, these alerts will reflect attempted exploitation of weaknesses in
the remote filesystem server or client software or attempts to gain system-level access to remote
filesystem servers themselves.
These alerts are generally provided by network-based intrusion detection systems, the remote
filesystem server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote filesystems (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote filesystem servers and/or
clients, or the possible removal of the remote filesystem service or client application related to this
event
AttackBehavior > ResourceAttack > NetworkAttack > Access > FileSystemAccess > NFSAccess
NFSAccess alerts are a specific type of FileSystemAccess alert that reflects malicious or abusive
usage of network resources where the intention, or the result, is gaining access to resources via NFS
(network file share) remote filesystem traffic. Generally, these alerts will reflect attempted
exploitation of weaknesses in the NFS server or client software or attempts to gain system-level
access to NFS servers themselves.
These alerts are generally provided by network-based intrusion detection systems, the remote
filesystem server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote filesystems (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote filesystem servers and/or
clients, or the possible removal of the remote filesystem service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > FileSystemAccess > SMBAccess
SMBAccess alerts are a specific type of FileSystemAccess alert that reflects malicious or abusive
usage of network resources where the intention, or the result, is gaining access to resources via SMB
410
Appendix B: Events
(server message block) remote filesystem traffic. Generally, these alerts will reflect attempted
exploitation of weaknesses in the SMB server or client software or attempts to gain system-level
access to SMB servers themselves.
These alerts are generally provided by network-based intrusion detection systems, the remote
filesystem server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote filesystems (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote filesystem servers and/or
clients, or the possible removal of the remote filesystem service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > LinkControlAccess
LinkControlAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources where the related data is low-level link control
(using protocols such as ARP). Generally, LinkControlAccess alerts will reflect attempted
exploitation of weaknesses in switching devices by usage of malformed incoming or outgoing data,
with intent to enumerate or gain access to or through switching devices, clients that are also on the
switching device, and entire networks attached to the switching device. In some cases, a managed
switch with restrictions on port analyzing activity may be forced into an unmanaged switch with no
restrictions - allowing a malicious client to sniff traffic and enumerate or attack.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices with link level control (such as switches). Appropriate response to
LinkControlAccess events may be to clear the link-level control mechanisms of the switching device
(things such as flushing the ARP cache), applying updates or patches to switching devices, or better
segmentation of networks to prevent information disclosure if an attack occurs.
AttackBehavior > ResourceAttack > NetworkAttack > Access > PointToPointAccess
PointToPointAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via point to point traffic (using protocols such
as PPTP). Generally, these alerts will reflect attempted exploitation of weaknesses in point to point
server or client software, attempts to enumerate networks, or attempts to further attack devices on
trusted networks.
These alerts are generally provided by network-based intrusion detection systems; in some cases,
network infrastructure devices such as firewalls, routers, or VPN servers may also provide them.
Appropriate response to these alerts may entail better access control of remote access services (e.g.
411
Security Events
restriction by IP address and/or user name to ensure only trusted clients are connecting), applying
updates or patches to remote access servers and/or clients, or the possible removal of the remote
point to point service or client application related to this event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > PointToPointAccess > PPTPSpoof
PPTPSpoof alerts reflect a specific type of PointToPointAccess alert where the attack traffic is all
PPTP and the intent is to misrepresent the originating address to either bypass detection or misdirect
response to attack activity; often times the target of these attacks are internal trusted networks that
allow remote access through PPTP tunneling. PPTP Spoofing is done by falsifying network
information to convince the destination (and any network hops in between) that the given source is
something other than the actual source. Generally, while spoofed, clients will attempt to gather
information, perform actual attacks on internal devices, or perform denial of service attacks.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers. Response to PPTP Spoofing is difficult, as the
originating host appears to be coming from a 'trusted' address that has already completed initial
handshaking and key sharing. Initial appropriate response to these alerts may entail blocking or
resetting the local or remote user's connection/IP address, applying updates or patches to server
and/or client software, updates to network infrastructure devices, or restriction of incoming/outgoing
PPTP traffic requests/responses to reflect inappropriate or abusive access.
AttackBehavior > ResourceAttack > NetworkAttack > Access > RemoteProcedureAccess
RemoteProcedureAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via remote procedure call traffic (using
protocols such as the traditional RPC services, RMI, and CORBA). Generally, these alerts will
reflect attempted exploitation of weaknesses in the remote procedure server or client software or
attempts to gain system-level access to remote procedure servers themselves.
These alerts are generally provided by network-based intrusion detection systems, the remote
procedure server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote procedure (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote procedure servers and/or
clients, or the possible removal of the remote procedure service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > RemoteProcedureAccess >
RPCPortmapperAccess
412
Appendix B: Events
RPCPortmapperAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources via remote procedure call traffic using the
traditional RPC portmapper service. Generally, these alerts will reflect attempted exploitation of
weaknesses in the remote procedure server or client software or attempts to gain system-level
access to remote procedure servers themselves.
These alerts are generally provided by network-based intrusion detection systems, the remote
procedure server, or the client software itself. Appropriate response to these alerts may entail better
access control of remote procedure (e.g. restriction by IP address and/or user name to ensure only
trusted clients are connecting), applying updates or patches to remote procedure servers and/or
clients, or the possible removal of the remote procedure service or client application related to this
event.
AttackBehavior > ResourceAttack > NetworkAttack > Access > RoutingAccess
RoutingAccess alerts reflect malicious or abusive usage of network resources where the intention, or
the result, is gaining access to resources where the related data is routing-related protocols (RIP,
IGMP, etc.). Generally, RoutingAccess alerts will reflect attempted exploitation of weaknesses in
routing protocols or devices with intent to enumerate or gain access to or through routers, servers,
clients, or other network infrastructure devices. These routing protocols are used to automate the
routing process between multiple devices that share or span networks.
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices that utilize routing protocols such as firewalls and routers. Appropriate
response to RoutingAccess events may be better access control of routing devices (e.g. restriction of
what devices are allowed to update routing by IP address to ensure only trusted devices are passing
data), applying updates or patches to routing servers and/or devices, or the possible removal of the
automated routing protocols from servers and/or devices.
AttackBehavior > ResourceAttack > NetworkAttack > Access > RoutingAccess >
MalformedRIPAccess
MalformedRIPAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources where the related data is all RIP (Routing
Information Protocol). Generally, MalformedRIPAccess alerts will reflect attempted exploitation of
weaknesses in RIP by usage of malformed incoming or outgoing data, with the intent to enumerate or
gain access to or through routers, servers, clients, or other network infrastructure devices. RIP is
used to automate the routing process between multiple devices that share or span networks.
413
Security Events
These alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices that utilize routing protocols such as firewalls and routers. Appropriate
response to RIP Access events may be better access control of routing devices (e.g. restriction of
what devices are allowed to update routing by IP address to ensure only trusted devices are passing
data), applying updates or patches to routing servers and/or devices, or the possible removal of the
automated routing protocols from servers and/or devices.
AttackBehavior > ResourceAttack > NetworkAttack > Access > TrojanTrafficAccess
TrojanTrafficAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources through malicious code commonly known as a
Trojan Horse. This alert detects the communication related to Trojans over the network (generally,
'trojaned' clients calling home to the originator). Trojans are generally executables that generally
require no user intervention to spread and contain malicious code that is placed on the client system
and used to exploit the client (and return access to the originator of the attack) or exploit other clients
(used in attacks such as distributed denial of service attacks).
These alerts are generally provided by a virus scanner, a network-based intrusion detection system,
or in some cases, the operating system or network infrastructure devices such as firewalls and
routers. Appropriate response to these alerts may entail a quarantine of the node from the network to
prevent internal attacks and further compromise of the client system, updates of virus scanner
pattern files on this and other network nodes to prevent future or further infection, virus scans on this
and other network nodes to detect further infection if any has taken place, and research into the
offending Trojan to find out methods of removal (if necessary).
AttackBehavior > ResourceAttack > NetworkAttack > Access > TrojanTrafficAccess >
TrojanCommandAccess
TrojanCommandAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources through malicious code commonly known as
Trojan Horses. This alert detects the communication related to Trojans sending commands over the
network (infecting other clients, participating in a denial of service activity, being controlled remotely
by the originator, etc.). Trojans are generally executables that generally require no user intervention to
spread and contain malicious code that is placed on the client system and used to exploit the client
(and return access to the originator of the attack) or exploit other clients (used in attacks such as
distributed denial of service attacks).
These alerts are generally provided by a virus scanner, a network-based intrusion detection system,
414
Appendix B: Events
or in some cases, the operating system or network infrastructure devices such as firewalls and
routers. Appropriate response to these alerts may entail a quarantine of the node from the network to
prevent internal attacks and further compromise of the client system, updates of virus scanner
pattern files on this and other network nodes to prevent future or further infection, virus scans on this
and other network nodes to detect further infection if any has taken place, and research into the
offending Trojan to find out methods of removal (if necessary).
AttackBehavior > ResourceAttack > NetworkAttack > Access > TrojanTrafficAccess >
TrojanInfectionAccess
TrojanInfectionAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources through malicious code commonly known as a
Trojan Horse. This alert detects the infection traffic related to a Trojan entering the network (generally
with intent to infect a client). Trojans are generally executables that generally require no user
intervention to spread and contain malicious code that is placed on the client system and used to
exploit the client (and return access to the originator of the attack) or exploit other clients (used in
attacks such as distributed denial of service attacks).
These alerts are generally provided by a virus scanner, a network-based intrusion detection system,
or in some cases, the operating system or network infrastructure devices such as firewalls and
routers. Appropriate response to these alerts may entail a quarantine of the node from the network to
prevent internal attacks and further compromise of the client system, updates of virus scanner
pattern files on this and other network nodes to prevent future or further infection, virus scans on this
and other network nodes to detect further infection if any has taken place, and research into the
offending Trojan to find out methods of removal (if necessary).
AttackBehavior > ResourceAttack > NetworkAttack > Access > VirusTrafficAccess
VirusTrafficAccess alerts reflect malicious or abusive usage of network resources where the
intention, or the result, is gaining access to resources through malicious code commonly known as
viruses. This alert detects the communication related to viruses over the network (generally, the
spread of a virus infection or an incoming virus infection). Viruses are generally executables that
require user intervention to spread, contain malicious code that is placed on the client system, and
are used to exploit the client and possibly spread itself to other clients.
These alerts are generally provided by a virus scanner, a network-based intrusion detection system,
or in some cases, the operating system or network infrastructure devices such as firewalls and
routers. Appropriate response to these alerts may entail a quarantine of the node from the network to
415
Security Events
prevent internal attacks and further compromise of the client system, updates of virus scanner
pattern files on this and other network nodes to prevent future or further infection, virus scans on this
and other network nodes to detect further infection if any has taken place, and research into the
offending virus to find out methods of removal (if necessary).
AttackBehavior > ResourceAttack > NetworkAttack > Denial
Children of the Denial tree define events centered on malicious or abusive usage of network
bandwidth/traffic where the intention, or the result, is inappropriate or abusive access to network
resources through a denial of service attack.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial
ApplicationDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is application-layer protocols. The intent, or the result, of this activity is inappropriate
or abusive access to network resources through a denial of service attack. ApplicationDenial events
may be attempts to exploit weaknesses in software to gain access to a host system, attempts to
exploit weaknesses in network infrastructure equipment to enumerate or reconfigure devices, or other
denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial >
FileTransferDenial
FileTransferDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is application-layer file transfer-related protocols (FTP, TFTP, etc.). The intent, or the
result, of this activity is inappropriate or abusive access to network resources through a denial of
service attack. FileTransferDenial events may be attempts to exploit weaknesses in file transferrelated software to gain access to a host system, attempts to exploit weaknesses in the software to
enumerate or reconfigure, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
416
Appendix B: Events
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial > MailDenial
MailDenial events are a specific type of Denial event where the transport of the malicious or abusive
usage is application-layer mail-related protocols (SMTP, IMAP, POP3, etc.) or services (majordomo,
spam filters, etc.). The intent, or the result, of this activity is inappropriate or abusive access to
network resources through a denial of service attack. MailDenial events may be attempts to exploit
weaknesses in mail-related software to gain access to a host system, attempts to exploit
weaknesses in the software to enumerate or reconfigure, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial > MailDenial >
MailServiceDenial
MailServiceDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is application-layer mail-related services (majordomo, spam filters, etc.). The intent, or
the result, of this activity is inappropriate or abusive access to network resources through a denial of
service attack. MailServiceDenial events may be attempts to exploit weaknesses in mail-related
software to gain access to a host system, attempts to exploit weaknesses in the software to
enumerate or reconfigure, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial > MailDenial >
MailServiceDenial > MailSpamDenial
MailSpamDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is application-layer mail-related services (usually SMTP). The intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service
attack through excessive mail relaying. MailSpamDenial events reflect excessive attempts to relay
mail through an SMTP server from remote sites that should not typically be relaying mail through the
server, let alone excessive quantities of mail. The goal of these attacks may not be to enumerate or
exploit weaknesses in the mail server, but to relay as much mail through an open relay mail server as
quickly as possible, resulting in a denial of service attack.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by the mail server itself, firewalls, or other network infrastructure devices. These alerts may
417
Security Events
indicate an open relay on the network or an attempt to find an open relay; appropriate response may
be to close access to SMTP servers to only internal and necessary external IP addresses.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ApplicationDenial > WebDenial
WebDenial events are a specific type of Denial event where the transport of the malicious or abusive
usage is application-layer web-related protocols (HTTP, HTTPS, etc.) or services (CGI, ASP, etc.).
The intent, or the result, of this activity is inappropriate or abusive access to network resources
through a denial of service attack. WebDenial events may be attempts to exploit weaknesses in webrelated software to gain access to a host system, attempts to exploit weaknesses in the software to
enumerate or reconfigure, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial
CoreDenial events are a specific type of Denial event where the transport of the malicious or abusive
usage is core protocols (TCP, IP, ICMP, UDP). The intent, or the result, of this activity is
inappropriate or abusive access to network resources through a denial of service attack. CoreDenial
events may be attempts to exploit weaknesses in software to gain access to a host system,
attempts to exploit weaknesses in network infrastructure equipment to enumerate or reconfigure
devices, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > ChargenDenial
ChargenDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of this
activity is inappropriate or abusive access to network resources through a denial of service via UDP
chargen or echo services. This attack attempts to exploit network infrastructure devices and hosts by
pointing two chargen or echo hosts at each other and forcing so many responses that the network and
hosts are flooded. In response to a request to the echo or chargen port, the second device will send a
response, which will trigger another request, which will trigger a response, etc. The source of the
initial request is a spoofed IP address, which appears as one of the hosts which will be a party in the
attack (sent to the second host). This will render both devices and possibly the network they are on
useless either temporarily or for a significant amount of time by the sheer amount of traffic that is
created.
418
Appendix B: Events
ChargenDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > ICMPFloodDenial
ICMPFloodDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service by an
ICMP-based 'flood' attack (which uses many very large ICMP packets). The network infrastructure
devices handling the traffic may pass on the traffic correctly, however, any vulnerable client or device
on the network may not be able to process the incoming traffic (it may use up system resources to the
point where the device is rendered useless and cannot accept network connections). Normal ICMP
Traffic should not trigger an ICMPFloodDenial alert.
ICMPFloodDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial >
ICMPFragmentationDenial
ICMPFragmentationDenial alerts reflect a specific type of CoreDenial alert where the intent, or the
result, of this activity is inappropriate or abusive access to network resources through a denial of
service attack by using many ICMP fragments (usually either much larger or smaller than normal
fragments). The network infrastructure devices handling the traffic will reassemble and pass on the
traffic correctly, however, any vulnerable client on the network may not be able to reassemble the
fragmented traffic (it may overflow the stack, triggering a host or service crash). Normal ICMP
fragmentation (data that has been taken apart because it is too large based on network parameters)
should not trigger an ICMPFragmentationDenial alert.
Fragmentation alerts themselves are generally provided by network-based intrusion detection
systems and network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial >
ICMPSourceQuenchDenial
ICMPSourceQuenchDenial alerts reflect a specific type of CoreDenial alert where the intent, or the
result, of this activity is inappropriate or abusive access to network resources through a denial of
service by an ICMP-based attack (which uses many ICMP packets set to type 4 - Source Quench).
The network infrastructure devices handling the traffic may pass on the traffic correctly, however, any
client listening and responding to source quench traffic may be slowed down to the point where
419
Security Events
rendered useless by way of correct response to the quench request. Normal ICMP traffic (including
single, normal, source quench packets) should not trigger an ICMPSourceQuenchDenial alert.
ICMPSourceQuenchDenial alerts are generally provided by network-based intrusion detection
systems and network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > IPFloodDenial
IPFloodDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of this
activity is inappropriate or abusive access to network resources through a denial of service by an IPbased 'flood' attack (which uses many very large IP packets). The network infrastructure devices
handling the traffic may pass on the traffic correctly, however, any vulnerable client or device on the
network may not be able to process the incoming traffic (it may use up system resources to the point
where the device is rendered useless and cannot accept network connections). Normal IP Traffic
should not trigger an IPFloodDenial alert.
IPFloodDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > IPFragmentationDenial
IPFragmentationDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result,
of this activity is inappropriate or abusive access to network resources through a denial of service
attack by using many IP fragments (usually either much larger or smaller than normal fragments). The
network infrastructure devices handling the traffic will reassemble and pass on the traffic correctly,
however, any vulnerable client on the network may not be able to reassemble the fragmented traffic (it
may overflow the stack, triggering a host or service crash). Normal IP fragmentation (data that has
been taken apart because it is too large based on network parameters) should not trigger an
IPFragmentationDenial alert.
Fragmentation alerts themselves are generally provided by network-based intrusion detection
systems and network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > IPFragmentationDenial
> PingOfDeathDenial
PingOfDeathDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service by a
'ping of death' attack (which uses many large ICMP Echo Request packets). The network
420
Appendix B: Events
infrastructure devices handling the traffic will pass on the traffic correctly, however, any vulnerable
client on the network may not be able to process the incoming traffic (it may be processed in such a
way that triggers a host or service crash). Unpatched Windows NT and 95/98 clients are especially
vulnerable to this type of attack. Normal ICMP Echo Traffic should not trigger a PingOfDeathDenial
alert.
PingOfDeathDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > LandAttackDenial
LandAttackDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service by a
'land' attack (which uses TCP traffic with the SYN bit set and the same source IP and port as the
destination). The network infrastructure devices handling the traffic will pass on the traffic correctly,
however, any vulnerable client on the network may not be able to process the incoming traffic (it may
be processed in such a way that triggers a host or service crash). Unpatched Windows 3.11, NT, and
95 clients are especially vulnerable to this type of attack. Normal TCP traffic (with or without the SYN
bit) should not trigger a LandAttackDenial alert.
LandAttackDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > SmurfDenial
SmurfDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of this
activity is inappropriate or abusive access to network resources through a denial of service by a
'Smurf' attack. A Smurf attack attempts to exploit a vulnerability in some network infrastructure
devices by sending ICMP Echo Requests to devices that will re-broadcast the traffic to internal
devices. In response to the broadcast Echo Request, all of the devices will send an ICMP Echo
Reply, which will effectively overflow the device. The destination of the ICMP Echo Reply is a
spoofed 'victim' IP address which will also be overflowed by the actual replies sent to their host. This
will render both devices useless either temporarily or for a significant amount of time.
SmurfDenial alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > SnorkDenial
421
Security Events
SnorkDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of this
activity is inappropriate or abusive access to network resources through a denial of service by a
'Snork' attack. A Snork attack attempts to exploit a vulnerability in Windows NT devices by using the
Windows RPC service and sending packets to devices that will broadcast the traffic to other internal
Windows NT devices using RPC. In response to the broadcast, all of the Windows NT devices will
send another packet, and this process will continue until it effectively overflows the device and
possibly the network. The destination or source of the initial packet is a spoofed 'victim' IP address
which will create the illusion of internal activity. This will render both devices useless either
temporarily or for a significant amount of time.
SnorkDenial alerts are generally provided by network-based intrusion detection systems and network
infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > SynFloodDenial
SYNFloodDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service by a
TCP-based 'flood' attack (which uses many very large TCP packets with the SYN bit set). The
network infrastructure devices handling the traffic may pass on the traffic correctly, however, any
vulnerable client or device on the network may not be able to process the incoming traffic (it may use
up system resources to the point where the device is rendered useless and cannot accept network
connections). Normal TCP Traffic (with or without the SYN flag) should not trigger a SYNFloodDenial
alert.
SYNFloodDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > TeardropDenial
TeardropDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of this
activity is inappropriate or abusive access to network resources through a denial of service by a
teardrop attack (which uses many overlapping IP fragments, usually either much larger or smaller
than normal fragments). The network infrastructure devices handling the traffic will reassemble and
pass on the traffic correctly, however, any vulnerable client on the network may not be able to
reassemble the fragmented traffic (it may be reassembled in such a way that triggers a host or
service crash). Unpatched Windows NT and 95/98 clients are especially vulnerable to this type of
attack. Normal IP fragmentation (data that has been taken apart because it is too large based on
network parameters) should not trigger a TeardropDenial alert.
422
Appendix B: Events
TeardropDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > CoreDenial > UDPBombDenial
UDPBombDenial alerts reflect a specific type of CoreDenial alert where the intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service by a
UDP-based 'bomb' attack (which uses many large UDP packets). The network infrastructure devices
handling the traffic may pass on the traffic correctly, however, any vulnerable client or device on the
network may not be able to process the incoming traffic (it may be processed in such a way that
triggers a host or service crash). Normal UDP Traffic should not trigger a UDPBombDenial alert.
UDPBombDenial alerts are generally provided by network-based intrusion detection systems and
network infrastructure devices such as firewalls or routers.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > ConfigurationDenial
ConfigurationDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is protocols related to configuration of resources (DHCP, BootP, SNMP, etc.). The
intent, or the result, of this activity is inappropriate or abusive access to network resources through a
denial of service attack. ConfigurationDenial events may be attempts to exploit weaknesses in
configuration-related software to gain access to a host system, attempts to exploit weaknesses in
network infrastructure equipment to enumerate or reconfigure devices, or other denial of service
activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > FileSystemDenial
FileSystemDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is remote filesystem-related protocols (NFS, SMB, etc.). The intent, or the result, of
this activity is inappropriate or abusive access to network resources through a denial of service
attack. FileSystemDenial events may be attempts to exploit weaknesses in remote filesystem
services or software to gain access to a host system, attempts to exploit weaknesses in network
infrastructure equipment to enumerate or reconfigure devices, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
423
Security Events
AttackBehavior > ResourceAttack > NetworkAttack > Denial > LinkControlDenial
LinkControlDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is link level protocols (such as ARP). The intent, or the result, of this activity is
inappropriate or abusive access to network resources through a denial of service attack.
LinkControlDenial events may be attempts to exploit weaknesses in link-level control software to
gain access to a host system, attempts to exploit weaknesses in network infrastructure equipment to
enumerate or reconfigure devices, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > RemoteProcedureDenial
RemoteProcedureDenial events are a specific type of Denial event where the transport of the
malicious or abusive usage is remote procedure-related protocols (traditional RPC, RMI, CORBA,
etc.) or service (portmapper, etc.). The intent, or the result, of this activity is inappropriate or abusive
access to network resources through a denial of service attack. RemoteProcedureDenial events may
be attempts to exploit weaknesses in remote procedure services or software to gain access to a host
system, attempts to exploit weaknesses in the software to enumerate or reconfigure, or other denial
of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > RemoteProcedureDenial >
RPCPortmapperDenial
RPCPortmapperDenial events are a specific type of Denial event where the transport of the
malicious or abusive usage is remote procedure-related protocols, specifically related to the RPC
portmapper service. The intent, or the result, of this activity is inappropriate or abusive access to
network resources through a denial of service attack. RPCPortmapperDenial events may be
attempts to exploit weaknesses the remote procedure service or software to gain access to a host
system, attempts to exploit weaknesses in the software to enumerate or reconfigure, or other denial
of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
424
Appendix B: Events
AttackBehavior > ResourceAttack > NetworkAttack > Denial > RoutingDenial
RoutingDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage is routing-related protocols (RIP, IGMP, etc.). The intent, or the result, of this activity
is inappropriate or abusive access to network resources through a denial of service attack.
RoutingDenial events may be attempts to exploit weaknesses in routers or routing software to gain
access to a host system, attempts to exploit weaknesses in the routing software or service to
enumerate or reconfigure, or other denial of service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Denial > TrojanTrafficDenial
TrojanTrafficDenial events are a specific type of Denial event where the transport of the malicious or
abusive usage originates with malicious code on a client system known as a Trojan. The intent, or the
result, of this activity is inappropriate or abusive access to network resources through a denial of
service attack. TrojanTrafficDenial events may be attempts to exploit weaknesses in software to
gain access to a host system, attempts to exploit weaknesses in network infrastructure equipment to
enumerate or reconfigure devices, attempts to spread the Trojan to other hosts, or other denial of
service activities.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Relay
Children of the Relay tree define events centered on malicious or abusive usage of network
bandwidth/traffic where the intention, or the result, is relaying inappropriate or abusive access to other
network resources (either internal or external). Generally, these attacks will have the perimeter or an
internal host as their point of origin. When sourced from remote hosts, they may indicate a successful
exploit of an internal or perimeter host.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
AttackBehavior > ResourceAttack > NetworkAttack > Relay > DDOSToolRelay
DDOSToolRelay events reflect potential network traffic related to known Distributed Denial of
425
Security Events
Service connectors. These connectors are used to relay attacks to new remote (and possibly local)
hosts to exploit or inundate the remote host with data in an attempt to cripple it. Generally, these
attacks will have a perimeter or an internal host as their point of origin. When sourced from remote
hosts, they may indicate a successful exploit of an internal or perimeter host.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by firewalls or other network infrastructure devices.
Appropriate response to these events may be to restrict the source from accessing any external
network, running a virus scanner or other detection utility to detect and remove the presence of any
relay connector (in some cases known as a 'zombie'), and if necessary, to quarantine the source
node from the network to further isolate the issue. If these events are sourced from a completely
external network, blocking the remote host, better access control of clients, servers, and services
(e.g. restriction by IP address and/or user name to ensure only trusted clients are connecting),
application of updates or patches to servers and/or clients, or the possible removal of the service
related to this event may also be appropriate actions.
AttackBehavior > ResourceAttack > NetworkAttack > Relay > FileTransferRelay
FileTransferRelay events reflect potential network traffic related to known attack connectors that
operate over file transfer protocols. These connectors are used to relay attacks to new remote (and
possibly local) hosts to exploit or abuse services. Generally, these attacks will have a perimeter or an
internal host as their point of origin. When sourced from remote hosts, they may indicate a successful
exploit of an internal or perimeter host.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by the file transfer software itself, and firewalls or other network infrastructure devices.
Appropriate response to these events may be to restrict the source from accessing any external
network, running a virus scanner or other detection utility to detect and remove the presence of any
relay connector, and if necessary, to quarantine the source node from the network to further isolate
the issue. If these events are sourced from a completely external network, blocking the remote host,
better access control of file transfer servers (e.g. restriction by IP address and/or user name to ensure
only trusted clients are connecting), application of updates or patches to file transfer servers and/or
clients, or the possible removal of the file transfer service or client application related to this event
may also be appropriate actions.
AttackBehavior > ResourceAttack > NetworkAttack > Relay > FileTransferRelay > FTPBounce
426
Appendix B: Events
FTPBounce events are a specific type of FileTransferRelay related to known attack connectors using
file transfer protocols that are used to launder connections to other services, redirect attacks to other
hosts or services, or to redirect connections to other hosts or services. Generally, these attacks will
have a perimeter or an internal host as their point of origin. When sourced from remote hosts, they
may indicate a successful exploit of an internal or perimeter host.
These alerts are generally provided by network-based intrusion detection systems, but may also be
provided by the file transfer software or service itself, and firewalls or other network infrastructure
devices.
Appropriate response to these events may be to restrict the source from accessing any external
network, running a virus scanner or other detection utility to detect and remove the presence of any
relay connector, and if necessary, to quarantine the source node from the network to further isolate
the issue. If these events are sourced from a completely external network, blocking the remote host,
better access control of file transfer servers (e.g. restriction by IP address and/or user name to ensure
only trusted clients are connecting), application of updates or patches to file transfer servers and/or
clients, or the possible removal of the file transfer service or client application related to this event
may also be appropriate actions.
AttackBehavior > ResourceAttack > ServiceProcessAttack
Members of the ServiceProcessAttack tree are used to define events centered on malicious or
abusive usage of services or user processes. These events include abuse or misuse of resources
from malicious code placed on the client system.
AttackBehavior > ResourceAttack > ServiceProcessAttack > VirusAttack
VirusAttack alerts reflect malicious code placed on a client or server system, which may lead to
system or other resource compromise and may lead to further attack. The severity of this alert will
depend on the ActionTaken field, which reflects whether the virus or other malicious code was
successfully removed.
These alerts are usually provided by a virus scanner running on the client system. Appropriate
response to these alerts may entail a quarantine of the node from the network to prevent further
outbreak, updates of virus scanner pattern files on other network nodes to prevent further outbreak,
virus scans on other network nodes to detect further outbreak if any has taken place, and research
into the offending virus to find out methods of removal.
AttackBehavior > ResourceAttack > ServiceProcessAttack > VirusSummaryAttack
427
Security Events
VirusSummaryAttack alerts reflect malicious code placed on a client or server system, which may
lead to system or other resource compromise and may lead to further attack. The severity of this alert
will depend on the ActionTaken field which reflects whether the virus or other malicious code was
successfully removed. These alerts differ from VirusAttack in that they may be a composite of virus
events normally due to a scheduled scan on the client system as opposed to a real-time scan.
These alerts are usually provided by a virus scanner running on the client system. Appropriate
response to these alerts may entail a quarantine of the node from the network to prevent further
outbreak, updates of virus scanner pattern files on other network nodes to prevent further outbreak,
virus scans on other network nodes to detect further outbreak if any has taken place, and research
into the offending virus to find out methods of removal.
GeneralSecurity
GeneralSecurity alerts are generated when a supported product outputs data that has not yet been
normalized into a specific alert, but is known to be security issue-related.
SuspiciousBehavior
Events that are children of SuspiciousBehavior are generally related to network activity that may be
consistent of enumeration of resources, unexpected traffic, abnormal authentication events, or other
abnormal behavior that should be considered indicative of a serious security event.
SuspiciousBehavior > AuthSuspicious
Members of the AuthSuspicious tree are used to define events regarding suspicious authentication
and authorization events. These events include excessive failed authentication or authorization
attempts, suspicious access to unauthenticated users, and suspicious access to unauthorized
services or information.
SuspiciousBehavior > AuthSuspicious > FailedAuthentication
FailedAuthentication events occur when a user has made several attempts to authenticate
themselves which has continuously failed, or when a logon failure is serious enough to merit a
security event on a single failure.
SuspiciousBehavior > AuthSuspicious > GuestLogin
GuestLogin events describe user authentication events where an attempt was made successfully or
unsuccessfully granting access to a user that generally has no password assigned (such as
428
Appendix B: Events
anonymous, guest, or default) and no special privileges. Access of a user with this level of privileges
may be granted access to enough of the client system to begin exploitation.
These events are usually produced by a client or server operating system, however may also be
produced by a network-based IDS or network infrastructure device when it is possible or appropriate.
SuspiciousBehavior > AuthSuspicious > RestrictedInformationAttempt
RestrictedInformationAttempt events describe a user attempt to access local or remote information
that their level of authorization does not allow. These events may indicate user attempts to exploit
services which they are denied access to or inappropriate access attempts to information.
SuspiciousBehavior > AuthSuspicious > RestrictedServiceAttempt
RestrictedServiceAttempt events describe a user attempt to access a local or remote service that
their level of authorization does not allow. These events may indicate user attempts to exploit
services which they are denied access to or inappropriate access attempts to services.
SuspiciousBehavior > InferredSuspicious
InferredSuspicious alerts are reserved SuspiciousBehavior alerts used for describing suspicious
behavior that is a composite of different types of alerts. These events will be defined and inferred by
Contego Policy.
SuspiciousBehavior > ResourceSuspicious
Members of the ResourceSuspicious tree are used to define different types of suspicious access to
network resources, where these resources may be network bandwidth/traffic, files, client processes
or services, or other types of shared security-related 'commodities'.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious
Members of the NetworkSuspicious tree are used to define events regarding suspicious usage of
network bandwidth/traffic. These events include unusual traffic and reconnaissance behavior
detected on network resources.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon
Children of the Recon tree reflect suspicious network behavior with intent of gathering information
about target clients, networks, or hosts. Reconnaissance behavior may be valid behavior on a
429
Security Events
network, however, only as a controlled behavior in small quantities. Invalid reconnaissance behavior
may reflect attempts to determine security flaws on remote hosts, missing access control policies
that allow external hosts to penetrate networks, or other suspicious behavior that results in general
information gathering without actively attacking.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate
Enumerate alerts reflect attempts to gather information about target networks, or specific target
hosts, by sending active data which will elicit responses that reveal information about clients,
servers, or other network infrastructure devices. The originating source of the enumeration is
generally attempting to acquire information that may reveal more than normal traffic to the target
would.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate
ApplicationEnumerate alerts reflect attempts to gather information about target hosts, or services on
target hosts, by sending active application-layer data which will elicit responses that reveal
information about the application or host. This enumeration may be a LEMple command sent to the
application to attempt to fingerprint what is allowed or denied by the service, requests to the
application which may enable an attacker to surmise the version and specific application running, and
other information gathering tactics. These enumerations may result in information being provided that
can allow an attacker to craft a specific attack against the host or application that may work correctly
the first time - enabling them to modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate > FileTransferEnumerate
FileTransferEnumerate alerts reflect attempts to gather information about target hosts, or services on
target hosts, by sending active application-layer data to file transfer services which will elicit
responses that reveal information about the application or host. This enumeration may be a LEMple
command sent to the file transfer service to attempt to fingerprint what is allowed or denied by the
service, requests to the file transfer service that may enable an attacker to surmise the version and
specific service running, and other information gathering tactics. These enumerations may result in
information being provided that can allow an attacker to craft a specific attack against the file transfer
service or application that may work correctly the first time - enabling them to modify their
methodology to go on relatively undetected.
430
Appendix B: Events
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate > FileTransferEnumerate > FTPCommandEnumerate
FTPCommandEnumerate alerts reflect attempts to gather information about target hosts, or services
on target hosts, by sending active application-layer data to file transfer services which will elicit
responses that reveal information about the application. This enumeration specifically entails
commands sent to the FTP service to attempt to fingerprint what is allowed or denied by the service,
requests to the FTP service that may enable an attacker to surmise the version and specific service
running, and other information gathering tactics that use FTP commands to query. These
enumerations may result in information being provided that can allow an attacker to craft a specific
attack against the FTP service that may work correctly the first time - enabling them to modify their
methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate > MailEnumerate
MailEnumerate alerts reflect attempts to gather information about target hosts, or services on target
hosts, by sending active application-layer data to mail-related services which will elicit responses
that reveal information about the application or host. This enumeration may be a LEMple command
sent to the mail service to attempt to fingerprint what is allowed or denied by the service, requests to
the mail service that may enable an attacker to surmise the version and specific service running, and
other information gathering tactics. These enumerations may result in information being provided that
can allow an attacker to craft a specific attack against the mail service or application that may work
correctly the first time - enabling them to modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate > MailEnumerate > SMTPCommandEnumerate
SMTPCommandEnumerate alerts reflect attempts to gather information about target hosts, or
services on target hosts, by sending active application-layer data to mail-related services which will
elicit responses that reveal information about the application. This enumeration specifically entails
commands sent to the SMTP service to attempt to fingerprint what is allowed or denied by the
service, requests to the mail service that may enable an attacker to surmise the version and specific
service running, and other information gathering tactics that use SMTP commands to query. These
enumerations may result in information being provided that can allow an attacker to craft a specific
attack against the mail service that may work correctly the first time - enabling them to modify their
methodology to go on relatively undetected.
431
Security Events
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
ApplicationEnumerate > WebEnumerate
WebEnumerate alerts reflect attempts to gather information about target hosts, or services on target
hosts, by sending active application-layer data to web-related services which will elicit responses
that reveal information about the application or host. This enumeration may be a LEMple command
sent to the web service to attempt to fingerprint what is allowed or denied by the service, requests to
the web service that may enable an attacker to surmise the version and specific service running, and
other information gathering tactics. These enumerations may result in information being provided that
can allow an attacker to craft a specific attack against the web service or application that may work
correctly the first time - enabling them to modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
BannerGrabbingEnumerate
BannerGrabbingEnumerate alerts reflect attempts to gather information about target hosts, or
services on target hosts, by sending a request which will elicit a response containing the host or
service's 'banner'. This 'banner' contains information that may provide a potential attacker with such
details as the exact application and version running behind a port. These details could be used to craft
specific attacks against hosts or services that an attacker may know will work correctly the first time
- enabling them to modify their methodology go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
MSNetworkingEnumerate
MSNetworkingEnumerate alerts reflect attempts to gather information about target hosts, or services
on target hosts, by sending active data to Microsoft networking services (using protocols such as
NetBIOS and SMB/CIFS) that will illicit responses that reveal information about the application, host,
or target network. This enumeration may be a LEMple command sent to the networking service to
attempt to fingerprint what is allowed or denied by a service, requests to a service that may enable an
attacker to surmise the version and specific service running, requests to a service that may enable an
attacker to fingerprint the target network, and other information gathering tactics. These enumerations
may result in information being provided that can allow an attacker to craft a specific attack against
the networking service, host, or application that may work correctly the first time - enabling them to
modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
RemoteProcedureEnumerate
432
Appendix B: Events
RemoteProcedureEnumerate alerts reflect attempts to gather information about target hosts, or
services on target hosts, by sending active data to Remote Procedure services (using protocols such
as RMI, CORBA, and traditional RPC) that will elicit responses that reveal information about the
application or host. This enumeration may be a LEMple command sent to the remote procedure
service to attempt to fingerprint what is allowed or denied by the service, requests to the remote
procedure service that may enable an attacker to surmise the version and specific service running,
and other information gathering tactics. These enumerations may result in information being provided
that can allow an attacker to craft a specific attack against the remote procedure service or
application that may work correctly the first time - enabling them to modify their methodology to go on
relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
RemoteProcedureEnumerate > RPCPortmapperEnumerate
RPCPortmapperEnumerate alerts reflect attempts to gather information about target hosts, or
services on target hosts, by sending active data to the Portmapper Remote Procedure service that
will illicit responses that reveal information about the application or host. This enumeration may be a
LEMple command sent to the portmapper service to attempt to fingerprint what is allowed or denied
by the service, requests to the portmapper service that may enable an attacker to surmise the version
and specific service running, and other information gathering tactics. These enumerations may result
in information being provided that can allow an attacker to craft a specific attack against the
portmapper service or client application that may work correctly the first time - enabling them to
modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Enumerate >
RemoteProcedureEnumerate > RPCPortScanEnumerate
RPCPortScanEnumerate alerts reflect attempts to gather information about target hosts, or services
on target hosts, by sending active data to Remote Procedure services (using protocols such as RMI,
CORBA, and traditional RPC) that will elicit responses that reveal information about the application or
host. This specific type of enumeration is done by sending queries to RPC related ports to attempt to
fingerprint the types and specific services running, and may involve other information gathering
tactics. These enumerations may result in information being provided that can allow an attacker to
craft a specific attack against the remote procedure service or application that may work correctly the
first time - enabling them to modify their methodology to go on relatively undetected.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Footprint
433
Security Events
Footprint alerts reflect attempts to gather information about target networks by tracing the network
through routers, clients, servers, or other network infrastructure devices. The originating source of the
footprint is generally attempting to acquire information that may reveal more about network behavior
than normal traffic to the target would.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Footprint >
DNSRequestFootprint
DNSRequestFootprint alerts are a specific type of Footprint alert that reflects a DNS record request
that may serve to reveal DNS configuration. Contained within this DNS configuration may be
information that reveals internal networks, protected devices, or IP addresses of potential targets.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Footprint >
FirewalkingFootprint
FirewalkingFootprint alerts are a specific type of Footprint alert that reflects the usage of a connector
that attempts to gather information about network infrastructure device access control and filtering
lists. Firewalking works by passing TCP and UDP packets to determine what packets a given device
will forward. This activity may reflect attempts to enumerate devices beyond the perimeter of a
network, gathering information about activity that is allowed or denied past given gateways.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Footprint >
TraceRouteFootprint
TraceRouteFootprint alerts are a specific type of Footprint alert that reflects an IP packet route trace
from source to destination. Generally, this route will not reveal specific information about device
types or hosts on a network, but will trace the path of IP traffic across routing devices. This traffic
may be an attempt to discover routing devices that are misconfigured (which may be vulnerable to
attacks such as IP spoofing or IP fragmentation).
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan
Scan alerts reflect attempts to gather information about target networks, or specific target hosts, by
sending scans which will elicit responses that reveal information about clients, servers, or other
network infrastructure devices. The originating source of the scan is generally attempting to acquire
information that may reveal more than normal traffic to the target would, information such as a list of
applications listening on ports, operating system information, and other information that a probe may
discover without enumeration of the specific services or performing attack attempts.
434
Appendix B: Events
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan
CoreScan alerts reflect attempts to gather information about target networks, or specific target hosts,
by sending scans over core network protocols (TCP, IP, ICMP, UDP) which will elicit responses that
reveal information about clients, servers, or other network infrastructure devices. The originating
source of the scan is generally attempting to acquire information that may reveal more than normal
traffic to the target would, information such as a list of applications listening on ports, operating
system information, and other information that a probe may discover without enumeration of the
specific services or performing attack attempts.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
HostScan
HostScan alerts reflect attempts to gather information about specific target hosts by sending scans
which will elicit responses that reveal information about clients, servers, or other network
infrastructure devices. The originating source of the scan is generally attempting to acquire
information that may reveal more than normal traffic to the target would, such as a list of applications
on the host, operating system information, and other information that a probe may discover without
enumeration of the specific services or performing attack attempts. These scans generally do not
occur across entire networks and generally have the intent of discovering operating system and
application information which may be used for further attack preparation.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
ICMPQuery
ICMPQuery alerts reflect attempts to gather information about specific target hosts, or networks, by
sending ICMP-based queries that will elicit responses that reveal information about clients, servers,
or other network infrastructure devices. The originating source of the scan is generally attempting to
acquire information that may reveal more than normal traffic to the target would, such as operating
system information and other information that a probe may discover without enumeration of the
specific services or performing attack attempts. These scans generally do not occur across entire
networks, contain many sequential ICMP packets, and generally have the intent of discovering
operating system and application information which may be used for further attack preparation.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PingSweep
PingSweep alerts reflect a specific type of CoreScan alert that describe an attempt to gather
information about target networks, and hosts on those networks, by sending ICMP or TCP ping
435
Security Events
packets to test whether hosts are alive. The originating source of the scan is generally attempting to
acquire information about network topology or groups of specific hosts on the network and may have
the intent of gathering information for future attack attempts.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PingSweep > ICMPPingSweep
ICMPPingSweep alerts reflect a specific type of CoreScan alert that describe an attempt to gather
information about target networks, and hosts on those networks, by sending ICMP ping packets to
test whether hosts are alive. The originating source of the scan is generally attempting to acquire
information about network topology or groups of specific hosts on the network and may have the
intent of gathering information for future attack attempts.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PingSweep > TCPPingSweep
TCPPingSweep alerts reflect a specific type of CoreScan alert that describe an attempt to gather
information about target networks, and hosts on those networks, by sending TCP ping packets to test
whether hosts are alive. The originating source of the scan is generally attempting to acquire
information about network topology or groups of specific hosts on the network and may have the
intent of gathering information for future attack attempts.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PortScan
PortScan alerts reflect attempts to gather information about target networks, or specific target hosts,
by sending scans over core network protocols (TCP, IP, ICMP, UDP) that will elicit responses that
reveal information about clients, servers, or other network infrastructure devices. The originating
source of the scan is generally attempting to acquire information that may reveal more than normal
traffic to the target would, such as a list of applications listening on ports, operating system
information, and other information that a probe may discover without enumeration of the specific
services or performing attack attempts. Portscans specifically operate by sending probes to every
port within a range, attempting to identify open ports that may use applications or services that are
easy to enumerate and attack.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PortScan > TCPPortScan
TCPPortScan alerts reflect attempts to gather information about target networks, or specific target
436
Appendix B: Events
hosts, by sending scans over TCP that will elicit responses that reveal information about clients,
servers, or other network infrastructure devices. The originating source of the scan is generally
attempting to acquire information that may reveal more than normal traffic to the target would, such as
a list of applications listening on ports, operating system information, and other information that a
probe may discover without enumeration of the specific services or performing attack attempts. TCP
portscans specifically operate by sending TCP probes to every port within a range, attempting to
identify open ports that may use applications or services that are easy to enumerate and attack.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
PortScan > UDPPortScan
UDPPortScan alerts reflect attempts to gather information about target networks, or specific target
hosts, by sending scans over UDP that will elicit responses that reveal information about clients,
servers, or other network infrastructure devices. The originating source of the scan is generally
attempting to acquire information that may reveal more than normal traffic to the target would, such as
a list of applications listening on ports, operating system information, and other information that a
probe may discover without enumeration of the specific services or performing attack attempts. UDP
portscans specifically operate by sending UDP probes to every port within a range, attempting to
identify open ports that may use applications or services that are easy to enumerate and attack.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
StackFingerprint
StackFingerprint alerts reflect attempts to gather information about specific target hosts by sending a
certain set of packets to probe a device's network stack, which will elicit responses that reveal
information about clients, servers, or other network infrastructure devices. The originating source of
the scan is generally attempting to acquire information that may reveal more than normal traffic to the
target would, such as operating system information (including type and version) and other information
that a probe may discover without enumeration of the specific services or performing attack attempts.
These scans generally do not occur across entire networks and generally have the intent of
discovering operating system information which may be used for further attack preparation.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
StackFingerprint > ICMPStackFingerprint
ICMPStackFingerprint alerts reflect attempts to gather information about specific target hosts by
sending a certain set of ICMP packets to probe a device's ICMP stack, which will elicit responses
that reveal information about clients, servers, or other network infrastructure devices. The originating
437
Security Events
source of the scan is generally attempting to acquire information that may reveal more than normal
traffic to the target would, such as operating system information (including type and version) and
other information that a probe may discover without enumeration of the specific services or
performing attack attempts. These scans generally do not occur across entire networks and generally
have the intent of discovering operating system information which may be used for further attack
preparation.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > CoreScan >
StackFingerprint > TCPStackFingerprint
TCPStackFingerprint alerts reflect attempts to gather information about specific target hosts by
sending a certain set of TCP packets to probe a device's TCP/IP stack, which will elicit responses
that reveal information about clients, servers, or other network infrastructure devices. The originating
source of the scan is generally attempting to acquire information that may reveal more than normal
traffic to the target would, such as operating system information (including type and version) and
other information that a probe may discover without enumeration of the specific services or
performing attack attempts. These scans generally do not occur across entire networks and generally
have the intent of discovering operating system information which may be used for further attack
preparation.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > Recon > Scan > TrojanScanner
TrojanScanner alerts reflect attempts of Trojans on the network to gather information about target
networks, or specific target hosts, by sending scans which will elicit responses that reveal
information about the host. The originating Trojan source of the scan is generally attempting to
acquire information that will reveal whether a target host or network has open and available services
for further exploitation, whether the target host or network is alive, and how much of the target
network is visible. A Trojan may run a scan before attempting an attack operation to test potential
effectiveness or targeting information.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic
UnusualTraffic alerts reflect suspicious behavior on network devices where the traffic may have no
known exploit, but is unusual and could be potential enumerations, probes, fingerprints, attempts to
confuse devices, or other abnormal traffic. UnusualTraffic may have no impending response,
however, it could reflect a suspicious host that should be monitored closely.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic >
UnusualICMPTraffic
438
Appendix B: Events
UnusualICMPTraffic alerts reflect ICMP-based suspicious behavior on network devices where the
traffic may have no known exploit, but is unusual and could be potential enumerations, probes,
fingerprints, attempts to confuse devices, or other abnormal traffic. UnusualICMPTraffic may have
no impending response, however, it could reflect a suspicious host that should be monitored closely.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic >
UnusualIPTraffic
UnusualIPTraffic alerts reflect IP-based suspicious behavior on network devices where the traffic
may have no known exploit, but is unusual and could be potential enumerations, probes, fingerprints,
attempts to confuse devices, or other abnormal traffic. UnusualIPTraffic may have no impending
response, however, it could reflect a suspicious host that should be monitored closely.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic >
UnusualProtocol
UnusualProtocol alerts reflect suspicious behavior on network devices where the traffic is targeted at
unknown, unassigned, or uncommonly used protocols. This traffic may have no known exploit, but is
unusual and should be considered potential enumerations, probes, fingerprints, attempts to confuse
devices, or other abnormal traffic. UnusualProtocol may have no impending response, however, it
could reflect a suspicious host that should be monitored closely.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic >
UnusualTCPTraffic
UnusualTCPTraffic alerts reflect TCP-based suspicious behavior on network devices where the
traffic may have no known exploit, but is unusual and could be potential enumerations, probes,
fingerprints, attempts to confuse devices, or other abnormal traffic. UnusualTCPTraffic may have no
impending response, however, it could reflect a suspicious host that should be monitored closely.
SuspiciousBehavior > ResourceSuspicious > NetworkSuspicious > UnusualTraffic >
UnusualUDPTraffic
UnusualUDPTraffic alerts reflect UDP-based suspicious behavior on network devices where the
traffic may have no known exploit, but is unusual and could be potential enumerations, probes,
fingerprints, attempts to confuse devices, or other abnormal traffic. UnusualUDPTraffic may have no
impending response, however, it could reflect a suspicious host that should be monitored closely.
439
Security Events
440
Appendix C: Appendix Event Data Fields
The following table explains the meaning of each grid column or data field that can appear in various
alert grids, event grids, and information panes throughout the Console. The actual columns and fields
that are shown vary according to the alert, view, or grid you are working with. But the meaning of
these fields remains the same, regardless of where you see them.
For convenience, the fields are listed in alphabetical order.
Grid column or
field
EventName
Description
The name of the alert. For information on a particular alert, see "Event
Types" on page 1.
ConnectionName
The name of the dial-up or VPN connection.
ConnectionStatus
The current status of the dial-up or VPN connection.
DestinationMachine The IP address the network traffic is going to.
DestinationPort
The port number the network traffic is going to.
DetectionIP
The network node that is the originating source of the alert data. This is
usually a Manager or an Agent and is the same as the InsertionIP field, but
can also be a network device such as firewall or an intrusion detection
system that may be sending log files over a remote logging protocol.
DetectionTime
The time the network node generated the data. This is usually the same as
the InsertionTime field, but they can differ when the Agent or Manager is
reading historical data, or if a network device has an incorrect time setting.
EventInfo
A short summary of the alert details. Additional details appear in the
following fields, but EventInfo provides enough information to view a
“snapshot” of the alert information.
ExtraneousInfo
Extra information that is relevant to the alert, but may not be reflected in
other fields. This can include information useful for correlating or
summarizing alert information in addition to the EventInfo field.
441
Appendix C: Appendix Event Data Fields
Grid column or
field
Host
Description
The node the log message came from (that is, the LEM or Agent that collected the message for forwarding to nDepth).
HostFromData
The originating network device (if different than the node) that the message
came from. Normally, Host and HostFromData are the same, but in the
case of a remote logging device (such as a firewall) this field reports the original remote device's address.
InferenceRule
The name of the correlation that caused this alert. The InferenceRule field
will generally be blank, but in cases where the alert was related to a rule, it
displays the rule name.
InsertionIP
The Manager or Agent that first created the alert. This is the source that first
read the log data from a file or other source.
InsertionTime
The time the Manager or Agent first created the alert. This time indicates
when the data was read from a log file or other source.
IPAddress
The IP address associated with the alert. This is a composite field, drawn
from several different alert fields. It shows all the IP addresses that appear
in alert data.
Manager
The name of the Manager that received the alert. For data generated from an
Agent, this is the Manager the Agent is connected to.
Order
In the Event explorer’s event grid, the Order field indicates when each event
occurred:
means the event occurred before the central event shown in the event
map.
means the event occurred during (as part of) the central event shown in
the event map.
means the event occurred after the central event shown in the event
map.
Protocol
Displays the protocol associated with this alert (TCP or UDP).
442
Appendix C: Appendix Event Data Fields
Grid column or
field
ProviderSID
Description
A unique identifier for the original data. Generally, the ProviderSID field
includes information that can be used in researching information on the alert
in the originating network device vendor's documentation.
SourceMachine
The IP address the network traffic is coming from.
SourcePort
The port number the network traffic is coming from.
ConnectorAlias
The Alias Name entered when configuring the connector on the Manager or
Agent. For more information on configuring connectors, see "Connecting
products to the SolarWinds LEM" on page 1.
ConnectorId
The actual connector that generated the log message.
ConnectorType
Connector category for the connector that generated the log message.
Username
The user name associated with the alert. This is a composite field, drawn
from several different alert fields. It shows all the places that user names
appear in alert data.
443
Appendix D: Connector Categories
FileName
Description
Version
3comswitch.xml
3Com Switch
7374
actianceusg.xml
Actiance Unified Security Gate- 7374
way
activescout.xml
ActiveScout
7374
AIXauditlog.xml
AIX Audit
7405
AIXsyslog.xml
AIX Syslog
7426
AlliedTelesis.xml
Allied Telesis Routers and
7374
Switches
amavis.xml
AMaViS
7374
ApacheAccessLog.xml
Apache Access
7374
ApacheErrorLog.xml
Apache Error
7374
apcinfrastruxure.xml
APC InfraStruXure
7374
arraynetworksspx.xml
Array Networks SPX
7374
aruba.xml
Aruba Wireless Access Point
7374
aruba3x.xml
Aruba Wireless Access Point
7374
3x
as400.xml
Legacy TriGeo Agent AS400
Tool
444
7453
Appendix D: Connector Categories
FileName
Description
Version
astarosg.xml
Astaro Security Gateway
7374
atlas.xml
Adtran Atlas Switch
7374
aventail.xml
SonicWALL Aventail SSL VPN
7374
E-Class
avgnetworkserver.xml
AVG DataCenter 7.5
7374
avgnetworkserver.xml
AVG DataCenter 8.0
7374
avgworkstation.xml
AVG 7.5 Network
7374
AxcientUMC.xml
Axcient Unified Management
7380
Console (UMC)
BackupExecSR.xml
Symantec Backup Exec Sys-
7374
tem Recovery
barracudaadmin.xml
Barracuda Admin
7374
barracudaNG.xml
Barracuda NG Firewall (Phion
7374
Netfence)
barracudaweb.xml
Barracuda Web Filter
7374
BarracudaWebAppFW.xml
Barracuda Web Application
7374
Firewall
bind.xml
Bind
7374
biopassword.xml
BioPassword
7374
Bit9Parity.xml
Bit9 Parity v5+ Syslog
7492
bladerackswitch.xml
Blade RackSwitch
7374
bluecoatproxySG.xml
Blue Coat ProxySG
7399
445
Appendix D: Connector Categories
FileName
Description
Version
bluecoatproxysgwa.xml
Blue Coat Proxy SG web
7379
access
bordermanager.xml
Novell BorderManager
7374
bordermanagerwebproxy.xml
Novell BorderManager Web
7374
Proxy
Borderware.xml
Borderware Firewall
7374
brightstor.xml
CA's BrightStor v11.5
7374
checkpointedgex.xml
Checkpoint Edge X Firewall
7374
ciscoacsadminaudit.xml
Cisco ACS Admin Audit 4.1+
7387
ciscoacsadminaudit.xml
Cisco ACS Admin Audit
7387
ciscoacsbackup.xml
Cisco ACS Backup and
7374
Restore
ciscoacsdbr.xml
Cisco ACS Database Rep-
7374
lication
ciscoacsdbs.xml
Cisco ACS Database Sync
7374
ciscoacsexpress.xml
Cisco ACS Express
7374
ciscoacsfailed.xml
Cisco ACS Failed Attempts
7374
ciscoacspassauth.xml
Cisco ACS Passed Authentic-
7374
ations
ciscoacspassword.xml
Cisco ACS User Password
7374
Changes
ciscoacsradius.xml
Cisco ACS RADIUS Accounting
446
7374
Appendix D: Connector Categories
FileName
Description
Version
ciscoacsservmon.xml
Cisco ACS Service Monitoring
7374
ciscoacssyslog.xml
Cisco Secure ACS 4.1 Syslog
7374
ciscoacssyslog5.xml
Cisco Secure ACS 5+ Syslog
7374
ciscoacstacacc.xml
Cisco ACS TACACS+
7374
Accounting
ciscoacstacadmin.xml
Cisco ACS TACACS+ Admin-
7374
istration
ciscoacsvoip.xml
Cisco ACS VoIP
7374
ciscocatos.xml
Cisco CatOS
7374
CiscoCSCSSM.xml
Cisco Content Security and
7374
Control Security Services Module 6.1-6.2
CiscoCSCSSM63.xml
Cisco Content Security and
7374
Control Security Services Module 6.3+
ciscocss.xml
Cisco Content Services
7374
Switch
CiscoFirewalls.xml
Cisco PIX and IOS
7443
CiscoIDS.xml
Cisco IDS/IPS v4/5.x
7374
CiscoIPSsdee.xml
Cisco IPS 5+ (SDEE)
7374
CiscoNAC_CA.xml
Cisco (NAC) Network Access
7422
Control Appliance with Clean
Access Manager (CAM) or
Server (CAS) Software
447
Appendix D: Connector Categories
FileName
Description
Version
cisconetworkregistrar.xml
Cisco Network Registrar for
7374
Windows
CiscoNXOS.xml
Cisco Nexus NX-OS
7395
CiscoVPN.xml
Cisco VPN
7374
ciscowlc.xml
Cisco Wireless LAN Controller
7388
and IOS-XE Software
citrixnetscaler.xml
Citrix Secure Access Gateway
7374
Enterprise Appliance / Netscaler
CitrixSAG.xml
Citrix Secure Access Gateway
7374
CitrixXD.xml
Citrix XenDesktop
7374
CitrixXS_auth.xml
Citrix XenServer auth log
7374
CitrixXS_daemon.xml
Citrix XenServer daemon log
7374
ClamAV.xml
ClamAV
7374
codegreenci.xml
CodeGreen Content Inspection
7374
codegreenciuser.xml
CodeGreen Content Inspection
7374
user
commandavwindows.xml
Command Antivirus for Win-
7374
dows
CommandES.xml
Command for Exchange
7374
Server
consentrycontroller.xml
ConSentry Controller
7374
ContegoManagerMonitor.xml
Manager Monitor
7374
448
Appendix D: Connector Categories
FileName
Description
Version
ContegoReports.xml
SWLEM Reports
7374
corenteawb.xml
Corente AWB
7374
cyberarkvault.xml
Cyber-Ark Vault
7374
cyberguard.xml
Cyberguard
7374
CyberoamUTM.xml
Cyberoam UTM
7374
dellPowerConnect.xml
Dell PowerConnect Switches
7374
devicelockevents.xml
DeviceLock Audit
7374
devicelockevents.xml
DeviceLock Events
7374
digitalpersona.xml
DigitalPersona Pro
7374
dlinkdfl.xml
D-Link DFL firewall
7374
dragonids.xml
Dragon IDS
7374
edmzpar.xml
eDMZ Password Auto Repos-
7374
itory
eeyeblinkep.xml
eEye Blink Professional End-
7380
point Protection
EFTServer.xml
EFT Server Enterprise Win-
7374
dows Application Log
emcrecoverpoint.xml
EMC RecoverPoint
7374
enterasysswitch.xml
Enterasys C-Series and N-Ser-
7374
ies Switches
epo.xml
ePolicy Orchestrator (ePO)
449
7380
Appendix D: Connector Categories
FileName
Description
Version
epo45.xml
ePolicy Orchestrator (ePO)
7467
4.5+
esafe.xml
eSafe
7374
esoft.xml
eSoft
7374
esxcfgfirewall.xml
VMWare ESX esxcfg-firewall
7374
log
esxhostd.xml
VMWare ESX hostd log
7483
esxihostd.xml
VMWare ESXi Hostd log
7397
esxmessages.xml
VMWare ESXi messages log
7406
esxmessages.xml
VMWare ESX messages log
7406
esxsecure.xml
VMWare ESX secure log
7429
esxvmkernel.xml
VMWare ESXi vmkernel log
7392
esxvmkernel.xml
VMWare ESX vmkernel log
7392
esxvmkwarning.xml
VMWare ESX vmkwarning log
7374
extremeswitch.xml
Extreme Switch
7452
F5BigIPdaemon.xml
F5 BigIP BSD daemon mes-
7374
sages
F5BigIPhttpd.xml
F5 BigIP HTTPD specific
7374
F5BigIPLTMgeneral.xml
F5 General BIG-IP specific
7454
messages
F5BigIPmessages.xml
F5 BigIP messages
7374
FileSure.xml
FileSure
7374
450
Appendix D: Connector Categories
FileName
Description
Version
FirePass.xml
FirePass SSL VPN
7374
fireproof.xml
FireProof
7374
flexteller.xml
Flex Teller
7374
forefrontapp.xml
Forefront Security Application
7374
Log (Client Security, Exchange
and Sharepoint)
forefrontEPAV.xml
Forefront Endpoint Protection -
7374
AV
forefrontSQLDB.xml
Forefront Security SQL Data-
7374
base
forefrontsys.xml
Forefront Security System Log
7374
(Client Security)
forescoutcounteractnac.xml
ForeScout CounterACT NAC
7374
fortigate25.xml
FortiGate 2.5
7374
fortigate28.xml
FortiGate 2.8+
7448
foundry.xml
Foundry
7374
freebsdauth.xml
FreeBSD Authentication
7374
freeradius.xml
FreeRADIUS
7374
freshclam.xml
FreshClam
7374
fsecureav.xml
F-Secure Anti-Virus 7
7374
GFIsim.xml
GFI LANguard System Integ-
7374
rity Monitor 3
globalscapeeftclient.xml
Globalscape EFT client
451
7374
Appendix D: Connector Categories
FileName
Description
Version
globalscapeftp.xml
Globalscape Secure FTP
7407
(W3C Extended file format)
GnatBox.xml
GNAT Box System Software
7415
v.3.3
GroupShield.xml
Group Shield/Outbreak for
7374
Exchange Server
hp_procurve.xml
HP ProCurve Switches Firm-
7374
ware F.05.65+ Zl Series
hp_procurve_msm700_series.xml
HP MSM700 Series Controller
7436
hpbladesystemenclosure.xml
HP BladeSystem Enclosure
7374
local log
hpbladesystemenclosure.xml
HP BladeSystem Enclosure
7374
auth log
hpstorwksmsa.xml
HP StorageWorks Modular
7374
Smart Array
hpuxsyslog.xml
HP-ux Syslog
7374
HuaweiSwitches.xml
Huawei Switches
7374
iasradius.xml
IAS RADIUS Rotating File
7374
iasradius.xml
IAS RADIUS Non-Rotating
7374
File
IASsystem.xml
Windows IAS System Log
7374
IIS.xml
Microsoft IIS Web Server 7.0
7374
(W3C Extended file format)
452
Appendix D: Connector Categories
FileName
Description
Version
IIS.xml
Microsoft IIS Web Server 6.0
7374
(W3C Extended file format)
IIS.xml
Microsoft IIS Web Server 5.0
7374
(W3C Extended file format)
iisftp.xml
Microsoft IIS FTP Server 7.0
7374
(W3C Extended file format)
iisftp.xml
Microsoft IIS FTP Server 5+
7374
(W3C Extended file format)
ingatesipfw.xml
Ingate Firewall
7374
InoculateIT60.xml
InoculateIT 6.0
7374
InoculateIT70plus.xml
InoculateIT 7.0+
7374
intrushield.xml
IntruShield
7490
ipfilter.xml
IP Filter
7374
iprism.xml
St. Bernard iPrism
7374
ironportemailsecurity.xml
IronPort Email Security Appli-
7374
ance
ironportwebsecurity.xml
IronPort Web Security
7374
ISA2004FirewallLog.xml
Microsoft ISA 2004/2006 Fire-
7374
wall (ISA Server file format)
ISA2004ProxyLog.xml
Microsoft ISA 2004 Web Proxy
7374
(ISA Server file format)
ISA2004W3CFirewall.xml
Microsoft ISA 2004/2006 Firewall (W3C Server file format)
453
7374
Appendix D: Connector Categories
FileName
Description
Version
ISA2004W3CWebProxy.xml
Microsoft ISA 2004 Web Proxy
7374
(W3C Server file format)
ISA2006ProxyLog.xml
Microsoft ISA 2006 Web Proxy
7374
(ISA Server file format)
ISA2006W3CWebProxy.xml
Microsoft ISA 2006 Web Proxy
7374
(W3C Server file format)
ISAApplication.xml
Microsoft ISA Server Applic-
7374
ation Log
ISAFirewallLog.xml
Microsoft ISA 2000 Firewall
7374
(ISA Server file format)
ISAPackertFilterLog.xml
Microsoft ISA Packet Filter
7374
(ISA Server file format)
isapi_redirect.xml
Apache Tomcat isapi_redirect
7374
ISAProxyLog.xml
Microsoft ISA Web Proxy (ISA
7374
Server file format)
ISAW3CFirewallLog.xml
Microsoft ISA Firewall (W3C
7374
Extended file format)
ISAW3CPackertFilterLog.xml
Microsoft ISA Packet Filter
7374
(W3C Extended file format)
ISAW3CProxyLog.xml
Microsoft ISA Web Proxy
7374
(W3C Extended file format)
issproventia.xml
ISS Proventia IPS
7380
issrealsecure.xml
ISS RealSecure IDS
7380
jacocartcare.xml
JACO CartCare
7374
454
Appendix D: Connector Categories
FileName
Description
Version
juniperidp30.xml
Juniper IDP 3.x
7374
juniperidp40.xml
Juniper IDP 4.0+
7374
junipernsm.xml
Juniper NSM
7374
junipersbr_authaccepts.xml
Juniper SBR authentication
7374
accepts report log
junipersbr_authaccepts.xml
Juniper SBR authentication
7374
accepts report log
junipersbr_authrejects.xml
Juniper SBR authentication
7374
rejects report log
junipersbr_authrejects.xml
Juniper SBR authentication
7374
rejects report log
junipervgw.xml
Juniper Virtual Gateway
7374
junos.xml
Juniper JUNOS
7455
KasperskyAdminKitDB.xml
Kaspersky Security Center
7417
KasperskyAdminKitDB.xml
Kaspersky Administration Kit 8
7417
kasperskyav.xml
Kaspersky Anti-Virus 6
7374
lancopestealthwatch.xml
Lancope StealthWatch
7374
linkproof.xml
LinkProof
7374
linuxauditd.xml
Linux Auditd
7374
linuxdhcpd.xml
DHCPd
7374
LogAgent.xml
LogAgent for OS400 (Patrick
7410
Townsend Security Solutions)
455
Appendix D: Connector Categories
FileName
Description
Version
LOGbinderSP.xml
LOGbinder for Sharepoint:
7374
Security Log
LOGbinderSP.xml
LOGbinder for Sharepoint:
7374
LOGbinder SP log
lotus8.xml
Lotus Notes and Domino
7374
Server 8
MacOSXcrash.xml
Mac OS X (crashreporter)
7374
MacOSXinstall.xml
Mac OS X (install)
7374
MacOSXmail.xml
Mac OS X (mail)
7374
MacOSXppp.xml
Mac OS X (ppp)
7374
MacOSXsecure.xml
Mac OS X (secure)
7374
MacOSXsystem.xml
Mac OS X (system)
7374
Made2Manage.xml
Made2Manage
7374
McAfeeAccessProtection.xml
McAfee Access Protection
7374
McafeeAccessScanLogReader.xml
McAfee On Access Scan v7.0
7374
McafeeActivityLog.xml
McAfee Activity Log (4.5 DAT
7374
file update)
mcafeeemailgateway.xml
McAfee Email Gateway
7374
McAfeeMailScan.xml
McAfee Mail Scan
7374
McAfeeNetShield.xml
McAfee NetShield
7374
McAfeeTotalProtection.xml
McAfee Total Protection
7374
McAfeeUpdateLogReader.xml
McAfee Update v7.0
7374
456
Appendix D: Connector Categories
FileName
Description
Version
McAfeeVSCLogReader.xml
McAfee VSC
7374
McafeeVSHHomeReader.xml
McAfee VSH Home
7374
McAfeeVSHLogReader.xml
McAfee VSH 5.0/7.0
7374
McAfeeVSHOnDemandReader.xml
McAfee VSH 85i
7374
McAfeeVSHOnDemandReader.xml
McAfee VSH 80i
7374
McAfeeWebEmail.xml
McAfee Web Email Scan
7374
mcafeewebgateway6x.xml
McAfee Web Gateway v6.x
7374
meditech.xml
Meditech
7374
meditechemraccess.xml
Meditech EMR Access Log
7374
motorola_wlancontroller.xml
Motorola WLAN Controller
7374
moveit.xml
MOVEit Log
7444
moveit.xml
MOVEit Windows Application
7444
Log
msexchange.xml
Microsoft Exchange Event Log
7411
msexchange.xml
Microsoft Exchange Applic-
7411
ation Log
msrras.xml
Microsoft RRAS
7374
mssecessentials.xml
Microsoft Security Essentials
7374
mssqlapplicationlog.xml
MSSQL 2000 Application Log
7442
mssqlauditor.xml
SolarWinds Log and Event
7475
Manager MSSQL Auditor
457
Appendix D: Connector Categories
FileName
Description
Version
nagios.xml
Nagios
7374
nDepthLogMessage.xml
nDepth Log Storage Message
7374
neoaccelvpn.xml
Neo Accel SSL VPN
7374
NeoterisVPN.xml
Neoteris VPN/Juniper SA
7374
series
NessusdMsgLog.xml
Nessus Message
7374
NessusdReport.xml
Nessus XML Report
7374
NessusdReport.xml
Nessus Report
7374
nessusnbe.xml
Nessus Security Scanner NBE
7374
Report
netaccess.xml
Net Access
7374
netfilter.xml
iptables / netfilter
7374
netgearFV.xml
Netgear FV Series
7374
netgearsslvpn.xml
Netgear SSL VPN Con-
7374
centrator SSL312
netgearswitch.xml
Netgear Switch
7374
netilla.xml
Netilla VPN
7419
netiqdra.xml
NetIQ Directory and Resource
7374
Administrator
Netscreen.xml
Netscreen
7374
netscreen5.xml
Juniper/NetScreen 5
7491
netvanta.xml
Adtran NetVanta Router
7374
458
Appendix D: Connector Categories
FileName
Description
Version
netware65.xml
Novell Netware 6.5
7374
netware65.xml
Novell Netware 6.5 File
7374
netware4153.xml
Novell Netware 4.1 - 5.3
7374
NetwareDB.xml
Novell Netware 6.5 (Database)
7374
networkbox.xml
Network Box RM300 and
7374
ITPE1000
nitroips.xml
NitroSecurity IPS
7374
NitroIPSsnort.xml
NitroGuard IPS - Snort Format
7374
NOD32DB.xml
NOD32 Antivirus 4 Access
7374
Threat
NOD32DB.xml
NOD32 Antivirus 4 Access
7374
Scan
NOD32DB.xml
NOD32 Antivirus 4 Access
7374
Event
NOD32DB.xml
NOD32 Antivirus 4 SQL Threat
7374
NOD32DB.xml
NOD32 Antivirus 4 SQL Scan
7374
NOD32DB.xml
NOD32 Antivirus 4 SQL Event
7374
nortel200series.xml
Nortel Contivity 200 Series
7374
nortelalteon.xml
Nortel Alteon
7374
nortelbaystack.xml
Nortel Baystack
7374
nortelcontivity.xml
Nortel Contivity
7374
nortelroutingswitch.xml
Nortel Ethernet Routing Switch
7374
459
Appendix D: Connector Categories
FileName
Description
Version
nortelswitch4500.xml
Nortel Ethernet Routing Switch
7374
4500 Series
nortelwss.xml
Nortel WLAN Security Switch
7374
norton.xml
Symantec Corp Antivirus
7374
novellidentityauditDB.xml
Novell Identity Audit DB
7374
ntapplication.xml
Windows Application Log
7423
ntdns.xml
Windows DNS Server Log
7374
ntds.xml
Windows Directory Service
7428
Log
ntfrs.xml
Windows File Replication Ser-
7374
vice
ntsecurity.xml
Windows NT/2000/XP Secur-
7374
ity Log
ntsystem.xml
Windows System Log
7446
nubridgesprotect.xml
NuBridges Protect Token Man-
7374
ager Engine
nubridgesprotect.xml
NuBridges Protect Resource
7374
Service
nubridgesprotect.xml
NuBridges Protect Key Man-
7374
ager
openbsdftpd.xml
OpenBSD FTPd
7374
OpenEdgeAudit.xml
OpenEdge Audit
7374
openldap.xml
OpenLDAP
7374
460
Appendix D: Connector Categories
FileName
Description
Version
OpenSSH.xml
Open SSH
7374
OpenVMS.xml
HP OpenVMS 8+
7374
Opsec.xml
OPSEC(TM) / Check Point
7374
(TM) NG LEA Client
oracledatabase.xml
Oracle Auditor - Database
7374
oraclesyslog.xml
Oracle Auditor - Syslog
7374
oraclewindows.xml
Oracle Auditor - Windows
7441
OsirisHIMS.xml
Osiris Host Integrity Monitoring
7374
System
paloaltofirewall.xml
Palo Alto Networks PA-2000
7463
Series and PA-4000 Series
Firewall
PAM.xml
Linux PAM
7418
PandaSecurityForDesktopsDB.xml
Panda Security for Desktops
7374
4.02
PassManPro.xml
ManageEngine Password Man-
7413
ager Pro SNMP
PatchLinkVulnDB.xml
PatchLink Vulnerability
7374
pcanywhere.xml
pcAnywhere
7374
permeo.xml
Permeo VPN
7374
pointsecpc.xml
PointSec PC
7374
postfix.xml
Postfix
7374
proftpdaccess.xml
ProFTPD Access
7374
461
Appendix D: Connector Categories
FileName
Description
Version
proftpdauth.xml
ProFTPD Auth
7374
proximorinoco.xml
Proxim Orinoco WAP
7374
ptechinteract.xml
PowerTech Interact
7374
pureftpd.xml
Pure-FTPd
7374
qualysguard.xml
QualysGuard Scan Report
7374
radwareappdirector.xml
Radware AppDirector
7374
RaritanDominion.xml
Raritan Dominion Switch
7374
refleximc.xml
Reflex IMC
7374
RemotelyAnywhere.xml
RemotelyAnywhere / LogMeIn
7374
RetinaStatusLog.xml
Retina
7374
rsaauthmanager71.xml
RSA Authentication Manager
7374
7.1
safeatoffice.xml
Checkpoint Safe@Office Fire-
7374
wall
safeword.xml
SafeNet SafeWord
7374
samba.xml
Samba
7374
SanDiskCMC.xml
SanDisk CMC
7374
savantprotection.xml
Savant Protection
7374
SecureNet.xml
SecureNet IDS
7380
securespheredb.xml
SecureSphere Database Gate-
7374
way 6.0
462
Appendix D: Connector Categories
FileName
Description
Version
securespheresystem.xml
SecureSphere System and
7374
Firewall Events 6.0
securesphereweb.xml
SecureSphere Web Applic-
7374
ation Firewall 6.0
securid.xml
SecurID
7374
securidsyslog.xml
SecurID Syslog
7374
selinux.xml
SELinux
7374
sendmail.xml
Linux Sendmail
7374
sentriant.xml
Extreme Sentriant
7374
servuftp.xml
Serv-U FTP Server (Never
7374
Rotate)
servuftp.xml
Serv-U FTP Server
7374
Sidewinder.xml
Sidewinder Firewall
7374
sidewinder61.xml
Sidewinder 6.1+ Firewall
7401
SmoothWallUTM.xml
SmoothWall Unified Threat
7433
Manager
snmpdmessages.xml
smnpd daemon messages
7374
snort.xml
FortiSnort
7440
snort.xml
Snort
7440
snort.xml
SyslogSnort
7440
solarisbsm.xml
Solaris 10 BSM Auditing
7374
solarissnare.xml
Solaris 8 and 9 Snare Auditing
7374
463
Appendix D: Connector Categories
FileName
Description
Version
solarissnare.xml
Solaris 10 Snare Auditing
7374
sonicsslvpn.xml
SonicWALL SSL VPN
7391
sonicwall.xml
SonicWall
7465
sonicwalles.xml
Sonicwall Email Security
7374
sonicwallgmsdb.xml
SonicWall GMS
7374
Sophos.xml
Sophos Anti-Virus for Win2k
7374
SophosDB.xml
Sophos Enterprise 3.0 Data-
7374
base
SophosDB.xml
Sophos Enterprise 2.0 Data-
7374
base
sophoses.xml
Sophos ES appliance auth
7374
sophoses.xml
Sophos ES appliance
7374
SophosSNMP.xml
Sophos Anti-Virus SNMP
7439
sophosws.xml
Sophos WS appliance
7374
SquidAccessLog.xml
Squid Access Log
7374
SquidGuardAccessBlock.xml
SquidGuard Access Block Log
7374
stonegatefirewall.xml
StoneGate Firewall v5.3 CEF
7374
sudolog.xml
sudo syslog
7374
sudolog.xml
sudo
7374
SW_Orion.xml
SolarWinds Orion and Vir-
7380
tualization Manager
464
Appendix D: Connector Categories
FileName
Description
Version
sybari.xml
Sybari's Antigen 7.0 for
7374
Exchange Server 2000
symantecep.xml
Symantec Endpoint Protection
7445
11
SymantecGatewayIDS.xml
Symantec Gateway IDS
7374
symantecwebsec.xml
Symantec Web Security for
7374
Windows
symmetricomsyncserver.xml
Symmetricom SyncServer
7419
thycoticsecretserver.xml
Thycotic Secret Server
7374
timirror.xml
Titanium Mirror Firewall
7374
tippingpoint.xml
Tippingpoint IPS 1.4
7374
tippingpoint.xml
Tippingpoint IPS 2.1
7374
tippingpoint.xml
Tippingpoint SMS
7374
tippingpoint_audit_system.xml
TippingPoint Audit and System
7374
tippingpointxseries.xml
Tippingpoint X505
7374
toplayer.xml
TopLayer Attack Mitigator
7374
trendDeepSecurity.xml
Trend Deep Security
7374
trendimss.xml
Trend IMSS
7374
trendimssemgr.xml
Trend IMSS Policy
7374
trendimssvirus.xml
Trend IMSS Virus
7374
trendInterScan.xml
Trend InterScan
7374
465
Appendix D: Connector Categories
FileName
Description
Version
trendmicroigsa.xml
Trend Micro Interscan Gate-
7374
way Security Appliance
trendOfficeScan.xml
Trend Office Scan
7374
trendScanMail.xml
Trend ScanMail
7374
trendServerProtect.xml
Trend Server Protect
7374
tricipher.xml
TriCipher
7374
tw_enterprise.xml
Tripwire Enterprise
7374
ultravnc.xml
Ultra VNC
7374
Velociraptor.xml
Symantec Velociraptor 1.5
7374
velociraptor20.xml
Symantec Velociraptor 2.0
7374
velociraptor30.xml
Symantec Velociraptor 3.0
7374
vericeptmonitor.xml
Vericept Monitor
7374
VIPREBusiness.xml
VIPRE 5.0
7374
VIPREBusiness.xml
VIPRE Business - System
7374
Events 4.0
VIPREBusiness.xml
VIPRE Business 4.0
7374
VIPREEnterpriseDB.xml
VIPRE Enterprise 3.1
7374
visneticfirewall.xml
VisNetic Firewall
7374
vistasecurity.xml
Windows 7/2008/Vista Secur-
7449
ity Log
vormetric.xml
Vormetric
466
7374
Appendix D: Connector Categories
FileName
Description
Version
vsftpxfer.xml
vsftpd xferlog
7374
WatchguardFirewalls.xml
WatchGuard firewalls
7420
WebrootAntispywareCorpEdDB.xml
Webroot Antispyware Cor-
7374
porate Edition 3.5
websense.xml
Websense Web Filter and Web- 7434
sense Web Security
websenseDB.xml
Websense Web Filter and Web- 7435
sense Web Security Database
websenseds.xml
Websense Data Security
7435
WgFirebox.xml
WatchGuard Firebox
7429
WgSoho.xml
WatchGuard SOHO
7429
WgVclass.xml
WatchGuard Vclass
7374
WgVclassAlarm.xml
WatchGuard Vclass (Alarm)
7374
WgVclassVpn.xml
WatchGuard Vclass (VPN)
7374
WgXcore.xml
WatchGuard Xcore
7429
WgXCSauth.xml
WatchGuard Extensible Con-
7374
tent Security (XCS) auth log
WgXCSsyslog.xml
WatchGuard Extensible Con-
7374
tent Security (XCS) syslog
WgXedge.xml
WatchGuard Firebox X Edge
7429
E-Series
WindowsDHCPServer.xml
Windows DHCP Server 2003
7374
WindowsDHCPServer.xml
Windows DHCP Server 2000
7374
467
Appendix D: Connector Categories
FileName
Description
Version
WindowsDHCPSystem.xml
Windows DHCP Server
7374
2000/2003/2008 System Log
WindowsDNSTraffic.xml
Windows DNS Traffic Log
7374
windowsfirewall.xml
Windows Firewall
7374
WRGHostGateway.xml
Wescom Resources Group's
7374
Host Gateway Windows Log
wsftpserver.xml
WS_FTP Server Corporate
7374
xirruswifiarray.xml
Xirrus WiFi Array
7374
468
Appendix E: CMC Commands
CMC commands are the only means to access LEM and nDepth Appliances. Use CMC to upgrade
and maintain the appliances.
You can use the CMC commands for such tasks as:
l
upgrading the Manager software
l
deploying new connector infrastructure to the Managers and Agents
l
rebooting or shutting down the network appliance
l
configuring trusted reporting hosts
l
configuring supplemental services on the Manager appliance, and
l
controlling your nDepth appliances.
The following topics describe how to log on to CMC and describe each command found in the
appliance, manager, service and ind menus.
Logging on to CMC
To log on to CMC:
1. Connect to the Network Appliance either of two ways:
l
Connect directly to the Network Appliance with a keyboard and monitor.
If you connect in this manner, skip to Step 7.
l
Connect using SSH on port 32022.
SSH stands for Secure Shell, which is a remote administration connector. To connect
to the network appliance using SSH, you can use PuTTY, which is a free SSH tool. For
more information on this too, see the SolarWinds Knowledge Base.
The following example shows the PuTTY Configuration form with the default
Manager settings.
469
Appendix E: CMC Commands
2. In the Host Name (or IP address) box, type the IP address of your Manager (in this
example, the IP address is 10.1.1.200).
3. Under Protocol, click SSH.
4. In the Port box, type 32022.
5. So you don’t have to do this again, type Manager into the Saved Sessions box, and
then click Save.
6. Click Open.
Note: To reopen this connection for future sessions, double-click Manager in the
Saved Session box. The connection will reopen
7. Whether you connect remotely or physically, the system will prompt you for your CMC
user name and password.
470
Using the CMC 'appliance' Menu
Using the CMC 'appliance' Menu
After typing the appliance command, the cmc::acm# prompt appears. You may then use any of the
commands listed in the following table.
The commands are listed in alphabetical order. Command descriptions with an asterisk (*) mean the
command requires an automatic restart of the Manager service.
Command
Description
activate
Activates appliance features after activating LEM.
checklogs
Shows the contents of the virtual appliance’s log files from sources such as syslog and SNMP.
cleantemp
Removes temporary files created by the virtual appliance during normal operation.
You may run this command to recover used disk space, or at the suggestion of
SolarWinds Support.
clearsyslog
Removes all rotated and compressed localN files.
dateconfig
Sets/shows the virtual appliance’s date and time.
demote
Demotes the appliance to a secondary appliance in a high availability or disaster
recovery configuration. The demoted appliance will disable running LEM services
and resume replicating its configuration information from the configured primary
appliance.
diskusage
Checks and provides a summary of disk usage for your virtual appliance and several of the internal components (such as the database or log files). This information is included when you send SolarWinds Support information using the
support command.
editbanner
Edits the SSH login banner.
exit
Exits the Appliance menu and returns to the main menu.
exportsyslog
Exports the System Logs.
help
Shows the Help menu
471
Appendix E: CMC Commands
Command
Description
hostname
Changes the virtual appliance’s hostname.
limitsyslog
Interrogates and/or changes the number of rotated log files to be kept.
netconfig
Configures network parameters for the appliance, such as the IP address, subnet
mask and DNS server(s).
ntpconfig
Configures the Network Time Protocol (NTP) service on the virtual appliance for
synchronization with a time server.
password
Changes the CMC user password.
ping
Pings other IP addresses or host names from the virtual appliance to verify network connectivity.
promote
Promotes the appliance to the primary appliance in a high availability or disaster
recovery configuration. The promoted appliance will take over LEM services until
it is demoted with the demote command.
reboot
Reboots the virtual appliance.
setlogrotate
Defines the syslog rotation frequency (hourly, daily
shutdown
Shuts down the virtual appliance.
top
Displays and monitors CPU and memory usage, as well as per process information for the Manager Network Appliance.
tzconfig
Configure the virtual appliance's time zone information.
viewnetconfig
Displays the current network configuration parameters for the appliance such as
the IP address, subnet mask and DNS server(s).
Using the CMC 'manager' Menu
After typing the manager command, the cmc::cmm# prompt appears. You may then use any of the
commands listed in the following table. The commands are listed in alphabetical order. Command
descriptions with an asterisk (*) mean the command requires an automatic restart of the Manager
service.
472
Using the CMC 'manager' Menu
Command
Description
actortoolupgrade
* Upgrades the Manager’s Actor Tools from CD or floppy disk.
archiveconfig
Configures the Manager appliance database archives to a remote file share
on a daily, weekly, or monthly schedule.
backupconfig
Configures the Manager appliance software and configuration backups to a
remote file share on a daily, weekly, or monthly schedule.
cleanagentconfig
Reconfigures the Agent on this Manager to a new Manager.
configurendepth
Configures the virtual appliance to use an nDepth server
dbquery
Queries the Manager appliance database directly.
debug
Emails the Manager debugging information to any given email address. The
email message contains a collection of data that can be useful in diagnosing
problems.
exit
Return to main CMC menu.
exportcert
Exports the CA certificate for Console.
exportcertrequest
Exports a certificate request for signing by CA.
help
Displays a brief description of each command.
importcenter
* Imports a certificate used for Console communication.
logbackupconfig
Configures the Manager appliance remote log backups to a remote file share
on a daily, weekly, or monthly schedule.
resetadmin
* Resets the admin password to "password". This command does not affect
other users on the system and all settings are preserved.
restart
* Restarts the Manager service. This will take the Manager offline for 1–3
minutes.
sensortoolupgrade Upgrades the Manager’s Sensor Tools from a CD or floppy disk.
showlog
Allows you to page through the Manager’s log file.
showmanagermem Displays the Manager's configured memory utilization settings.
473
Appendix E: CMC Commands
Command
start
Description
Starts the Manager service. If the Manager is already started, then nothing
will happen.
stop
* Stops the Manager service. This makes the Manager inactive until it is
started again.
support
Sends debugging information via email to [email protected]. This
command prompts you for your name and email address. It then sends
SolarWinds a collection of data that can be useful in diagnosing problems.
viewsysinfo
Displays appliance settings and information, useful for support and
troubleshooting.
watchlog
Displays 20 lines of the current Manager log file and monitors the log for
further updates. Any new log entries appear as they are written to the log.
Using the CMC 'ndepth' menu
If you have one or more nDepth appliances, CMC has an ind menu that lets you control these
appliances. After typing the ind command, the cmc::ind# prompt appears. You may then use any of
the commands listed in the following table.
The commands are listed in alphabetical order. Command descriptions with an asterisk (*) mean the
command requires an automatic restart of the Manager service.
Command
Description
exit
Exits the nDepth menu and returns to the main menu.
help
Shows the help menu.
logmarchiveconfig
Sets Log Message archive share settings.
logmbackupconfig
Sets Log Message backup share settings.
restart
* Restarts the Log Message search/storage service.
start
Starts the Log Message search/storage service.
stop
Stops the Log Message search/storage service.
474
Using the CMC 'service' Menu
Using the CMC 'service' Menu
After typing the service command, the cmc::scm# prompt appears. You may then use any of the
commands listed in the following table.
The commands are listed in alphabetical order. Command descriptions with an asterisk (*) mean the
command requires an automatic restart of the Manager service.
Command
copysnortrules
Description
Copy the existing Snort rules from the Manager onto a floppy disk or network
file share. This allows you to retrieve the Snort rules from the Manager’s hard
drive and make any rule updates or modifications. This requires a formatted
floppy disk or a network file share.
disableflow
Disables NetFlow/sFlow collection on the SolarWinds Appliance (and in the
SolarWinds Explorer).
disablesnmp
Disables SNMP trap logging to the Manager. The SNMP trap logging service
will be permanently disabled until the enablesnmp command is issued.
enableflow
* Enables NetFlow/sFlow collection on the SolarWinds Appliance (and in the
Explorer).
enablesnmp
Enables SNMP trap logging to the Manager. By default, SNMP is disabled on
the Manager. This command enables SNMP to allow integration with some
security tools that can only log using SNMP.
exit
Returns to the main CMC menu.
getflowdbsize
Checks the size of the Flow database.
help
Displays a brief description of each command within the service menu.
loadsnortbackup Loads Snort rules from “factory default” on the Manager. This allows you to
revert to the Snort rules’ original default settings in case of an error. This
command overwrites any changes that were made to the main set of rules with
the original rules that were installed with the SolarWinds system.
475
Appendix E: CMC Commands
Command
loadsnortrules
Description
Loads Snort rules from a floppy disk or a network file share to the Manager.
This allows you to update the Snort rules on the Manager. The floppy disk
must be in the same format (i.e., the same names and directories) that the
copysnortrules command uses to issue the original rules; otherwise, the rules
will not be updated.
restartsnort
Restarts the Snort service.
restartssh
Restarts the SSH service. If the SSH service is running, this command stops
and then restarts the service.
restrictconsole
Restricts access to the Console’s graphical user interface to only certain IP
addresses or hostnames. This command prompts you to provide the allowable
IP addresses or hostnames. Once the restriction is in place, only the given IP
addresses/hostnames are able to connect to the Console. Users are still
required to log in with a password to fully access the Console.
restrictreports
Restricts access to reports to only certain IP addresses or hostnames. This
command prompts you to provide the allowable IP addresses or hostnames.
Once the restriction is in place, only the given IP addresses/hostnames are
able to create and view reports.
restrictssh
Restrict the SSH service to only certain IP addresses. This command prompts
you to provide the allowable IP addresses. Once the restriction is done, only
the given IP address/user combinations will be able to connect to the Manager
using the SSH service.
startssh
Start running the SSH service.
stopopsec
Terminate any connections from the Manager Appliance to Check Point®
OPSEC™ hosts.
stopssh
Stops running the SSH service. If you issue this command, you can only
access the Manager with a keyboard and monitor until you issue a reboot
command.
To restrict access to the SSH service (outside of the user name and password
requirements), see the restrictssh command.
476
Using the CMC 'service' Menu
Command
Description
unrestrictconsole Removes restrictions to the Console’s graphical user interface. This command
removes all restrictions and allows any valid system user to connect to the
Console. The only protection at this point is the user name and password
combination.
unrestrictreports
Removes restrictions on access to reports. This command removes all
restrictions and allows anyone with the Reports Console, or any alternative
database connection software, with the proper username and password, to
create and view reports and browse the database.
unrestrictssh
Removes restrictions to the SSH service. Any connection attempts will still
require a user name and password.
477
Appendix F: Report Tables
The following tables list all of LEM’s reports, provide descriptions of their contents, and suggest
schedules for running each report.
Table of Audit reports
The following table lists and describes each audit reports. For your convenience, the reports are listed
alphabetically by title.
File
Title
Description
name
Schedule
Authentication
This report lists all authentications tracked by the SolarWinds system,
RPT2003- Weekly
Report
including user logon, logoff, failed logon attempts, guest logons, etc.
02.rpt
Authentication
This report lists event events that are related to authentication and
RPT2003- As needed
Report -
authorization of accounts and account “'containers'” such as groups or
02-10.rpt
Authentication
domains. These events can be produced from any network node including
Audit
firewalls, routers, servers, and clients.
Authentication
This report lists event events that are related to suspicious authentication
RPT2003- As Needed
Report -
and authorization events. These events include excessive failed
02-9.rpt
Suspicious
authentication or authorization attempts, suspicious access to
Authentication
unauthenticated users, and suspicious access to unauthorized services or
information.
Authentication
This report lists the Top User Log On events grouped by user name.
Report - Top
RPT2003- As needed
02-6-2.rpt
User Log On by
User
Authentication
This report lists the Top User Log On Failure events grouped by user name. RPT2003- As needed
Report - Top
02-7-2.rpt
User Log On
Failure by User
Authentication
This report shows logon, logoff, and logon failure activity to the SolarWinds
RPT2003- As needed
Report -
Console.
02-8.rpt
SolarWinds
Authentication
478
Appendix F: Report Tables
File
Title
Description
name
Schedule
Authentication
User Logoff events reflect account logoff events from network devices
RPT2003- As needed
Report - User
(including network infrastructure devices). Each event will reflect the type of
02-5.rpt
Log Off
device from which the user was logging off. These events are usually
normal events but are tracked for consistency and auditing purposes.
Authentication
User Logon events reflect user account logon events from network devices
RPT2003- As needed
Report - User
monitored by SolarWinds (including network infrastructure devices). Each
02-6.rpt
Log On
event will reflect the type of device that the logon was intended for along with
all other relevant fields.
Authentication
This report lists all account logon events, grouped by user name.
Report - User
RPT2003- As needed
02-6-1.rpt
Log On by User
Authentication
User Logon Failure events reflect failed account logon events from network
RPT2003- As needed
Report - User
devices (including network infrastructure devices). Each event will reflect
02-7.rpt
Log On Failure
the point on the network where the user was attempting logon. In larger
quantities, these events may reflect a potential issue with a user or set of
users, but as individual events they are generally not a problem.
Authentication
This report lists all account logon failure events, grouped by user name.
Report - User
RPT2003- As needed
02-7-1.rpt
Log On Failure by
User
Change
This report includes changes to domains, groups, machine accounts, and
RPT2006- As needed
Management -
user accounts.
20.rp
Change
This report includes changes to domains, including new domains, new
RPT2006- As needed
Management -
members, and modifications to domain settings.
20-01.rpt
General
Authentication
Related Events
General
Authentication:
Domain Events
479
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report lists changes to domain type. These events are uncommon and
RPT2006- As needed
Management -
usually provided by the operating system. Usually, these changes are made
20-01-
General
by a user account with administrative privileges, but occasionally a change
7.rpt
Authentication:
will happen when local system maintenance activity takes place.
Domain Events Change Domain
Attribute
Change
This report lists event events that occur when an account or account
RPT2006- As needed
Management -
container within a domain is modified. Usually, these changes are made by
20-01-
General
a user account with administrative privileges, but occasionally an event
4.rpt
Authentication:
occurs when local system maintenance activity takes place. Events of this
Domain Events -
nature mean a user, machine, or service account within the domain has
Change Domain
been modified.
Member
Change
This report lists event events that occur upon removal of a trust relationship
RPT2006- As needed
Management -
between domains, deletion of a subdomain, or deletion of account
20-01-
General
containers within a domain. Usually, these changes are made by a user
8.rpt
Authentication:
account with administrative privileges.
Domain Events Delete Domain
Change
This report lists event events that occur when an account or account
RPT2006- As needed
Management -
container has been removed from a domain. Usually, these changes are
20-01-
General
made by a user account with administrative privileges, but occasionally they
3.rpt
Authentication:
occur when local system maintenance activity takes place.
Domain Events Delete Domain
Member
Change
This report lists event events that happen when the alias for a domain
RPT2006- As needed
Management -
member has been changed. This means an account or account container
20-01-
General
within a domain has an alias created, deleted, or otherwise modified. This
5.rpt
Authentication:
event is uncommon and is used to track links between domain members
Domain Events -
and other locations in the domain where the member may appear.
Domain Member
Alias
480
Appendix F: Report Tables
File
Title
Description
name
Schedule
Change
This report lists authentication, authorization, and modification events that
RPT2006- As needed
Management -
are related only to domains, subdomains, and account containers. These
20-01-
General
events are normally related to operating systems. However, they can be
1.rpt
Authentication:
produced by any network device.
Domain Events DomainAuthAudit
Change
This report lists event events that occur upon creation of a new trust
RPT2006- As needed
Management -
relationship between domains, creation of a new subdomain, or creation of
20-01-
General
new account containers within a domain. Usually, these creations are done
6.rpt
Authentication:
by a user account with administrative privileges.
Domain Events New Domain
Change
This report lists event events that occur when an account or an account
RPT2006- As needed
Management -
container (a new user, machine, or service account) has been added to the
20-01-
General
domain. Usually, these additions are made by a user account with
2.rpt
Authentication:
administrative privileges, but occasionally they occur when local system
Domain Events -
maintenance activity takes place.
New Domain
Member
Change
This report lists changes to groups, including new groups, members
RPT2006- As needed
Management -
added/removed to/from groups, and modifications to group settings.
20-02.rpt
Change
This report lists event events that occur when a group type is modified.
RPT2006- As needed
Management -
Usually, these changes are made by a user account with administrative
20-02-
General
privileges, but occasionally a they occur when local system maintenance
6.rpt
Authentication:
activity takes place.
General
Authentication:
Group Events
Group Events Change Group
Attribute
Change
This report lists event events that occur upon deletion of a new group of any
RPT2006- As needed
Management -
type. Usually, these additions are made by a user account with
20-02-
General
administrative privileges.
5.rpt
Authentication:
Group Events Delete Group
481
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report lists event events that occur when an account or group has been RPT2006- As needed
Management -
removed from a group. Usually, these changes are made by a user account
20-02-
General
with administrative privileges, but occasionally they occur when local system
3.rpt
Authentication:
maintenance activity takes place.
Group Events Delete Group
Member
Change
This report lists authentication, authorization, and modification events
RPT2006- As needed
Management -
related only to account groups. These events are normally operating
20-02-
General
system related, however could be produced by any network device.
1.rpt
Change
This report lists NewGroup events. These events occur upon creation of a
RPT2006- As needed
Management -
new group of any type. Usually, these additions are made by a user account
20-02-
General
with administrative privileges.
4.rpt
Change
This report lists NewGroupMember events. These events occur when an
RPT2006- As needed
Management -
account (or other group) has been added to a group. Usually, these
20-02-
General
additions are made by a user account with administrative privileges, but
2.rpt
Authentication:
occasionally an event will occur when local system maintenance activity
Group Events -
takes place. A new user, machine, or service account has been added to the
New Group
group.
Authentication:
Group Events Group Audit
Authentication:
Group Events New Group
Member
Change
This report includes changes to machine accounts, including
RPT2006- As needed
Management -
enabling/disabling machine accounts and modifications to machine account
20-03.rpt
General
settings.
Authentication:
Machine Account
Events
482
Appendix F: Report Tables
File
Title
Description
name
Schedule
Change
This report lists MachineDisable events. These events occur when a
RPT2006- As needed
Management -
machine account is actively disabled and/or when an account is forcibly
20-03-
General
locked out by the operating system or other authentication tool. These
3.rpt
Authentication:
events are usually operating system related and could reflect a potential
Machine Account
issue with a computer or set of computers.
Events - Machine
Disabled
Change
This report lists MachineEnable events, which reflect the action of enabling
RPT2006- As needed
Management -
a computer or machine account. These events are normally related to the
20-03-
General
operating system, and will trigger when a machine is “enabled,” normally by
1.rpt
Authentication:
a user with administrative privileges.
Machine Account
Events - Machine
Enabled
Change
This report lists MachineModifyAttribute events, which occur when a
RPT2006- As needed
Management -
computer or machine type is changed. These events are uncommon and
20-03-
General
usually provided by the operating system.
2.rpt
Change
This report includes changes to user accounts, including enabling/disabling
RPT2006- As needed
Management -
user accounts and modifications to user account settings.
20-04.rpt
Change
This report lists UserDisable events. These events occur when a user
RPT2006- As needed
Management -
account is actively disabled and/or when a user is forcibly locked out by the
20-04-
General
operating system or other authentication tool. These events are usually
3.rpt
Authentication:
related to the operating system and can reflect a potential issue with a user
User Account
or set of users.
Authentication:
Machine Account
Events - Machine
Modify Attribute
General
Authentication:
User Account
Events
Events - User
Disabled
483
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report lists UserEnable events, which reflect the action of enabling a
RPT2006- As needed
Management -
user account. These events are normally related to the operating system .
20-04-
General
They occur both when an account is “'unlocked'” after lockout due to
1.rpt
Authentication:
unsuccessful logons, and when an account is “enabled” in the traditional
User Account
sense.
Events - User
Enabled
Change
This report lists UserModifyAttribute events that occur when a user type is
RPT2006- As needed
Management -
changed. These events are uncommon and usually provided by the
20-04-
General
operating system.
2.rpt
Change
This report includes accesses to network infrastructure device policy,
RPT2006- As needed
Management -
including viewing or changing device policy.
21.rpt
This report includes creations of Windows/Active Directory groups.
RPT2006- As needed
Authentication:
User Account
Events - User
Modify Attributes
Network
Infrastructure:
Policy/View
Change
Change
Management -
22-01.rpt
Windows/Active
Directory
Domains: Group
Created
Change
This report includes deletions of Windows/Active Directory groups.
Management -
RPT2006- As needed
22-02.rpt
Windows/Active
Directory
Domains: Group
Deleted
Change
This report includes Windows/Active Directory group-related events.
Management -
RPT2006- As needed
22.rpt
Windows/Active
Directory
Domains: Group
Events
484
Appendix F: Report Tables
File
Title
Description
name
Schedule
Change
This report includes changes to Windows/Active Directory group properties, RPT2006- As needed
Management -
such as the display name.
22-03.rpt
This report includes Windows/Active Directory machine-related events.
RPT2006- As needed
Windows/Active
Directory
Domains: Group
Property
Updated
Change
Management -
23.rpt
Windows/Active
Directory
Domains:
Machine Events
Change
This report includes creations of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts.
23-01.rpt
Change
This report includes deletions of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts.
23-02.rpt
Change
This report includes disables of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts.
23-03.rpt
Windows/Active
Directory
Domains:
Machine Events Account Created
Windows/Active
Directory
Domains:
Machine Events Account Deleted
Windows/Active
Directory
Domains:
Machine Events Account Disabled
485
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report includes enables of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts.
23-04.rpt
Change
This report includes changes to Windows/Active Directory machine account
RPT2006- As needed
Management -
properties, such as the display name.
23-05.rpt
Change
This report includes additions of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts to groups.
23-06.rpt
Change
This report includes additions of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts to Organizational Units.
23-07.rpt
Change
This report includes removals of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts from groups.
23-08.rpt
Windows/Active
Directory
Domains:
Machine Events Account Enabled
Windows/Active
Directory
Domains:
Machine Events Account
Properties
Update
Windows/Active
Directory
Domains:
Machine Events Added To Group
Windows/Active
Directory
Domains:
Machine Events Added To OU
Windows/Active
Directory
Domains:
Machine Events Removed From
Group
486
Appendix F: Report Tables
File
Title
Description
name
Schedule
Change
This report includes removals of Windows/Active Directory machine
RPT2006- As needed
Management -
accounts from Organizational Units.
23-09.rpt
Change
This report includes additions of Windows/Active Directory user accounts to
RPT2006- As needed
Management -
critical groups, such as Domain or Enterprise Admins.
22-04.rpt
Change
This report includes Windows/Active Directory Organizational Unit-related
RPT2006- As needed
Management -
events.
24.rpt
Change
This report includes creation of Windows/Active Directory Organizational
RPT2006- As needed
Management -
Units.
24-01.rpt
Change
This report includes deletion of Windows/Active Directory Organizational
RPT2006- As needed
Management -
Units.
24-02.rpt
Windows/Active
Directory
Domains:
Machine Events Removed From
OU
Windows/Active
Directory
Domains: New
Critical Group
Members
Windows/Active
Directory
Domains: OU
Events
Windows/Active
Directory
Domains: OU
Events - OU
Created
Windows/Active
Directory
Domains: OU
Events - OU
Deleted
487
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report includes updates to Windows/Active Directory Organizational
RPT2006- As needed
Management -
Unit properties, such as the display name.
24-03.rpt
This report includes Windows/Active Directory user-related events.
RPT2006- As needed
Windows/Active
Directory
Domains: OU
Events - OU
Properties
Update
Change
Management -
25.rpt
Windows/Active
Directory
Domains: User
Events
Change
This report includes creations of Windows/Active Directory user accounts.
Management -
RPT2006- As needed
25-01.rpt
Windows/Active
Directory
Domains: User
Events - Account
Created
Change
This report includes deletions of Windows/Active Directory user accounts.
Management -
RPT2006- As needed
25-02.rpt
Windows/Active
Directory
Domains: User
Events - Account
Deleted
Change
This report includes disables of Windows/Active Directory user accounts.
Management -
RPT2006- As needed
25-03.rpt
Windows/Active
Directory
Domains: User
Events - Account
Disabled
488
Appendix F: Report Tables
File
Title
Change
Description
This report includes enables of Windows/Active Directory user accounts.
Management -
name
Schedule
RPT2006- As needed
25-04.rpt
Windows/Active
Directory
Domains: User
Events - Account
Enabled
Change
This report includes user-driven disables of Windows/Active Directory user
RPT2006- As needed
Management -
accounts, such as a user triggering an excessive failed password limit.
25-05.rpt
Change
This report includes changes to Windows/Active Directory user account
RPT2006- As needed
Management -
properties, such as the display name.
25-06.rpt
Change
This report includes additions of Windows/Active Directory user accounts to
RPT2006- As needed
Management -
groups.
25-07.rpt
Change
This report includes additions of Windows/Active Directory user accounts to
RPT2006- As needed
Management -
Organizational Units.
25-08.rpt
Windows/Active
Directory
Domains: User
Events - Account
Lockout
Windows/Active
Directory
Domains: User
Events - Account
Properties
Updated
Windows/Active
Directory
Domains: User
Events - Added
To Group
Windows/Active
Directory
Domains: User
Events - Added
To OU
489
Table of Audit reports
File
Title
Description
name
Schedule
Change
This report includes removals of Windows/Active Directory user accounts
RPT2006- As needed
Management -
from groups.
25-09.rpt
Change
This report includes removals of Windows/Active Directory user accounts
RPT2006- As needed
Management -
from Organizational Units.
25-10.rpt
This report tracks file system activity associated with audited files and
RPT2003- Weekly
system objects, such as file access successes and failures.
05.rpt
Windows/Active
Directory
Domains: User
Events Removed From
Group
Windows/Active
Directory
Domains: User
Events Removed From
OU
File Audit Events
File Audit Events - File Attribute Change is a specific File Write event generated for the
RPT2003- As needed
File Attribute
modification of file attributes (including properties such as read-only status).
05-41.rpt
Change
These events may be produced by any tool that is used to monitor the
activity of file usage, including a Host-Based IDS and some Operating
Systems.
File Audit Events - File Audit events are used to track file activity on monitored network devices, RPT2003- As needed
File Audit
usually through the Operating System or a Host-Based IDS. These events
05-11.rpt
will note success or failure of the requested operation.
File Audit Events - File Audit Failure events are used to track failed file activity on monitored
RPT2003- As needed
File Audit Failure
05-12.rpt
network devices, usually through the Operating System or a Host-Based
IDS. These events will note what requested operation failed.
File Audit Events - File Create is a specific File Write event generated for the initial creation of a
RPT2003- As needed
File Create
05-42.rpt
file. These events may be produced by any tool that is used to monitor the
activity of file usage, including a Host-Based IDS and some Operating
Systems.
490
Appendix F: Report Tables
File
Title
Description
name
Schedule
File Audit Events - File Data Read is a specific File Read event generated for the operation of
RPT2003- As needed
File Data Read
05-31.rpt
reading data from a file (not just properties or status of a file). These events
may be produced by any tool that is used to monitor the activity of file usage,
including a Host-Based IDS and some Operating Systems.
File Audit Events - File Data Write is a specific File Write event generated for the operation of
File Data Write
RPT2003- As needed
writing data to a file (not just properties or status of a file). These events may 05-43.rpt
be produced by any tool that is used to monitor the activity of file usage,
including a Host-Based IDS and some Operating Systems.
File Audit Events - File Delete is a specific File Write event generated for the deletion of an
RPT2003- As needed
File Delete
05-44.rpt
existing file. These events may be produced by any tool that is used to
monitor the activity of file usage, including a Host-Based IDS and some
Operating Systems.
File Audit Events - File Execute is a specific File Read event generated for the operation of
RPT2003- As needed
File Execute
05-32.rpt
executing files. These events may be produced by any tool that is used to
monitor the activity of file usage, including a Host-Based IDS and some
Operating Systems.
File Audit Events - File Handle Audit events are used to track file handle activity on monitored
RPT2003- As needed
File Handle Audit
05-21.rpt
network devices, usually through low level access to the Operating System,
either natively or with or a Host-Based IDS. These events will note success
or failure of the requested operation.
File Audit Events - File Handle Close is a specific File Handle Audit event generated for the
RPT2003- As needed
File Handle Close closing of file handles. These events may be generated by a tool that has
05-22.rpt
low-level file access, such as an Operating System or some Host-Based
IDS'.
File Audit Events - File Handle Copy is a specific File Handle Audit event generated for the
RPT2003- As needed
File Handle Copy
05-23.rpt
copying of file handles. These events may be generated by a tool that has
low-level file access, such as an Operating System or some Host-Based
IDS'.
File Audit Events - File Handle Open is a specific File Handle Audit event generated for the
RPT2003- As needed
File Handle Open
05-24.rpt
opening of file handles. These events may be generated by a tool that has
low-level file access, such as an Operating System or some Host-Based
IDS'.
File Audit Events - File Link is a specific File Write event generated for the creation, deletion, or
RPT2003- As needed
File Link
05-45.rpt
modification of links to other files. These events may be produced by any
tool that is used to monitor the activity of file usage, including a Host-Based
IDS and some Operating Systems.
491
Table of Audit reports
File
Title
Description
name
Schedule
File Audit Events - File Move is a specific File Write event generated for the operation of
RPT2003- As needed
File Move
05-46.rpt
moving a file that already exists. These events may be produced by any tool
that is used to monitor the activity of file usage, including a Host-Based IDS
and some Operating Systems.
File Audit Events - File Read is a specific File Audit event generated for the operation of
RPT2003- As needed
File Read
05-33.rpt
reading files (including reading properties of a file or the status of a file).
These events may be produced by any tool that is used to monitor the
activity of file usage, including a Host-Based IDS and some Operating
Systems.
File Audit Events - File Write is a specific File Audit event generated for the operation of writing
RPT2003- As needed
File Write
05-47.rpt
to a file (including writing properties of a file or changing the status of a file).
These events may be produced by any tool that is used to monitor the
activity of file usage, including a Host-Based IDS and some operating
systems.
File Audit Events - Object Audit events are used to track special object activity on monitored
RPT2003- As needed
Object Audit
05-51.rpt
network devices, usually through the Operating System or a Host-Based
IDS. Generally, Objects are special types of system resources, such as
registry items or user account databases. These objects may be actual 'files'
on the system, but are not necessarily human readable. These events will
note success or failure of the requested operation.
File Audit Events - Object Audit Failure events are used to track special object activity on
RPT2003- As needed
Object Audit
monitored network devices, usually through the Operating System or a
05-52.rpt
Failure
Host-Based IDS. Generally, Objects are special types of system resources,
such as registry items or user account databases. These objects may be
actual 'files' on the system, but are not necessarily human readable. These
events will note a failure of the requested operation.
File Audit Events - Object Delete is a specific Object Audit event generated for the deletion of
RPT2003- As needed
Object Delete
05-53.rpt
an existing object. These events may be produced by any tool that is used to
monitor the activity of file and object usage, including a Host-Based IDS and
some Operating Systems.
File Audit Events - Object Link is a specific Object Audit event generated for the creation,
RPT2003- As needed
Object Link
05-54.rpt
deletion, or modification of links to other objects. These events may be
produced by any tool that is used to monitor the activity of file and object
usage, including a Host-Based IDS and some Operating Systems.
492
Appendix F: Report Tables
File
Title
Incident Events
Description
name
Schedule
This report tracks the Incident, HostIncident, HybridIncident and
RPT2006- Daily
NetworkIncident events that have been generated to reflect enterprise-
19.rpt
wide issues.
Inferred Events
Inferred Events
This report tracks events that are triggered by correlations built in the
RPT2006- As needed
SolarWinds Rule Builder.
27.rpt
This report tracks events that are triggered by correlations, and orders
RPT2006- As needed
by Inference Rule them by the correlation rule name.
27-01.rpt
Log
Track activity associated with account events such as log on, log off and log
RPT2003- Weekly
On/Off/Failure
on failures. This is a refined version of the Authentication Report that does
03.rpt
not include SolarWinds authentication events. It is more appropriate for
management reports or audit reviews than regular use.
Network Traffic
Track activity associated with network traffic audit events such as TCP, IP
RPT2003- Daily, if
Audit
and UDP events. Specifically, this report tracks regular network traffic
06.rpt
needed
activity, such as encrypted traffic, web traffic, and other forms of UDP, TCP
and ICMP traffic. It gives you both an overview and some details of exactly
what is flowing through your network. This report can be quite large.
Network Traffic
ApplicationTrafficAudit events reflect network traffic that is mostly or all
Audit - Application application-layer data. Events that are children of ApplicationTrafficAudit
Traffic
RPT2003- As needed
06-11.rpt
are also related to application-layer resources. Events placed in the parent
ApplicationTrafficAudit event itself are known to be application-related, but
are not able to be further categorized based on the message provided by
the tool or because they are uncommon and rarely, if ever, imply network
attack potential.
Network Traffic
This report lists all Application Traffic events (such as WebTrafficAudit),
RPT2003- As needed
Audit - Application grouped by destination machine/IP.
06-11-
Traffic by
2.rpt
Destination
Machine
Network Traffic
This report lists all Application Traffic events (such as WebTrafficAudit),
RPT2033- As needed
Audit - Application grouped by provider SID.
06-11-
Traffic by
3.rpt
Provider SID
Network Traffic
This report lists all Application Traffic events (such as WebTrafficAudit),
RPT2003- As needed
Audit - Application grouped by source machine/IP.
06-11-
Traffic by Source
1.rpt
Machine
493
Table of Audit reports
File
Title
Network Traffic
Description
This report lists all Application Traffic events (such as WebTrafficAudit),
name
Schedule
RPT2003- As needed
Audit - Application grouped by the SolarWinds sensor tool alias that reported each event.
06-11-
Traffic by Tool
0.rpt
Alias
Network Traffic
Configuration Traffic Audit events reflect application-layer data related to
RPT2003- As needed
Audit -
configuration of network resources. Included in ConfigurationTrafficAudit
06-02.rpt
Configuration
are protocols such as DHCP, BootP, and SNMP. ConfigurationTrafficAudit
Traffic
events generally indicate normal traffic, however, events of this type could
also be symptoms of misconfiguration, inappropriate usage, attempts to
enumerate or access network devices or services, attempts to access
devices that are configured via these services, or other abnormal traffic.
Network Traffic
CoreTrafficAudit events reflect network traffic sent over core protocols.
RPT2003- As needed
Audit -
Events that are children of CoreTrafficAudit are all related to the TCP, IP,
06-03.rpt
Core Traffic
UDP, and ICMP protocols. Events of this type and its children do not have
any application-layer data. Events placed in the parent CoreTrafficAudit
event itself are known to be a core protocol, but are not able to be further
categorized based on the message provided by the tool.
Network Traffic
This report lists all Core Traffic events (such as TCPTrafficAudit), grouped
RPT2003- As needed
Audit - Core
by destination machine/IP.
06-03-
Traffic by
2.rpt
Destination
Machine
Network Traffic
This report lists all Core Traffic events (such as TCPTrafficAudit), grouped
RPT2003- As needed
Audit - Core
by provider SID.
06-03-
Traffic by
3.rpt
Provider SID
Network Traffic
This report lists all Core Traffic events (such as TCPTrafficAudit), grouped
RPT2003- As needed
Audit - Core
by source machine/IP.
06-03-
Traffic by Source
1.rpt
Network Traffic
This report lists all Core Traffic events (such as TCPTrafficAudit), grouped
RPT2003- As needed
Audit - Core
by the SolarWinds tool sensor alias that reported the event.
06-03-
Traffic by Tool
0.rpt
Alias
494
Appendix F: Report Tables
File
Title
Description
name
Schedule
Network Traffic
Encrypted Traffic Audit events reflect application-layer traffic that has been
RPT2003- As needed
Audit - Encrypted
encrypted and is intended for a secure host. Included in Encrypted Traffic
06-04.rpt
Traffic
Audit are client and server side application events, such as key exchanges,
that normally occur after the low-level session creation and handshaking
have completed.
Network Traffic
Link Control Traffic Audit events are generated for network events related
Audit -
to link level configuration. Link Control Traffic Audit events generally indicate 06-05.rpt
RPT2003- As needed
Link Control
normal traffic, however, events of this type could also be symptoms of
Traffic
misconfiguration at the link level, inappropriate usage, or other abnormal
traffic.
Network Traffic
Members of the Network Audit tree are used to define events centered on
RPT2003- As needed
Audit - Network
usage of network resources/bandwidth.
06-06.rpt
Network Traffic
Point To Point Traffic Audit events reflect application-layer data related to
RPT2003- As needed
Audit -
point-to-point connections between hosts. Included in Point To Point Traffic
06-07.rpt
Point to Point
Audit are encrypted and unencrypted point-to-point traffic.
Traffic
Traffic
Network Traffic
Remote Procedure Traffic Audit events reflect application-layer data
RPT2003- As needed
Audit - Remote
related to remote procedure services. Included in Remote Procedure
06-08.rpt
Procedure Traffic Traffic Audit are the traditional RPC services used to service remote logons
and file shares, and other services which require remote procedure access
to complete authentication, pass data, or otherwise communicate.
RemoteProcedureTrafficAudit events generally indicate normal traffic for
networks that have remote procedure services on their network; however,
events of this type could also be symptoms of inappropriate access,
misconfiguration of the remote procedure services, errors in the remote
procedure calls, or other abnormal traffic.
Network Traffic
Routing Traffic Audit events are generated for network events related to
RPT2003- As needed
Audit - Routing
configuration of network routes, using protocols such as IGMP, IGRP, and
06-09.rpt
Traffic
RIP. RoutingTrafficAudit events generally indicate normal traffic, however,
events of this type could also be symptoms of misconfigured routing,
unintended route configuration, or other abnormal traffic.
Network Traffic
Time Traffic Audit events reflect application-layer data related to network
RPT2003- As needed
Audit -
time configuration. Included in TimeTrafficAudit are protocols such as NTP
06-10.rpt
Time Traffic
and activities, such as detection of client-side network time updates.
495
Table of Audit reports
File
Title
Description
name
Schedule
Network Traffic
This report lists the Top Application Traffic events (such as
RPT2003- As needed
Audit -
WebTrafficAudit), grouped by source machine/IP.
06-01-
Top Application
2.rpt
Traffic by Source
Network Traffic
This report lists the Top Core Traffic events (such as TCPTrafficAudit),
RPT2003- As needed
Audit -
grouped by source machine/IP.
06-03-
Top Core Traffic
2.rpt
by Source
Network Traffic
WebTrafficAudit events reflect application-layer data related to web
RPT2003- As needed
Audit -
services. Included in WebTrafficAudit are client and server web events from
06-01.rpt
Web Traffic
web servers, web applications, content filter related events, and other web
services. WebTrafficAudit events generally indicate normal traffic, however,
events of this type could also be symptoms of inappropriate web usage,
potential abuse of web services, or other abnormal traffic.
Network Traffic
This report lists all WebTrafficAudit events grouped by destination
RPT2003- As needed
Audit - Web
machine/IP.
06-01-
Traffic by
2.rpt
Destination
Machine
Network Traffic
This report lists Web Traffic Audit events grouped by provider SID.
RPT2003- As needed
Audit -
06-01-
Web Traffic by
3.rpt
Provider SID
Network Traffic
This report lists all WebTrafficAudit events grouped by source machine/IP.
RPT2003- As needed
Audit - Web
06-01-
Traffic by Source
1.rpt
Machine
Network Traffic
This report lists Web Traffic Audit events grouped by tool alias.
RPT2003- As needed
Audit -
06-01-
Web Traffic by
0.rpt
Tool Alias
Network Traffic
This report lists the most frequently visited URLs grouped by the requesting
RPT2003- As needed
Audit -
client source machine.
06-01-
Web URL
5.rpt
Requests by
Source Machine
496
Appendix F: Report Tables
File
Title
Description
name
Schedule
Network Traffic
This report shows graphs of the most frequently visited URLs for each client
RPT2003- As needed
Audit -
source machine.
06-01-
Web URL
4.rpt
Requests by
Source Machine Graphs
Resource
The Resource Configuration report details events that relate to
RPT2003- Weekly
Configuration
configuration of user accounts, machine accounts, groups, policies and their 08.rpt
relationships. Items such as domain or group modification, policy changes,
and creation of new network resources.
Resource
Events that are part of the Auth Audit tree are related to authentication and
RPT2003- As needed
Configuration -
authorization of accounts and account ''containers'' such as groups or
08-01.rpt
Authorization
domains. These events can be produced from any network node including
Audit
firewalls, routers, servers, and clients.
Resource
Domain Auth Audit events are authentication, authorization, and
RPT2003- As needed
Configuration -
modification events related only to domains, subdomains, and account
08-02.rpt
Domain
containers. These events are normally operating system related, however
Authorization
could be produced by any network device.
Audit
Resource
Group Audit events are authentication, authorization, and modification
RPT2003- As needed
Configuration -
events related only to account groups. These events are normally operating 08-03.rpt
Group Audit
system related, however could be produced by any network device.
Resource
Machine Auth Audit events are authentication, authorization, and
RPT2003- As needed
Configuration -
modification events related only to computer or machine accounts. These
08-04.rpt
Machine
events can be produced from any network node including firewalls, routers,
Authorization
servers, and clients, but are normally operating system related.
Audit
Resource
Policy Audit events are used to track access, modification, scope change,
RPT2003- As needed
Configuration -
and creation of authentication, domain, account, and account container
08-06.rpt
Policy Audit
policies. Many of these events reflect normal system traffic. Most PolicyAudit
events are provided by the Operating System.
Resource
User Auth Audit events are authentication, authorization, and modification
RPT2003- As needed
Configuration -
events related only to user accounts. These events can be produced from
08-05.rpt
User
any network node including firewalls, routers, servers, and clients.
Authorization
Audit
497
Table of Security reports
Table of Security reports
The following table lists and describes each of the security reports. For your convenience, the reports
are listed alphabetically by title.
File
Title
Description
name
Schedule
Authentication Failed Authentication events occur when a user has made several attempts to
RPT2003- As needed
Report -
authenticate themselves which has continuously failed, or when a logon failure
02-1.rpt
Failed
is serious enough to merit a security event on a single failure.
Authentication
Authentication This report shows logins to various Guest accounts.
RPT2003- As needed
Report -
02-2.rpt
Guest Login
Authentication Restricted Information Attempt events describe a user attempt to access local
RPT2003- As needed
Report -
or remote information that their level of authorization does not allow. These
02-3.rpt
Restricted
events may indicate user attempts to exploit services which they are denied
Information
access to or inappropriate access attempts to information.
Attempt
Authentication Restricted Service Attempt events describe a user attempt to access a local or
RPT2003- As needed
Report -
remote service that their level of authorization does not allow. These events
02-4.rpt
Restricted
may indicate user attempts to exploit services which they are denied access to
Service
or inappropriate access attempts to services.
Attempt
Console
The Console report shows every event that passes through the system in the
RPT2003- As needed
given time interval. It mimics the basic management console view. It does not
10.rpt
contain the same level of field detail, but it is useful to get a quick snapshot of
activity for a period, a lunch hour, for example.This report can be very large, so
you will only want to run for small time intervals, such as hours.
Console -
An overview of all events during the specified time range. Shows graphs of the
RPT2003- As needed
Overview
most common generic event field data from the console report.
10-00.rpt
Event
Event Summary Sub Report - Attack Behavior Statistics
RPT2003- As needed
Summary -
01-02.rpt
Attack
Behavior
Statistics
498
Appendix F: Report Tables
File
Title
Event
Description
name
Event Summary Sub Report - Authorization Audit Statistics
Summary -
Schedule
RPT2003- As needed
01-03.rpt
Authorization
Audit Statistics
Event
The event summary report gathers statistical data from all major event
RPT2003- Daily
Summary -
categories, summarizes it with a one-hour resolution, and presents a quick,
01.rpt
Graphs
graphical overview of activity on your network.
Event
Event Summary Sub Report - Machine Audit Statistics
Summary -
RPT2003- As needed
01-05.rpt
Machine Audit
Statistics
Event
Event Summary Sub Report - Policy Audit Statistics
Summary -
RPT2003- As needed
01-06.rpt
Policy Audit
Statistics
Event
Event Summary Sub Report - Resource Audit Statistics
Summary -
RPT2003- As needed
01-07.rpt
Resource
Audit Statistics
Event
Event Summary Sub Report - Suspicious Behavior Statistics
Summary -
RPT2003- As needed
01-08.rpt
Suspicious
Behavior
Statistics
Event
Event Summary Sub Report - Top Level Statistics
Summary -
RPT2003- As needed
01-01.rpt
Top Level
Statistics
Machine Audit Track activity associated with machine process and service audit events. This
report shows machine-level events such as software installs, patches, system
RPT2003- Weekly
09.rpt
shutdowns, and reboots. It can be used to assist in software license compliance
auditing by providing records of installs.
Machine Audit This report tracks activity associated with file system audit events including
RPT2003- As needed
-
mount file system and unmount file system events. These events are generally
09-010.rpt
File System
normal system activity, especially during system boot.
Audit
499
Table of Security reports
File
Title
Description
name
Schedule
Machine Audit Mount File System events are a specific type of File System Audit that reflect the RPT2003- As needed
- File System
action of creating an active translation between hardware to a usable files
Audit - Mount
ystem. These events are generally normal during system boot.
09-012.rpt
File System
Machine Audit Unmount File System events are a specific type of File System Audit that reflect
RPT2003- As needed
- File System
the action of removing a translation between hardware and a usable files
09-013.rpt
Audit -
ystem. These events are generally normal during system shutdown.
Unmount File
System
Machine Audit This report tracks activity related to processes, including processes that have
RPT2003- As needed
- Process
09-030.rpt
started, stopped, or reported useful process-related information.
Audit
Machine Audit This report lists Process Audit events that are generated to track launch, exit,
RPT2003- As needed
- Process
status, and other events related to system processes. Usually, these events
09-031.rpt
Audit -
reflect normal system activity. Process-related activity that may indicate a failure
Process Audit
will be noted separately from normal activity in the event detail.
Machine Audit Process Info is a specific type of Process Audit event that reflects information
RPT2003- As needed
- Process
related to a process. Most of these events can safely be ignored, as they are
09-032.rpt
Audit -
generally normal activity that does not reflect a failure or abnormal state.
Process Info
Machine Audit Process Start is a specific type of Process Audit event that indicates a new
RPT2003- As needed
- Process
process has been launched. Usually, Process Start reflects normal system
09-033.rpt
Audit -
activity.
Process Start
Machine Audit Process Stop is a specific type of Process Audit event that indicates a process
RPT2003- As needed
- Process
has exited. Usually, Process Stop reflects normal application exit, however in
09-034.rpt
Audit -
the event of an unexpected error the abnormal state will be noted.
Process Stop
Machine Audit Process Warning is a specific type of Process Audit event that indicates a
RPT2003- As needed
- Process
process has returned a 'Warning' message that is not a fatal error and may not
09-035.rpt
Audit -
have triggered an exit of the process.
Process
Warning
Machine Audit This report tracks activity related to services, including services that have
RPT2003- As needed
- Service Audit started, stopped, or reported useful service-related information or warnings.
09-040.rpt
500
Appendix F: Report Tables
File
Title
Description
name
Schedule
Machine Audit This report tracks ServiceInfo events, which reflect information related to a
RPT2003- As needed
- Service Audit particular service. Most of these events can safely be ignored, as they are
09-041.rpt
- Service Info
generally normal activity that does not reflect a failure or abnormal state.
Machine Audit This report tracks ServiceStart events, which indicate that a new system service RPT2003- As needed
- Service Audit is starting.
09-042.rpt
- Service Start
Machine Audit This report tracks ServiceStop events, which indicate that a system service is
RPT2003- As needed
- Service Audit stopping. This activity is generally normal, however, in the event of an
09-043.rpt
- Service Stop
unexpected stop the abnormal state will be noted.
Machine Audit This report lists ServiceWarning events. These events indicate a service has
RPT2003- As needed
- Service Audit returned a “'Warning” message that is not a fatal error and may not have
09-044.rpt
- Service
triggered an exit of the service.
Warning
Machine Audit This report tracks activity associated with system status and modifications,
RPT2003- As needed
- System Audit including software changes, system reboots, and system shutdowns.
09-020.rpt
Machine Audit Machine Audit events are used to track hardware or software status and
RPT2003- As needed
- System Audit modifications. These events are generally acceptable, but do indicate
09-021.rpt
- Machine
modifications to the client system that may be noteworthy.
Audit
Machine Audit SoftwareInstall events reflect modifications to the system at a software level,
RPT2003- As needed
- System Audit generally at the operating system level (or equivalent, in the case of a network
09-025.rpt
- Software
infrastructure device). These events are generated when a user updates a
Install
system or launches system-native methods to install third party applications.
Machine Audit SoftwareUpdate is a specific type of SoftwareInstall that reflects a more current
RPT2003- As needed
- System Audit version of software being installed to replace an older version.
09-026.rpt
- Software
Update
Machine Audit System Reboot events occur on monitored network devices (servers, routers,
RPT2003- As needed
- System Audit etc.) and indicate that a system has restarted.
09-022.rpt
- System
Reboot
Machine Audit System shutdown events occur on monitored network devices (servers,
RPT2003- As needed
- System Audit routers, etc.) and indicate that a system has been shutdown.
09-023.rpt
- System
Shutdown
501
Table of Security reports
File
Title
Description
name
Schedule
Machine Audit SystemStatus events reflect general system state events. These events are
RPT2003- As needed
- System Audit generally normal and informational, however, they could potentially reflect a
09-024.rpt
- System
failure or issue which should be addressed.
Status
Machine Audit This report tracks activity associated with USB-Defender, including insertion
RPT2003- As needed
-
and removal events related to USB Mass Storage devices.
09-050.rpt
Malicious
This report tracks event activity associated with malicious code such as virus,
RPT2003- Weekly
Code
Trojans, and worms, both on the network and on local machines, as detected
04.rpt
USBDefender
by anti-virus software.
Malicious
Members of the Service Process Attack tree are used to define events centered RPT2003- As needed
Code -
on malicious or abusive usage of services or user processes. These events
Service
include abuse or misuse of resources from malicious code placed on the client
Process
system.
04-01.rpt
Attack
Malicious
Trojan Command Access events reflect malicious or abusive usage of network
RPT2003- As needed
Code - Trojan
resources where the intention, or the result, is gaining access to resources
04-05.rpt
Command
through malicious code commonly known as Trojan Horses. This event detects
Access
the communication related to Trojans sending commands over the network
(infecting other clients, participating in a denial of service activity, being
controlled remotely by the originator, etc.). Trojans are generally executables
that generally require no user intervention to spread and contain malicious code
that is placed on the client system and used to exploit the client (and return
access to the originator of the attack) or exploit other clients (used in attacks
such as distributed denial of service attacks).
Malicious
Trojan Infection Access events reflect malicious or abusive usage of network
RPT2003- As needed
Code - Trojan
resources where the intention, or the result, is gaining access to resources
04-04.rpt
Infection
through malicious code commonly known as a Trojan Horse. This event detects
Access
the infection traffic related to a Trojan entering the network (generally with
intent to infect a client). Trojans are generally executables that generally require
no user intervention to spread and contain malicious code that is placed on the
client system and used to exploit the client (and return access to the originator of
the attack) or exploit other clients (used in attacks such as distributed denial of
service attacks).
502
Appendix F: Report Tables
File
Title
Description
name
Schedule
Malicious
Trojan Traffic Access events reflect malicious or abusive usage of network
RPT2003- As needed
Code - Trojan
resources where the intention, or the result, is gaining access to resources
04-02.rpt
Traffic Access through malicious code commonly known as a Trojan Horse. This event detects
the communication related to Trojans over the network (generally, 'trojaned'
clients calling home to the originator). Trojans are generally executables that
generally require no user intervention to spread and contain malicious code that
is placed on the client system and used to exploit the client (and return access to
the originator of the attack) or exploit other clients (used in attacks such as
distributed denial of service attacks).
Malicious
Trojan Traffic Denial events are a specific type of Denial event where the
Code Report - transport of the malicious or abusive usage originates with malicious code on a
Trojan Traffic
client system known as a Trojan. The intent, or the result, of this activity is
Denial
inappropriate or abusive access to network resources through a denial of
RPT2003- As needed
04-03.rpt
service attack. Trojan Traffic Denial events may be attempts to exploit
weaknesses in software to gain access to a host system, attempts to exploit
weaknesses in network infrastructure equipment to enumerate or reconfigure
devices, attempts to spread the Trojan to other hosts, or other denial of service
activities.
Malicious
Virus Attack events reflect malicious code placed on a client or server system,
Code Report - which may lead to system or other resource compromise and may lead to
Virus Attack
RPT2003- As needed
04-06.rpt
further attack. The severity of this event will depend on the ActionTaken field,
which reflects whether the virus or other malicious code was successfully
removed.
Malicious
Virus Summary Attack events reflect malicious code placed on a client or server
Code Report - system, which may lead to system or other resource compromise and may lead
Virus
to further attack. The severity of this event will depend on the Action Taken field
Summary
which reflects whether the virus or other malicious code was successfully
Attack
removed. These events differ from Virus Attack in that they may be a composite
RPT2003- As needed
04-07.rpt
of virus events normally due to a scheduled scan on the client system as
opposed to a real-time scan
Malicious
Virus Traffic Access events reflect malicious or abusive usage of network
Code Report - resources where the intention, or the result, is gaining access to resources
Virus Traffic
through malicious code commonly known as viruses. This event detects the
Access
communication related to viruses over the network (generally, the spread of a
virus infection or an incoming virus infection). Viruses are generally executables
that require user intervention to spread, contain malicious code that is placed on
the client system, and are used to exploit the client and possibly spread itself to
other clients.
503
RPT2003- As needed
04-08.rpt
Table of Security reports
File
Title
Network
Description
name
This report tracks activity associated with top-level NetworkAttack events.
Events: Attack
Schedule
RPT2003- As needed
11-00.rpt
Behavior
Network
This report shows malicious asset access via the network. For example, attacks RPT2003- Weekly
Events: Attack on FTP or Windows Network servers, malicious network database access,
Behavior -
11.rpt
abuses of services, or attempted unauthorized entry.
Access
Network
Children of the Access tree define events centered on malicious or abusive
Events: Attack usage of network bandwidth/traffic where the intention, or the result, is
Behavior -
RPT2003- As needed
11-01.rpt
inappropriate or abusive access to network resources.
Access Access
Network
Application Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources
Behavior -
where the related data is mostly or all application-layer. Generally,
Access -
ApplicationAccess events will reflect attempted exploitation of weaknesses in
Application
server or client software, or information that is restricted/prohibited by device
Access
access control or policy.
Network
Configuration Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
resource configuration traffic (using protocols such as DHCP, BootP, and
Access -
SNMP). Generally, these events will reflect attempted exploitation of
Configuration
weaknesses in the configuration server or client software or attempts to gain
Access
system-level access to configuration servers themselves. In the case of SNMP
RPT2003- As needed
11-02.rpt
RPT2003- As needed
11-03.rpt
and similar configuration protocols, it could reflect an attempt to enumerate a
device or devices on the same network for further attack.
Network
Core Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources where the
Behavior -
related data is mostly or all core protocols (TCP, UDP, IP, ICMP). Generally,
Access - Core
CoreAccess events will reflect attempted exploitation of weaknesses in network
Access
protocols or devices with intent to gain access to servers, clients, or network
RPT2003- As needed
11-04.rpt
infrastructure devices.
Network
Database Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
application-layer database traffic. Generally, these events will reflect attempted
Access -
exploitation of weaknesses in database server or client software.
Database
Access
504
RPT2003- As needed
11-05.rpt
Appendix F: Report Tables
File
Title
Network
Description
name
File System Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
remote filesystem traffic (using protocols such as SMB and NFS). Generally,
Access - File
these events will reflect attempted exploitation of weaknesses in the remote
System
filesystem server or client software or attempts to gain system-level access to
Access
remote filesystem servers themselves.
Network
File Transfer Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
application-layer file transfer traffic. Generally, these events will reflect
Access - File
attempted exploitation of weaknesses in file transfer server or client software.
Schedule
RPT2003- As needed
11-06.rpt
RPT2003- As needed
11-07.rpt
Transfer
Network
Link Control Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources
Behavior -
where the related data is low-level link control (using protocols such as ARP).
Access - Link
Generally, Link Control Access events will reflect attempted exploitation of
Control
weaknesses in switching devices by usage of malformed incoming or outgoing
Access
data, with intent to enumerate or gain access to or through switching devices,
RPT2003- As needed
11-08.rpt
clients that are also on the switching device, and entire networks attached to the
switching device. In some cases, a managed switch with restrictions on port
analyzing activity may be forced into an unmanaged switch with no restrictions allowing a malicious client to sniff traffic and enumerate or attack.
Network
Mail Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer mail transfer, retrieval, or service traffic. Generally, these events will reflect
Access - Mail
attempted exploitation of weaknesses in mail-related server or client software.
RPT2003- As needed
11-09.rpt
Access
Network
Naming Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer naming service traffic (using protocols such as DNS and WINS).
Access -
Generally, these events will reflect attempted exploitation of weaknesses in the
Naming
naming server or client software.
RPT2003- As needed
11-10.rpt
Access
Network
News Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer news traffic (over protocols such as NNTP). Generally, these events will
Access -
reflect attempted exploitation of weaknesses in the news server or client
News Access
software.
505
RPT2003- As needed
11-11.rpt
Table of Security reports
File
Title
Network
Description
name
Point To Point Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
point to point traffic (using protocols such as PPTP). Generally, these events will
Access - Point
reflect attempted exploitation of weaknesses in point to point server or client
to Point
software, attempts to enumerate networks, or attempts to further attack
Access
devices on trusted networks.
Network
Printer Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer remote printer traffic. Generally, these events will reflect attempted
Access -
exploitation of weaknesses in the remote printer server or client software.
Schedule
RPT2003- As needed
11-12.rpt
RPT2003- As needed
11-13.rpt
Printer Access
Network
Remote Console Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources via
Behavior -
application-layer remote console service traffic (services such as telnet, SSH,
Access -
and terminal services). Generally, these events will reflect attempted
Remote
exploitation of weaknesses in the remote console server or client software.
RPT2003- As needed
11-14.rpt
Console
Access
Network
Remote Procedure Access events reflect malicious or abusive usage of
Events: Attack network resources where the intention, or the result, is gaining access to
Behavior -
resources via remote procedure call traffic (using protocols such as the
Access -
traditional RPC services, RMI, and CORBA). Generally, these events will reflect
Remote
attempted exploitation of weaknesses in the remote procedure server or client
Procedure
software or attempts to gain system-level access to remote procedure servers
Access
themselves.
Network
Routing Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources where the
Behavior -
related data is routing-related protocols (RIP, IGMP, etc.). Generally, Routing
Access -
Access events will reflect attempted exploitation of weaknesses in routing
Routing
protocols or devices with intent to enumerate or gain access to or through
Access
routers, servers, clients, or other network infrastructure devices. These routing
RPT2003- As needed
11-15.rpt
RPT2003- As needed
11-16.rpt
protocols are used to automate the routing process between multiple devices
that share or span networks.
Network
Time Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer remote time service traffic (using protocols such as NTP). Generally,
Access - Time
these events will reflect attempted exploitation of weaknesses in the remote
Access
time server or client software.
506
RPT2003- As needed
11-17.rpt
Appendix F: Report Tables
File
Title
Network
Description
name
Virus Traffic Access events reflect malicious or abusive usage of network
Events: Attack resources where the intention, or the result, is gaining access to resources
Behavior -
Schedule
RPT2003- As needed
11-19.rpt
through malicious code commonly known as viruses. Generally, these events
Access - Virus will reflect attempted exploitation of weaknesses in the web server or client
Traffic Access software.
Network
Web Access events reflect malicious or abusive usage of network resources
Events: Attack where the intention, or the result, is gaining access to resources via applicationBehavior -
layer WWW traffic. Generally, these events will reflect attempted exploitation of
Access - Web
weaknesses in the web server or client software.
RPT2003- As needed
11-18.rpt
Access
Network
Track activity associated with network denial or relay attack behaviors. This
Events: Attack report shows malicious asset relay attempts and denials of service via the
RPT2003- Weekly
12.rpt
Behavior -
network. For example, FTP bouncing, Distributed Denial of Service events, and
Denial / Relay
many protocol abuses.
Network
Application Denial events are a specific type of Denial event where the transport RPT2003- As needed
Events: Attack of the malicious or abusive usage is application-layer protocols. The intent, or
Behavior -
the result, of this activity is inappropriate or abusive access to network
Denial / Relay
resources through a denial of service attack. Application Denial events may be
- Application
attempts to exploit weaknesses in software to gain access to a host system,
Denial
attempts to exploit weaknesses in network infrastructure equipment to
12-01.rpt
enumerate or reconfigure devices, or other denial of service activities.
Network
Configuration Denial events are a specific type of Denial event where the
Events: Attack transport of the malicious or abusive usage is protocols related to configuration
Behavior -
of resources (DHCP, BootP, SNMP, etc.). The intent, or the result, of this
Denial / Relay
activity is inappropriate or abusive access to network resources through a
-
denial of service attack. ConfigurationDenial events may be attempts to exploit
Configuration
weaknesses in configuration-related software to gain access to a host system,
Denial
attempts to exploit weaknesses in network infrastructure equipment to
RPT2003- As needed
12-02.rpt
enumerate or reconfigure devices, or other denial of service activities.
Network
Core Denial events are a specific type of Denial event where the transport of
Events: Attack the malicious or abusive usage is core protocols (TCP, IP, ICMP, UDP). The
Behavior -
intent, or the result, of this activity is inappropriate or abusive access to network
Denial / Relay
resources through a denial of service attack. Core Denial events may be
- Core Denial
attempts to exploit weaknesses in software to gain access to a host system,
attempts to exploit weaknesses in network infrastructure equipment to
enumerate or reconfigure devices, or other denial of service activities.
507
RPT2003- As needed
12-03.rpt
Table of Security reports
File
Title
Network
Description
name
Children of the Denial tree define events centered on malicious or abusive
Events: Attack usage of network bandwidth/traffic where the intention, or the result, is
Behavior -
inappropriate or abusive access to network resources through a denial of
Denial / Relay
service attack.
Schedule
RPT2003- As needed
12-04.rpt
- Denial
Network
File System Denial events are a specific type of Denial event where the
Events: Attack transport of the malicious or abusive usage is remote filesystem-related
Behavior -
protocols (NFS, SMB, etc.). The intent, or the result, of this activity is
Denial / Relay
inappropriate or abusive access to network resources through a denial of
- File System
service attack. File System Denial events may be attempts to exploit
Denial
weaknesses in remote filesystem services or software to gain access to a host
RPT2003- As needed
12-05.rpt
system, attempts to exploit weaknesses in network infrastructure equipment to
enumerate or reconfigure devices, or other denial of service activities.
Network
File Transfer Denial events are a specific type of Denial event where the
Events: Attack transport of the malicious or abusive usage is application-layer file transferBehavior -
related protocols (FTP, TFTP, etc.). The intent, or the result, of this activity is
Denial / Relay
inappropriate or abusive access to network resources through a denial of
RPT2003- As needed
12-06.rpt
- File Transfer service attack. FileTransferDenial events may be attempts to exploit
Denial
weaknesses in file transfer-related software to gain access to a host system,
attempts to exploit weaknesses in the software to enumerate or reconfigure, or
other denial of service activities.
Network
Link Control Denial events are a specific type of Denial event where the
Events: Attack transport of the malicious or abusive usage is link level protocols (such as ARP).
Behavior -
The intent, or the result, of this activity is inappropriate or abusive access to
Denial / Relay
network resources through a denial of service attack. LinkControlDenial events
- Link Control
may be attempts to exploit weaknesses in link-level control software to gain
Denial
access to a host system, attempts to exploit weaknesses in network
RPT2003- As needed
12-07.rpt
infrastructure equipment to enumerate or reconfigure devices, or other denial
of service activities.
Network
MailDenial events are a specific type of Denial event where the transport of the
Events: Attack malicious or abusive usage is application-layer mail-related protocols (SMTP,
Behavior -
IMAP, POP3, etc.) or services (majordomo, spam filters, etc.). The intent, or the
Denial / Relay
result, of this activity is inappropriate or abusive access to network resources
- Mail Denial
through a denial of service attack. MailDenial events may be attempts to exploit
weaknesses in mail-related software to gain access to a host system, attempts
to exploit weaknesses in the software to enumerate or reconfigure, or other
denial of service activities.
508
RPT2003- As needed
12-08.rpt
Appendix F: Report Tables
File
Title
Network
Description
name
Children of the Relay tree define events centered on malicious or abusive
Events: Attack usage of network bandwidth/traffic where the intention, or the result, is relaying
Behavior -
inappropriate or abusive access to other network resources (either internal or
Denial / Relay
external). Generally, these attacks will have the perimeter or an internal host as
- Relay
their point of origin. When sourced from remote hosts, they may indicate a
Schedule
RPT2003- As needed
12-09.rpt
successful exploit of an internal or perimeter host.
Network
Remote Procedure Denial events are a specific type of Denial event where the
Events: Attack transport of the malicious or abusive usage is remote procedure-related
Behavior -
protocols (traditional RPC, RMI, CORBA, etc.) or service (portmapper, etc.).
Denial / Relay
The intent, or the result, of this activity is inappropriate or abusive access to
- Remote
network resources through a denial of service attack. RemoteProcedureDenial
Procedure
events may be attempts to exploit weaknesses in remote procedure services or
Denial
software to gain access to a host system, attempts to exploit weaknesses in the
RPT2003- As needed
12-10.rpt
software to enumerate or reconfigure, or other denial of service activities.
Network
Routing Denial events are a specific type of Denial event where the transport of
Events: Attack the malicious or abusive usage is routing-related protocols (RIP, IGMP, etc.).
Behavior -
The intent, or the result, of this activity is inappropriate or abusive access to
Denial / Relay
network resources through a denial of service attack. Routing Denial events
- Routing
may be attempts to exploit weaknesses in routers or routing software to gain
Denial
access to a host system, attempts to exploit weaknesses in the routing software
RPT2003- As needed
12-11.rpt
or service to enumerate or reconfigure, or other denial of service activities.
Network
Web Denial events are a specific type of Denial event where the transport of the RPT2003- As needed
Events: Attack malicious or abusive usage is application-layer web-related protocols (HTTP,
Behavior -
HTTPS, etc.) or services (CGI, ASP, etc.). The intent, or the result, of this
Denial / Relay
activity is inappropriate or abusive access to network resources through a
- Web Denial
denial of service attack. Web Denial events may be attempts to exploit
12-12.rpt
weaknesses in web-related software to gain access to a host system, attempts
to exploit weaknesses in the software to enumerate or reconfigure, or other
denial of service activities.
Network
Track activity associated with suspicious network behaviors such as
RPT2003- Weekly
Events:
reconnaissance or unusual traffic. Specifically, this report shows potentially
07.rpt
Suspicious
dangerous activity, such as excessive authentication failures, port scans, stack
Behavior
fingerprinting, and network enumerations.
509
Table of Security reports
File
Title
Description
name
Schedule
Network
Application Enumerate events reflect attempts to gather information about
RPT2003- As needed
Events:
target hosts, or services on target hosts, by sending active application-layer
07-01.rpt
Suspicious
data which will elicit responses that reveal information about the application or
Behavior -
host. This enumeration may be a LEMple command sent to the application to
Application
attempt to fingerprint what is allowed or denied by the service, requests to the
Enumerate
application which may enable an attacker to surmise the version and specific
application running, and other information gathering tactics. These
enumerations may result in information being provided that can allow an
attacker to craft a specific attack against the host or application that may work
correctly the first time - enabling them to modify their methodology to go on
relatively undetected.
Network
Banner Grabbing Enumerate events reflect attempts to gather information
RPT2003- As needed
Events:
about target hosts, or services on target hosts, by sending a request which will
07-02.rpt
Suspicious
elicit a response containing the host or service's 'banner'. This 'banner' contains
Behavior -
information that may provide a potential attacker with such details as the exact
Banner
application and version running behind a port. These details could be used to
Grabbing
craft specific attacks against hosts or services that an attacker may know will
Enumerate
work correctly the first time - enabling them to modify their methodology go on
relatively undetected.
Network
Core Scan events reflect attempts to gather information about target networks,
Events:
or specific target hosts, by sending scans over core network protocols (TCP, IP, 07-03.rpt
RPT2003- As needed
Suspicious
ICMP, UDP) which will elicit responses that reveal information about clients,
Behavior -
servers, or other network infrastructure devices. The originating source of the
Core Scan
scan is generally attempting to acquire information that may reveal more than
normal traffic to the target would, information such as a list of applications
listening on ports, operating system information, and other information that a
probe may discover without enumeration of the specific services or performing
attack attempts.
Network
Enumerate events reflect attempts to gather information about target
RPT2003- As needed
Events:
networks, or specific target hosts, by sending active data which will elicit
07-04.rpt
Suspicious
responses that reveal information about clients, servers, or other network
Behavior -
infrastructure devices. The originating source of the enumeration is generally
Enumerate
attempting to acquire information that may reveal more than normal traffic to
the target would.
Network
Footprint events reflect attempts to gather information about target networks
RPT2003- As needed
Events:
by tracing the network through routers, clients, servers, or other network
07-05.rpt
Suspicious
infrastructure devices. The originating source of the footprint is generally
Behavior -
attempting to acquire information that may reveal more about network behavior
Footprint
than normal traffic to the target would.
510
Appendix F: Report Tables
File
Title
Description
name
Schedule
Network
General Security events are generated when a supported product outputs data RPT2003- As needed
Events:
that has not yet been normalized into a specific event, but is known to be
Suspicious
security issue-related.
07-17.rpt
Behavior General
Security
Network
Host Scan events reflect attempts to gather information about specific target
RPT2003- As needed
Events:
hosts by sending scans which will elicit responses that reveal information about
07-06.rpt
Suspicious
clients, servers, or other network infrastructure devices. The originating source
Behavior -
of the scan is generally attempting to acquire information that may reveal more
Host Scan
than normal traffic to the target would, such as a list of applications on the host,
operating system information, and other information that a probe may discover
without enumeration of the specific services or performing attack attempts.
These scans generally do not occur across entire networks and generally have
the intent of discovering operating system and application information which
may be used for further attack preparation.
Network
ICMP Query events reflect attempts to gather information about specific target
RPT2003- As needed
Events:
hosts, or networks, by sending ICMP-based queries that will elicit responses
07-07.rpt
Suspicious
that reveal information about clients, servers, or other network infrastructure
Behavior -
devices. The originating source of the scan is generally attempting to acquire
ICMP Query
information that may reveal more than normal traffic to the target would, such
as operating system information and other information that a probe may
discover without enumeration of the specific services or performing attack
attempts. These scans generally do not occur across entire networks, contain
many sequential ICMP packets, and generally have the intent of discovering
operating system and application information which may be used for further
attack preparation.
511
Table of Security reports
File
Title
Description
name
Schedule
Network
MS Networking Enumerate events reflect attempts to gather information about
RPT2003- As needed
Events:
target hosts, or services on target hosts, by sending active data to Microsoft
07-08.rpt
Suspicious
networking services (using protocols such as NetBIOS and SMB/CIFS) that will
Behavior - MS illicit responses that reveal information about the application, host, or target
Network
network. This enumeration may be a LEMple command sent to the networking
Enumerate
service to attempt to fingerprint what is allowed or denied by a service, requests
to a service that may enable an attacker to surmise the version and specific
service running, requests to a service that may enable an attacker to fingerprint
the target network, and other information gathering tactics. These
enumerations may result in information being provided that can allow an
attacker to craft a specific attack against the networking service, host, or
application that may work correctly the first time - enabling them to modify their
methodology to go on relatively undetected.
Network
Members of the NetworkSuspicious tree are used to define events regarding
RPT2003- As needed
Events:
suspicious usage of network bandwidth/traffic. These events include unusual
07-09.rpt
Suspicious
traffic and reconnaissance behavior detected on network resources.
Behavior Network
Suspicious
Network
Port Scan events reflect attempts to gather information about target networks,
Events:
or specific target hosts, by sending scans over core network protocols (TCP, IP, 07-10.rpt
RPT2003- As needed
Suspicious
ICMP, UDP) that will elicit responses that reveal information about clients,
Behavior -
servers, or other network infrastructure devices. The originating source of the
Port Scan
scan is generally attempting to acquire information that may reveal more than
normal traffic to the target would, such as a list of applications listening on ports,
operating system information, and other information that a probe may discover
without enumeration of the specific services or performing attack attempts. Port
Scans specifically operate by sending probes to every port within a range,
attempting to identify open ports that may use applications or services that are
easy to enumerate and attack.
Network
Children of the Recon tree reflect suspicious network behavior with intent of
RPT2003- As needed
Events:
gathering information about target clients, networks, or hosts. Reconnaissance
07-11.rpt
Suspicious
behavior may be valid behavior on a network, however, only as a controlled
Behavior -
behavior in small quantities. Invalid reconnaissance behavior may reflect
Recon
attempts to determine security flaws on remote hosts, missing access control
policies that allow external hosts to penetrate networks, or other suspicious
behavior that results in general information gathering without actively attacking.
512
Appendix F: Report Tables
File
Title
Description
name
Schedule
Network
Remote Procedure Enumerate events reflect attempts to gather information
RPT2003- As needed
Events:
about target hosts, or services on target hosts, by sending active data to
07-12.rpt
Suspicious
Remote Procedure services (using protocols such as RMI, CORBA, and
Behavior -
traditional RPC) that will elicit responses that reveal information about the
Remote
application or host. This enumeration may be a LEMple command sent to the
Procedure
remote procedure service to attempt to fingerprint what is allowed or denied by
Enumerate
the service, requests to the remote procedure service that may enable an
attacker to surmise the version and specific service running, and other
information gathering tactics. These enumerations may result in information
being provided that can allow an attacker to craft a specific attack against the
remote procedure service or application that may work correctly the first time enabling them to modify their methodology to go on relatively undetected.
Network
Scan events reflect attempts to gather information about target networks, or
RPT2003- As needed
Events:
specific target hosts, by sending scans which will elicit responses that reveal
07-13.rpt
Suspicious
information about clients, servers, or other network infrastructure devices. The
Behavior -
originating source of the scan is generally attempting to acquire information that
Scan
may reveal more than normal traffic to the target would, information such as a
list of applications listening on ports, operating system information, and other
information that a probe may discover without enumeration of the specific
services or performing attack attempts.
Network
Stack Fingerprint events reflect attempts to gather information about specific
RPT2003- As needed
Events:
target hosts by sending a certain set of packets to probe a device's network
07-14.rpt
Suspicious
stack, which will elicit responses that reveal information about clients, servers,
Behavior -
or other network infrastructure devices. The originating source of the scan is
Stack
generally attempting to acquire information that may reveal more than normal
Fingerprint
traffic to the target would, such as operating system information (including type
and version) and other information that a probe may discover without
enumeration of the specific services or performing attack attempts. These
scans generally do not occur across entire networks and generally have the
intent of discovering operating system information which may be used for
further attack preparation.
Network
Trojan Scanner events reflect attempts of Trojans on the network to gather
RPT2003- As needed
Events:
information about target networks, or specific target hosts, by sending scans
07-15.rpt
Suspicious
which will elicit responses that reveal information about the host. The originating
Behavior -
Trojan source of the scan is generally attempting to acquire information that will
Trojan
reveal whether a target host or network has open and available services for
Scanner
further exploitation, whether the target host or network is alive, and how much
of the target network is visible. A Trojan may run a scan before attempting an
attack operation to test potential effectiveness or targeting information.
513
Table of Support Reports
File
Title
Description
name
Schedule
Network
Unusual Traffic events reflect suspicious behavior on network devices where
RPT2003- As needed
Events:
the traffic may have no known exploit, but is unusual and could be potential
07-16.rpt
Suspicious
enumerations, probes, fingerprints, attempts to confuse devices, or other
Behavior -
abnormal traffic. Unusual Traffic may have no impending response, however, it
Unusual
could reflect a suspicious host that should be monitored closely.
Traffic
Priority Event
This report is no longer in use. The Priority Event report tracks those events that RPT2003- As needed
(reference)
the user has identified as a priority event. These events appear in the Priority
16.rpt
filter of the Console.
Priority Event
This report is no longer in use.This report mirrors the standard Priority Event
RPT2003- As needed
By User
report but groups the events received by Console User account. The same
17.rpt
(reference)
event may be seen by many users, so this report tends to be much larger than
the standard Priority Event report.
Rule
The Rule Subscriptions report tracks those events that the user has subscribed
RPT2006- Daily
Subscriptions
to monitor.
28-01.rpt
SolarWinds
The SolarWinds Action Report lists all commands or actions initiated by
RPT2003- As needed
Actions
SolarWinds Network Security.
18.rpt
by User
Table of Support Reports
Support Reports are diagnostic tools used by SolarWinds Customer Support. You will normally only
run these reports at SolarWinds’s request. For your convenience, the reports are listed alphabetically
by title.
File
Title
Description
name
Schedule
Agent
This report is a diagnostic tool used by Customer Support, and generally run
RPT2009- As
Connection
only at their request. This report tracks internal agent online and offline events.
33-1.rpt
Agent
This report is a diagnostic tool used by Customer Support, and generally run
RPT2009- As
Connection
only at their request. This report tracks internal agent online and offline events
33-2.rpt
Status by
grouped by agent.
requested
Status
Agent
514
requested
Appendix F: Report Tables
File
Title
Description
name
Schedule
Agent
This report is a diagnostic tool used by Customer Support, and generally run
RPT2009- As
Connection
only at their request. This report shows high level summary information for
33.rpt
Summary
when agents go online and offline.
Audit -
Audit - Internal Audit Report
requested
RPT2006- As
Internal Audit
31-01.rpt
requested
Report
Audit -
Internal Audit Report grouped by User
RPT2006- As
Internal Audit
31-02.rpt
requested
Report by
User
Agent
This report is a diagnostic tool used by Customer Support, and generally run
RPT2007- As
Maintenance
only at their request. This report displays internal event data for possible
32.rpt
Report
misconfigured agents.
Database
This report is a diagnostic tool used by Customer Support, and generally run
RPT2006- As
Maintenance
only at their request.
26.rpt
This report lists available rules for the Rule Subscriptions.
RPT2006- As needed
requested
requested
Report
List of Rules
for Rule
29-02.rpt
Subscriptions
List of
This report lists the rules that users have subscribed to.
Subscription
RPT2006- As needed
29-03.rpt
Rules by User
List of Users
This report lists each user entered. Currently, the users are only used for Rule
RPT2006- As needed
Subscriptions.
29-01.rpt
Tool
This report is a diagnostic tool used by Customer Support, and generally run
RPT2003- As needed
Maintenance
only at their request. List of New Tool Data events based on Tool Alias.
14.rpt
Tool
This report is a diagnostic tool used by Customer Support, and generally run
RPT2003- As needed
Maintenance
only at their request. List of New Tool Data events based on Agent InsertionIP.
15.rpt
Tool
This report is a diagnostic tool used by Customer Support, and generally run
RPT2003- As needed
Maintenance
only at their request. List of New Tool Data events based on ProviderSID.
13.rpt
by Alias
by Insertion
Point
by Provider
515
Report schedule definitions
File
Title
Description
name
Schedule
Tool
This report is a diagnostic tool used by Customer Support, and generally run
RPT2003- As
Maintenance
only at their request. The report displays a summary of all SolarWinds error
14.rpt
Detail Report
messages received from various tools.
Tool
This report is a diagnostic tool used by Customer Support, and generally run
RPT2003- As
Maintenance
only at their request. The report displays a summary of unique SolarWinds error
13.rpt
Report
messages received from various tools.
requested
requested
Report schedule definitions
The following table describes each recommended report schedule.
Schedule
Description
Daily
Run and review this report once each day.
Weekly
Run and review this report once each week.
As
SolarWinds suggests that you run these reports only when needed for specific auditing
needed
purposes, or when you need the details surrounding a Priority event or a suspicious
event.
As
These reports are diagnostic tools and should only be run at the request of SolarWinds's
requested technical support personnel.
516
Appendix G: Connector Configuration Tables
The tables in this section describe the various categories of network security products that can be
connected to LEM, and explain the fields for configuring sensors, actors, and notification systems.
Connector Categories
The following table describes the various categories of network security products that can be
connected to LEM. The Description column describes how the connectors (sensors and actors)
typically work with each type of product or device. The Use with columns indicate if each product
type requires Manager connectors, Agent connectors, or both.
Use with
Category
Anti-Virus
Description
This category lets you configure sensors for use with
Managers Agents
●
common anti-virus products. These products protect
against, isolate, and remove viruses, worms, and Trojan
programs from computer systems.
To configure an anti-virus connector, the anti-virus
software must already be installed on the Agent
computer.
Some anti-virus connectors can also be run on the
Manager by remotely logging from an Anti-Virus server.
Due to software conflicts, it is recommended that you run
only one brand of anti-virus software per computer.
Application
This category lets you configure sensors for use with
Switch
application switches. Application-Layer switches
transmit and monitor data at the application layer.
517
●
●
Appendix G: Connector Configuration Tables
Use with
Category
Database
Description
This category lets you configure sensors for use with
Managers Agents
●
●
database auditing products. These products monitor
databases for potential database intrusions, changes,
and database system events.
File Transfer and This category lets you configure sensors for use with file
Sharing
●
transfer and file sharing products. These products are
used to share files over the local network and/or Internet.
Monitoring these products provides information about
what files are being transferred, by whom, and system
events.
Firewalls
This category lets you configure sensors and actors for
use with applications and devices that are used to protect
and isolate networks from other networks and the
Internet.
Firewall sensors connect to, read, and retrieve firewall
logs. Most firewalls also have an active response
connector. These connectors configure actors that
interface with routers and firewalls to perform block
commands. Actors can perform active responses either
via telnet or serial/console cable. Normally, you will
configure these connectors on the Manager.
To configure a firewall connector, the firewall product
must already be installed on the Agent computer, or it
must be remotely logging to an Agent or a Manager.
Normally, you will configure these connectors on the
Manager.
You must also configure each firewall’s data gathering
and active response capabilities separately. For example,
configuring a firewall’s data gathering capabilities does
not configure the firewall’s active response settings.
518
●
●
Connector Categories
Use with
Category
Description
Identity and
This category lets you configure sensors for use with
Access
identity access, identity management, and other single-
Management
sign on connectors. These products provide
Managers Agents
●
authentication and single-sign on capabilities, account
management, and other user access features. Monitoring
these products provides information about authentication
and management of accounts.
IDS and IPS
This category lets you configure sensors and actors for
●
use with network-based and host-based intrusion
detection systems. These products provide information
about potential threats on the network or host, and can be
used to raise alarms about possible intrusions,
misconfigurations, or network issues.
Generally, network-based IDS and IPS connectors are
configured to log remotely, while host-based IDS and IPS
systems log locally on an agent system. Some networkbased IPS systems provide the capability to perform an
active response via their actor connector, allowing you to
block an IP address at the IPS device.
Manager
This category lets you configure sensors for use with the
Manager and other Appliances. These connectors
monitor for conditions on the Manager that may be
informational or display potential problems with the
appliances.
519
●
●
Appendix G: Connector Configuration Tables
Use with
Category
Description
Network
This category lets you configure sensors for use with
Management
network management connectors. These connectors
Managers Agents
●
●
●
●
monitor for different types of network activity from users
on the network, such as workstation-level process and
application monitoring. Generally, these systems are
configured to log remotely from a central monitoring
server.
Network Services This category lets you configure sensors for use with
different network services. These connectors monitor
service-level activity for different network services,
including DNS and DHCP. Most network services are
configured to log locally on an agent's system, however,
some are configured to log remotely.
Operating
This category lets you configure sensors for use with
Systems
utilities in the Microsoft Windows operating system that
monitor system events.
This category includes a Windows Active Response
connector. This connector configures an actor that
enables Windows active response capabilities on Agents
using Windows operating systems. This allows LEM to
perform operating system-level responses, such as
rebooting computers, shutting down computers, disabling
networking, and disabling accounts.
To configure an operating system connector, the
operating system software must already be installed on
the Agent computer.
If you perform the remote Agent installation, the Windows
NT/2000/XP Event Application Logs and System Logs
connectors are configured by default.
520
●
Connector Categories
Use with
Category
Description
Proxy Servers
This category lets you configure sensors for use with
and Content
different content monitoring connectors. These
Filters
connectors monitor user network activity for such
Managers Agents
●
●
●
●
activities as web surfing, IM/chat, and file downloads,
and events related to administering the monitoring
systems themselves. Generally, these connectors are
configured to log remotely from the monitoring system.
Routers/Switches This category lets you configure sensors, and in some
cases actors, for use with different routers and switches.
These connectors monitor activity from routers and
switches such as connected/disconnected devices,
misconfigurations or system problems/events, detailed
access-list information, and other related messages.
Some routers/switches have the capability to configure
an actor connector to block an IP address at the device.
Generally, these connectors are configured to log
remotely from the router/switch.
System Scan
This category lets you configure sensors for use with
Reporters
different asset scanning connectors, such as vulnerability
●
scanners. These connectors provide information about
potential vulnerabilities, exposures, and
misconfigurations with different devices on the network.
Generally, these connectors create events in the 'Asset'
categories in the event tree.
System
This category lets you configure the Manager with an
Connectors
external notification system, so LEM can transmit event
messages to LEM users via email or pager. For details,
see Setting up a Notification System
521
●
Appendix G: Connector Configuration Tables
Use with
Category
Description
VPN and Remote This category lets you configure sensors and actors for
Access
Managers Agents
●
●
use with Virtual Private Network (VPN) server products
that provide secure remote access to networks.
Normally, you will configure these connectors on the
Manager.
Web Server
This category lets you configure sensors for use with
Web server products. To configure a web server
connector, the web server software must already be
installed on the Agent or Manager computer.
522
●
Configuring Sensors
Configuring Sensors
The following table describes each field you’ll find on the Connector Configuration form when
configuring sensors for data gathering connectors. The actual fields that appear depend on the
connector you are configuring. Not every field appears with every connector. For convenience, the
table is sorted alphabetically by field name.
Field
Alias
Description
Type a name that easily identifies the application or appliance event log file
that is being monitored.
For active response connectors, we recommend you end the alias with
“AR”. For example, an alias for the Cisco PIX Active Response connector
might be “Cisco PIX AR”. This allows you to differentiate the active
response connector from the data gathering connector.
523
Appendix G: Connector Configuration Tables
Field
Description
Log File /
When you create a new alias for a connector, LEM automatically places a
Log Directory
default log file path in the Log File box. This path tells the connector where
the operating system stores the product’s event log file.
For most connectors, you can change the log file path, as needed. However,
some products write events to the Windows Application Log or the Windows
System Log. In these cases, you are actually configuring the sensor that
monitors events that are written to that log file. For these connectors, the
Log File setting is disabled, and the system automatically populates the
Log File field with the name of the Windows event log the sensor is
monitoring.
In most cases, you should be able to use the default log file path that is
shown for the connector. These paths are based on the default vendor
settings and the product documentation for each product. If a different log
path is needed, type or paste the correct path in the Log File box, or use the
Browse button to explore to correct folder or file.
If you are uncertain about which file path to use, either refer to your original
product documentation, or contact SolarWinds Technical Support.
Note: If the product creates separate log files based on the current date or
some other fixed interval, you can either select the log directory or any log
file in that directory. If you select a log file, LEM reads through the
directory’s log files in order, from the file you selected to the most current
file. The LEM then reads new files as they are added.
nDepth Host
If you are using a separate nDepth appliance (other than LEM), type the IP
address or host name for the nDepth appliance. Generally, the default setting is correct. Only change it if you are advised to do so.
nDepth Port
If you are using a separate nDepth appliance (other than the SolarWinds
LEM), type the port number to which the connector is to send nDepth data.
Generally, the default setting is correct. Only change it if you are advised to
do so.
524
Configuring Sensors
Field
Description
New File Name
Select the interval in which the connector posts and names each new log
Interval
file. The interval tells the SolarWinds LEM when to begin reading the next
log file. The default setting is Daily: yymmdd.
Output
Select the appropriate data output option:
Event - This is the default option. It sends the connector’s log file data as
events to the SolarWinds LEM for processing by your correlation rules,
associated active responses, SolarWinds Consoles, and databases.
nDepth - This option sends the connector’s log file data to a separate
nDepth appliance for archiving. The data does not go to the SolarWinds
LEM, so any potential event activity does not appear in the Event Panel.
However, you can still use the Console's nDepth explorer to search the data
on this appliance.
Event, nDepth - SolarWinds recommends that you choose this option if you
want to use nDepth to search log messages in addition to events. This
option sends the connector’s log file data to the SolarWinds LEM for event
processing and to SolarWinds nDepth for data archiving. This means the
LEM reports potential event activity in the Event Panel, and nDepth
archives the connector’s output data for later reference. Furthermore, you
can use the Console's nDepth explorer to search either type of data.
Server IP Address/
Type the IP address of the router or firewall. Use the following IP address
[Product] IP
format: 192.123.123.123.
Address/ [Product]
Server
525
Appendix G: Connector Configuration Tables
Field
Sleep Time
Description
Type or select the time (in seconds) the connector sensor is to wait between
event monitoring sessions. The default (and minimum) value for all
connectors is one (1) second. If you experience adverse effects due to too
many rapid readings of log entries, increase the Sleep Time for the
appropriate connectors.
Windows NT-based connectors automatically notify Windows Event Log
sensors of new events that enter the log file. Should automatic notification
stop for any reason, the Sleep Time dictates the interval the sensor is to
use for monitoring new events.
Tool Version
This is SolarWinds’s release version for this tool. This is read-only
information for reference purposes.
Wrapper Name
This is an identification key that the SolarWinds LEM uses to uniquely
identify the properties that apply to this particular connector. This is readonly information for SolarWinds reference purposes.
If the connector settings you need are not shown here, you are probably configuring an active
response connector. See "connector configuration tables," below. When you have finished
configuring the connector settings, don’t forget to start the connector.
526
Configuring Actors
Configuring Actors
The following table describes each field you will find on the Connector Configuration form when
configuring actors for active response connectors. Because each connector is product-based, the
fields that appear depend on the connector you are currently configuring. Not every field appears with
every connector. For convenience, the table is sorted alphabetically by field name.
Field
Recommended field settings
Advanced
These settings are no longer applicable.
Auth Port
For CheckPoint OPSEC firewalls, select the port used to connect to the
CheckPoint server via the LEA/OPSEC interface.
Base URL
Type the URL to connect to the SonicWALL firewall and perform the login. Include
“http://” at the beginning of the URL.
Note: SolarWinds does not support HTTPS. Only use this connector for older
SonicWALL firmware version.
Block
For CheckPoint OPSEC firewalls, type the timeout in seconds for the blocks to
Timeout
expire from the firewall. A value of zero (0) means “never expire.”
Client DN
For CheckPoint OPSEC firewalls, type the client DN string. The “CN” and “O”
must be uppercase.
Configuration Select either telnet or SerialPort.
Mode
Enable
Type the connector’s password for entering Enable mode.
Password
Enable
For the Windows Active Response connector, select this check box to enable
Windows
active response settings.
Active
Response
From Zone
Type the external zone used for configuring restrictions on firewall connections.
527
Appendix G: Connector Configuration Tables
Field
Recommended field settings
Incoming
Type the Interface for which the block is to be made effective; that is, the Interface
Interface
for which incoming traffic will be filtered to prevent traffic from the blocked IP
address.
Password /
Type the connector’s login password. For some products, the password name
Login
must be the same one that was used when the firewall was installed.
Password
Port Name /
Select a serial port for performing active response via console cable, if applicable.
Serial Port
The port name represents the physical communication port on the computer. The
Name
port name is only relevant if the Configuration Mode (below) is set to SerialPort.
/dev/ttyS0 = serial port 1, and
/dev/ttyS1 = serial port 2.
If the Configuration Mode is set to telnet, then this field is disabled and the Port
Name box reads: There are no ports available.
Remote
Type the firewall port used for connecting to and configuring the firewall.
Connection
Port
Server DN
For CheckPoint OPSEC firewalls, type the server DN string. The “cn” and “o” must
be lowercase.
Server Port
For CheckPoint OPSEC firewalls, select the port used to connect to the
CheckPoint server via the SAM/OPSEC interface.
Server /
Type the IP address of the router or firewall. This address allows LEM to perform
Server
active responses to events on that particular router or firewall. Use the following IP
Address /
address format: 192.123.123.123.
IP Address /
[Product] IP
Address
528
Setting up a Notification System
Field
SSLCA
Recommended field settings
For CheckPoint OPSEC firewalls, click the Browse button to locate the SSL
certificate file to upload to the server. If the connector is already configured, then
use the existing certificate on the server. You can use the same path for both the
LEA (log reading) and SAM (active response) certificates.
Take Admin
Only one person can configure the firewall at one time. Selecting this check box
Control
allows LEM’s active response to take administrative control over the firewall when
a user is logged into the WatchGuard Management Console. That is, LEM
disconnects the user and takes control over the firewall.
To Zone
Type the internal zone used for configuring restrictions on firewall connections.
connector
Type a name that easily identifies the product that LEM is to act on. For active
Configuration response connectors, we recommend you end the alias with “AR”. For example,
Instance
an alias for the Cisco PIX Active Response connector might be “Cisco PIX AR”.
(Alias)
This allows you to differentiate the active response connector from the data
gathering connector.
User Name /
Type the user name needed to log onto and configure the firewall. For some
Login User
products, the user name must be the same one that was used when the firewall
Name
was installed.
If the connector settings you need are not shown here, you are probably configuring a sensor (data
gathering) connector.When you have finished configuring the connector settings, don’t forget to start
the connector.
Setting up a Notification System
The Connector Configuration form has a category called System connectors that you can use to
set up an external notification system. This allows the Manager to transmit messages to SolarWinds
users via e-mail or pager, to record pertinent event data or text to a specified file, or to synchronize
your existing Directory Service Groups with your existing network directory services.
The following table explains how to configure each option in the System connectors category.
529
Appendix G: Connector Configuration Tables
Field
Recommended field settings
Append Text to File Active Response
Description
Use this connector to have the Agent “write” the specified event data or text to the
specified file.
How to
Select Newline to write the event data to the file so that each event is on a
append
distinct line (that is, one event per line), by inserting a “return” or “newline”
character.
Select No Newline to stream the event data to the file by appending the new data
immediately following any existing data in the file.
Maximum file
Type the allowable maximum file size for the text file, in Megabytes.
size (MB)
Directory Service Query
Description
Use this connector to have the Manager communicate with existing directory
services on the network to retrieve and update group information. This allows you
to synchronize your existing Directory Service Groups for use with rules and
filters.
User Name
Type a user name that is valid on the configured domain and server for
authenticating to the domain and retrieving group information.
Directory
Type the IP address or host name of your directory services server (commonly,
Service Server this is a domain controller).
Domain Name Type the fully-qualified domain name of your directory services domain.
Password
Type the password for the above user name that is valid on the configured domain
and server for authenticating to the domain and retrieving group information.
Directory
Type the port used to communicate with the directory service server.
Service
Server’s Port
Email Active Response
530
Setting up a Notification System
Field
Description
Recommended field settings
Use this connector to have a Manager automatically notify users of event events
when configured to do so by event policy.
Return
Type the name that you want to appear in the From field of active response e-mail
Display Name messages.
Port
Type the port used to communicate with the internal email server.
Return
Type the email address that you want to appear in the From field of active
Address
response email messages.
Mail Host
Type the IP address or host name of an internal SMTP server that the Manager
can use to send email messages through without authentication.
Authentication Type the user name needed to access the internal email server, if required.
Server
Username
Authentication Type the password needed to access the internal email server, if required.
Server
Password
Test E-mail
Type the e-mail address you want to use to test the Mail Host assignment. When
Address
you click the Test Email button, a test message should appear at this email
address.
Test Email
This button tests your email notification settings to ensure that you entered the
button
correct e-mail host.
Click the Test Email button. Then check the email address’s in-box. If you
entered the correct address, the in-box should receive the test message.
531
Appendix H: Filter Configuration Tables
Filter Condition Table
The following table is for use with Filter Creation. It lists the possible filter combinations that you can
create in the Conditions box for each type of field.
l
The Left field column lists each type of field you can drag into the Conditions box’s
left field.
l
The Right field column lists the corresponding field types that you can drag into the
Conditions box’s right field.
l
The Operators columns list the types of comparisons you can make between left and
right fields.
Operators
not
Left field
exists
event
•
event group
•
in
in
text event field
=
≠
>
>=
<
<=
Right field
•
•
text event field
•
•
text event group field
•
•
text constant
•
•
directory service group
•
•
subscription group
•
•
connector profile
•
•
user-defined group
time event field
•
532
•
•
•
time event field
Appendix H: Filter Configuration Tables
Operators
not
Left field
exists
in
•
in
=
≠
>=
<
<=
text event group field
Right field
•
•
•
•
time event group field
•
•
•
•
time constant
time of day
•
number event field
•
•
•
•
•
•
number event field
•
•
•
•
•
•
number event field group
•
•
•
•
•
•
number constant
•
•
text event field
•
•
text event group field
•
•
text constant
•
•
directory service group
•
•
subscription group
•
•
connector profile
•
•
user-defined group
time event group field
•
•
•
•
•
time event field
•
•
•
•
time event group field
•
•
•
•
time constant
time of day
•
number event group field
text constant
>
•
•
•
•
•
•
number event field
•
•
•
•
•
•
number event group field
•
•
•
•
•
•
number constant
•
•
directory service group
•
•
connector profile
533
Comparing Values with Operators
Operators
not
Left field
exists
number constant
time constant
in
in
=
≠
>
>=
<
<=
Right field
•
•
user-defined group
•
•
directory service group
•
•
connector profile
•
•
user-defined group
•
•
directory service group
•
•
connector profile
•
•
user-defined group
Comparing Values with Operators
When configuring a rule or a filter, whenever you drag an item from the list pane and position it next to
event variable, an operator icon appears between them. The operator states how the event variable
must compare with the other item to be subject to rule's or filter’s conditions.
For example, an operator might state whether or not an event should be contained within or outside of
an Time of Day Set; or it may state whether or not an event applies to a particular Connector Profile.
The operators that appear between two elements vary, depending on your selections. The form only
allows comparisons that are logical for the elements you have selected. For more information on
which operators are available for a particular field, see the following reference tables:
l
For configuring filter conditions, see the "Filter condition table" on page 1.
l
For configuring rule correlations, see see the "Rule correlation table" on page 1.
Each of these tables provides a matrix of valid operators for comparing an event variable to other
elements.
534
Appendix H: Filter Configuration Tables
Selecting a new operator
l
Click an operator to cycle through the various operators that are acceptable for the
current condition.
l
Ctrl+click an operator to show a list of operators you can choose from. Then click to
select the operator you want to use.
535
Operator tips
Operator tips
The following tips apply to operators:
l
When comparing two numeric values, the full range of mathematical operator options is
available.
l
An IP address is treated as a string (or text) value. Therefore, operators are limited to
“equal” and “not equal.”
l
DateTime fields have a default value of “> Time Now”, which means, greater than the
current date and time.
Table of operators
The following table describes each operator and how it should be interpreted when used as a filter
condition. (missing or bad snippet)
Operator Meaning
Exists
Description
Use these operators to specify if a particular event or Event Group exists.
Read conditions with these operators as follows: “This [event/Event Group]
Not
must [exist/not exist].”
exist
Note: "Not exist" is only used in rules.
is in
Use these operators when comparing event fields with groups (such as Event
Groups, User-Defined Groups, etc.). They determine the filter’s behavior,
based on whether or not the field is contained a specific Group.
is not in
Read conditions with these operators as follows:
n
This [event field] must be in this [Group].
n
This [event field] must not be in this [Group].
536
Appendix H: Filter Configuration Tables
Operator Meaning
Equals
Does
Description
Read conditions with these operators as follows:
n
This [event variable] must equal this [list item*].
n
This [event variable] must not equal this [list item*].
not
Text comparisons (for IP addresses, host names, etc.) are limited to “equal” or
equal
“not equal” operators.
Greater
Read conditions with these operators as follows:
than
Greater
n
This [event variable] must be greater than this [list item*].
n
This [event variable] must be greater than or equal to this [list item*].
n
This [event variable] must be less than this [list item*].
n
This [event variable] must be less than or equal to this [list item*].
than OR
equal to
Less
than
Less
than OR
equal to
AND
Conditions and groups of conditions are subject to AND and OR
comparisons.
n
The AND symbol means two or more conditions (or groups) must occur
together for the filter to apply. This is the default comparison for new
groups.
OR
n
The OR symbol means any one of several conditions (or groups) may occur
for the filter to apply. When comparing groups of distinct events, you must
use the OR symbol.
If you click an AND operator, it changes to an OR, and vice versa.
*A list item can be another event variable, such as an event field. For example, you may want to
compare that an event's source is equal to a destination. In this case, you would compare two event
fields, such as SourceMachine = DestinationMachine.
537
Examples of AND and OR conditions
Examples of AND and OR conditions
Filter groups and conditions, and rule groups and correlations, are all subject to AND and OR
conditions. By default, new groups, conditions, and correlations appear with an AND condition. AND
and OR conditions can surround nested groups, and they can be used between groups on the same
level to create complex filter conditions or rule correlations.
Example
If x AND y AND z occur, report the
Description
If all of the conditions apply, report the event.
event.
If x OR y OR z occurs, report the event.
If any of the conditions apply, report the event.
If (x AND y) OR z occurs, report the
If conditions x and y occur, or if condition z occurs,
event.
report the event.
If (a AND b) OR (x AND y) OR (z),
In this case, you would create three groups, two nested
occurs, report the event.
within the third:
n
The nested groups are configured as (a AND b) and
(x AND y), joined with an OR.
n
The outer group is configured as (z), surrounding the
nested groups with an OR.
“Condition1” AND
In this example, the filter reports the event when it meets
“Condition2 AND Condition3” OR
the following conditions:
“Condition4 AND Condition5.”
Condition1 and Condition2 and Condition3, or
Condition1 and Condition4 and Condition5.
Configuring event filter notifications
In Filter Creation, the Notifications box lets you to define how the Console is to notify a user when
the filter receives an event. Each notification option instructs the Console to announce the event in a
particular way. You can have the filter display a pop-up message, display the event in bold text, play a
warning sound, have the filter name blink, or configure a combination of these methods.
538
Appendix H: Filter Configuration Tables
Selecting the notification method
1. In the list pane, click the Notifications list.
2. Drag one or more notification option from the Notifications list to the Notifications
box.
3. Configure each option, as described in the Notifications table, below.
Notifications table
The following table lists the various notification methods that can be employed to notify a user that a
filter’s event threshold has been met.
l
The Notification column lists each options that is available in the list pane’s
Notifications list. They are alphabetized for easy reference.
l
The Description column briefly states how each option behaves.
l
The Fields column explains the data fields that can be configured for each option.
539
Notifications table
Notification
Description
Fields
Display
This option causes the Notify on x events received
Popup
filter to display the
Message
Popup Notification
form when receiving
an event.
This form states the
Type the number of events the filter must
receive before displaying the Popup
Notification form.
Repeat on x events received
name of the filter that
If you want the pop-up form to appear again
is receiving the
after receiving repeated events, select the
events, and that the
Repeat on check box.
filter’s event threshold Then in the events received box, type how
has been met.
many more events the filter should receive
before issuing the pop-up form another time.
From the form, the
message recipient can
choose to view the
filter, to turn off the
pop-up form for that
filter, or to turn off the
pop-up form for all
filters.
Display
This option displays
New
new events in the filter
Events As
with bold text.
Unread
They remain bold until
you acknowledge
them by clicking them
or by opening them in
the Event Explorer.
l
540
Not applicable
Appendix H: Filter Configuration Tables
Notification
Description
Fields
Enable
This option causes the Color
Blinking
filter name to blink in
Filter
the Filters pane.
Click the Color button to open the Blink
Color form. Choose a color from one of the
Name
three color palettes. Then click OK. The filter
name will blink in this color.
Time (ms)
Move the slider to select the amount of time
between blinks, in milliseconds.
Notify on x events received
Type the number of events the filter must
receive before the filter tab begins blinking.
Repeat on x events received
The filter tab stops blinking once you
acknowledge it by selecting it. If you want the
tab to begin blinking again after receiving
repeated events, select the Repeat on check
box. Then in the events received box, type
how many more events the filter should
receive before it starts blinking again.
541
Notifications table
Notification
Description
Fields
Play
This option causes the Sound/Browse
Sound
filter to play a sound
upon receiving an
To select a sound, click the Browse button.
Then use the Open form to locate and select
event.
the sound file that you want to use. Sound files
must be of the .wav file type.
When you are done, the name of the file should
appear in the Sound box. To test the sound,
click the “play” button.
Notify on x events received
Type the number of events the filter must
receive before displaying the sound.
Repeat on x events received
If you want the sound to play again after
receiving repeated events, select the Repeat
on check box.
Then in the events received box, type how
many more events the filter should receive
before the filter plays the sound another time.
542
Appendix I: Rule Configuration Tables
Rule Correlation Table
The following table is for use with Rule Creation. It lists the possible rule configurations you can
create in the rule window’s Correlations box for each type of field.
l
The Left field column lists each type of field you can drag into the Correlations box’s
left field.
l
The Right field column lists the corresponding field types that you can drag into the
Correlations box’s right field.
l
The Operators columns list the types of comparisons you can make between left and
right fields.
Operators
not
Left field
exists
not
exists
event
•
•
event group
•
•
in
in
text event field
=
≠
>
>=
<
<=
Right field
•
•
text event field
•
•
text event group field
•
•
text state variable field
•
•
text constant
•
•
directory service group
•
•
connector profile
•
•
user-defined group
time event field
543
•
•
•
•
time event field
•
•
•
•
time event group field
•
•
•
•
time state variable field
Appendix I: Rule Configuration Tables
Operators
not
Left field
exists
not
exists
in
in
=
≠
>
•
•
text event group field
•
<=
•
Right field
time constant
time of day
•
•
•
•
•
•
number event field
•
•
•
•
•
•
number event group field
•
•
•
•
•
•
number state variable field
•
•
•
•
•
•
number constant
•
•
text event field
•
•
text event group field
•
•
text state variable field
•
•
text constant
•
•
directory service group
•
•
connector profile
•
•
user-defined group
time event group field
•
text state variable
•
<
•
number event field
number event group field
>=
•
•
•
•
time event field
•
•
•
•
time event group field
•
•
•
•
time state variable field
•
•
•
•
time constant
•
time of day
•
•
•
•
•
•
number event field
•
•
•
•
•
•
number event group field
•
•
•
•
•
•
number state variable field
•
•
•
•
•
•
number constant
•
•
text event field
•
•
text event group field
•
•
text state variable field
544
Appendix I: Rule Configuration Tables
Operators
not
Left field
exists
not
exists
in
in
=
≠
<=
Right field
•
text constant
•
•
directory service group
•
•
•
connector profile
•
•
user-defined group
•
•
•
•
time event field
•
•
•
•
time event group field
•
•
•
•
time state variable field
•
•
•
•
time constant
•
time of day
number state variable
time constant
<
•
•
number constant
>=
•
time state variable
text constant
>
•
•
•
•
•
•
number event field
•
•
•
•
•
•
number event group field
•
•
•
•
•
•
number state variable field
•
•
•
•
•
•
number constant
•
•
directory service group
•
•
connector profile
•
•
user-defined group
•
•
directory service group
•
•
connector profile
•
•
user-defined group
•
•
directory service group
•
•
connector profile
•
•
user-defined group
Comparing Values with Operators
When configuring a rule or a filter, whenever you drag an item from the list pane and position it next to
event variable, an operator icon appears between them. The operator states how the event variable
545
Appendix I: Rule Configuration Tables
must compare with the other item to be subject to rule's or filter’s conditions.
When configuring a rule or a filter, whenever you drag an item from the list pane and position it next to
event variable, an operator icon appears between them. The operator states how the event variable
must compare with the other item to be subject to rule's or filter’s conditions.
For example, an operator might state whether or not an event should be contained within or outside of
an Time of Day Set; or it may state whether or not an event applies to a particular connector Profile.
Selecting a New Operator
l
Click an operator to cycle through the various operators that are acceptable for the
current condition.
l
Ctrl+click an operator to show a list of operators you can choose from. Then click to
select the operator you want to use.
Operator Tips
The following tips apply to operators:
l
When comparing two numeric values, the full range of mathematical operator options is
available.
l
An IP address is treated as a string (or text) value. Therefore, operators are limited to
“equal” and “not equal.”
l
DateTime fields have a default value of “> Time Now”, which means, greater than the
current date and time.
Filter groups and conditions, and rule groups and correlations, are all subject to AND and OR
conditions. By default, new groups, conditions, and correlations appear with an AND condition. AND
and OR conditions can surround nested groups, and they can be used between groups on the same
level to create complex filter conditions or rule correlations.
Filter groups and conditions, and rule groups and correlations, are all subject to AND and OR
conditions. By default, new groups, conditions, and correlations appear with an AND condition. AND
and OR conditions can surround nested groups, and they can be used between groups on the same
level to create complex filter conditions or rule correlations.
546
Appendix I: Rule Configuration Tables
Example
If x AND y AND z occur, report the
Description
If all of the conditions apply, report the event.
event.
If x OR y OR z occurs, report the event.
If any of the conditions apply, report the event.
If (x AND y) OR z occurs, report the
If conditions x and y occur, or if condition z occurs,
event.
report the event.
If (a AND b) OR (x AND y) OR (z),
In this case, you would create three groups, two nested
occurs, report the event.
within the third:
n
The nested groups are configured as (a AND b) and
(x AND y), joined with an OR.
n
The outer group is configured as (z), surrounding the
nested groups with an OR.
“Condition1” AND
In this example, the filter reports the event when it meets
“Condition2 AND Condition3” OR
the following conditions:
“Condition4 AND Condition5.”
Condition1 and Condition2 and Condition3, or
Condition1 and Condition4 and Condition5.
Accountable
The following table lists the various actions a Manager can take to respond to event events. These
actions are configured in Respond form when you are initiating an active response, and in the rules
window’s Actions box when you are configuring a rule's automatic response.
The table’s Action column lists the actions that are available. They are alphabetized for easy
reference. The Description column briefly states how the action behaves. The Fields column lists
the primary data fields that apply with each action. Some data fields will vary, depending on the
options you select.
547
Appendix I: Rule Configuration Tables
Action
Description
Fields
Add Domain User
This action adds a domain
To Group
user to a specified user group
that resides on a particular
Agent.
Domain Controller Agent
Select the event field or constant that defines
the Agent on which the group to be modified
resides.
To modify a group at the domain level, specify
a domain controller as the Agent.
Group Name
Select the event field or constant that defines
the group that is to be modified.
Username
Select the event field or constant that defines
the user who is to be added to the group.
Add Local User To
This action adds a local user
Group
to a specified user group that
resides on a particular Agent.
Agent
Select the event field or constant that defines
the Agent on which the group to be modified
resides.
To modify a group at the domain level, specify
a domain controller as the Agent.
Group Name
Select the event field or constant that defines
the group that is to be modified.
Username
Select the event field or constant that defines
the user who is to be added to the group.
548
Appendix I: Rule Configuration Tables
Action
Description
Fields
Add User-Defined
This action adds a new data
Group Element
element to a particular userdefined group.
User-Defined Group Element
From the User-Defined Groups list, select
the User-Defined Group that is to receive the
new data Element.
Value
Select the event field or constant that defines
the data element that is to be added to the
specified User-Defined Group. The fields will
vary according to which User-Defined Group
you select.
Append Text To File This action appends text to a
file. This allows you to data
from an event and put it in a
text file.
Agent
Select the event field or constant that defines
the Agent on which the file to be appended is
located.
File Path
Select the event field or constant that defines
the path to the Agent file that is to be
appended with text.
Text
Select the event field or constant that defines
the text to be appended to file.
Block IP
This action blocks an IP
IP Address
address.
Select the event field or constant that
identifies the device’s IP address.
549
Appendix I: Rule Configuration Tables
Action
Description
Fields
Create User
This action creates a new
Agent
Account
user account on an Agent.
Select the event field or constant that defines
the Agent on which the new user account is to
be added.
To create a user account at the domain level,
specify a domain controller as the Agent.
Account Name
Select the event field or constant that names
the account that is to be created.
Account Password
Select the event field or constant that defines
the password that is to be assigned to the
new account.
Create User Group
This action creates a
Agent
specified user group on an
Agent.
Select the event field or constant that defines
the Agent on which the new user group is to
A user group is a new group
of Windows users on a
reside.
To create a user group at the domain level,
Windows PC, server, or
network who are external to
specify a domain controller as the Agent.
Group Name
the LEM system.
Select the event field or constant that defines
which user group is to be created.
550
Appendix I: Rule Configuration Tables
Action
Description
Delete User
This action deletes a user
Account
account from an Agent.
Fields
Agent
Select the event field or constant that defines
the Agent on which the user account is to be
deleted.
To delete a user account at the domain level,
specify a domain controller as the Agent.
Account Name
Select the event field or constant that names
the account that is to be deleted.
Delete User Group
This action deletes a user
Agent
group from a particular Agent.
Select the event field or constant that defines
the Agent on which the user group to be
deleted resides.
To delete a user group at the domain level,
specify a domain controller as the Agent.
Group Name
Select the event field or constant that defines
the user group that is to be deleted.
Detach USB
This action detaches a USB
Device
mass storage device that is
connected to an Agent.
Agent
Select the event field or constant that defines
the Agent from which the USB device is to be
detached.
Device
Select the event field or constant that defines
the device ID of the USB device that is to be
detached.
551
Appendix I: Rule Configuration Tables
Action
Description
Fields
Disable Domain
This action disables a
Domain Controller Agent
User Account
Domain User Account on a
Domain Controller Agent.
Select the event field or constant that defines
the Domain Controller Agent on which the
domain user is to be disabled.
Destination Account
Select the event field or constant that defines
the account that is to be disabled.
Disable Local User
This action disables a local
Account
user account on an Agent.
Agent
Select the event field or constant that defines
the Agent on which the local user is to be
disabled.
Destination Account
Select the event field or constant that defines
the account that is to be disabled.
Disable Networking This action disables an
Agent
Agent’s network access.
Select the event field or constant that defines
The result is that the
the Agent that is to be disabled from the
specified Agent will be unable network.
to connect to the network.
Message
Type the message that is to appear on the
Agent.
552
Appendix I: Rule Configuration Tables
Action
Description
Fields
Disable Windows
This action disables a
Domain Controller Agent
Machine Account
Windows machine account
that resides on a Domain
Select the event field or constant that defines
the Domain Controller Agent on which the
Controller Agent.
account is to be disabled.
Destination Account
Select the event field or constant that
specifies which Windows account is to be
disabled.
Enable Domain
This action enables a Domain Domain Controller Agent
User Account
User Account on a Domain
Controller Agent.
Select the event field or constant that defines
the Domain Controller Agent on which the
domain user is to be enabled.
Destination Account
Select the event field or constant that defines
the account that is to be enabled.
Enable Local
This action enables a local
User Account
user account on an Agent.
Agent
Select the event field or constant that defines
the Agent on which the local user is to be
enabled.
Destination Account
Select the event field or constant that defines
the account that is to be enabled.
553
Appendix I: Rule Configuration Tables
Action
Description
Fields
Enable Windows
This action enables a
Domain Controller Agent
Machine Account
Windows machine account
that resides on a Domain
Select the event field or constant that defines
the Domain Controller Agent on which the
Controller Agent.
account is to be enabled.
Destination Account
Select the event field or constant that
specifies which Windows account is to be
enabled.
Incident Event
This action escalates
Event
potential issues by creating
an Incident Event.
Select which Incident Event the rule is to
create.
Event Fields
From the list pane, select the events and
constants that define the appropriate data
elements for each event fields The fields vary,
depending on which Incident Event event is
selected.
Infer Event
This action escalates
Event
potentially irregular audit
traffic into security events by
Select which Event the rule is to infer.
creating (or “inferring”) a new
Event Fields
event with a higher severity.
From the list pane, select the events and
constants that define the appropriate data
elements for each event field. The fields vary,
depending on the which event is selected.
554
Appendix I: Rule Configuration Tables
Action
Kill Process by ID
Description
Fields
This action terminates the
specified process on an
Agent by using its process ID
value.
Agent
Select the event field or constant that defines
the Agent on which the process is to be
terminated.
Process ID
Select the event field or constant that
identifies the ID number of the process that is
to be terminated.
Kill Process by
This action terminates the
Name
specified process on an
Agent
Select the event field or constant that defines
Agent by referring to the
the Agent on which the process is to be
process name.
terminated.
Process Name
Select the event field or constant that
identifies the name of the process that is to be
terminated.
Account Name
Select the event field or constant that
identifies the name of the account that is
running the process to be terminated.
Log Off User
This action logs the user off
of an Agent.
Agent
Select the event field or constant that defines
the Agent from which the user is to be logged
off.
Account Name
Select the event field or constant that
identifies the specific account name that is to
be logged off.
555
Appendix I: Rule Configuration Tables
Action
Description
Fields
Modify State
This action modifies a state
Variable
variable.
State Variable
From the State Variables list, drag the state
variable that the rule is to modify.
State Variable Fields
From the appropriate component list, type or
drag the data element that is to be modified in
the state variable. The fields vary, depending
on the which state variable is selected.
Remove Domain
This action removes a domain Domain Controller Agent
User From Group
user from a specified user
group that resides on a particular Agent.
Select the event field or constant that defines
the domain controller Agent on which the
group to be modified resides.
Group Name
Select the event field or constant that defines
the group that is to be modified.
User Name
Select the event field or constant that defines
the user who is to be removed from the group.
Remove Local User This action removes a local
From Group
user from a specified user
group that resides on a particular Agent.
Agent
Select the event field or constant that defines
the Agent on which the group to be modified
resides.
Group Name
Select the event field or constant that defines
the group that is to be modified.
User Name
Select the event field or constant that defines
the user who is to be removed from the group.
556
Appendix I: Rule Configuration Tables
Action
Description
Fields
Remove User-
This action removes a data
Defined Group
element from a particular
Element
user-defined group.
User-Defined Group
From the User-Defined Groups list, select
the user-defined group from which the
specified data element is to be removed.
Value
Select the event field or constant that defines
the data element that is to be removed from
the specified user-defined group. The fields
will vary according to which user-defined
group you select.
Reset User
This action resets a user
Account Password
account password on a
Agent
Select the event field or constant that
particular Agent.
identifies the Agent on which the user
password is to be reset.
To reset an account at the domain level,
specify a domain controller as the Agent.
Account Name
Select the event field or constant that
identifies the user account that is to be reset.
New Password
Select the event field or constant that defines
the user’s new password.
557
Appendix I: Rule Configuration Tables
Action
Restart Machine
Description
Fields
This action reboots an Agent. Agent
Select the event field or constant that
identifies the Agent that is to be rebooted.
Delay (sec)
Type the time (in seconds) after the event
occurs that the Manager is to wait before
rebooting the Agent.
Restart Windows
This action restarts the
Agent
Service
specified Windows service
on an Agent.
Select the event field or constant that
identifies the Agent on which the Windows
service will be restarted.
Service Name
Select the event field or constant that
identifies the name of the service that is to be
restarted.
558
Appendix I: Rule Configuration Tables
Action
Description
Fields
Send Email
This action sends a
Email Template
Message
preconfigured email message
to a predetermined email
Select the template that the email message is
to use. For more information on email
distribution list.
templates, see "Configuring Email
Templates" on page 1.
Recipients
Click the check boxes to select which users
are to receive the email message.
Email Fields
Either drag a field from the components list, or
select a constant from the components list to
select the appropriate data elements that are
to appear in each email template field. The
fields vary, depending on which email
template is selected.
Send Popup
This action displays a pop-up Agent
Message
message to an Agent.
Select the event field or constant that
identifies the Agent that is to receive the popup message.
Account Name
Select the event field or constant that
identifies the user account to receive the
message.
Message
Select the event field or constant that defines
the message that is to appear on the Agent’s
monitor.
559
Appendix I: Rule Configuration Tables
Action
Shutdown Machine
Description
Fields
This action shuts down an
Agent.
Agent
Select the event field or constant that
identifies the Agent that is to be shut down.
Delay (sec)
Type the time (in seconds) after the event
occurs that the Manager is to wait before
shutting down the Agent.
Start Windows
This action starts the
Agent
Service
specified Windows service
on an Agent.
Select the event field or constant that
identifies the Agent on which the Windows
service is to be started.
Service Name
Select the event field or constant that defines
the Windows service that is to be started.
Stop Windows
This action stops the
Agent
Service
specified Windows service
on an Agent.
Select the event field or constant that
identifies the Agent on which the Windows
service is to be stopped.
Service Name
Select the event field or constant that defines
the Windows service that is to be stopped.
560