Thanks to visit codestin.com
Credit goes to www.scribd.com

0% found this document useful (0 votes)
36 views128 pages

ESM ArcSightWeb UserGuide 5.2

ESM_ArcSightWeb_UserGuide_5.2

Uploaded by

Zoumana Diomande
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
36 views128 pages

ESM ArcSightWeb UserGuide 5.2

ESM_ArcSightWeb_UserGuide_5.2

Uploaded by

Zoumana Diomande
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 128

ArcSight Web™

User’s Guide
ArcSight ESM™ 5.2

March 2012
ArcSight Web™ User’s Guide ArcSight ESM™ 5.2

Copyright © 2012 Hewlett-Packard Development Company, LP. All rights reserved.


Confidential computer software. Valid license from HP required for possession, use or copying. Consistent
with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard
commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products
and services are set forth in the express warranty statements accompanying such products and services.
Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for
technical or editorial errors or omissions contained herein.
Follow this link to see a complete statement of copyrights and acknowledgements:
http://www.arcsight.com/copyrightnotice
The network information used in the examples in this document (including IP addresses and hostnames) is
for illustration purposes only.
This document is confidential.

Revision History

Date Product Version Description

02/10/2012 ArcSight ESM v5.2 Update for ESM v5.2. Updated version, dates, and
copyright information.

Contact Information

Phone 1-866-535-3285 (North America)


+44 (0)870 141 7487 (EMEA)

Support Web Site http://www.support.openview.hp.com

Protect 724 Community https://protect724.arcsight.com


Contents

Chapter 1: Welcome to ArcSight Web .................................................................................. 1

Chapter 2: What’s New ....................................................................................................... 3

Reporting .......................................................................................................... 3
Standard Content ............................................................................................... 3
Correlation ......................................................................................................... 4
Dashboards ........................................................................................................ 4
Asset Model Import Connector .............................................................................. 4

Chapter 3: Navigating ArcSight Web ................................................................................... 5

Navigating the Home Page ............................................................................................... 5


Basic Navigation ............................................................................................................. 6

Chapter 4: Standard Content ............................................................................................... 7

Standard Content Foundations .......................................................................................... 7


Configuration Monitoring Foundation ............................................................................ 7
Intrusion Monitoring Foundation .................................................................................. 8
Network Monitoring Foundation ................................................................................... 8
ArcSight Workflow Foundation .................................................................................... 8
ArcSight Administration Foundation ............................................................................. 8
ArcSight System Content ........................................................................................... 8
Conditional Variable Filters ......................................................................................... 8
Anti-Virus Reports ..................................................................................................... 8
Getting Started Using Standard Content ............................................................................. 9
Monitoring with Standard Content ..................................................................................... 9
Reporting with Standard Content ..................................................................................... 10

Chapter 5: ArcSight Express Content ................................................................................ 13

ArcSight Express Home Page .......................................................................................... 14


Recent Notifications ................................................................................................. 14
My Cases ............................................................................................................... 14
Dashboards ............................................................................................................ 14
Active Channels ...................................................................................................... 14
Getting Started Using ArcSight Express Content ................................................................ 15

Confidential ArcSight™ Web User’s Guide iii


ArcSight Express Groups .......................................................................................... 15
Monitoring with ArcSight Express Active Channels ............................................................. 16
Monitoring with ArcSight Express Dashboards ............................................................. 17
Reporting with ArcSight Express Reports .......................................................................... 18

Chapter 6: Using Active Channels ..................................................................................... 19

Opening Active Channels ................................................................................................ 19


Viewing Active Channels ................................................................................................ 21
Using Active Channel Headers ................................................................................... 21
Using Active Channel Grids ....................................................................................... 21
Supported Expressions for Inline Filtering ............................................................. 23
Inspecting Events .......................................................................................................... 24
Event Inspector Header Features .............................................................................. 24
Event Inspector Field Features .................................................................................. 25
Show Details for Event Attributes .............................................................................. 25
Event Categories .............................................................................................. 25
Event Data Fields .............................................................................................. 32
Audit Events .................................................................................................... 78
Status Monitor Events ....................................................................................... 84

Chapter 7: Using Cases ..................................................................................................... 95

Managing Cases ............................................................................................................ 95


Default Case Management Columns ........................................................................... 96
Security Classification Default Letter Codes ................................................................ 96
Creating Cases ............................................................................................................. 97
Initial Tab .............................................................................................................. 97
Follow Up Tab ......................................................................................................... 99
Final Tab ..............................................................................................................100
Events Tab ............................................................................................................101
Attachments Tab ....................................................................................................101
Notes Tab .............................................................................................................102

Chapter 8: Handling Notifications ................................................................................... 103

Chapter 9: ...................................................................................................................... 105

Chapter 9: Using Reports ................................................................................................ 105

Running and Viewing Reports .........................................................................................105


Running and Saving Archived Reports .............................................................................106
Report Parameters .......................................................................................................106
Viewing Archived Reports ..............................................................................................107
Downloading an Archived Report ..............................................................................107
Adding New Archived Reports ..................................................................................108
Deleting Archived Reports .......................................................................................108

iv ArcSight™ Web User’s Guide Confidential


Advanced Configuration for Report Performance ...............................................................108
Configurations for Large Reports ..............................................................................108
Configurations for Reports with Large Time Ranges ....................................................109

Chapter 10: Monitoring Dashboards ................................................................................ 111

Viewing and Managing Dashboards .................................................................................111


Changing Dashboard Layouts .........................................................................................111

Chapter 11: Using the Knowledge Base ........................................................................... 113

Chapter 12: Using Reference Pages ................................................................................ 115

Chapter 13: Setting Preferences ..................................................................................... 117

Chapter 14: Custom Branding and Styling ....................................................................... 119

Index .................................................................................................................................................... 121

Confidential ArcSight™ Web User’s Guide v


vi ArcSight™ Web User’s Guide Confidential
Chapter 1
Welcome to ArcSight Web

ArcSight Web is the web interface to monitoring and reporting features of ArcSight ESM for
operators and analysts engaged in network perimeter and security monitoring.

Because it can be installed at a location remote from the ArcSight Manager, ArcSight Web
can operate outside a firewall that protects the Manager. Because of its design, it also
offers opportunities for custom branding and styling.

Installing ArcSight Web is described in the Installation and Configuration Guide. For a list of
new features, see “What’s New” on page 3. To get started using the ArcSight Web
interface, see the introduction to “ArcSight Express Content” on page 13 if you have an
ArcSight Epxress deployment, or “Standard Content” on page 7 if you have an ESM
depoyment.

See “Navigating ArcSight Web” on page 5 for a quick tour of all ArcSight Web’s features.

Confidential ArcSight Web™ User’s Guide 1


1 Welcome to ArcSight Web

2 ArcSight Web™ User’s Guide Confidential


Chapter 2
What’s New

ArcSight Web offers browser-based access to selected ArcSight Manager installations from
anywhere on your intranet. While the ArcSight Console remains your tool for analysis
authoring and detailed operational tasks, ArcSight Web provides a way to see and readily
use the results of that analytical capability.

ArcSight Web is an independent server (not integral to the ArcSight Manager) and can be
located anywhere from which it can connect to a Manager, even outside a firewall.

The best way to get acquainted with ArcSight Web is to take a quick tour of the user
interface. If you are a standard ESM user, see “Standard Content” on page 7. If you are an
ArcSight Express user, see “ArcSight Express Content” on page 13.

This topic describes the new features and enhancements added in this release.

Reporting
Standard Content
Correlation
Dashboards
Asset Model Import Connector

Reporting
In the ArcSight Console, reporting has been enhanced to create a report
once and distribute it to multiple recipients. You have the option to not
send empty reports. Reporting has also been enhanced to define non-
ESM users as recipients.

For more information, see “Building Reports” on page 329.

Standard Content
Administration foundation: Made navigation of administration tasks
easier by adding use cases and enhancing the resource monitoring
content to better monitor query-based resources (reports, trends, and
query viewers).

For more information, see “Standard Content” on page 47.

Confidential ArcSight™ Web User’s Guide 3


2 What’s New

Correlation
New, light-weight rules that skip multiple event aliases and aggregation,
limit actions and auditing for significant performance gains. For more
information, see “Rules Authoring” on page 441.

Active List Enhancements:


- SUM, MIN, MAX numeric subtypes 
- Store data in time segments
- Enhanced variable functions to support active lists 
For more information, see “List Authoring” on page 577.

Dashboards
The ArcSight Console has been enhanced to support greater drill-down
from data monitors and query viewers to dashboards, reports, active
channels, and query viewers.

For more information, see “Using Dashboards” on page 154.

Asset Model Import Connector


The Asset Model Import Connector now supports the ability to create and
manage the Asset Model within ESM. The Asset Model Import Connector
monitors changes in an asset model CSV file, enabling you to manage
and maintain your Asset model more easily.

For more information, see “Automatically-Created Assets” on page 747.

4 ArcSight™ Web User’s Guide Confidential


Chapter 3
Navigating ArcSight Web

Access the ArcSight Web server through whichever web browser you prefer: Internet
Explorer 8.0+ or Firefox 3.6+. The ArcSight Web home URL is
https://hostname:9443/arcsight/app, where hostname is the machine on which
the web server is running.

“Navigating the Home Page” on page 5


“Basic Navigation” on page 6

Navigating the Home Page


The ArcSight Web client opens to the Home display. From here you can easily reach
everything the client offers.

The Home display's summaries are quick references and links to the most-appropriate or
most-interesting security resources in your enterprise. The initial or default information in
each group is configured by your ArcSight administrator. In the sections that offer a Show
menu, you can choose Start Up View to see this default or Personal Folder to switch to
resources selected by or assigned to you.

The information summarized in the Home display is identical to, although possibly a subset
of, the same information managed through the ArcSight Console. It is simply presented in a
browser-compatible format.

Home
The Home link returns you to the home page from any other view.

Dashboards
The Dashboards section lists a set of data monitor dashboards that expose selected
analytical security information about your enterprise. Click a dashboard's name to open it.

Reports
The Reports section lists available reports. Reports are captured views or summaries of
data extrapolated from the ArcSight System by means of queries and trends. Reports
communicate the state of your enterprise security. Click a report, set the parameters or
accept the defaults (HTML or PDF), and click Run Report. You have the option of saving
the Report results in a variety of file formats to your local system, or just viewing the
results in the ArcSight Web window.

Confidential ArcSight Web™ User’s Guide 5


3 Navigating ArcSight Web

Active Channels
Active Channels display the filtered events as they stream through the system. Click a
channel to open it as a grid view in which you can inspect individual events. You can pause
channels, and sort event columns in the grid.

Cases
The Cases section summarizes currently tracked, event-related security situations by the
area they fall into (rows) and the workflow-style stage they have reached (columns). Click
a type and stage cell to see more detail.

Recent Notifications
The Recent Notifications section summarizes ArcSight notifications by workflow-style
categories. Click a category to see more detail.

Basic Navigation
Use the Dashboards, Reports, Channels, Cases Notifications, and Knowledge Base links at
the top of the display to go to those features. A link to Customer Support is also provided.

Button Description

Home

Dashboards

Reports

Channels

Cases

Notifications

The top bar also has the client's basic controls.

 Click Help to open this Help window. To visit previously viewed Help pages, you can
use standard keyboard commands for Back and Next. For example, on most Web
browsers running on Microsoft Windows systems, you can hit the Backspace key to
show the previously viewed page (move backward in the History) and Shift +
Backspace to move forward in the History of viewed pages. For more information on
using the Help (including how to print topics and get a PDF), see Chapter 3‚ About the
Online Help‚ on page vii.
 Click Options to change your preferences concerning date and time formats, locale
settings, active channel setup, and your password.
 Click Logout to leave the client and log in again, or browse elsewhere. If you leave
the client idle for a period of time you may need to log in again because of an
automatic security time-out.
 Click the ArcSight logo in the upper-left corner of the Home display to see version and
licensing information.

6 ArcSight Web™ User’s Guide Confidential


Chapter 4
Standard Content

The system comes with a series of coordinated resource systems (active channels,
dashboards, and reports) that address common enterprise network security and ESM
management tasks. These resource systems are referred to collectively as standard
content. Standard content is designed to give you comprehensive operational function out
of the box with minimal configuration.

The content that comes with ArcSight ESM provides a broad range of security, network and
configuration monitoring tasks, as well as a comprehensive system monitoring coverage.

The standard content is organized into functional groups called foundations. For more
about the foundations, see “Standard Content Foundations” on page 7.

“Standard Content Foundations” on page 7


“Getting Started Using Standard Content” on page 9
“Monitoring with Standard Content” on page 9
“Reporting with Standard Content” on page 10

Standard Content Foundations


Each foundation is a coordinated system of resources that provides real-time monitoring
capabilities for its area of focus, as well as after-the-fact analysis in the form of reports,
trends, and trend reports.

Configuration Monitoring Foundation


The Configuration Monitoring foundation identifies, analyzes, and provides support for
remediation of undesired modifications to systems, devices, and applications. Configuration
monitoring is concerned mainly with monitoring hosts and user accounts for configuration-
related activity, such as installing new applications, adding new systems to the network,
anti-virus/network scanner/IDS engine and signature updates, and asset vulnerability
postures.

The configuration monitoring foundation helps you monitor how your networks change
over time, measure daily statistics, understand the changes made, and know who's making
them. Trends help you know what is normal and spot anomalies that should be
investigated.

Confidential ArcSight Web™ User’s Guide 7


4 Standard Content

Intrusion Monitoring Foundation


The focus of the Intrusion Monitoring foundation is to identify hostile activity and enable
you to take appropriate action either automatically or manually. This foundation provides
statistics about intrusion-related activity, which you can for incident investigation as well as
routine monitoring and reporting. As with previous releases, the essential security
monitoring functions of the Intrusion Monitoring foundation make up the bulk of the
standard content.

The Intrusion Monitoring foundation targets general intrusion types as well as specific
types of attacks, such as worms, viruses, denial-of-service (DoS) attacks, and so on.

Network Monitoring Foundation


The Network Monitoring foundation monitors the status of network throughput and
network infrastructure as monitored by Argus, the real-time flow monitoring device by
Qosient.

This foundation provides statistics about traffic and bandwidth usage that helps you
identify anomalies and areas of the network that need attention.

ArcSight Workflow Foundation


The ArcSight Workflow foundation is a system of active channels and reports that support
incident response tracking using the incident response system.

Qualifying events in the other foundation packages trigger notifications and cases that get
escalated through the incident response stages.

ArcSight Administration Foundation


The ArcSight Administration foundation provides statistics about component health and
performance. This foundation is installed automatically, and is essential for managing and
tuning the performance of content and components.

ArcSight System Content


The ArcSight System content consists of resources required for basic security processing
functions, such as threat escalation and priority calculations, as well as basic event
monitoring channels required for out-of-the-box functionality.

Conditional Variable Filters


The Conditional Variable Filters are a library of filters used by variables in standard content
report queries, filters, and rule definitions. They express conditions that can also be used
by any content in any package.

The Conditional Variable Filters are used by the Anti Virus, ArcSight Express, Configuration
Monitoring, Intrusion Monitoring, Network Monitoring, and Workflow foundations.

Anti-Virus Reports
The Anti-Virus reports serve both the Configuration Monitoring and Intrusion Monitoring
foundations.

8 ArcSight Web™ User’s Guide Confidential


4 Standard Content

Getting Started Using Standard Content


Whatever your role in the security operations center, you can get started right away using
the standard content.

Each foundation is organized with content for different types of users.

 Executive Summaries. Executive summaries provide high-level analysis of event


activity for management reports. These views show overall trends and long-term
summaries.
 Operational Summaries. The operational summaries are intended for SOC
operators and analysts for daily event monitoring and triage-level investigation.
 Details. The detailed content is intended for incident responders and analysts who
need access to relevant event details in order to investigate situations that arise from
monitoring reports in the operational summaries.
 SANS Top 5 Reports. Each security-related foundation contains a set of reports that
address the SANS Institute's list of recommendations of what every IT staff should
know about their network at a minimum, based on the Top 5 Essential Log Reports.

Monitoring with Standard Content


You can use standard content active channels to begin monitoring your network
immediately after SmartConnectors are added and basic configuration is complete.

Each foundation provides high-level channels for observing general activity for its area of
focus.

Foundation Channel Description

ArcSight System System Events Channel showing all events generated by


Last Hour ArcSight during the last hour. A filter
prevents the channel from showing
events that contributed to the firing of a
rule, commonly referred to as correlated
events.

Today Channel showing events received today


since midnight. A filter prevents the
channel from showing events that
contributed to the firing of a rule,
commonly referred to as correlated
events.

All Events / Last 5 Channel showing events received during


Minutes and Last the last five minutes or the last hour. The
Hour channel includes a sliding window that
always displays exactly the last five
minutes of event data.

Core / Live Live Channel showing events received


during the last two hours. The channel
includes a sliding window that always
displays exactly the last two hours of
event data. A filter prevents the channel
from showing correlation events.

Confidential ArcSight Web™ User’s Guide 9


4 Standard Content

Foundation Channel Description

Configuration Operational This channel shows scan results in real


Monitoring Summaries / High- time to give you a view into any high-
Priority Scan priority vulnerabilities detected on highly
Events Directed critical assets.
Toward High-
Criticality Assets

Intrusion Intrusion This channel provides an overview of


Monitoring Monitoring - hostile, compromise or high priority
Significant Events events. It continuously monitors events
matching:

Not ArcSight Internal Events

Priority greater than 8 or Category


Significance Starts With /Compromise or
/Hostile

Uses the Business Impact Analysis Field


Set (End Time, Business Role, Data Role,
Attacker Zone Name, Target Host Name,
Category Significance, Category Outcome
and Priority).

Network Argus Events This active channel shows all the events
Monitoring coming from Argus SmartConnectors for
the past 24 hours.

Workflow Assigned Events This channel shows events assigned


today. The channel always displays
events occurring since midnight of the
current day up to the current time. A
filter prevents the channel from showing
correlated events. It shows only events
that are not in closed stage and are
assigned to a user.

Each foundation contains more channels that focus on events of different types. Explore
the active channels to monitor the activity you are interested in.

For more about using active channels, see “Using Active Channels” on page 19.

Use dashboards to view activity from many perspectives in a single screen. Dashboards are
also fully drill-down enabled. For more about investigating using dashboards, see
“Monitoring Dashboards” on page 111.

Reporting with Standard Content


Standard content supplies a robust set of reports for each foundation. The reports for each
foundation are organized into different levels of detail depending on who the reports are
for as outlined in Getting Started Using Standard Content.

Foundation Reports

Common The Common group contains a set of anti-virus reports that apply to
all the foundations.

10 ArcSight Web™ User’s Guide Confidential


4 Standard Content

Foundation Reports

Configuration Detailed reports concentrate on configuration changes by device and


Monitoring by user, inventories of applications and assets by role, and
vulnerabilities by asset, asset type, asset criticality, and so on.

• Executive Summary reports focus on overall host configurations


by zone, role, criticality, data role, and operating system.
• Operational Summaries provide summaries of host configuration
modifications by Customer, OS, and over the last 30 days; top
user login successes and failures over recent time periods; and
asset restarts over recent time periods.
• SANS Top 5 Reports focus on SANS section 3: Unauthorized
Changes to Users, Groups, and Services.

Intrusion Detailed reports are organized into types of activity: anti-virus;


Monitoring attack monitoring; environment state for applications, operating
systems, and services; reconnaissance attempts; access events;
user activity through device type; vulnerability activity by asset and
by vulnerability; and worm outbreak activity.

• Executive Summary reports provide an overall Security


Intelligence Status Report, and summary views by business role
and systems that are subject to regulations, such as the
Sarbanes-Oxley Act.
• Operational Summaries provide mid-level summaries organized
into device types, such as anti-virus, attack monitoring, and
reconnaissance.
• SANS Top 5 Reports focus on SANS sections 1, 4, and 5:
Attempts to Gain Access, Through Existing Accounts, Systems
Most Vulnerable to Attack, and Suspicious or Unauthorized
Network Traffic Patterns.

Network Detailed reports provide views into traffic by host, by protocol, and
Monitoring by target, and activity over network devices and VPNs.

• Executive Summary reports provide traffic summaries over daily,


monthly, quarterly, and weekly time intervals.
• Operational Summaries provide an overall traffic snapshot;
bandwidth utilization statistics by device and by time interval;
and statistics for inbound and outbound traffic by protocol and by
host.
• SANS Top 5 Reports focus on SANS section 5: Suspicious or
Unauthorized Network Traffic Patterns.

Workflow Detailed reports provide statistics for all cases, notifications, and
notification action events.

• Executive Summary reports provide overall case statistics, such


as average time to case resolution, number of cases at each
escalation stage, and cases as they affect operations.
• Operational Summaries provide detailed case statistics, including
trends over time, notifications that reach level 3, the status of
notifications by user, and so on.

Each foundation contains more reports that focus on events of different types. Explore the
reports to find the activity on which you are interested in reporting.

For more about using reports, see “Using Reports” on page 105.

Confidential ArcSight Web™ User’s Guide 11


4 Standard Content

12 ArcSight Web™ User’s Guide Confidential


Chapter 5
ArcSight Express Content

ArcSight Express is an Information and Event Management (SIEM) appliance that provides
essential network perimeter and security monitoring tools combined with Logger, ArcSight's
data retention hardware storage solution. ArcSight Express delivers an easy-to-deploy,
enterprise-level security monitoring and response system through a series of coordinated
resources, such as dashboards, rules, and reports included as part of ArcSight Express
Content.

ArcSight Express content is designed to give you comprehensive operational function out of
the box with minimal configuration.

These resources enable you to use the active channels and dashboards to monitor the
network, use the case tracking tools to investigate and resolve issues, and use the reports
to communicate the condition of the network to key stakeholders at all levels of the
enterprise.

“ArcSight Express Home Page” on page 14


“Getting Started Using ArcSight Express Content” on page 15
“Monitoring with ArcSight Express Active Channels” on page 16
“Reporting with ArcSight Express Reports” on page 18

Confidential ArcSight Web™ User’s Guide 13


5 ArcSight Express Content

ArcSight Express Home Page


The ArcSight Express home page displays a series of basic views designed to give you an
overview of activity that concerns you. These views are described below.

Recent Notifications
Recent notifications show the status of notifications generated by correlated events that
concern you. To view the details of a notification, click any line item to go to the
Notifications page. For more about notifications, see “Handling Notifications” on page 103.

My Cases
My cases show a snapshot of cases assigned to the user who is currently logged in. For
details, click the cases icon to go to the Cases page. For more about cases, see “Using
Cases” on page 95.

Dashboards
Dashboards show a selection of key dashboards. You can select among these views:

 Start Up View: The start-up view provides quick access to the Security Activity
Statistics and Current Event Sources dashboards. These dashboards give you a
comprehensive general view of the security state of your environment and the sources
where the events are generated.
 Recent Dashboards: This view shows the last five dashboards you viewed to enable
you to easily toggle among several dashboards without having to navigate to them in
the Dashboard tab.
Click any of these links to display the dashboard itself.

Active Channels
 Start Up View: The start-up view provides a link to the Correlated Alerts channel,
which shows all events generated by rules. These events are considered to be events
of interest that warrant attention.

14 ArcSight Web™ User’s Guide Confidential


5 ArcSight Express Content

 Personal Folder: This view contains active channels that you have modified and
saved.
 Recent Channels: This view shows the last five active channels you viewed to enable
you to easily toggle among several active channels without having to navigate to them
in the active channels tab.
For more about the home page, see “Navigating ArcSight Web” on page 5.

Getting Started Using ArcSight Express Content


Whatever your role in the security operations center, you can get started right away using
the ArcSight Express content.

ArcSight Express Groups


ArcSight Express content is organized into the following device groups relevant to the
function the content performs:

Function Description

Cross-Device This group contains resources that monitor and report on functions
that apply to multiple kinds of devices, such as login attempts,
bandwidth usage, and configuration changes.

Anti-Virus This group contains resources that support monitoring and reporting
on anti-virus activity, such as update status, virus activity, and
configuration changes.

Case This group contains resources that support monitoring and reporting
Management on activity and notifications involving cases opened in ArcSight as a
result of activity that warrants investigation.

Database This group contains resources that monitor and report on database
activity, such as configuration changes, database logins, errors and
warnings.

Firewall This group contains resources that monitor and report on firewall
activity, such as network logins and logouts, denied connections,
bandwidth usage, and configuration changes.

Identity This group contains resources that monitor and report on user
Management activity, such as logins, user session durations, and configuration
changes in order to identify who is doing what activity on the
network.

IDS-IPS This group contains resources that monitor and report on activity
involving Intrusion Detection and Prevention Systems, such as
signature updates, alerts, and statistics.

Network This group contains resources that monitor and report on activity
involving network infrastructure, including system up/down status,
configuration changes, bandwidth usage, and login events.

Operating This group contains resources that monitor and report on activity
System involving operating systems, such as user logins, and user
modification events.

VPN This group contains resources that monitor and report on activity
involving VPN connections, including authentication errors, logins,
and connection status.

Vulnerabilities This group contains resources that monitor and report on exposed
vulnerabilities by asset.

Confidential ArcSight Web™ User’s Guide 15


5 ArcSight Express Content

Monitoring with ArcSight Express Active Channels


The active channels contain three major groups of channels:

 ArcSight Administration
 ArcSight Express
 Device Class Event Channels

The staple active channels in the ArcSight Express group are a good place to start for
monitoring event flows. For instructions about how to use active channels, see “Using
Active Channels” on page 19.

16 ArcSight Web™ User’s Guide Confidential


5 ArcSight Express Content

Monitoring with ArcSight Express Dashboards


The dashboards contain the ArcSight Administration and ArcSight Express groups. Explore
the dashboards to find views you are interested in.

The example below shows the IDS-IPS dashboard, which summarizes the number of
events from IDS and IPS systems. Click on any bar to view the details of the events
represented in this bar in a channel.

For more about working with dashboards, see “Monitoring Dashboards” on page 111.

Confidential ArcSight Web™ User’s Guide 17


5 ArcSight Express Content

Reporting with ArcSight Express Reports


The reports also contain the ArcSight Administration and ArcSight Express groups.

The Security Intelligence Status Report provides a summary of event counts and top
events, attacks, targets, ports, and so on, as shown in the example below.

For more about working with reports, see “Using Reports” on page 105.

18 ArcSight Web™ User’s Guide Confidential


Chapter 6
Using Active Channels

The event information presented in the ArcSight Web active channel views is the same data
presented in the Console. The web client makes channels accessible from anywhere on
your enterprise network, or even outside a firewall.

Using active channels includes opening them, controlling their views, and drilling down into
the individual events that channels collect.

“Opening Active Channels” on page 19


“Viewing Active Channels” on page 21
“Inspecting Events” on page 24

Opening Active Channels


To open an active channel, click its name in the Active Channels section of the Home
display, or click the Channels icon in the toolbar and choose a channel in the Active
Channels resource tree. Channels you click in the Home display open directly, but channels
you choose in the resource tree offer a setup page before opening.

Use the Open Active Channel setup display to adjust the timing, filter, and column-set
parameters of the channel, if necessary. This display appears unless you have turned
channel setup off (bypass channel setup) in the Channels panel of the Options display.

There is also an option to hide (collapse) the channel tree on the left panel when a channel
is already running. By default, this tree remains in view. Click the Show ( ) or Hide ( )
buttons at the top of the left panel to show or hide the folder tree.

Active Channel Parameters

Option Description

Channel Read-only field that shows the channel name.

Start Time The relative or absolute time reference that begins the period in
which to actively track the events in the channel. Edit the time
expression or clear the Date expression check box to use an
absolute date and time.

End Time The relative or absolute time reference that ends the period in which
to actively track the events in the channel. Edit the time expression
or clear the Date expression check box to use an absolute date
and time.

Confidential ArcSight Web™ User’s Guide 19


6 Using Active Channels

Option Description

Evaluate Choose whether the channel shows events that are qualified by Start
parameters and End times that are re-evaluated constantly while it is running
continuously (selected), or show only the events that qualify when the channel is
first run (cleared).

Use as Choose the event-timing phase that best supports your analysis.
Timestamp End Time represents the time the event ended, as reported by the
device. Manager Receipt Time is the event's recorded arrival time
at the ArcSight Manager.

Field Set The Field Set you choose here determines which columns show up in
the active channel display. By default, a standard list of columns is
shown in the channel.

Choose an existing field set to control the selection and order of the
columns in the grid or choose More Choices or click the plus sign
(+) to open the Field Sets resource tree. The None option clears a
field set and restores the channel to its original definition.

Global variables make it possible to define a variable that derives


particular values from existing data, then re-use it in multiple places
wherever conditions can be expressed, and wherever fields can be
selected. For more informatin about global variables, see “Global
Variables” on page 483, in the ArcSight Console User Guide.

If your system is configured with domain field sets (a separately-


licensed feature), these are available to select here as field set
choices. For more information about domain field sets, see “Domain
Field Sets” on page 497the Domain Field Sets topic in the ArcSight
Console User’s Guide.

Filter Override You can use the Filter Override to narrow the event flow in the
channel to only those events that satisfy conditions you specify here.
You have these options for Filter Override:

• Simply choose an existing filter. You can choose a recently used


filter from the drop-down menu, or navigate to other filters by
clicking More Choices or clicking the plus sign (+) to override
the default channel filter. (The None option clears a filter choices
and restores the channel to its original definition.)
Or

• Explicitly specify new filter conditions for the channel by using


event attributes (field groups and fields) or an existing filter
(MatchesFilter) as part of a condition.
You can use domain fields to create conditions on channels the
same way that you use other fields. If available, domain field
sets show up under Event Attributes with the other field groups.
For more information about domains, see “Domain Field Sets” on
page 497the Domain Field Sets topic in the ESM User’s Guide.
You can review the conditions of the filter in the active channel
header (see “Using Active Channel Headers” on page 21).

20 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Viewing Active Channels


This topic explains how to understand, change, and drill into the grid views of active
channels.

Using Active Channel Headers


Using active channels begins with reading and understanding their headers. Headers
display the following information:

Feature Usage

Name and The top line of the header shows the channel's name and the
Total percentage of qualifying events that are currently loaded in the
view.

Time Span The Start Time and End Time show the chronological range of the
channel.

Evaluation This flag indicates whether the channel is set to evaluate events
continuously as they are received, or only once when the channel
opens. Click Modify to change this parameter.

Filter This text describes the filter that limits what the channel shows.

Priority Totals On the right side of the header is a column of event-priority category
totals. The figures are the number of events in those categories.

Channel State The channel state box contains a play and pause button and a
refresh progress bar. This display indicates whether the channel is
running or paused, and if it is running, the progress of the next
refresh cycle.

Radar Display The Radar display in active channel headers indicates the activity
taking place in the entire channel (not just the current page). Its
graphics represent units of time horizontally, and numbers of events
in vertical bars segmented by Priority attribute-value counts. The
time and quantity scales in the graphic automatically adjust to
accommodate the scope of the channel. The broader the scope, the
smaller the graphical units become.

To focus the grid on the event of one period, click that bar in the
display. To restore the display, click Clear at the right end of the bar.
Your sorting choices in the grid affect the arrangement of the activity
units in the Radar.

Time Range The Displaying bar below the Radar display and above the grid
header shows the time range of the events selected in the Radar
display and reflected in the grid. If nothing is selected, the time
range shows All.

Using Active Channel Grids


Event grids display the individual events that active channels capture.

To page through a grid


Click the navigation buttons on the right side of the grid column header. The numbers
represent specific pages, and the advance arrows go one step or all the way forward or
back.

Confidential ArcSight Web™ User’s Guide 21


6 Using Active Channels

To use field sets


Choose a named set of fields from the Field Set drop-down menu. The sets available are
usually tailored to your enterprise. Note that the field-set variables found in the ArcSight
Console are not available through ArcSight Web.

Choose the Field Set Customize option (if available) to temporarily add, remove, or
rearrange the columns in the current grid. You can create one custom field set per channel.

If your ESM system is configured with domain field sets, these are also available here to
select as a pre-defined Field Set choice and for use with the Customize option. For more
information about domain field sets, see the Domain Field Sets topic in the ArcSight
Console User’s Guide.

To sort a grid
Click any grid column heading to sort the whole view by that column. Each click toggles
between ascending and descending. The default order of grids is usually determined by the
End Time of events, as selected in the current active channel display.

To filter a grid
To apply an inline filter, click Inline Filter in the grid header and choose an available value
from the drop-down menus for one or more columns. This enables you to filter by values
already available in the channel. Click Apply to put the filter into effect.

You can also filter by entering custom expressions into the text field for each column. To
customize an inline filter, type a value in the text field above the column on which you want
to filter, and click Apply. Supported expressions for custom filtering are shown in the table
below.

22 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Supported Expressions for Inline Filtering

Type Supported Expressions and Examples

String-based The Contains and StartsWith operators are supported. The


Columns values for the operator must be in quotes.

Examples:

Contains "Event"
Contains "Event" OR Contains "Top"
Contains "Web" AND Contains "denied"
StartsWith "Web"
StartsWith "Web" OR Contains "denied"
StartsWith "Web" AND Contains "denied"
You can use OR and AND Boolean operators in between the
expressions. The Column field name is implicitly used as the
left-hand parameter.

Integer and IP The Between operator is supported. The values in the Between
Address Columns expression must be in quotes.

Examples:

For the port column: Between("20", "80")


For the IP address column: Between("10.0.0.1",
"10.0.0.255")
For priority column: Between("1","2") OR
Between("7","8")
You can use OR and AND Boolean operators in between the
expressions. The Column field name is implicitly used as the
left-hand parameter.

To add an event to a case


Select one or more event check boxes on the left, then click Add to Case to choose an
existing or new case to add it to in the Cases resource tree. Click the Existing case radio
button to add the events to the case you select in the tree. Click the New case radio
button to name the case and add it at the currently selected point in your personal tree.
Click Add to save the assignments and return to the grid.

To view the events associated with a case, click the Cases navigation button at the top
of the page, choose a case, and click the Events tab for that case. For more information,
see “Events Tab” on page 101 in “Using Cases” on page 95.

To change a grid's options


Click Options in the grid header to change the display's update frequency and its number
of rows per page.

To save a modified channel


Click Save Channel As in the channel header to add a modified channel to your personal
folder in the Active Channels resource tree. In the Save Channel As dialog box, name the
channel and click Save.

Confidential ArcSight Web™ User’s Guide 23


6 Using Active Channels

To inspect an event
Click any individual event in the grid to show that event in the Event Inspector as described
in Inspecting Events.

Inspecting Events
Use the Event Inspector display to examine the details of events that appear in active
channels. To open the Event Inspector, click an event in an active channel's grid view. The
Event Inspector shows the data fields and categories associated with the event you
selected. Apart from these fields, the display has the features described below.

Event Inspector Header Features


Feature Usage

Associated Articles If a knowledge base article exists for this event, the View
Articles link displays the article from the Knowledge Base.

Associated References If a reference page exists for this event, the View
References link displays the reference page. Reference
pages provide additional background on an event or a
resource. These may be pre-populated by ArcSight,
provided by vendors, or added by technologists in your
organization.

Additional Details Click this link to view Additional Details on the event,
such as vendor and product information, event category
information, reference pages, and vulnerability pages.

View Event Context Click this link to run an Event Context Report that shows
Report the events that occurred within a specified number of
minutes (a window) before and after this event.

View Rule Context Click this link to run a Rule Context Report that shows
Report the events that occurred within a specified number of
minutes (a window) before and after the current rule was
invoked.

Payload Viewer Click this link to view the payload for the event. The
Payload Viewer option is available only if the event has a
payload associated with it. A "payload" is information
carried in the body of an event's network packet, as distinct
from the packet's header data. Events include payloads
only if the associated SmartConnectors are configured to
send events with payloads.

View iDefense Incident Click View iDefense Incident Report to view information
Report about vulnerability IDs related to the event. This option is
available only if you have VeriSign iDefense software
installed and configured to interact with the Arcsight
system, and if the selected event has a vulnerability ID
associated with it. In that case, the iDefense report
provides more details on the vulnerability.

Field Sets Choose Field Sets to see a predefined set of event data
fields rather than all fields. Use the None option to restore
the default view.

Hide Empty Rows By default, the Hide Empty Rows check box is checked,
so the display isn't filled with unused fields. Clear the check
box to see all fields, even if empty.

24 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Event Inspector Field Features


The values for fields in events are also links. Click these values to open new channels or to
filter current channels using them.

Option Use

Create Channel  Open a channel containing only those events that have
[Field Name = Value] matching values for the selected field.

Create Channel  Open a channel that shows only those events that do
[Field Name != Value] not have a matching value for the selected event.

Add to Channel Add the attribute-value pair to the channel's filter


[Attribute = Value] (require that they match).

Add to Channel Exclude the attribute-value pair from the channel's


[Attribute != Value] filter (require that they do not match).

Show Details for Event Attributes


View details for each attribute associated with an event.

 To view event attribute details inline, click the Details button ( ) next to the
attribute.
 To view event attribute details on a new Web page, click the Show detail in a new
page button ( ) next to the attribute.

Event Categories
ESM uses six primary categories and a flexible set of supporting attributes to more
precisely distinguish the events reported by SmartConnectors or generated internally by
ArcSight Managers. These categories appear as a field in the Event Inspector.

These categories and attributes are designated by ArcSight, based on the information
offered to SmartConnectors by sensors. Keep in mind that the applicability of a category
always depends on the actual configuration of the environment.

The category groups are:

 Object: The physical or virtual object that was the focus of the event. (See “Object
Category” on page 26.)
 Behavior: The action taken on the object. (See “Behavior Category” on page 27.)
 Outcome: An indication of whether the action succeeded on the object. (See
“Outcome Category” on page 29.)
 Device Group: The type of device from which the sensor reported the event. (See
“Device Group Category” on page 29.)
 Technique: The method used to apply the action to the object (i.e., the type of
attack). (See “Technique Category” on page 30.)
 Significance: A description of the security significance of the event from the
reporting sensor's perspective. (See “Significance Category” on page 32.)

Confidential ArcSight Web™ User’s Guide 25


6 Using Active Channels

Object Category

Object Category Description

Host Any end-system on the network, such as a PDA, a


Windows computer, or a Linux computer.

Operating System The system software that controls execution of


computer programs and access to resources on a host.

Application A software program that is not an integral part of the


operating system.

Service An application that normally executes at operating


system startup. A service often accepts network
connections.

Database A database application.

Backdoor An application, visible on a host, that listens for


network connections and can give a non-authorized
user control over that host.

DoS Client A host that is displaying an application that can


participate in a (possibly distributed) denial-of-service
attack.

Peer to Peer An application that listens for, and establishes network


connections to, other installations of the same
application such as Kazaa, Morpheus, or Napster.

Virus A host that is displaying a replicating infection of a file


that also executes other behaviors on the infected
host.

Worm A host that is displaying a self-replicating program that


spreads itself automatically over the network from one
computer to the next.

Resource An operating system resource that is characteristically


limited in its supply.

File A long-term storage mechanism (e.g., files, directories,


hard disks, etc.).

Process A single executable module that runs concurrently with


other executable modules.

Interface An interface to the network.

Interface Tunnel Packaging a lower network protocol layer within a


higher layer such as IPSec Tunnel and HTTP tunneling.

Registry The central configuration repository for the operating


system and the applications. Application-specific
information is not stored here.

CPU Events directed at this object relate to consumption or


use of the overall processing power of the host.

Memory Events directed at this object relate to consumption or


use of the overall memory of the host.

Network Events that cannot be clearly associated with a host's


subitem. Events that involve transport, or many hosts
on the same subnet.

26 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Object Category Description

Routing Routing related events such as BGP.

Switching Switching related events such as VLANS.

Actor

User A single human identity.

Group A named collection of users, such as an employee


division or social group.

Vector The replication path for a section of malicious code.

Virus A replicating infection of a file that also executes other


behaviors on the infected host.

Worm A self-replicating program that automatically spreads


itself across the network, from one computer to the
next.

Backdoor An application that listens for network connections and


can give a non-authorized user control over that host.

DoS Client An application that participates in a (possibly


distributed) denial-of-service attack.

Behavior Category

Behavior
Description
Category

Access Refers to accessing objects, as in reading.

Start The start of an ongoing access, such as login.

Stop The end of an ongoing access, such as logging out.

Authentication Actions that support authentication.

Add Adding new authentication credentials.

Delete Deleting authentication credentials.

Modify Modifying authentication credentials.

Verify Credential verification, such as when logins occur.

Authorization Authorization-related actions.

Add Adding a privilege for the associated object (for


example, a user).

Delete Removing a privilege for the associated object (for


example, a user).

Modify Modifying the existing privileges for the associated


user or entity.

Verify An authorization check, such as a privilege check.

Communicate Transactions that occur over the wire.

Confidential ArcSight Web™ User’s Guide 27


6 Using Active Channels

Behavior
Description
Category

Query Communicating a request to a service.

Response Communicating a response to a request, from a


service.

Create Seeks to create resources, install applications or


services, or otherwise cause a new instance of an
object.

Delete The reverse of creation events. Includes uninstalling


applications, services, or similar activity.

Execute Involves loading or executing code, booting or shutting


systems down, and similar activity.

Start The beginning of execution of an application or service.


This event is clearly distinguished from a lone
"Execute" attribute.

Stop The termination of execution of an application or


service. This event is clearly distinguished from a lone
"Execute" attribute.

Query A query sent to a specific entity - but not over the


network such as when generating a report.

Response The answer returned by an Execute/Query. For


example, a report delivered back from an application,
or status messages from applications.

Modify Involves changing some aspect of an object.

Content Changing the object's content, such as writing to or


deleting from a file or database.

Attribute Changing some attribute of an object, such as a file


name, modification date, or create date.

Configuration Changing an object's configuration. For example,


application, operating system, or registry changes.

Substitute Replacing files, upgrading software, or service or host


failovers.

Found Noticing an object or its state.

Vulnerable An exploitable state that is characteristic of a particular


hardware or software release.

Misconfigured An exploitable state caused by a weak configuration or


similar mishandling.

Insecure An exploitable state that arises from poor management


or implementation. For example, weak authentication,
weak passwords, passwords passed in the clear,
default passwords, or simplistically named accounts.

Exhausted The targeted object was found to be exhausted (for


example, not enough file descriptors are available).

28 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Outcome Category
These attributes indicate the probable success or failure of the specified event, within an
overall context. For example, the outcome of an event such as an "operation failed" error
message can be reported as a "/Success" given that the operation can be presumed to
have actually caused a failure. Another example would be an event that identifies a Code
Red infection: on a host running Linux the outcome would be "/Failure" (Code Red is
Windows-only) while the same event directed at a host with an unknown OS would be
reported as an "/Attempt.

Outcome
Description
Category

Attempt The event occurred but its success or failure cannot be determined.

Failure The event can be reasonable presumed to have failed.

Success The event can be reasonable presumed to have succeeded.

Device Group Category

Device Group
Description
Category

Application An application program.

Assessment Tool A network- or host-based scanner that monitors issues


such as vulnerability, configurations, and ports.

Security A security-event processing correlation engine (such as


Information the Manager). This "device" deals only in correlated
Manager events.

Firewall A firewall.

IDS An intrusion-detection system.

Network A network-based intrusion-detection system.

Host A host-based intrusion-detection system.

Antivirus An anti-virus scanner.

File Integrity A file-integrity scanner.

Identity Identity management.


Management

Operating System An operating system.

Network Network equipment.


Equipment

Router A network device with routing (layer 3) capabilities.

Switches A network device with switching (layer 2) capabilities.

VPN A virtual private network.

Confidential ArcSight Web™ User’s Guide 29


6 Using Active Channels

Technique Category

Technique
Description
Category

Traffic An anomaly in the network traffic, such as non-RFC


compliance.

Network Layer Anomalies related to IP, ICMP, and other network-layer


protocols.

IP Fragment Fragmented IP packets.

Man in the Middle A man-in-the-middle attack.

Spoof Spoofing a source or destination IP address.

Flow A problem in network-layer communication logic, such as


an out-of-order IP fragment.

Transport Layer Anomalies related to TCP, UDP, SSL, and other transport-
layer protocols.

Hijack Hijacking a connection.

Spoof Spoofing a transport layer property such as a TCP port


number, or an SSL entity.

Flow A problem in TCP connections or flows, such as a SYNACK


without SYN, a sequence number mismatch, or time
exceeded.

Application Layer Application-layer anomalies.

Flow A peer does not follow the order of commands.

Syntax Error A syntax error in an application-layer command.

Unsupported A command which does not exist or is not supported.


Command

Man in the Middle A man-in-the-middle attack on the application layer.

Exploit Vulnerability Exploiting a vulnerability such as a buffer overflow, code


injection, or format string.

Weak Exploitation of a weak configuration. This is something


Configuration that could be remedied easily by changing the
configuration of the service Examples of a weak
configuration are weak passwords, default passwords,
insecure software versions, or open SMTP relays.

Privilege Escalation A user identity has received an increase in its user


privileges.

Directory A user identity is attempting to browse or methodically


Transversal review directories for which it may not have appropriate
privileges.

Brute Force Brute-force attacks.

Login Continued trials for logins.

URL Guessing Continued trials for URLs to access information or scripts.

Redirection Redirecting an entity.

30 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Technique
Description
Category

ICMP ICMP redirects.

DNS Unauthorized DNS changes.

Routing Protocols Attacks aimed at routing protocols such as BGP, RIP, and
OSPF.

IP Redirection using the IP protocol (source routing).

Application Redirection attacks on the application layer such as cross-


site scripting, mail routing, or JavaScript spoofing.

Code Execution Either the execution or transmission of executable code,


or the transmission of a distinctive response from
executed code.

Trojan The code in question is concealed within other code that


serves as a Trojan Horse. In other words, it appears to be
one thing (that is safe) but is really another (which is
unsafe).

Application The code in question is intended to invoke an application


Command command.

Shell Command The code in question is intended to be executed in a shell.

Worm Code associated with a worm.

Virus Code associated with a virus.

Scan Any type of scanning. A network, host, application, or


operating system scan can be identified through the
specified object.

Port Multiple ports are scanned.

Service A service is scanned (for example, DoS client discovery,


backdoors, RPC services, or scans for a specific
application such as NMB).

Host Scanning for hosts on a network.

IP Protocol A search for responding protocols. Note that TCP and UDP
are not the only transport protocols available.

Vulnerability A scan for vulnerabilities.

DoS A denial of service (DoS) attack is in progress.

Information Information leaking out of its intended environment such


Leak as mail messages leaking out, system file access, FTP
data access, or web document access.

Convert Channel Leakage was detected from a covert channel such as Loki.

Policy Policy-related violations such as pornographic web site


access.

Breach A policy-related security breach occurred.

Compliant A policy-compliant event occurred.

Confidential ArcSight Web™ User’s Guide 31


6 Using Active Channels

Significance Category

Significance
Description
Category

Compromise A potentially compromising event occurred.

Hostile A malicious event has happened or is happening.

Informational Events considered worthy of inspection; for example,


those produced by polling.

Error An execution problem.

Warning A possible problem.

Alert A situational problem that requires immediate


attention.

Normal Ordinary or expected activity that is significant only for


forensic purposes.

Recon Relates to scans and other reconnaissance activity.

Suspicious A potentially malicious event occurred.

Event Data Fields


The security monitoring devices report events that are collected, filtered, and formatted by
ArcSight SmartConnectors and passed to Managers for analysis. The events that appear in
your client are composed of several data fields, each of which has its own characteristics.

Event data fields fall into the groups shown below. Most groups have several attributes.

 Connector
 Attacker
 Category
 Destination
 Device
 Device Custom
 Event
 Event Annotation
 File
 Final Device
 Flex
 Manager
 Old File
 Original Agent
 Request
 Source
 Target
 Threat

32 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Connector
This category falls into the device-to-Manager information chain. The chain begins at
Device, which is the actual network hardware that senses an event. In cases where data is
concentrated or otherwise pre-processed, it may be passed to a trusted reporting Final
Device before reaching an Original Agent (agents are also known as SmartConnectors).
Although the Original Agent is usually the only connector, if the data passes up through a
Manager hierarchy the chain includes handling by Connector stages that are the ArcSight
Manager SmartConnectors that facilitate Manager-to-Manager connections.

Default Turbo Level


Data
Group Label Script Alias Type Description

Connector Address connectorAddress IP address 1 The IP address of the


device hosting the
SmartConnector.

Connector Asset ID connectorAssetId Resource 1 The asset that


represents the device
hosting the
SmartConnector.

Connector Asset connectorAssetName String 1 The connector's asset


Name name.

Connector Asset connectorAssetResource Resource 1 The connector


Resource resource.

Connector Descriptor connectorDescriptorId ID 1 The connector


ID descriptor.

Connector DNS connectorDnsDomain String 1 The Domain Name


Domain Service domain name
associated with the
device hosting the
SmartConnector.

Connector Host connectorHostName String 1 The name of the device


Name hosting the
SmartConnector.

Connector ID connectorId String 1 The identifier


associated with the
SmartConnector
configuration resource.
The format is
connectorID(1) |
connectorID(2) | …

Connector MAC connectorMacAddress MacAddre 1 The MAC address


Address ss associated with the
SmartConnector (which
may or may not be the
MAC address of the
host device.)

Confidential ArcSight Web™ User’s Guide 33


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Connector Name connectorName String 1 The user-supplied


name of the associated
SmartConnector
configuration resource.

Connector NT connectorNtDomain String 1 The Windows NT


Domain domain associated with
the device hosting the
SmartConnector.

Connector Receipt connectorReceiptTime DateTime 2 The time the event


Time arrived at the
SmartConnector.

Connector Severity connectorSeverity Connector 1 The normalized


Severity ArcSight form of the
Enumerati event severity value
on provided by the
SmartConnector.

Connector Time connectorTimeZone String 1 The time zone reported


Zone by the device hosting
the SmartConnector
(as TLA).

Connector Time connectorTimeZoneOffset Integer 1 The time zone reported


Zone by the device hosting
Offset the SmartConnector
(shown as a UTC
offset). Note that
device times may be
less accurate than
other sources.

Connector Translated connectorTranslatedAddress IP address 1 If network address


Address translation is an issue,
this is the translated IP
address of the device
hosting the
SmartConnector.

Connector Translated connectorTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the Network
Zone associated with
the translated IP
address of the device
hosting the
SmartConnector.

Connector Translated connectorTranslatedZoneExt String 1 See the common set of


Zone ernalID resource attributes.
External
ID

34 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Connector Translated connectorTranslatedZoneID String 1 See the common set of


Zone ID resource attributes.

Connector Translated connectorTranslatedZoneNa String 1 See the common set of


Zone me resource attributes.
Name Returns the name from
the URI. It assumes
that the name is always
the last field of the URI.

Connector Translated connectorTranslatedZoneRef ID 1 See the common set of


Zone erenceID resource attributes.
Reference Returns the unique
ID descriptor ID for this
reference.

Connector Translated connectorTranslatedZoneRe Resource 1 See the common set of


Zone source resource attributes.
Resource Locates the resource
described by this
reference.

Connector Translated connectorTranslatedZoneUR String 1 See the common set of


Zone URI I resource attributes.

Connector Type connectorType String 1 A description of the


type of SmartConnector
that reported the
event.

Connector Version connectorVersion String 1 The software revision


number of the
SmartConnector that
reported the event

Connector Zone connectorZone Zone 1 The network zone in


which the device
hosting this
SmartConnector
resides.

Connector Zone connectorZoneExternalID String 1 See the common set of


External resource attributes.
ID

Connector Zone ID connectorZoneID String 1 See the common set of


resource attributes.

Connector Zone connectorZoneName String 1 See the common set of


Name resource attributes.

Connector Zone connectorZoneReferenceID ID 1 See the common set of


Reference resource attributes.
ID

Confidential ArcSight Web™ User’s Guide 35


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Connector Zone connectorZoneResource Resource 1 See the common set of


Resource resource attributes.

Connector Zone URI connectorZoneURI String 1 Returns the URI for this
reference.

Attacker

Default Turbo Level


Data
Group Label Script Alias Type Description

Attacker Address attackerAddress IP address 1 The IP address of the


device hosting the
attacker.

Attacker Asset ID attackerAssetId Resource 2 The asset that


represents the device
hosting the attacker.

Attacker Asset attackerAssetName String 2 The name of the asset


Name that represents the
device hosting the
attacker.

Attacker Asset attackerAssetResource Resource 2 See the common set of


Resource resource attributes

Attacker DNS attackerDnsDomain String 2 The Domain Name


Domain Service domain name
associated with the
device hosting the
attacker.

Attacker FQDN attackerFqdn String 2 The fully qualified


domain name
associated with the
device hosting the
attacker.

Attacker Geo attackerGeo GeoDescri 1 See the common set of


ptor geographical attributes.

36 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Attacker Geo attackerGeoCountryCode String 1 See the common set of


Country geographical attributes.
Code

Attacker Geo attackerGeoCountryFlagUrl String 1 See the common set of


Country geographical attributes.
Flag URL

Attacker Geo attackerGeoCountryName String 1 See the common set of


Country geographical attributes.
Name

Attacker Geo attackerGeoDescriptorId ID 1 See the common set of


Descriptor geographical attributes.
ID

Attacker Geo attackerGeoLatitude Double 1 See the common set of


Latitude geographical attributes.

Attacker Geo attackerGeoLocationInfo String L See the common set of


Location o geographical attributes.
Info c
a
ti
o
n

Attacker Geo attackerGeoLongitude Double 1 See the common set of


Longitude geographical attributes.

Attacker Geo attackerGeoPostalCode String 1 See the common set of


Postal geographical attributes.
Code

Attacker Geo attackerGeoRegionCode String 1 See the common set of


Region geographical attributes.
Code

Attacker Host attackerHostName String 2 The name of the device


Name hosting the attacker.

Attacker MAC attackerMacAddress MAC 2 The MAC address


Address address associated with the
source of the attack
(which may or may not
be the MAC address of
the host device).

Attacker NT attackerNtDomain String 2 The Windows NT


Domain domain associated with
the device hosting the
attacker.

Attacker Port attackerPort Integer 1 The network port


associated with the
source of the attack.

Confidential ArcSight Web™ User’s Guide 37


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Attacker Process attackerProcessName String 2 The name of process


Name associated with the
source of the attack.

Attacker Service attackerServiceName String 2 The name of service


Name associated with the
source of the attack.

Attacker Translated attackerTranslatedAddress IP address 1 If network address


Address translation is an issue,
this is the translated IP
address of the device
hosting the attacker.

Attacker Translated attackerTranslatedPort Integer 1 If network address


Port translation is an issue,
this is the translated
source port associated
with the attack. This
can happen in a NAT
environment.

Attacker Translated attackerTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the device hosting the
attacker.

Attacker Translated attackerTranslatedZoneExte String 1 See the common set of


Zone rnalID resource attributes.
External
ID

Attacker Translated attackerTranslatedZoneID String 1 See the common set of


Zone ID resource attributes.

Attacker Translated attackerTranslatedZoneNam String 1 See the common set of


Zone e resource attributes. It
Name is assumed that the
name is always the last
field of the URI.

Attacker Translated attackerTranslatedZoneRefe ID 1 See the common set of


Zone renceID resource attributes.
Reference
ID

Attacker Translated attackerTranslatedZoneReso Resource 1 See the common set of


Zone urce resource attributes.
Resource

Attacker Translated attackerTranslatedZoneURI String 1 See the common set of


Zone URI resource attributes.

38 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Attacker User ID attackerUserId String 2 The identifier


associated with the OS
or application of the
attacker, at the source
of the attack.

Attacker User attackerUserName String 2 The name associated


Name with the attacker, at the
source of the attack.

Attacker User attackerUserPrivileges String 2 The user-privilege


Privileges associated with the
attacker, at the source
of the attack.

Attacker Zone attackerZone Zone 1 The network zone in


which the attacker's
device resides.

Attacker Zone attackerZoneExternalID String 1 See the common set of


External resource attributes.
ID

Attacker Zone ID attackerZoneID String 1 See the common set of


resource attributes.

Attacker Zone attackerZoneName String 1 See the common set of


Name resource attributes. It
is assumed that the
name is always the last
field of the URI.

Attacker Zone attackerZoneReferenceID ID 1 See the common set of


Reference resource attributes.
ID

Attacker Zone attackerZoneResource Resource 1 See the common set of


Resource resource attributes.

Attacker Zone URI attackerZoneURI String 1 See the common set of


resource attributes.

Confidential ArcSight Web™ User’s Guide 39


6 Using Active Channels

Category
See “Event Categories” on page 25 for a complete description of the event category types
and their supporting attributes.

Default Turbo Level


Data
Group Label Script Alias Type Description

Category Behavior categoryBehavior String 1 Describes the action


taken with or by the
object.

Category Custom categoryCustomFormatField String 1 Describes the content


Format of a custom formatted
Field field, if present.

Category Descriptor categoryDescriptorId ID 1 The unique ID for the


ID sensor that reported
the event

Category Device categoryDeviceGroup String 1 Describes the type of


Group event this event
represents.

Category Object categoryObject String 1 Describes the physical


or virtual object that
was the focus of the
event

Category Outcome categoryOutcome String 1 Indicates whether the


action was successfully
applied to the object.

Category Significan categorySignificance String 1 Characterizes the event


ce from a network-
intrusion-detection
perspective.

Category Technique categoryTechnique String 1 Describes the method


used to apply the
action to the object.

Category Tuple categoryTupleDescription String 1 The prose description


Descriptio of the event category,
n assembled from the
category components.

40 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Destination

Default Turbo Level


Data
Group Label Script Alias Type Description

Destination Address destinationAddress IP address 1 The IP address of the


destination device.

Destination Asset ID destinationAssetId Resource 2 The asset that


represents the device
that was the network
traffic's destination.

Destination Asset destinationAssetName String 2 See the common set of


Name resource attributes.

Destination Asset destinationAssetResource Resource 2 See the common set of


Resource resource attributes.

Destination DNS destinationDnsDomain String 2 The Domain Name


Domain Service domain name
associated with the
user at the destination
device.

Destination FQDN destinationFqdn String 2 The fully qualified


domain name
associated with the
destination device.

Destination Geo destinationGeo GeoDescri See the common set of


ptor geographical attributes.

Destination Geo destinationGeoCountryCode String 1 The country code.


Country
Code

Destination Geo destinationGeoCountryFlag String 1 The country flag.


Country Url
Flag URL

Destination Geo destinationGeoCountryNam String 1 The country name.


Country e
Name

Destination Geo destinationGeoDescriptorId ID 1 See the common set of


Descriptor geographical attributes.
ID

Destination Geo destinationGeoLatitude Double 1 The destination


Latitude latitude.

Destination Geo destinationGeoLocationInfo String 1 The destination


Location location.
Info

Destination Geo destinationGeoLongitude Double 1 The destination


Longitude longitude.

Confidential ArcSight Web™ User’s Guide 41


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Destination Geo destinationGeoPostalCode String 1 The destination postal


Postal code.
Code

Destination Geo destinationGeoRegionCode String 1 See the common set of


Region geographical attributes.
Code

Destination Host destinationHostName String 2 The name of the


Name destination device.

Destination MAC destinationMacAddress MAC 2 The MAC address


Address address associated with the
network traffic's
destination (which may
or may not be the MAC
address of the host
device).

Destination NT destinationNtDomain String 2 The Windows NT


Domain domain associated with
the destination device.

Destination Port destinationPort Integer 1 The network port


associated with the
network traffic's
destination.

Destination Process destinationProcessName String 2 The name of process


Name associated with the
network traffic's
destination.

Destination Service destinationServiceName String 2 The name of service


Name associated with the
network traffic's
destination.

Destination Translated destinationTranslatedAddres IP address 1 If network address


Address s translation is an issue,
this is the translated IP
address of the device
that was the network
traffic's destination.

Destination Translated destinationTranslatedPort Integer 1 If network address


Port translation is an issue,
this is the translated
source port associated
with the attack.

42 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Destination Translated destinationTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the device at the
network's traffic's
destination.

Destination Translated destinationTranslatedZoneE String 1 See the common set of


Zone xternalID resource attributes.
External
ID

Destination Translated destinationTranslatedZoneI String 1 See the common set of


Zone ID D resource attributes.

Destination Translated destinationTranslatedZoneN String 1 See the common set of


Zone ame resource attributes.
Name

Destination Translated destinationTranslatedZoneR ID 1 See the common set of


Zone eferenceID resource attributes.
Reference

Destination Translated destinationTranslatedZoneR Resource 1 See the common set of


Zone esource resource attributes.
Resource

Destination Translated destinationTranslatedZoneU String 1 See the common set of


Zone URI RI resource attributes.

Destination User ID destinationUserId String 2 The OS- or application-


based identifier
associated with the
user at the network
traffic's destination.

Destination User destinationUserName String 2 The name associated


Name with the user at the
network traffic's
destination.

Destination User destinationUserPrivileges String 2 The privileges accorded


Privileges the user at the network
traffic destination.

Destination Zone destinationZone Zone 1 The network zone in


which the destination
device resides.

Destination Zone destinationZoneExternalID String 1 See the common set of


External resource attributes.
ID

Confidential ArcSight Web™ User’s Guide 43


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Destination Zone ID destinationZoneID String 1 See the common set of


resource attributes.

Destination Zone destinationZoneName String 1 See the common set of


Name resource attributes.

Destination Zone destinationZoneReferenceID ID 1 Returns the unique


Reference descriptor ID for this
ID reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Destination Zone destinationZoneResource Resource 1 See the common set of


Resource resource attributes.

Destination Zone URI destinationZoneURI String 1 See the common set of


resource attributes.

Device
This category falls into the device-to-Manager information chain. The chain begins at
Device, which is the actual network hardware that senses an event. In cases where data is
concentrated or otherwise pre-processed, it may be passed to a trusted reporting Final
Device before reaching an Original Connector. Although the Original Connector is
usually the only connector, if the data passes up through a Manager hierarchy the chain
includes handling by Connector stages that are the Manager SmartConnectors that
facilitate Manager-to-Manager connections.
Default Turbo Level

Data
Group Label Script Alias Type Description

Device Action deviceAction String 2 The device-specific


description of some
activity associated with
the event

Device Address deviceAddress IP address 1 The IP address of the


device hosting the
sensor.

Device Asset ID deviceAssetId Resource 1 The asset that


represents the device
hosting the sensor.

44 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Device Asset deviceAssetName String 1 The name of the


Name device.

Device Asset deviceAssetResource Resource 1 The resource the asset


Resource represents.

Device Descriptor deviceDescriptorId ID 1 The asset's descriptor


ID ID.

Device Direction deviceDirection DeviceDir 2 Whether the traffic was


ectionEnu inbound or outbound.
meration

Device DNS deviceDnsDomain String 1 The Domain Name


Domain Service domain name
associated with the
device hosting the
sensor.

Device Domain deviceDomain String 2 The specific domain


containing the sensor
device associated with
the event

Device Event deviceEventCategory String 2 The category


Category description included
with the event as
reported by the device.

Device Event deviceEventClassId String 2 The device-specific


Class ID identifier associated
with this type of event

Device External deviceExternalId String 1 The external identifier


ID associated with this
sensor device, if
provided by the vendor.

Device Facility deviceFacility String 1 The sensor submodule


that reported the event

Device Host deviceHostName String 1 The name of the device


Name hosting the sensor.

Device Inbound deviceInboundInterface String 1 The NIC card on the


Interface sensor device that
received the network
traffic associated with
the event.

Device MAC deviceMacAddress MAC 1 The MAC address


Address address associated with the
source of the attack
(which may or may not
be the MAC address of
the host device).

Confidential ArcSight Web™ User’s Guide 45


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Device NT deviceNtDomain String 1 The Windows NT


Domain domain associated with
the device hosting the
sensor.

Device Outbound deviceOutboundInterface String 1 The NIC card on the


Interface sensor device that
transmitted the
network traffic
associated with the
event.

Device Payload devicePayloadId String 2 The internal identifier


ID associated with a
payload object
associated with this
event.

Device Process deviceProcessName String 1 The sensor device


Name process that reported
the event.

Device Product deviceProduct String 1 The product name of


the sensor device.

Device Receipt deviceReceiptTime DateTime 2 The time when the


Time sensor device observed
the event.

Device Severity deviceSeverity String 2 The device-specific


assessment of event
severity. This
assessment varies with
the device involved.

Device Time deviceTimeZone String 1 The time zone reported


Zone by the device hosting
the sensor device
(shown as TLA).

Device Time deviceTimeZoneOffset Integer 1 The time zone reported


Zone by the device hosting
Offset this sensor device
(shown as an offset
from UTC).

Device Translated deviceTranslatedAddress IP address 1 If network address


Address translation is an issue,
this is the translated IP
address of the device
hosting the sensor.

46 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Device Translated deviceTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the device hosting the
sensor.

Device Translated deviceTranslatedZoneExtern String 1 See the common set of


Zone alID resource attributes.
External
ID

Device Translated deviceTranslatedZoneID String 1 See the common set of


Zone ID resource attributes.

Device Translated deviceTranslatedZoneName String 1 See the common set of


Zone resource attributes.
Name

Device Translated deviceTranslatedZoneRefere ID 1 Returns the unique


Zone nceID descriptor ID for this
Resource reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Device Translated deviceTranslatedZoneResour Resource 1 See the common set of


Zone ce resource attributes.
Resource

Device Translated deviceTranslatedZoneURI String 1 See the common set of


Zone URI resource attributes.

Device Vendor deviceVendor String 1 The vendor who


manufactured or sold
the sensor device.

Device Version deviceVersion String 1 The software revision


number of the sensor
device.

Device Zone deviceZone Zone 1 The network zone in


which the sensor's
device resides.

Device Zone deviceZoneExternalID String 1 See the common set of


External resource attributes.
ID

Device Zone ID deviceZoneID String 1 See the common set of


resource attributes.

Confidential ArcSight Web™ User’s Guide 47


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Device Zone deviceZoneName String 1 See the common set of


Name resource attributes.

Device Zone deviceZoneReferenceID ID 1 Returns the unique


Reference descriptor ID for this
ID reference. This is
populated only if this
reference has been
persisted and given a
unique database
identifier.

Device Zone deviceZoneResource Resource 1 See the common set of


Resource resource attributes.

Device Zone URI deviceZoneURI String 1 See the common set of


resource attributes.

Device Custom
Default Turbo Level

Data
Group Label Script Alias Type Description

Device Date1 deviceCustomDate1 DateTime 2 First customDate


Custom

Device Date1 deviceCustomDate1Label String 2 First customDate label


Custom Label

Device Date2 deviceCustomDate2 DateTime 2 Second customDate


Custom

Device Date2 deviceCustomDate2Label String 2 Second customDate


Custom Label label

Device Descriptor deviceCustomDescriptorId ID 2 Custom descriptior ID


Custom ID

Device Number1 deviceCustomNumber1 Long 2 First customNumber


Custom

Device Number1 deviceCustomNumber1Labe String 2 First customNumber


Custom Label l label

48 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Device Number2 deviceCustomNumber2 Long 2 Second customNumber


Custom

Device Number2 deviceCustomNumber2Labe String 2 Second customNumber


Custom Label l label

Device Number3 deviceCustomNumber3 Long 2 Third customNumber


Custom

Device Number3 deviceCustomNumber3Labe String 2 Third customNumber


Custom Label l label

Device String1 deviceCustomString1 String 2 First customString


Custom

Device String1 deviceCustomString1Label String 2 First customString label


Custom Label

Device String2 deviceCustomString2 String 2 Second customString


Custom

Device String2 deviceCustomString2Label String 2 Second customString


Custom Label label

Device String3 deviceCustomString3 String 2 Third customString


Custom

Device String3 deviceCustomString3Label String 2 Third customString


Custom Label label

Device String4 deviceCustomString4 String 2 Fourth customString


Custom

Device String4 deviceCustomString4Label String 2 Fourth customString


Custom Label label

Device String5 deviceCustomString5 String 2 Fifth customString


Custom

Device String5 deviceCustomString5Label String 2 Fifth customString label


Custom Label

Device String6 deviceCustomString6 String 2 Sixth customString


Custom

Device String6 deviceCustomString6Label String 2 Sixth customString


Custom Label label

Confidential ArcSight Web™ User’s Guide 49


6 Using Active Channels

Event

Default Turbo Level


Group Label Script Alias Data Type Description

Event Additional additionalData AdditionalData 3 Reference to additional


Data data.

Event Aggregated (not applicable) (not n A derived field that


Event Count applicable) / reports the number of
a actual events
collectively represented
by the event in
question.

Event Application applicationProtocol String 2 A description of the


Protocol application layer
protocol. May be set,
but defaults to Target
Port lookup (FTP).

Event Base Event baseEventCount Integer 1 The number of events


Count upon which this event
is based (e.g., type ==
BASE|ACTION).

Event Base Event baseEventIds ID 2 The array of event IDs


IDs that contributed to
generating this
correlation event. This
is populated only in
correlated events.

Event Bytes In bytesIn Integer 2 Number of bytes


transferred into the
device during this
transaction (this would
typically be associated
with entries in HTTP
logs).

Event Bytes Out bytesOut Integer 2 Number of bytes


transferred out of the
device during this
transaction (this would
typically be associated
with entries in HTTP
logs).

Event Concentrator concentratorConne ConnectorDes 2 The chain of


Connectors ctors criptor concentrators that
forwarded the event
This is not yet exposed
in the user interface.

50 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Group Label Script Alias Data Type Description

Event Concentrator concentratorDevice DeviceDescript 2 The list of devices that


Devices s or concentrate events, if
applicable. This is not
exposed in the user
interface.

Event Correlated (not applicable) (not n A derived field that


Event Count applicable) / reports the number of
a actual events that had
to occur to cause a
correlation event to
occur.

Event Crypto cryptoSignature String 2 The signature of the


Signature event object (meaning
in this alert, as opposed
to the occurrence
represented by the
event). Not yet
supported.

Event Customer customer Customer 1 The "customer"


resource reference.
This is used in MSSP
environments to
describe the client or
divisional entity to
whom the event
applies.

Event Customer customerExternalI String 1 Returns the external ID


External ID D for this reference.

Event Customer ID customerID String 1 Returns the ID for the


resource in this
resource reference.

Event Customer customerName String 1 Returns the name from


Name the URI, which is
always assumed to be
the last field of the URI.

Event Customer customerReference ID 1 Returns the unique


Reference ID ID descriptor ID for this
reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Event Customer customerResource Resource 1 Locates the resource


Resource described by this
reference.

Confidential ArcSight Web™ User’s Guide 51


6 Using Active Channels

Default Turbo Level


Group Label Script Alias Data Type Description

Event Customer URI customerURI String 1 Returns the URI for this
reference.

Event End Time endTime DateTime 1 Event ends (defaults to


deviceReceiptTime).

Event Event ID eventId ID 1 Long value identifying


an event.

Event External ID externalId String 2 A reference to the ID


used by an external
device. This is useful
for tracking devices
that create events that
contain references to
these IDs (e.g.,
ManHunt).

Event Generator generator null 1 The "generator"


resource reference (the
resource that
generated the event.
This is the
subcomponent in the
connector that
generates the event.

Event Generator generatorExternalI String 1 Returns the external ID


External ID D for this reference.

Event Generator ID generatorID String 1 Returns the ID for the


resource in this
resource reference.

Event Generator generatorName String 1 Returns the name from


Name the URI, which is
always assumed to be
the last field of the URI.

Event Generator generatorReferenc ID 1 Returns the unique


Reference ID eID descriptor ID for this
reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Event Generator generatorResource Resource 1 Locates the resource


Resource described by this
reference.

Event Generator URI generatorURI String 1 Returns the URI for this
reference.

52 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Group Label Script Alias Data Type Description

Event Locality locality LocalityEnume 2 The locality associated


ration with the event.

Event Message message String 2 A brief comment


associated with this
event.

Event Name name String 1 An arbitrary string that


describes this type of
event. Event details
included in other parts
of an event shouldn't
be used in the event
name.

Event Originator originator OriginatorEnu 1 Holds the value of


meration Source|Destination.
This determines
whether source and
destination should be
translated to attacker
and target or they
should be inversed.

Event Persistence persistence PersistenceEn 2 There are two states:


umeration Persisted or Transient.
Events default to being
Transient and are
marked as Persisted as
soon as they reach the
Batch Alert Persistor or
when they are loaded
by the Alert Broker.

Event Raw Event rawEvent String 1 The original log entry


reported by the sensor
(synthesized when the
sensor does not log to a
file or text stream).

Event Rule Thread ruleThreadId String 2 A single rule can issue


ID many events, based on
several triggers,
starting with On First
Event and ending with
On Threshold Timeout.
All such events for a
single Rule and a single
Group By tuple are
marked with the same
identifier using this
attribute.

Confidential ArcSight Web™ User’s Guide 53


6 Using Active Channels

Default Turbo Level


Group Label Script Alias Data Type Description

Event Session ID sessionId Long 2 Tags for events created


by a correlation
simulation, as part of a
particular simulation.

Event Start Time startTime DateTime 1 Event begins (defaults


to deviceReceiptTime).

Event Transport transportProtocol String 1 The format of the


Protocol transmitted data
associated with the
event from a network
transport perspective
(e.g., TCP, UDP).

Event Type type TypeEnumerati 1 One of the event types:


on Base, Correlation,
Aggregation, or Action.

Event Vulnerability vulnerability Vulnerability 2 The vulnerability


resource that
represents the
vulnerability or
exposure that may be
exploited by this event
and is present on the
targeted device
according to our
network model.

Event Vulnerability vulnerabilityExtern String 2 Returns the external ID


External ID alID for this reference.

Event Vulnerability vulnerabilityID String 2 Returns the ID for the


ID resource in this
resource reference.

Event Vulnerability vulnerabilityName String 2 Returns the name from


Name the URI, which is
always assumed to be
the last field of the URI.

Event Vulnerability vulnerabilityRefere ID 2 Returns the unique


Reference ID nceID descriptor ID for this
reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Event Vulnerability vulnerabilityResour Resource 2 Locates the resource


Resource ce described by this
reference.

54 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Group Label Script Alias Data Type Description

Event Vulnerability vulnerabilityURI String 2 Returns the URI for this


URI reference.

Event Annotation

Default Turbo Level


Data
Group Label Script Alias Type Description

Event Audit Trail eventAnnotationAuditTrail String 2 The text log of


Annotation annotation changes.
Changes are recorded
as sets of comma-
separated-value
entries.

Event Comment eventAnnotationComment String 2 A text description of the


Annotation event or associated
information.

Event End Time eventAnnotationEndTime DateTime 2 The timestamp for an


Annotation eventannotation.

Event Event ID eventAnnotationEventId ID 2 The event ID for the


Annotation annotation event.

Event Flags eventAnnotationFlags FlagsValu 2 The state of the


Annotation eSet collaboration flags.

Event Manager eventAnnotationManagerRe DateTime 2 The time the Manager


Annotation Receipt ceiptTime received the event
Time annotation.

Event Modificati eventAnnotationModificatio DateTime 2 The time the


Annotation on Time nTime annotation was
modified.

Event Modified eventAnnotationModifiedBy User 2 The user ID of the


Annotation By person who last edited
this annotation.

Event Modified eventAnnotationModifiedBy String 2 Returns the external ID


Annotation By ExternalID for this reference.
External
ID

Confidential ArcSight Web™ User’s Guide 55


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Event Modified eventAnnotationModifiedByI String 2 Returns the ID for the


Annotation By ID D resource in this
resource reference.

Event Modified eventAnnotationModifiedBy String 2 Returns the name from


Annotation By Name Name the URI (the last field of
the URI).

Event Modified eventAnnotationModifiedBy ID 2 Returns the unique


Annotation By ReferenceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference has been
stored and uniquely
identified in the
database.

Event Modified eventAnnotationModifiedBy Resource 2 Locates the resource


Annotation By Resource described by this
Resource reference.

Event Modified eventAnnotationModifiedBy String 2 Returns the URI for this


Annotation By URI URI reference.

Event Stage eventAnnotationStage Stage 2 The current disposition


Annotation of the event. This
enables annotation
workflow.

Event Stage eventAnnotationStageEvent ID 2 The reference to an


Annotation Event ID Id internal identifier for
another event. It is
used by 'Mark Similar'.

Event Stage eventAnnotationStageExter String 2 Returns the external ID


Annotation External nalID for this reference.
ID

Event Stage ID eventAnnotationStageID String 2 Returns the ID for the


Annotation resource in this
resource reference.

Event Stage eventAnnotationStageName String 2 Returns the name from


Annotation Name the URI, which is
always assumed to be
the last field of the URI.

Event Stage eventAnnotationStageRefer ID 2 Returns the unique


Annotation Reference enceID descriptor ID for this
ID reference. This is
populated only if this
reference is stored and
uniquely identified in
the database.

56 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Event Stage eventAnnotationStageResou Resource 2 Locates the resource


Annotation Resource rce described by this
reference.

Event Stage eventAnnotationStageUpdat ID 2 The time of the last


Annotation Update eTime stage change (in UTC).
Time

Event Stage URI eventAnnotationStageURI String 2 Returns the URI for this
Annotation reference.

Event Stage eventAnnotationStageUser User 2 The user associated


Annotation User with the current stage.
This implements
assignment within
workflow.

Event Stage eventAnnotationStageUserE String 2 Returns the external ID


Annotation User xternalID for this reference.
External
ID

Event Stage eventAnnotationStageUserI String 2 Returns the ID for the


Annotation User ID D resource in this
resource reference.

Event Stage eventAnnotationStageUserN String 2 Returns the name from


Annotation User ame the URI, which is
Name always assumed to be
the last field of the URI.

Event Stage eventAnnotationStageUserR ID 2 Returns the unique


Annotation User eferenceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference is stored and
uniquely identified in
the database.

Event Stage eventAnnotationStageUserR Resource 2 Locates the resource


Annotation User esource described by this
Resource reference.

Event Stage eventAnnotationStageUserU String 2 Returns the URI for this


Annotation User URI RI reference.

Event Version eventAnnotationVersion Integer 2 The editing version


Annotation number which
increments with each
change. This enables
optimistic locking.

Confidential ArcSight Web™ User’s Guide 57


6 Using Active Channels

File

Default Turbo Level


Data
Group Label Script Alias Type Description

File Create fileCreateTime DateTime 2 The time the file was


Time created (in UTC).

File Hash fileHash String 2 The hashcode


associated with the
file's contents (e.g.,
MD5).

File ID fileId String 2 The external identifier


associated with the file.

File Modificati fileModificationTime DateTime 2 The time the file was


on Time last changed (in UTC).

File Name fileName String 2 The name of the file.

File Path filePath String 2 The directory path to


the file in the file
system.

File Permissio filePermission String 2 The user permissions


n associated with the file
(sensor specific).

File Size fileSize Long 2 The size of the file's


contents (typically in
bytes; sensor specific).

File Type fileType String 2 The type of file


contents (sensor
specific).

58 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Final Device
This category falls into the device-to-Manager information chain. The chain begins at
Device, which is the actual network hardware that senses an event. In cases where data is
concentrated or otherwise pre-processed, it may be passed to a trusted reporting Final
Device before reaching an Original Connector. Although the Original Connector is
usually the only connector, if the data passes up through a Manager hierarchy the chain
includes handling by Connector stages that are the Manager SmartConnectors that
facilitate Manager-to-Manager connections.

Default Turbo Level


Data
Group Label Script Alias Type Description

Final Address finalDeviceAddress IP address 2 The IP address of the


Device trusted reporting
device.

Final Asset ID finalDeviceAssetId Resource 2 The asset that


Device represents the trusted
reporting device.

Final Asset finalDeviceAssetName String 2 The name of the


Device Name trusted reporting
device.

Final Asset finalDeviceAssetResource Resource 2 The resource


Device Resource represented by the
trusted reporting
device.

Final Descriptor finalDeviceDescriptorId ID 2 The descriptor ID of the


Device ID trusted reporting
device.

Final DNS finalDeviceDnsDomain String 2 The Domain Name


Device Domain Service domain name
associated with the
trusted reporting
device.

Final External finalDeviceExternalId String 2 The external ID for the


Device ID trusted reporting
device, if provided by
the vendor.

Final Facility finalDeviceFacility String 2 A facility or capability of


Device a device. This
accomodates
concentrators (e.g., like
syslog, which has a
concept of device
logging for "parts" of a
device).

Final Host finalDeviceHostName String 2 The host name of the


Device Name trusted reporting
device.

Confidential ArcSight Web™ User’s Guide 59


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Final Inbound finalDeviceInboundInterface String 2 The NIC card on the


Device Interface sensor device that
received the network
traffic associated with
the event.

Final MAC finalDeviceMacAddress MAC 2 The MAC address


Device address address associated with the
trusted reporting
device.

Final NT finalDeviceNtDomain String 2 The Windows NT


Device Domain domain associated with
the trusted reporting
device.

Final Outbound finalDeviceOutboundInterfa String 2 The NIC card on the


Device Interface ce trusted reporting
device.

Final Process finalDeviceProcessName String 2 The process name of


Device Name the trusted reporting
device.

Final Product finalDeviceProduct String 2 The product name of


Device the trusted reporting
device.

Final Time finalDeviceTimeZone String 2 The time zone reported


Device Zone by the trusted reporting
device.

Final Time finalDeviceTimeZoneOffset Integer 2 Returns the raw time-


Device Zone zone offset for the
Offset trusted reporting
device. Note that
connector and device
times are not always
reliably accurate.

Final Translated finalDeviceTranslatedAddres IP address 2 If network address


Device Address s translation is an issue,
this is the translated IP
address of the trusted
reporting device.

Final Translated finalDeviceTranslatedZone Zone 2 If network address


Device Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the trusted reporting
device.

60 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Final Translated finalDeviceTranslatedZoneE String 2 Returns the external ID


Device Zone xternalID for this reference.
External
ID

Final Translated finalDeviceTranslatedZoneI String 2 Returns the ID for the


Device Zone ID D resource in this
resource reference.

Final Translated finalDeviceTranslatedZoneN String 2 Returns the name from


Device Zone ame the URI, which is
Name always assumed to be
the last field of the URI.

Final Translated finalDeviceTranslatedZoneR ID 2 Returns the unique


Device Zone eferenceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference has been
stored and uniquely
identified in the
database.

Final Translated finalDeviceTranslatedZoneR Resource 2 Locates the resource


Device Zone esource described by this
Resource reference.

Final Translated finalDeviceTranslatedZoneU String 2 Returns the URI for this


Device Zone URI RI reference.

Final Vendor finalDeviceVendor String 2 Device vendor.


Device

Final Version finalDeviceVersion String 2 The software revision


Device number of the trusted
reporting device.

Final Zone finalDeviceZone Zone 2 The network zone in


Device which the trusted
reporting device
resides.

Final Zone finalDeviceZoneExternalID String 2 Returns the external ID


Device External for this reference.
ID

Final Zone ID finalDeviceZoneID String 2 Returns the ID for the


Device resource in this
resource reference.

Final Zone finalDeviceZoneName String 2 Returns the name from


Device Name the URI, which is
always assumed to be
the last field of the URI.

Confidential ArcSight Web™ User’s Guide 61


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Final Zone finalDeviceZoneReferenceID ID 2 Returns the unique


Device Reference descriptor ID for this
ID reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Final Zone finalDeviceZoneResource Resource 2 Locates the resource


Device Resource described by this
reference.

Final Zone URI finalDeviceZoneURI String 2 Returns the URI for this
Device reference.

Flex
Default Turbo Level

Data
Group Label Script Alias Type Description

Flex Date1 flexDate1 DateTime 2 First flexDate.

Flex Date1 flexDate1Label String 2 Label of first flexDate.


Label

Flex Number1 flexNumber1 Long 2 First flexNumber.

Flex Number1 flexNumber1Label String 2 Label of the first


Label FlexNumber.

Flex Number2 flexNumber2 Long 2 Second flexNumber.

Flex Number2 flexNumber2Label String 2 Label of the second


Label FlexNumber.

Flex String1 flexString1 String 2 First flexString

Flex String1 flexString1Label String 2 Label of the first FlexString.


Label

Flex String2 flexString2 String 2 Second flexString.

Flex String2 flexString2Label String 2 Label of the second


Label FlexString.

62 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Manager

Default Turbo Level


Data
Group Label Script Alias Type Description

Manager Receipt managerReceiptTime DateTime 1 The time at which the


Time current Manager first
received the event.

Old File

Default Turbo Level

Data
Group Label Script Alias Type Description

Old File Create oldFileCreateTime DateTime 2 The time the file was
Time created (in UTC).

Old File Hash oldFileHash String 2 The hashcode associated


with the file's contents
(e.g., MD5).

Old File ID oldFileId String 2 The external identifier


associated with the file.

Old File Modificati oldFileModificationTime DateTime 2 The time the file was last
on Time changed (in UTC).

Old File Name oldFileName String 2 The file's name.

Old File Path oldFilePath String 2 The directory path to the


file in the file system.

Old File Permissio oldFilePermission String 2 The user permissions


n associated with the file
(sensor specific).

Old File Size oldFileSize Long 2 The size of the file's


contents (typically in bytes;
sensor specific).

Old File Type oldFileType String 2 The type of the file's


contents (sensor specific).

Confidential ArcSight Web™ User’s Guide 63


6 Using Active Channels

Original Connector
This category falls into the device-to-Manager information chain. The chain begins at
Device, which is the actual network hardware that senses an event. In cases where data is
concentrated or otherwise pre-processed, it may be passed to a trusted reporting Final
Device before reaching an Original Connector. Although the Original Connector is
usually the only connector, if the data passes up through a Manager hierarchy the chain
includes handling by Connector stages that are the Manager SmartConnectors that
facilitate Manager-to-Manager connections.

Default Turbo Level


Data
Group Label Script Alias Type Description

Original Address originalConnectorAddress IP address 2 The IP address of the


Connector device hosting the first
reporting
SmartConnector.

Original Asset ID originalConnectorAssetID Resource 2 The asset that


Connector represents the device
hosting the first
reporting
SmartConnector.

Original Asset originalConnectorAssetNam String 2 The first reporting


Connector Name e connector's asset
name.

Original Asset originalConnectorAssetReso Resource 2 The first reporting


Connector Resource urce connector's resource.

Original Descriptor originalConnectorDescriptor ID 2 The first reporting


Connector ID Id connector's descriptor.

Original DNS originalConnectorDnsDomai String 2 The Domain Name


Connector Domain n Service domain name
associated with the
device hosting the first
reporting
SmartConnector.

Original Host originalConnectorHostName String 2 The name of the device


Connector Name hosting the first
reporting
SmartConnector.

Original ID originalConnectorId String 2 The ID of the


Connector connector. The format
is
connectorId(1)|connect
orId(2)|...

64 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Original MAC originalconnectorMacAddres MAC 2 The MAC address


connector address s address associated with the first
reporting
Smartconnector (which
may or may not be the
MAC address of the
host device.)

Original Name originalconnectorName String 2 User-supplied name of


connector the first reporting
connector.

Original NT originalconnectorNtDomain String 2 The Windows NT


connector Domain domain associated with
the device hosting the
first reporting
Smartconnector.

Original Time originalconnectorTimeZone String 2 The time zone reported


connector Zone by the device hosting
the first reporting
Smartconnector.

Original Time originalconnectorTimeZone Integer 2 Returns the raw time-


connector Zone Offset zone offset for the first
Offset reporting connector's
time zone. Note that
device and connector
times may not be
reliably accurate.

Original Translated originalconnectorTranslated IP address 2 If network address


connector Address Address translation is an issue,
this is the translated IP
address of the device
hosting the first
reporting
Smartconnector.

Original Translated originalconnectorTranslated Zone 2 If network address


connector Zone Zone translation is an issue,
this is the Network
Zone associated with
the translated IP
address of the device
hosting the first
reporting
Smartconnector.

Original Translated originalconnectorTranslated String 2 Returns the external ID


connector Zone ZoneExternalID for this reference.
External
ID

Confidential ArcSight Web™ User’s Guide 65


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Original Translated originalconnectorTranslated String 2 Returns the ID for the


connector Zone ID ZoneID resource in this
resource reference.

Original Translated originalconnectorTranslated String 2 Returns the name from


connector Zone ZoneName the URI, which is
Name always assumed to be
the last field of the URI.

Original Translated originalconnectorTranslated ID 2 Returns the unique


connector Zone ZoneReferenceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference has been
stored and uniquely
identified in the
database.

Original Translated originalconnectorTranslated Resource 2 Locates the resource


connector Zone ZoneResource described by this
Resource reference.

Original Translated originalconnectorTranslated String 2 Returns the URI for this


connector Zone URI ZoneURI reference.

Original Type originalconnectorType String 2 A string that describes


connector the type of the first
reporting connector.
This is not the same as
the device type.

Original Version originalconnectorVersion String 2 The software revision


connector number of the
Smartconnector that
first reported the event.

Original Zone originalconnectorZone Zone 2 The network zone in


connector which the device
hosting the first
reporting
Smartconnector
resides.

Original Zone originalconnectorZoneExter String 2 Returns the external ID


connector External nalID for this reference.
ID

Original Zone ID originalconnectorZoneID String 2 Returns the ID for the


connector resource in this
resource reference.

Original Zone originalconnectorZoneName String 2 Returns the name from


connector Name the URI, which is
always assumed to be
the last field of the URI.

66 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Original Zone originalconnectorZoneRefer ID 2 Returns the unique


connector Reference enceID descriptor ID for this
ID reference. This is
populated only if this
reference has been
stored and is uniquely
identified in the
database.

Original Zone originalconnectorZoneResou Resource 2 Locates the resource


connector Resource rce described by this
reference.

Original Zone URI originalconnectorZoneURI String 2 Returns the URI for this
connector reference.

Request
Default Turbo Level

Data
Group Label Script Alias Type Description

Request Client requestClientApplication String 2 The client application


Applicatio (such as a web
n browser) used to issue
the request.

Request Client requestClientApplication String 2 A description of the


Applicatio client application used
n to initiate this request,
e.g., the HTTP User
connector.

Request Context requestContext String 2 A description of the


content from which the
request originated,
e.g., the HTTP Referrer.

Request Cookies requestCookies String 2 Cookie data offered by


the client application as
part of the request.

Confidential ArcSight Web™ User’s Guide 67


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Request Method requestMethod String 2 The style of the


request, i.e., for an
HTTP request this could
be PUT or GET.

Request Protocol requestProtocol String 2 The communication


protocol used when
issuing the request.

Request URL requestUrl String 2 A universal resource


locator associated with
the event.

Request URL requestUrlAuthority String 2 The URL component


Authority used for authentication
and authorization.

Request URL File requestUrlFileName String 2 The URL component


Name that refers to the file
containing the
resource.

Request URL Host requestUrlHost String 2 The URL component


that specifies the host
device where the
resource resides.

Request URL Port requestUrlPort Integer 2 The URL component


that specifies the port
to contact on the host
device where the
resource resides.

Request URL requestUrlQuery String 2 The URL component


Query that specifies the query
to use to request the
resource.

68 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Source

Default Turbo Level


Data
Group Label Script Alias Type Description

Source Address sourceAddress IP address 1 The IP address of the


source device.

Source Asset ID sourceAssetId Resource 2 The asset that


represents the device
that was the network
traffic's source.

Source Asset sourceAssetName String 2 See the common set of


Name resource attributes.

Source Asset sourceAssetResource Resource 2 See the common set of


Resource resource attributes.

Source DNS sourceDnsDomain String 2 The Domain Name


Domain Service domain name
associated with the
user at the source
device.

Source FQDN sourceFqdn String 2 The fully qualified


domain name
associated with the
source device. This has
no value if either the
host name or DNS
domain are without a
value.

Source Geo sourceGeo GeoDescri 1 The geographical


ptor information.

Source Geo sourceGeoCountryCode String 1 Country Code.


Country
Code

Source Geo sourceGeoCountryFlagUrl String 1 County Flag.


Country
Flag URL

Source Geo sourceGeoCountryName String 1 Country Code.


Country
Name

Source Geo sourceGeoDescriptorId ID 1 Unique descriptor for


Descriptor the geo field.
ID

Source Geo sourceGeoLatitude Double 1 See the common set of


Latitude geographical attributes.

Confidential ArcSight Web™ User’s Guide 69


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Source Geo sourceGeoLocationInfo String 1 See the common set of


Location geographical attributes.
Info

Source Geo sourceGeoLongitude Double 1 See the common set of


Longitude geographical attributes.

Source Geo sourceGeoPostalCode String 1 See the common set of


Postal geographical attributes.
Code

Source Geo sourceGeoRegionCode String 1 See the common set of


Region geographical attributes.
Code

Source Host sourceHostName String 2 The name of the source


Name device.

Source MAC sourceMacAddress MAC 2 The MAC address


Address address associated with the
network traffic's source
(which may or may not
be the MAC address of
the host device).

Source NT sourceNtDomain String 2 The Windows NT


Domain domain associated with
the source device.

Source Port sourcePort Integer 1 The network port


associated with the
network traffic's
source.

Source Process sourceProcessName String 2 The name of the


Name process associated with
the source of the
network traffic.

Source Service sourceServiceName String 2 The name of the


Name service associated with
the network traffic's
source.

Source Translated sourceTranslatedAddress IP address 1 If network address


Address translation is an issue,
this is the translated IP
address of the device
that was the network
traffic's source.

Source Translated sourceTranslatedPort Integer 1 If network address


Port translation is an issue,
this is the translated
source port associated
with the attack.

70 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Source Translated sourceTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the device that was the
network traffic's
source.

Source Translated sourceTranslatedZoneExtern String 1 Returns the external ID


Zone alID for this reference.
External
ID

Source Translated sourceTranslatedZoneID String 1 Returns the ID for the


Zone ID resource in this
resource reference.

Source Translated sourceTranslatedZoneName String 1 Returns the name from


Zone the URI, which is
Name always assumed to be
the last field of the URI.

Source Translated sourceTranslatedZoneRefere ID 1 Returns the unique


Zone nceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference has been
stored and uniquely
identified in the
database.

Source Translated sourceTranslatedZoneResou Resource 1 Locates the resource


Zone rce described by this
Resource reference.

Source Translated sourceTranslatedZoneURI String 1 Returns the URI for this


Zone URI reference.

Source User ID sourceUserId String 2 The OS- or application-


based identifier
associated with the
user at the network
traffic's source.

Source User sourceUserName String 2 The OS- or application-


Name based name associated
with the user at the
network traffic's
source.

Source User sourceUserPrivileges String 2 The privileges afforded


Privileges the user at the network
traffic's source.

Confidential ArcSight Web™ User’s Guide 71


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Source Zone sourceZone Zone 1 The network zone


where the source
device resides.

Source Zone sourceZoneExternalID String 1 Returns the external ID


External for this reference.
ID

Source Zone ID sourceZoneID String 1 Returns the ID for the


resource in this
resource reference.

Source Zone sourceZoneName String 1 Returns the name from


Name the URI, which is
always assumed to be
the last field of the URI.

Source Zone sourceZoneReferenceID ID 1 Returns the unique


Reference descriptor ID for this
ID reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Source Zone sourceZoneResource Resource 1 Locates the resource


Resource described by this
reference.

Source Zone URI sourceZoneURI String 1 Returns the URI for this
reference.

Target
Default Turbo Level

Data
Group Label Script Alias Type Description

Target Address targetAddress IP address 1 The IP address of the


device hosting the
attacker.

72 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Target Asset ID targetAssetId Resource 2 The asset that


represents the attacked
device's host.

Target Asset targetAssetName String 2 See the common set of


Name resource attributes.

Target Asset targetAssetResource Resource 2 See the common set of


Resource resource attributes.

Target DNS targetDnsDomain String 2 The Domain Name


Domain Service domain name
associated with the
attacked device.

Target FQDN targetFqdn String 2 The fully qualified


domain name
associated with the
attacked device.

Target Geo targetGeo GeoDescri 1 The geographical


ptor information.

Target Geo targetGeoCountryCode String 1 Country code.


Country
Code

Target Geo targetGeoCountryFlagUrl String 1 County flag.


Country
Flag URL

Target Geo targetGeoCountryName String 1 Country name.


Country
Name

Target Geo targetGeoDescriptorId ID 1 Unique descriptor for


Descriptor the geo field.
ID

Target Geo targetGeoLatitude Double 1 Latitude.


Latitude

Target Geo targetGeoLocationInfo String 1 Location information.


Location
Info

Target Geo targetGeoLongitude Double 1 Longitude.


Longitude

Target Geo targetGeoPostalCode String 1 Postal code.


Postal
Code

Target Geo targetGeoRegionCode String 1 Region code.


Region
Code

Confidential ArcSight Web™ User’s Guide 73


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Target Host targetHostName String 2 The name of the


Name attacked device.

Target MAC targetMacAddress MAC 2 The MAC address


Address address associated with the
target of the attack
(which may or may not
be the MAC address of
the host device).

Target NT targetNtDomain String 2 The Windows NT


Domain domain associated with
the attacked device.

Target Port targetPort Integer 1 The network port


associated with the
target of the attack.

Target Process targetProcessName String 2 The name of the


Name process associated with
the attack's target.

Target Service targetServiceName String 2 The name of service


Name associated with the
attack's target.

Target Translated targetTranslatedAddress IP address 1 If network address


Address translation is an issue,
this is the translated IP
address of the attacked
device.

Target Translated targetTranslatedPort Integer 1 If network address


Port translation is an issue,
this is the translated
port associated with the
attack.

Target Translated targetTranslatedZone Zone 1 If network address


Zone translation is an issue,
this is the network zone
associated with the
translated IP address of
the targeted device.

Target Translated targetTranslatedZoneExtern String 1 Returns the external ID


Zone alID for this reference.
External
ID

Target Translated targetTranslatedZoneID String 1 Returns the ID for the


Zone ID resource in this
resource reference.

74 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Target Translated targetTranslatedZoneName String 1 Returns the name from


Zone the URI, which is
Name always assumed to be
the last field of the URI.

Target Translated targetTranslatedZoneRefere ID 1 Returns the unique


Zone nceID descriptor ID for this
Reference reference. This is
ID populated only if this
reference has been
stored and uniquely
identified in the
database.

Target Translated targetTranslatedZoneResour Resource 1 Locates the resource


Zone ce described by this
Resource reference.

Target Translated targetTranslatedZoneURI String 1 Returns the URI for this


Zone URI reference.

Target User ID targetUserId String 2 The OS- or application-


based identifier
associated with the
attacker, at the target
of the attack.

Target User targetUserName String 2 The OS- or application-


Name based name associated
with the attacker, at the
target of the attack.

Target User targetUserPrivileges String 2 The privileges afforded


Privileges the attacker, at the
target of the attack.

Target Zone targetZone Zone 1 The network zone in


which the attacked
device resides.

Target Zone targetZoneExternalID String 1 Returns the external ID


External for this reference.
ID

Target Zone ID targetZoneID String 1 Returns the ID for the


resource in this
resource reference.

Target Zone targetZoneName String 1 Returns the name from


Name the URI, which is
always assumed to be
the last field of the URI.

Confidential ArcSight Web™ User’s Guide 75


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Target Zone targetZoneReferenceID ID 1 Returns the unique


Reference descriptor ID for this
ID reference. This is
populated only if this
reference has been
stored and uniquely
identified in the
database.

Target Zone targetZoneResource Resource 1 Locates the resource


Resource described by this
reference.

Target Zone URI targetZoneURI String 1 Returns the URI for this
reference.

Threat
Default Turbo Level

Data
Group Label Script Alias Type Description

Threat Asset assetCriticality Integer 2 The relative measure of


Criticality the importance of the
targeted device, on a
scale of 0 to 10.

Threat Model modelConfidence Integer 2 The relative measure of


Confidenc ArcSight's confidence in
e its model of the
attacked device, on a
scale of 0 to 10.

Threat Priority priority Integer 1 The relative measure of


importance of
investigating this event
on a scale of 0 to 10.
This field incorporates
Model Confidence.

Threat Relevance relevance Integer 2 The relative measure of


likelihood that this
event succeeded, on a
scale of 0 to 10.

76 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Default Turbo Level


Data
Group Label Script Alias Type Description

Threat Severity severity Integer 2 The relative measure of


possible damage to
network security
represented by the
event on a scale of 0 to
10. It may be noted
that event severity is
supplied by the device;
ArcSight severity is
supplied by the
Smartconnector; and
attack severity is
supplied by the threat
evaluation process.

Resource Attributes

Attribute
Suffix Description

External ID The user-defined identifier associated with a configuration resource.

ID The internal identifier associated with a resource (a UUID).

Reference ID The internal identifier associated with the resource reference (an
integer).

Type Name The type of configuration resource.

URI The URI associated with the resource (e.g., /All


Users/Administrators/Mlow).

Geographical Attributes

Attribute
Suffix Description

Descriptor ID The internal ID of the geographical reference.

Country Code The identifier for the national-political state in which a device
resides.

Country Flag The URL of an image of the flag of the national-political state in
URL which the device resides.

Country Name The name of the national-political state where a device resides.

Latitude The latitude of a device (Float).

Location Info Other, free-form text information about the device's location.

Longitude The longitude of a device (Float).

Confidential ArcSight Web™ User’s Guide 77


6 Using Active Channels

Attribute
Suffix Description

Postal Code The postal code of the device's location, as assigned by the national-
political state where it resides.

Region Code The identifier of the sub-region of the national-political state where a
device resides. The style of the identifier varies with the host
country.

Audit Events
Audit events are ones generated within ArcSight itself to mark a wide variety of routine
actions that can occur manually or automatically, such as adding an event to a case or
when a Moving Average data monitor detects a rapidly rising moving average. Audit events
have many applications, which can include notifications, task validation, compliance
tracking, automated housekeeping, and system administration.

In the table below, use the Audit Event Category to locate events. The Audit Event
Description approximates the Name you see in active channel grids. Additional details,
when necessary, appear in the Notes column.

Compare audit events, which report on system activity, with Status Monitor Events, which
provide information about a wide variety of system states.

Audit Event Categories


 Active Channel
 Active List
 Agent Connection
 Agent Exceptions
 Agent Login
 Agent Registration and Configuration
 Authorization
 Configuration Resources
 Dashboard
 Manager Activation
 Manager Database Error Conditions
 Manager External Event Flow Interruption
 Moving Average Data Monitor
 Notification
 Notification Acknowledgement
 Notification Testing
 Partition Archiver
 Partition Manager
 Reconciliation Data Monitor
 Report
 Resource Quota
 Rule Actions

78 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

 Rule Activations
 Rule Firings
 Rule Warnings
 Scheduler Execution
 Scheduler Scheduling Tasks
 Scheduler Skip
 Statistical Data Monitor
 Stress
 User Login
ArcSight Audit Events

Audit Event Device Event Class


Category ID Audit Event Description

Active Channel activechannel:100 An active channel was opened

Active Channel activechannel:101 An empty active channel was opened

Active List activelist:101 An entry was added to an active list

Active List activelist:102 An entry was removed from an active list

Active List activelist:103 An entry was changed in an active list

Agent Connection agent:009 Manager rejected a connection attempt from an


agent for reasons other than authentication failure

Agent Connection agent:30 Agent started

Agent Connection agent:31 Agent shutdown

Agent Connection agent:101 Agent has just connected to Manager

Agent Connection agent:102 Agent is sending events but no heartbeats

Agent Connection agent:103 Agent is sending neither events nor heartbeats

Agent Connection agent:104 An unknown agent attempted to connect to the


Manager

Agent Connection agent:105 An agent presented an incorrect shared secret


when authenticating

Agent Exceptions agent:012 Agent detected source events from a sensor


device containing incorrect time stamps

Agent Exceptions agent:013 Agent noted that a new sensor device is sending
events

Agent Exceptions agent:014 Agent could not find a base event referenced in a
syslog aggregate event

Agent Exceptions agent:016 Agent successfully connected to the sensor


device's log

Agent Exceptions agent:017 Agent successfully executed a command

Agent Exceptions agent:018 Agent could not execute a command

Agent Exceptions agent:019 Agent is caching events because they could not be
immediately transmitted to the Manager

Confidential ArcSight Web™ User’s Guide 79


6 Using Active Channels

Audit Event Device Event Class


Category ID Audit Event Description

Agent Exceptions agent:020 Agent has emptied its cache of events

Agent Exceptions agent:021 Agent could not communicate with an NT collector


sensor

Agent Exceptions agent:023 Agent could not communicate with a CheckPoint


sensor

Agent Exceptions agent:024 Agent is having difficulty communicating with


CheckPoint

Agent Exceptions agent:028 Agent experienced an unexpected problem

Agent Exceptions agent:029 Agent was forced to drop its cached data

Agent Exceptions agent:030 Agent cache filled and part of the cached data was
deleted

Agent Login authentication:200 Successful Agent authentication

Agent Login authentication:201 Agent authentication failed

Agent Registration agent:007 Agent successfully registered with Manager


and Configuration

Agent Registration agent:008 Agent did not successfully register with Manager
and Configuration

Agent Registration agent:022 Agent could not process a reconfiguration request


and Configuration

Agent Registration agent:032 Agent configuration was successfully changed


and Configuration

Agent Registration agent:025 Agent content was successfully updated


and Configuration

Agent Registration agent:026 Agent content update failed


and Configuration

Agent Registration agent:010 Agent upgrade succeeded, This is currently in the


and Configuration context of an installer upgrade.

Agent Registration agent:011 Agent upgrade failed. This event is not currently
and Configuration being generated.

Authorization authorization:100 Manager refused to authorize client

Configuration resource:100 Deleted a configuration resource


Resources

Configuration resource:101 Updated a configuration resource


Resources

Configuration resource:102 Added a new configuration resource


Resources

Configuration resourcereference:10 Could not locate a configuration resource. Through


Resources 0 the supplied universal resource identifer (URI).

Dashboard dashboard:100 Dashboard has opened

Manager Activation manager:100 Manager has started

Manager Activation manager:101 A clean Manager shutdown has been requested

80 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Audit Event Device Event Class


Category ID Audit Event Description

Manager Database database:100 Database tablespace is low and are deactivated


Error Conditions

Manager Database database:101 Database has generated a fatal error and are
Error Conditions deactivated

Manager Database database:102 Database has been reactivated


Error Conditions

Manager Database database:103 Database has more tablespace available after


Error Conditions detecting a low tablespace condition

Manager External manager:200 Manager has stopped the event flow


Event Flow
Interruption

Manager External manager:201 Manager has allowed the event flow to resume
Event Flow
Interruption

Moving Average datamonitor:102 Moving Average data monitor detected a rapidly


Data Monitor falling moving average

Moving Average datamonitor:103 Moving Average data monitor detected a rapidly


Data Monitor rising moving average

Moving Average datamonitor:104 Moving Average data monitor reporting the


Data Monitor current moving average

Notification notification:100 Notification has been disabled

Notification notification:101 Notification has been disabled because the queue


of notifications to be sent is too large

Notification notification:102 Notification has been enabled

Notification notification:103 Notification has been enabled because the queue


of notifications is back under control

Notification notification:104 A particular notification destination has been


disabled

Notification notification:105 A particular notification destination has been


disabled because too much traffic was directed at
it

Notification notification:106 A particular notification destination has been


enabled

Notification notification:107 A notification expired without being acknowledged

Notification notification:108 A functioning destination could not be located for


this notification

Notification notification:109 Old notification has been purged

Notification notification:300 This notification has been acknowledged


Acknowledgement

Notification Testing notification:200 Sent a test notification to this destination group

Partition Archiver partitionarchiver:10 The partition was successfully archived


0

Confidential ArcSight Web™ User’s Guide 81


6 Using Active Channels

Audit Event Device Event Class


Category ID Audit Event Description

Partition Archiver partitionarchiver:20 There was a problem while archiving the partition
0

Partition Archiver partitionarchiver:30 Partition archiving is disabled


0

Partition Archiver partitionarchiver:40 Partition archiving did not complete in the alotted
0 time

Partition Archiver partitionarchiver:50 Partition archiving failed


0

Partition Archiver partitionarchiver:60 There was an unexpected error while archiving


0 partitions

Partition Manager partitionmanager:100 Partitions have been successfully rotated

Partition Manager partitionmanager:200 There was a problem rotating partitions

Partition Manager partitionmanager:300 The partition manager has been disabled

Partition Manager partitionmanager:500 Partitions could not be rotated

Partition Manager partitionmanager:600 There was an unexpected error while rotating


partitions

Reconciliation Data datamonitor:300 Correlation data monitor reporting a correlated or


Monitor non-correlated event

Report report:100 Generated a new archived-report configuration


resource

Report report:101 Failed to generate a new archived-report


configuration resource

Report report:102 Generated a new delta archived-report


configuration resource

Resource Quota quota:100 Resource usage has fallen below the fixed-quota
level

Resource Quota quota:101 Resource usage has exceeded the fixed-quota


level

Resource Quota quota:102 Asset autocreation has exceeded a fixed quota

Resource Quota quota:103 Asset autocreation is proceeding too rapidly

Rule Actions rule:301 Set Severity action. This event has been
deprecated.

Rule Actions rule:302 Set Event Attribute action

Rule Actions rule:303 Send to Notifier action

Rule Actions rule:304 Execute Command action

Rule Actions rule:305 Export... action

Rule Actions rule:306 Create New Case action

Rule Actions rule:307 Add to Case action

Rule Actions rule:308 Create New Case action failed

Rule Actions rule:309 Add to Case action failed

82 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Audit Event Device Event Class


Category ID Audit Event Description

Rule Actions rule:310 Add to Active List action

Rule Actions rule:311 Move between Active Lists action. This event has
been deprecated.

Rule Actions rule:312 Remove from Active List action

Rule Activations rule:700 Rule has been deactivated

Rule Activations rule:701 Rule has been deactivated because it is unsafe.


There was excessive recursion or event matching.

Rule Activations rule:702 Rule has been activated

Rule Firings rule:101 Rule fired OnEveryEvent

Rule Firings rule:102 Rule fired OnFirstEvent

Rule Firings rule:103 Rule fired OnSubsequentEvents

Rule Firings rule:104 Rule fired OnEveryThreshold

Rule Firings rule:105 Rule fired OnFirstThreshold

Rule Firings rule:106 Rule fired OnSubsequentThresholds

Rule Firings rule:107 Rule fired OnTimeUnitExpiration

Rule Warnings rule:501 Rule is firing on events generated by itself

Scheduler scheduler:200 A task has been executed


Execution

Scheduler scheduler:201 A task failed to execute


Execution

Scheduler scheduler:300 A new task has been scheduled


Scheduling Tasks

Scheduler scheduler:301 A new task could not be scheduled


Scheduling Tasks

Scheduler scheduler:302 Enabled a task


Scheduling Tasks

Scheduler scheduler:303 Could not enable a task


Scheduling Tasks

Scheduler scheduler:304 Deleted a task


Scheduling Tasks

Scheduler scheduler:305 Failed to delete a task


Scheduling Tasks

Scheduler scheduler:306 Disable a task


Scheduling Tasks

Scheduler scheduler:307 Could not disable a task


Scheduling Tasks

Scheduler Skip scheduler:100 The task scheduler skipped a scheduled task


execution because the scheduler was not allowed
to run

Confidential ArcSight Web™ User’s Guide 83


6 Using Active Channels

Audit Event Device Event Class


Category ID Audit Event Description

Scheduler Skip scheduler:101 The task scheduler skipped a scheduled task


invocation because the last invocation of the task
is still executing

Statistical Data datamonitor:200 Statistical Data Monitor reporting a change in


Monitor status

Stress test:100 A stress test event. This event is generated only


by ArcSight Quality Assurance.

User Login authentication:100 Successful client login

User Login authentication:101 Failed client login

User Login authentication:102 Client logout

User Login authentication:103 Client timed out due to inactivity

User Login authentication:104 Too many client login failures occurred within a
time period

Status Monitor Events


ArcSight status monitor events can reveal and isolate many different quantity and time-unit
issues that bear directly on performance and capacity. There are many possible
applications of this system-state data, but those applications must always be interpreted
within the context of your particular hardware, software, and network environment, and
the deployment choices made for ArcSight and its SmartConnectors.

Compare status monitoring events, which provide information about a wide variety of
system states, to Audit Events, which report on system activity.

 Active Channel Statistics


 Active List Statistics
 Asset Statistics
 Data Monitor Statistics
 Event Broker Statistics
 Filter Engine Statistics
 Main Flow Statistics
 Notification Statistics
 Pattern Discovery Statistics
 Report Statistics
 Resource Framework Statistics
 Rules Engine Statistics
 Session Management Statistics
 Side Table Statistics
 SmartConnector Flow Statistics

Active Channel Statistics


Active channel statistics, specifically any changes that occur in the counts they report, can
indicate performance issues and the use of processing cycles. These events summarize:

84 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

 The number of events changed across all open Active Channels per second
 The number of events inserted into Active Channels per second
 The number of currently open Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/ActiveChannels/Open monitor:100 Open active channel count.

Provides count and current


value.

/Monitor/ActiveChannels/Events monitor:174 Active channel event insertions


/Insertions per second.

Provides count per second since


last monitor event.

/Monitor/ActiveChannels/Events monitor:175 Active channel event changes


/Changes per second.

Provides count per second since


last monitor event.

Active List Statistics


Active list statistics monitor the resources being used by active lists. Active lists entries use
some memory and database resources, and use CPU resources when they are referenced
by other parts of the system (e.g., rules, reports, and filters). While changes to these
temporary lists are not persisted, they do represent some memory overhead. Note that
when active lists are used by replay-with-rules, this also creates temporary lists.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/ActiveLists/ListCount monitor:114 Open active list count.

Provides count, current value.

/Monitor/ActiveLists/EntryCount monitor:115 Active list entry count.

Provides count, current value.

/Monitor/ActiveLists/EntryCapaci monitor:116 Active list entry capacity.


ty
Provides count, current value.

/Monitor/ActiveLists/EntryPercen monitor:117 Active list entry usage.


tUsed
Provides percent, current value.

/Monitor/ActiveLists/TemporaryL monitor:118 Temporary Active list count.


istCount
Provides count, current value.

/Monitor/ActiveLists/TemporaryE monitor:119 Temporary Active list entry


ntryCount count.

Provides count, current value.

Confidential ArcSight Web™ User’s Guide 85


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/ActiveLists/TemporaryC monitor:120 Temporary Active list capacity.


apacity
Provides count, current value.

/Monitor/ActiveLists/TemporaryP monitor:121 Temporary Active list usage.


ercentageUsed
Provides percent, current value.

/Monitor/ActiveLists/QueriesPer monitor:122 Active list queries per second.


Second
Provides count of queries per
second since startup.

/Monitor/ActiveLists/ChangesPer monitor:123 Active list changes per second.


Second
Count per second since startup.

Asset Statistics
Asset statistics offer insight into performance areas that affect assets in the system and can
help resolve source, destination, agent, and device asset issues for incoming events. These
events summarize:

 Asset resolutions per second is the average number of end-points in events, that
are resolved to assets in a second.
 Asset resolutions average time is the average time in milliseconds taken to resolve
an end-point in an event to an asset.
 Asset scanner events per second is the number of scanner events processed in a
second.
 Asset scanner events average time is the average time in milliseconds taken to process
a scanner event.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Asset/TotalCount monitor:200 Asset total count.

Provides count, current value.

/Monitor/Asset/Scanner/EventsP monitor:201 Scanner events processed per second.


erSecond
Provides count per second since last monitor
event.

/Monitor/Asset/ResolutionsPerSe monitor:202 Asset resolutions per second.


cond
Provides count per second for asset
resolutions since last monitor event.

/Monitor/Asset/Scanner/Average monitor:203 Scanner event average processing time.


Time
Provides count per second for scanner event
average processing time since starup.

/Monitor/Asset/ResolutionsAvera monitor:204 Asset resolution average time.


geTime
Provides average time in milliseconds for
asset resolution since startup.

86 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Asset/ResolutionsAvera monitor:205 Asset source resolution average time.


geTime/Source
Provides average time in milliseconds for
asset source resolution since startup.

/Monitor/Asset/ResolutionsAvera monitor:206 Asset destination resolution average time.


geTime/Destination
Provides average time in milliseconds for
asset destination resolution since startup.

/Monitor/Asset/Size monitor:240 Transitive Closure Size.

Provides count per second and current value


for transitive closure size.

Data Monitor Statistics


The data monitor statistics indicate how intensively the data monitors are working, which
in turn can indicate situations such as filters needing adjustment or data monitors needing
restructuring. These events summarize:

 Active probes is the number of currently enabled data monitors.


 Evaluations per second is the number of events times the number of enabled data
monitors per second.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/DataMonitors/ActivePro monitor:101 Active data monitor probe count.


bes
Provides count, current value.

/Monitor/DataMonitors/Evaluatio monitor:124 Data monitor evaluations per second.


nsPerSecond
Provides count per second since last monitor
event.

Event Broker Statistics


These statistics monitor reading events from, and writing events to, the database. As such,
they are database health indicators. These events summarize:

 Event count is the number of events inserted into the database since the last monitor
event.
 Insert time is the average time taken to insert each event into the database, in
microseconds.
 Retrieval time is the average time taken to retrieve each event from the database in
microseconds.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/EventBroker/InsertTim monitor:102 Events insertion time per event


e
Provices count in microseconds for insertion
time per event since last monitor event.

Confidential ArcSight Web™ User’s Guide 87


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/EventBroker/InsertedE monitor:103 Events processed count.


ventCount
Provides count since last monitor event.

/Monitor/EventBroker/RetrievalT monitor:140 Events retrieval time per event.


ime
Provides count in microseconds per count,
since last monitor event.

Filter Engine Statistics


The count of in-memory filter evaluations can serve as a broad indicator of filter
performance.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Filters/EvaluationCount monitor:161 Filter evaluation count.

Main Flow Statistics


These events report statistically on the overall throughput of the ArcSight Manager, for
both incoming and internal events. This flow is the sequence of processing steps applied to
each event and is a broad indicator or benchmark of system traffic. These events
summarize:

 Count describes the number of events that have passed through the flow since the
manager started.
 Rate describes the current event rate in events per second.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/MainFlow/EPS monitor:230 Main flow event rate.

Provides count per second since last monitor


event.

/Monitor/MainFlow/Events monitor:231 Main flow event count.

Provides count since startup.

Notification Statistics
This group reports on notification activity, which can be of diagnostic value in detecting
unusually high notifications activity.

 New count describes the number of new notifications since the last monitor event.

88 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

 Escalated count describes the number of notifications that were escalated since the
last monitor event.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Notification/New monitor:180 New notification count.

Provides count since last monitor event.

/Monitor/Notification/Escalated monitor:181 Escalated notification count.

Provides count since last monitor event.

Pattern Discovery Statistics


These events provide statistics for recent or pending pattern discovery runs. Because
pattern discovery is database-intensive, these statistics can indicate or help diagnose
database performance issues.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Patterns/RunCount monitor:190 Pattern discoveries run count.

Provides count since last monitor event.

/Monitor/Patterns/RunsQueued monitor:191 Pattern discoveries queued count.

Provides count current value.

Report Statistics
These events provide statistics about the current number of reports querying the database
or being rendered. Because reports are database-intensive, these statistics can indicate or
help diagnose database performance issues.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Reports/Running monitor:130 Reports running count.

Provides count, current value.

/Monitor/Reports/RunningQueryi monitor:131 Reports querying database count.


ngDB
Provides count, current value.

/Monitor/Reports/RunningRende monitor:132 Reports rendering count.


ring
Provides count, current value.

Resource Framework Statistics


Resource-framework events report on the database activity connected with updates (reads,
writes, and deletions) to system resources such as rules, assets, and filters, since the last

Confidential ArcSight Web™ User’s Guide 89


6 Using Active Channels

monitor event. This data can be valuable in tracking or diagnosing performance-related


issues such as automatic asset maintenance, the threat-level formula, or rule-driven usage.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Resource/Activity/Inser monitor:171 Resources inserted per second.


t
Provides count per second since last monitor
event.

/Monitor/Resource/Activity/Upda monitor:172 Resources updated per second.


te
Provides count per second since last monitor
event.

/Monitor/Resource/Activity/Dele monitor:173 Resources deleted per second.


te
Provides count per second since last monitor
event.

Rules Engine Statistics


The statistics related to the ArcSight Manager's rules engine can help reveal performance
issues in several areas. Please remember that information about rules activity always needs
to be considered in the full content of the Manager's operations. For example, a busy
Moving Average data monitor, if used inefficiently, can affect several of these statistics; a
poorly written rule can inadvertently drive up the rate of actions executed.

These statistics have the following performance implications

 Count of events inserted into the rule engine: CPU.


 Rate of event insertion into the rule engine: CPU.
 Count of correlated events generated by the rule engine: CPU.
 Rate of correlated event generation by the rule engine: CPU.
 Count of partial matches in the rule engine: memory.
 Count of events that are still present in rule engine's working memory: memory.
 Count of groupBy cells that are being used by the rule engine: memory.
 Count of rules currently active in the rule engine: comparative value only.
 Rate of actions being executed by the rule engine: CPU.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Rules/InsertedEventCo monitor:151 Rules total event count.


unt
Provides count since last monitor event.

/Monitor/Rules/InsertedEventRa monitor:152 Rules inserted events per second.


te
Provides count per second since last monitor
event.

/Monitor/Rules/GeneratedEvent monitor:153 Rules generated events per second.


Rate
Provides count per second since last monitor
event.

90 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Rules/PartialMatchCou monitor:154 Rules partial match count.


nt
Provides count, current value.

/Monitor/Rules/EventsInRuleEng monitor:155 Rules in-memory event count.


ineMemory
Provides count, current value.

/Monitor/Rules/GroupByCellsSiz monitor:156 Rules group by cells size.


e
Provides count, current value.

/Monitor/Rules/ActiveRulesCoun monitor:157 Active rules count.


t
Provides count, current value.

/Monitor/Rules/ActionsTakenRat monitor:158 Rules actions rate.


e
Provides count per second since last monitor
event.

/Monitor/Rules/GeneratedEvent monitor:159 Rules generated event count.


Count
Provides count since last monitor event.

Session Management Statistics


This statistic tracks the current number of active user sessions.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Sessions/Active/Total monitor:160 Active session count.

Provides count and current value.

Side Table Statistics


Side tables are ones held in-memory and in the database to retain common and relatively
static information, similar to a cache. The purpose is to improve access times for inserts
and queries. Side tables store event data that includes: geographical information,
categorization information, agent information, device information and labels for custom
strings and numbers.

 Size identifies how many entries are presently in the cache.


 Insert identifies the number of inserts in the past two hours.
 Cache misses identifies how many failed attempts to find entries occurred in the past
two hours.

Confidential ArcSight Web™ User’s Guide 91


6 Using Active Channels

 Cache hit rate identifies how many successful attempts to find entries occurred in
the past two hours.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/SideTable/GeoInfo/HitR monitor:210 Geo info sidetable cache hit rate.


ate
Provides a percentage over a moving time
frame.

/Monitor/SideTable/GeoInfo/Inse monitor:211 Geo info sidetable inserts.


rts
Provides count over a moving timeframe.

/Monitor/SideTable/GeoInfo/Cac monitor:212 Geo info sidetable cache misses.


heMisses
Provides count over a moving timeframe.

/Monitor/SideTable/GeoInfo/Size monitor:213 Geo info sidetable size.

Provides count, current value.

/Monitor/SideTable/Category/Hit monitor:214 Category sidetable cache hit rate.


Rate
Provides a percentage over a moving
timeframe.

/Monitor/SideTable/Category/Ins monitor:215 Category sidetable inserts.


erts
Provides count over a moving timeframe.

/Monitor/SideTable/Category/Ca monitor:216 Category sidetable cache misses.


cheMisses
Provides count over a moving timeframe.

/Monitor/SideTable/Category/Siz monitor:217 Category sidetable size.


e
Provides count, current value.

/Monitor/SideTable/Agent/HitRat monitor:218 Agent sidetable cache hit rate.


e
Provides a percentage over a moving
timeframe.

/Monitor/SideTable/Agent/Insert monitor:219 Agent sidetable inserts.


s
Provides count over a moving timeframe.

/Monitor/SideTable/Agent/Cache monitor:220 Agent sidetable cache misses.


Misses
Provides count over a moving timeframe.

/Monitor/SideTable/Agent/Size monitor:221 Agent sidetable size.

Provides count, current value.

/Monitor/SideTable/Device/HitRa monitor:222 Device sidetable cache hit rate.


te
Provides a percentage over a moving
timeframe.

/Monitor/SideTable/Device/Inser monitor:223 Device sidetable inserts.


ts
Provides count over a moving timeframe.

92 ArcSight Web™ User’s Guide Confidential


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/SideTable/Device/Cach monitor:224 Device sidetable cache misses.


eMisses
Provides count over a moving timeframe.

/Monitor/SideTable/Device/Size monitor:225 Device sidetable size.

Provides count, current value.

/Monitor/SideTable/Labels/HitRa monitor:226 Labels sidetable cache hit rate.


te
Provides a percentage over a moving
timeframe.

/Monitor/SideTable/Labels/Insert monitor:227 Labels sidetable inserts.


s
Provides count over a moving timeframe.

/Monitor/SideTable/Labels/Cach monitor:228 Labels sidetable cache misses.


eMisses
Provides count over a moving timeframe.

/Monitor/SideTable/Labels/Size monitor:229 Labels sidetable size.

Provides count, current value.

SmartConnector Flow Statistics


SmartConnector flow statistics record the event rates that occur at different stages of
agent processing. "Sum of" statistics are sums of all values reported by all agents
connected to the ArcSight Manager. All values are statistics over the past 1-minute range.
These events summarize:

 Received event rate is the rate at which agents receive events from devices.
 Post filter event rate is the rate of events that passed the filter (e.g., were not filtered
out).
 Post aggregation event rate is the rate of event aggregation.
 Agent-to-manager event rate and count describe how many events were actually
sent to the Manager.
 Cache size describes the estimated size of the on-disk agent event cache.

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Agents/Events/ToMana monitor:104 Agent output event count, since startup.


ger
Provides count.

/Monitor/Agents/EPS/ToManager monitor:109 Agent output event rate.

Provides count per second and agent-to-


manager since last monitor event.

/Monitor/Agents/EPS/Received monitor:110 Agent input event rate.

Provides count per second for the agent


received event rate since last monitor event.

Confidential ArcSight Web™ User’s Guide 93


6 Using Active Channels

Status Monitor Event Device Event


Category Class ID Audit Event Description

/Monitor/Agents/EPS/PostFilter monitor:111 Agent filtered event rate.

Provides count per second for the agent post-


filter event rate since last monitor event.

/Monitor/Agents/EPS/PostAggre monitor:112 Agent aggregated event rate.


gation
Provides count per second for the agent post-
aggregation event rate since last monitor
event.

/Monitor/Agents/CacheSize monitor:113 Estimated agent cache size, current value.

Provides count.

/Monitor/Agents/Total/Events/To monitor:141 Sum of agent output event counts.


Manager
Provides count-per-second sum of agent-to-
manager event counts since startup.

/Monitor/Agents/Total/EPS/ToMa monitor:146 Sum of agent-to-manager output event rates.


nager
Provides counted per-second since last
monitor event.

/Monitor/Agents/Total/EPS/Recei monitor:147 Sum of agent input event rates.


ved
Provides count per second for the sum of
agent received event rates since last monitor
event.

/Monitor/Agents/Total/EPS/PostF monitor:148 Sum of agent filtered event rates.


ilter
Provides count per second for the sum of
agent post-filter event rates since last monitor
event.

/Monitor/Agents/Total/EPS/Post monitor:149 Sum of agent aggregated event rates.


Aggregation
Provides count per second for the sum of
agent post-aggregation event rates since the
last monitor event.

/Monitor/Agents/Total/CacheSiz monitor:150 Sum of estimated agent cache sizes.


e
Provides count as a sum of the estimated
agent cache sizes current value.

94 ArcSight Web™ User’s Guide Confidential


Chapter 7
Using Cases

ArcSight cases provide organized, workflow-style tracking and management of interesting


events or situations.

The ArcSight Web interface enables you to create, manage, or customize cases.

Cases have a large number of fields to cover a wide range of event analysis and
investigation possibilities. (See “Creating Cases” on page 97.).

You can add an Export button to the Cases display to export selected cases. Add the
line ui.export.enabled=true to the webserver.properties file and restart
ArcSight Web.

“Managing Cases” on page 95


“Creating Cases” on page 97

Managing Cases
The cases display shows cases that are already created in the Cases tree. From the main
panel, you can select, view, and customize existing cases, and create new ones.

To view an existing case


1 Navigate to and select the case in the Cases resource tree on the left.

 Click the group folders in the tree to open or close them.


 Click a folder to see a list of its cases in the pane to the right.
 Click the arrow icon in the upper-right corner of the resource pane to hide it or
show it.
2 The Cases content pane shows individual listings. Click an individual case to see its
fields (see “Creating Cases” on page 97).

To edit an individual case


1 Click Lock this case.

2 Make your changes and click Submit.

3 Unlock a case after you finish editing.

To remove a case
1 Select the check box for the case you want to remove and click Remove.

Confidential ArcSight Web™ User’s Guide 95


7 Using Cases

If you want to keep the case but not allow others to edit it, you can Lock (hold for
editing) or Unlock (release for others to edit) buttons.

2 Click Refresh to update the display.

To create a new case


Click New Case to go to the Create a New Case display. For details about how to create a
case, see “Creating Cases” on page 97.

To customize a case
Click Customize to select, deselect, and arrange the columns of the case list.

Default Case Management Columns


Attribute Description

Name The name assigned to the case. Using descriptive names is


important.

Locked Whether the case is free to be edited by others. If Locked, it cannot.

Security The letter codes that identify the nature of the security issues the
Classification case represents. See “Security Classification Default Letter Codes”
Code on page 96 below.

Ticket Type The source of the case or its means of tracking.

Stage The current collaboration or workflow stage assigned to the case.

Frequency The numerical range of events that occur in regard to a case.

Created By The ArcSight user ID of the person who created the case.

Security Classification Default Letter Codes


Classification
Letter Codes
Category

Attack I = Informational
Mechanism

O = Operational

P = Physical

U = Unknown

Attack Agent C = Collaborative

I = Insider

O = Outsider

U = Unknown

Vulnerability D = Design

E = Operational Environment

O = Operational

U = Unknown

96 ArcSight Web™ User’s Guide Confidential


7 Using Cases

Classification
Letter Codes
Category

Sensitivity C = Confidential

S = Secret

T = Top Secret

U = Unclassified

Associated A = Availability
Impact

C = Confidentiality

I = Integrity

U = Unknown

Action B = Block/Shutdown

M = Monitoring

O = Other

Creating Cases
To create a case, choose the Initial attributes tab first. Fill in the required and other
appropriate fields, tab by tab, then click Submit at the bottom of the display. Overall, the
tabs represent:

 Initial - Basic case information: case ticket attributes, description and security
classification.
 Follow Up - Description of actions taken, planned, or recommended.
 Final - Ticket resolution and reporting including attack mechanism, attack agent,
incident information, and vulnerability information.
 Events - List of events included in case.
 Notes - Miscellaneous information applicable to a case.
Display ID numbers are assigned automatically when you save the case.

Initial Tab
The fields on this tab provide basic case information.

Field Description

Case

Name Required field specifying name of case.

Display ID An automatically assigned unique number.

Ticket

Ticket Type Drop-down list includes Internal, Client, and


Incident types.

Confidential ArcSight Web™ User’s Guide 97


7 Using Cases

Field Description

Stage Indicate workflow stage of ticket; selections


include Queued, Initial, Follow-up, Final, and
Closed.

Frequency Indicates how often reported issue occurs. Values


assigned are 0 (never or once), 1 (less than 10
times), 2 (10 to 15 times), 3 (15 times), 4 (more
than 15).

Operational Impact of reported issue. Values assigned are 0


Impact (no impact), 1 (no immediate impact), 2 (low-
priority impact), 3 (high-priority impact), 4
(immediate impact).

Security Values assigned are 1 (Unclassified), 2


Classification (Confidential), 3 (Secret), 4 (Top Secret).

Consequence Values assigned are 0 (None), 1 (Insignificant), 2


Severity (Marginal), 3 (Critical), 4 (Catastrophic).

Reporting This is a calculated number, based on Ticket info


Level values entered.

Incident Information

Detection This field is auto-populated.


Time

Estimated This field is auto-populated.


Start Time

Estimated This field is auto-populated.


Restore Time

External ID This field is auto-populated.

Alias Another name by which the incident is referenced


in the system.

Description A text description of the incident.

Assign

Owner Users designated as owners of the case.

Notification Pre-defined groups that should be notified when


Groups the case is created or updated.

Description

Affected This text field can contain up to 4,000 characters.


Services

Affected This text field can contain up to 4,000 characters.


Elements

Estimated This text field can contain up to 4,000 characters.


Impact

Affected Sites This text field can contain up to 4,000 characters.

Security Classification

98 ArcSight Web™ User’s Guide Confidential


7 Using Cases

Field Description

Attack I = Informational
Mechanism O = Operational
P = Physical
U = Unknown

Attack Agent C = Collaborative


I = Insider
O = Outsider
U = Unknown

Incident This field is auto-populated.


Source 1

Incident This field is auto-populated.


Source 2

Vulnerability D = Design
E = Operational Environment
U = Unknown

Sensitivity C = Confidential
S = Secret
T = Top Secret
U = Unclassified

Associated A = Availability
Impact C = Confidentiality
I = Integrity
U = Unknown

Action B = Block/Shutdown
M = Monitoring
O = Other

Security Classification Code

Security This field is auto-populated.


Classification
Code

Follow Up Tab
The fields on this tab describe follow-up entries for a case.

Field Description

Actions Taken This text field can contain up to 4,000 characters.

Planned This text field can contain up to 4,000 characters.


Actions

Recommended This text field can contain up to 4,000 characters.


Actions

Follow-up This text field can contain up to 4,000 characters.


Contact

Confidential ArcSight Web™ User’s Guide 99


7 Using Cases

Final Tab
Fields on this tab provide ticket resolution and reporting information related to the attack
agent associated with a case.

Field Description

Attack
Mechanism

Attack This field is auto-populated.


Mechanism

Attack The network protocol that is transporting the


Protocol attack.

Attack OS The operating system supporting the attack.

Attack The program that is performing the attack.


Program

Attack Time The date and time of the attack.

Attack Target The host or device at which the attack is directed.

Attack Service The service at which the attack is directed.

Attack Impact The effect of the attack.

Final Report The action recommended for this case.


Action

Attack Agent

Attack Agent This field is auto-populated.

Attack A short description of the location under attack, of


Location ID up to 255 characters.

Attack Node A short description of the network node under


attack, of up to 255 characters.

Attack Address A text field in which you can record the IP address
under attack, of up to 255 characters.

Incident
Information

Incident This field is auto-populated.


Source 1

Incident This field is auto-populated.


Source 2

Incident A text field in which you can record up to 200


Source characters.
Address

Vulnerability

Vulnerability This field is auto-populated.

Vulnerability Selections include: Accidental or Intentional.


Type 1

100 ArcSight Web™ User’s Guide Confidential


7 Using Cases

Field Description

Vulnerability Selections include: EMI/RFI, Insertion of Data,


Type 2 Theft of Service, Unauthorized, Probes, Root
Compromise, DoS Attack, User Account.

Vulnerability This text field can contain up to 4,000 characters.


Evidence

Vulnerability This text field can contain up to 4,000 characters.


Source

Vulnerability This text field can contain up to 4,000 characters.


Data

Other

History Selections include: Known Occurrence and


Unknown.

No. A numeric value; the number of occurrences of the


Occurrences incident.

Last The date and time of the most recent incident.


Occurrence
Time

Resistance Selections include: High, Low, and Unknown.

Consequence This field is auto-populated.


Severity

Sensitivity This field is auto-populated.

Recorded Data This text field can contain up to 4,000 characters.

Inspection This text field can contain up to 4,000 characters.


Results

Conclusions This text field can contain up to 4,000 characters.

Events Tab
You can add events to a case from the Active Channels page ( ), as described in Using
Active Channel Grids. The system then displays these events on the Cases Events tab.

Field Description

Description This field is auto-populated from events included in a case.

Event Info and For selected events, this field displays event values and payload
Payload fields fields, if available.

Events related to a use case are preserved in the case for tracking purposes even after the
time period where the events would typically age out of the database.

Attachments Tab
The Attachments tab shows files associated with the selected case. Click the Attach button
to attach another file to the case.

Confidential ArcSight Web™ User’s Guide 101


7 Using Cases

If you do not see files as expected, try clicking the Refresh button ( ) to update the
view to show recently added files.

Field Description

Local file Select this option to choose a file on your local


system. Specify values for the following fields,
which are displayed when you choose a local file:

Name A descriptive name for the file. This name can


differ from the actual file name, and can include
spaces. If you do not provide an alternative name
here, the original file name is used.

Description A text description of the file.

File Click Browse and use the file browser to navigate


to and select the local file you want to attach to
the case. (This field requires user input.)

Text Encoding Encoding type. The default is ISO-8859-1.

Share this file Click this option if you want to make the file
in ArcSight available as a shared resource on the ArcSight
Manager.

ArcSight file Select this option to choose a file on the ArcSight


Manager.

Files to attach Click the plus button next the drop-down menu to
show the file browser on the ArcSight Manager.
Navigate to and select a file on the ArcSight
Manager. (This field requires user input.)

Click Attach to attach the file to the case. (Or click Cancel to abandon attachment edits.)

Click Submit to save the case with the new attachment, the same way you save new
settings on the other tabs.

Once the file is attached, anyone viewing the case can view details about the file and
download it. To do this, navigate to a case, and click the Attachments tab. To view more
details about an attachment, click the file name. To download an attachment, click the
Download button ( ) for that file.

Notes Tab
Field Description

Note Use this field to record notes of up to 4,000 characters.

102 ArcSight Web™ User’s Guide Confidential


Chapter 8
Handling Notifications

The Notifications feature displays notifications relevant to you that were triggered by
certain event conditions.

The notifications on the display are grouped according to workflow-style stages such as
pending, acknowledged, resolved, or informational. The specific groups you see have been
tailored to your enterprise.

To see the details of a notification, click its listing in the relevant group.

Notification
Use
Categories

Pending These are notifications that you have not yet handled (reassigned to
one of the following categories). Pending notifications older than 24
hours are automatically refiled as Not Acknowledged.

Acknowledged These are notifications to which you have responded.

Not Pending notifications that go unacknowledged or unresolved for


Acknowledged more than 24 hours are automatically refiled as Not Acknowledged.

Resolved These are notifications for which you or a colleague have found a
resolution and so have marked the notification accordingly.

Informational These are notifications that are provided for information purposes
only and do not require resolution or response.

Confidential ArcSight Web™ User’s Guide 103


8 Handling Notifications

104 ArcSight Web™ User’s Guide Confidential


Chapter 9

Using Reports

The ArcSight Web interface enables you to run reports, and view and save the report
results.

The reports available to you are organized in the Cases resource tree on the left. Click the
group folders in the tree to open or close them. Click a folder to see a list of its cases in the
right-hand pane. Click the arrow icon in the upper-right corner of the resource pane to hide
it or show it.

“Running and Viewing Reports” on page 105


“Running and Saving Archived Reports” on page 106
“Report Parameters” on page 106
“Viewing Archived Reports” on page 107
“Advanced Configuration for Report Performance” on page 108

Running and Viewing Reports


To run and view a report

1 Click Report Definitions just below the toolbar.

2 Navigate to a report in the resource tree.

3 Click a report definition name to show it in the right pane.

4 Use the values already defined for the report's parameters or change them as
necessary. (See “Report Parameters” on page 106.)

5 Click Run Report to run the report and display the results.

If you are running the context report from the event inspector, click View Report to
run and display the report.

For tips about how to run large reports that make efficient use of system
resources, see “Advanced Configuration for Report Performance” on
page 108.

Confidential ArcSight™ Web User’s Guide 105


9 Using Reports

Running and Saving Archived Reports


To run and save a report

1 Click Report Definitions just below the toolbar.

2 Navigate to a report in the resource tree.

3 Click a report definition name to show it in the right pane.

4 Use the values already defined for the report's parameters or change them as
necessary. (See “Report Parameters” on page 106.)

5 Select the Save Output checkbox to expose the archive report detail fields.

If you are archiving the context report from the event inspector, click Archive
Report. The report generates and be displayed in the viewer panel. You can save the
report output using the browser Save As function.

6 Enter the following details for saving the report output as an archived report and click
Run Report:

Field Enter this

Archive Report Folder Browse to an existing folder in the ArcSight file system
to save the report results. This makes the report
results retrievable from the Archived Reports view
later.

If you do not select a folder, you can save the report


once the results are displayed using the save method
that applies to the report format. For example, if you
chose PDF, you can use the PDF save to save the
results.

Archive Report Name Accept the default report name or enter a name for the
saved report results. Spaces are OK.

Archive Report Accept the default date (6 months from today), or


Expiration Time enter a date when the archived report results are
deleted. $NOW indicates that the report results are
deleted when you close the report results viewer.

Report Parameters
The following parameters are common to most reports. Depending on the query used as
the source for a report, other parameters may be exposed here. For example, a report
might prompt for a Start and End Date (timestamps) over which to run the report.

Parameter Use

Report Format The format in which to generate the report. Note that RTF appears
by default in Word documents, XLS in Excel worksheets, CSV in
Excel worksheets, and PDF and HTML in browser windows. The CSV-
Plain format intentionally has fewer report header lines.

Page Size Choose a standard paper size for the printed report (whether you
send it directly to print or not).

106 ArcSight™ Web User’s Guide Confidential


9 Using Reports

Parameter Use

Run as User As an option, choose an existing ArcSight user's identity as a report


constraint. The user identity can serve as a type of filter on the
report's output, or it may be desirable to run a report on behalf of a
user, as in a provider/customer (MSSP) circumstance.

E-mail to Select one or more e-mail addresses to send notifications to when


the report runs.

E-mail Format Choose to send the generated report or a URL to the file.

Save Output Select this option to save the generated report to the ArcSight
Manager as an Archived Report.

When you select the Save Output option (toggled "on"), provide the
name, location, and expiration date of the archived report.

Archive Report Indicate the name of the folder in which you want to store the
Folder report.

Archive Report Enter the name of the report. You can use Velocity Template
Name references here. By default, the report names is set to:
${Today}/${ReportName}_${Now}

$CurrentDateTime: Prints the current date and time. (Same as


$Now)

$CurrentDate: Prints the current date.

$CurrentMonth: Prints the current month.

$CurrentWeek: Prints the current week.

$Now: Prints the current date and time. (Same as


$CurrentDateTime)

$CurrentDateTime-<Number>: Prints the current date and time


minus the number of days you specify.

Archive Report Enter an expiration date and time for the archived report. Click the
Expiration calendar button next to the date field to get a popup calendar in
Time which to designate the date. The ArcSight system automatically
removes expired reports.

Viewing Archived Reports


To view an archived report

1 Click Archived Reports just below the toolbar.

2 Navigate to a report in the resource tree.

3 Click the name of an archived report to show it in the right pane.

Downloading an Archived Report


To download an archived report

1 Click Archived Reports just below the toolbar.

2 In the Download column for the report archive you want, click the Download icon.

3 In the File Download dialog box, choose to open the file or save it to a particular
location.

Confidential ArcSight™ Web User’s Guide 107


9 Using Reports

Adding New Archived Reports


To add a new archived report to a folder

1 Click Archived Reports just below the toolbar.

2 In the resource tree, select the report folder to which you want to add the new
archived report.

3 Above the list of available reports, click New Report.

4 In the Upload Report screen, enter a report name and specify the path to its file, or
click Browse to locate it.

5 Click Upload to add the archived file to the others available in the folder.

Deleting Archived Reports


To delete archived reports

1 Click Archived Reports just below the toolbar.

2 Navigate to a report folder in the resource tree.

3 In the list of archived reports on the right, check those you want to delete.

4 Click Delete to remove the checked reports, then click OK to confirm.

Advanced Configuration for Report Performance


Reports with large file sizes or large time ranges may require special configurations at the
Manager to ensure system performance.

Set these parameters only as needed if you encounter large or complex reports that
repeatedly cause performance problems or cause the Manager to restart when you try to
run them. Refer to the ArcSight Administrator's Guide for more information on setting
server properties on the Manager. The properties described here are also documented in
the server.properties file itself.

Configurations for Large Reports


A very large report (for example, a 500 MB PDF report) might require so much virtual
machine (VM) memory that it can cause the ArcSight Manager to crash and re-start.

To prevent that, set up the Manager to expose a special report parameter for generating
the report in a separate process. The separate process has its own VM and heap, so the
report is more likely to finish. Even if the memory allocated is still not enough, the report
failure will not crash the Manager.

This option must be set up on the ArcSight Manager to expose it in the ArcSight Web report
parameters list. On the ArcSight Manager in the server.properties file, set
report.canarchivereportinseparateprocess=true. Save the
server.properties file and restart the Manager.

Once this property is set to "true" on the Manager, the Save Output options for a selected
report on ArcSight Web include a new parameter called Generate Report In Separate
Process. Select this option for a report you want to archive as a separate process, and run
the report.

108 ArcSight™ Web User’s Guide Confidential


9 Using Reports

If a report is saved with the parameter set to "true", the report is archived as a separate
process even if the property report.canarchivereportinseparateprocess in
server.properties is set back to "false" later on.

Configurations for Reports with Large Time Ranges


Reports that query over a large time range with complex joins run much faster if the query
contains a full scan database hint. This option must be set up on the Manager to expose it
in the ArcSight Web report parameters list.

On the ArcSight Manager in the server.properties file, set


report.canquerywithfullscanhint=true. Save the server.properties file and
restart the Manager.

Once this property is set to "true" on the Manager, the Save Output options for a selected
report on ArcSight Web include a new parameter called Query with Full Scan Hint. Select
this option for a report you want to run with the full scan hint, and run the report.

If a report is saved with the parameter set to "true", the report is archived as a separate
process even if the property report.canquerywithfullscanhint in
server.properties is set back to "false" later on.

Confidential ArcSight™ Web User’s Guide 109


9 Using Reports

110 ArcSight™ Web User’s Guide Confidential


Chapter 10
Monitoring Dashboards

The ArcSight Web interface enables you to view dashboards made available from the
ArcSight Console.

When you click Dashboards in the toolbar, you see the Dashboards display, usually with
the Dashboards tree open in the resource pane and the dashboards of the current branch
listed in the content pane.

“Viewing and Managing Dashboards” on page 111


“Changing Dashboard Layouts” on page 111

Viewing and Managing Dashboards


The dashboards are organized in the resource tree on the left. Click the group folders in the
tree to open or close them. Click a folder to see a list of its dashboards in the pane to the
right. Click the arrow icon in the upper-right corner of the resource pane to hide or show it.

Click a dashboard's name to open it and its collection of data monitors in the right pane.

By default, the information on a dashboard refreshes automatically every 60 seconds. Click


the "Pause" button (||) to stop refreshing, or click the circular arrow to refresh
immediately. Click the arrow head to resume auto-refreshing.

Run the mouse pointer over elements in graphic data monitors to see their details in
tooltips.

Three types of data monitors are available through ArcSight Web: Event Graph, Geographic
Event Graph, and Hierarchy Map.

Changing Dashboard Layouts


You can change the way data monitors are laid out on dashboard displays. When you click
Dashboards and choose one to show from the resource tree, the layout of data monitors
in the right panel is a default pattern.

In a dashboard display, click Edit Layout to open the Dashboard Layout editor.

To rearrange data monitors, click and drag them from one of the display areas to another.
The upper and lower "wide" areas are intended to better accommodate tables, which most
often run wide and cannot be resized. The left and right "narrow" areas are intended to
accommodate charts, which are more likely to resize successfully.

To see a rearrangement, click Save.

Confidential ArcSight Web™ User’s Guide 111


10 Monitoring Dashboards

112 ArcSight Web™ User’s Guide Confidential


Chapter 11
Using the Knowledge Base

ArcSight Web provides access to viewing knowledge base articles. The articles available to
you are organized in the resource tree on the left. Click the folders in the tree to open or
close them. Click the arrow icon in the upper-right corner of the resource tree panel to hide
it or show it.

ArcSight offers the Knowledge Base as a convenience for storing user-


generated pointers or articles of interest. It is not pre-populated.

Confidential ArcSight Web™ User’s Guide 113


11 Using the Knowledge Base

114 ArcSight Web™ User’s Guide Confidential


Chapter 12
Using Reference Pages

An event viewed from the Event Inspector may have a reference page associated with it.
The contents of a reference page is set through the ArcSght Console.

 If present in an event, click View references to show the reference page content in a
separate browser window.
 Use the drop-down menu to navigate or other pages of this reference if more pages
are available.
 Use the browser's Back button to return.

Confidential ArcSight Web™ User’s Guide 115


12 Using Reference Pages

116 ArcSight Web™ User’s Guide Confidential


Chapter 13
Setting Preferences

In any display, click Options in the toolbar to set or change your preferences for date
formatting, locale, active channel startup, and password.

Click the Formats tab to choose the style and punctuation to use for date and time values.
Click Update to apply your changes before moving to another tab.

Click the Locale tab to choose the time zone you work in. Click Update to apply your
changes before moving to another tab.

Click the Channels tab to set, or bypass setting, the parameters for active channels, each
time you open one. The check box is clear by default, which means that you see the
channel setup options. Select the check box to avoid setup and to go directly to the
channel display. There is also an option to hide (collapse) the channel tree on the left panel
when a channel is already running. By default, this tree remains in view. Click Update to
apply your changes before moving to another tab.

Click the Password tab to change your current password. Enter your old password first.
Then enter your new password and repeat it to confirm. Click Update to put your change
into effect.

Confidential ArcSight Web™ User’s Guide 117


13 Setting Preferences

118 ArcSight Web™ User’s Guide Confidential


Chapter 14
Custom Branding and Styling

You can change logo images, colors, and styles for ArcSight Web by creating and editing
the file <ArcSightWeb_HOME>/config/web/styles.properties.

This file doesn't exist by default, but you can create it by copying either
example.styles.properties or full.styles.properties and renaming it to
styles.properties.

Please do not modify the file


<ArcSightWeb_HOME>/config/web/styles.defaults.properties. This file
contains the default settings. It is overriden by your custom
styles.properties file.

The properties file provides information about those properties that can be changed, along
with example values.

To add custom branding or styles:

1 Modify the properties in styles.properties as needed to fit your custom branding


and style requirements, and remove the comment tags from the lines that contain
property settings you want to apply.

2 If you want to add one or more custom logo images as part or your re-branding effort,
you need to both both modify the relevant property settings and add the image(s) to
the webapp/images directory:

 Modify the properties file to call your custom image file(s) and un-comment the
relevant lines (e.g., navbarLogoImg=MyCustomLogo.gif and
loginLogoImg=logo-login-MyCustomLogo.gif). You might also want to
modify and un-comment the logo image size property and navigation bar text
colors to make the proper customizations.
 Add the image file to the directory <ArcSightWeb_HOME>/webapp/images.
3 Restart ArcSight Web to see the effects of your custom changes.

Remember that branding changes are visible to anyone using that instance of ArcSight
Web. You can, however, run multiple instances of ArcSight Web against the same ArcSight
Manager.

Confidential ArcSight Web™ User’s Guide 119


14 Custom Branding and Styling

120 ArcSight Web™ User’s Guide Confidential


Index

A E
Active Channels 19 Events
Grids 21 Audit Events 78
Headers 21 Data Fields 32
Inline Filters 23 Event Categories 25
Opening 19 Events in cases 101
Viewing 21 Inspecting 24
Archived Reports
Saving 106
Viewing 107 F
ArcSight Express 13 Formats
Getting Started with ArcSight Express 15 Preferences 117
Home Page 14 Foundations 7
Monitoring 16 Administration 8
Reporting 18 Configuration Monitoring 7
ArcSight Web Network Monitoring 8
About 1 System Content 8
Navigating 5 Workflow 8
What’s New 3
Audit Events 78
G
Getting Started
B with ArcSight Express 15
Branding 119 with Standard Content 9

C H
Cases 95 Home Page 5
Attachments tab 101 ArcSight Express Home Page 14
Columns 96
Events Tab 101
Final Tab 100
I
Follow Up tab 99 Inline Filters 23
Inspecting Events 24
How to create 97
Initial Tab 97
Notes Tab 102 K
Security Classification Codes 96
Knowledge Base 113
Channels 19
Preferences 117
Content L
ArcSight Express 13 Locale
Standard Content 7 Preferences 117
logo
customizing 119
D
Dashboards 111
Changing Layouts 111 M
Viewing and Managing 111 Monitoring
Data Fields 32 Active Channels 19
ArcSight Express 16
Dashboards 111

Confidential ArcSight™ Web User’s Guide 121


Index

Inspecting Events 24 R
Standard Content 9
Reference Pages 115
Reporting
N with ArcSight Express 18
Navigating ArcSight Web 5 with Standard Content 10
Reports 105
ArcSight Express Home Page 14
Advanced Configuration 108
Basic Navigation 6
Home Page 5 Parameters 106
Running and Viewing 105
New Features 3
Saving Archived Reports 106
Notifications 103
Viewing Archived Reports 107

O
Options 117
S
see Active Channels 19
Standard Content 7
P Foundations 7
Password Getting Started using Standard Content 9
Changing 117 styles.properties 119
Preferences 117 System Content 8

122 ArcSight™ Web User’s Guide Confidential

You might also like