Professional Documents
Culture Documents
This document may not be reproduced by any means nor modified, decompiled, disassembled, published
or distributed, in whole or in part, or translated to any electronic medium or other means without the prior
written consent of SolarWinds. All right, title, and interest in and to the software, services, and
documentation are and shall remain the exclusive property of SolarWinds, its affiliates, and/or its
respective licensors.
The SolarWinds, SolarWinds & Design, Orion, and THWACK trademarks are the exclusive property of
SolarWinds Worldwide, LLC or its affiliates, are registered with the U.S. Patent and Trademark Office, and
may be registered or pending registration in other countries. All other SolarWinds trademarks, service
marks, and logos may be common law marks or are registered or pending registration. All other
trademarks mentioned herein are used for identification purposes only and are trademarks of (and may
be registered trademarks) of their respective companies.
page 2
Table of Contents
SolarWinds SAM Getting Started Guide 8
Product terminology 9
User accounts 17
Create a user 18
Get connected 21
Discover 25
Discovery checklist 26
Monitoring overview 27
Advanced discovery 36
page 3
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Monitor 41
Action types 62
page 4
Run a preconfigured report 71
Schedule a report 72
Templates 82
Export a template 85
Import a template 85
Export a template 87
Import a template 88
Thresholds 90
Customization checklist 97
Tips 98
page 5
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Agents 130
page 6
How agents work 130
page 7
SolarWinds SAM Getting Started Guide
Welcome to the SolarWinds Server & Application Monitor (SAM) Getting Started guide.
This guide walks you through the best features and options to get visibility into hardware health, asset
inventory and operating and application performance and further customize your monitoring with SAM.
l Get started. Plan your implementation, set up SAM, and collect data about your environment.
o Understand the SAM environment, user accounts, and access
o Discover applications, servers, cloud instances/VMs, and devices
o Monitor applications, hardware health, assets, cloud instances/VMs, and more
o Use Performance Analysis (PerfStack) to identify issues before customers call the help desk
o Prepare alerts and reports
l Customize. Tailor SAM to your internal processes so you can more effectively respond to
performance issues.
o Create templates for custom applications
o Create and assign custom properties to nodes
o Create dependencies between applications and supporting infrastructure
o Create custom pages
o Create dashboard views and adjust user permissions
o Create custom alerts and reports
Existing customers: Follow recommendations in this guide to ensure your system capabilities are
appropriate and your environment is sized correctly. Minimum system requirements used during
evaluation are not sufficient for a production environment. Access your licensed software from the
SolarWinds Customer Portal. If you need implementation help, contact Customer Support.
Read Working with Support to learn how to open a support case with the correct level of visibility.
Evaluators: If you are evaluating SolarWinds SAM, concentrate on the Get Started and Customize
objectives described earlier. As you work through the guide, you will see some topics that provide
information for production deployments. That information is included to provide a sense of what a
production environment looks like. Download a free 30-day evaluation here. For assistance during
evaluation, contact sales@solarwinds.com.
l This SAM Administrator Guide provides an overview of product features and related technologies. In
addition to details about configuring and using SolarWinds SAM, it contains recommendations on
best practices, and troubleshooting information for common situations.
l To install SAM, review SAM 6.7 system requirements and SAM release notes, and then use the
SolarWinds Orion Installer.
l To get the latest version of SAM, use the SAM upgrade guide.
page 8
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
l For details about features shared by SAM and other Orion Platform products such as user accounts,
views, dashboards, and alerts, see the Orion Platform Administration Guide.
l Visit the SolarWinds Success Center for product guides, training resources, and technical support
articles.
Be sure to check out the Server & Application Monitor product forum in the SolarWinds online IT
community, THWACK, to connect with SolarWinds developers and product managers, plus other
SAM users. Download templates, reports, scripts and more that allow you to customize and extend our
products. Some content in this area is created by SolarWinds staff and the rest is created and shared with
the community by our members.
Product terminology
Orion Platform: The common backend platform used by the Solarwinds Orion suite of products, including
NPM, SAM, NCM, NTA, and more. The Orion Platform is the backbone for navigation, settings, and common
features like alerts and reports. It also provides a consistent look-and-feel across products, giving you a
"single pane of glass" for your Orion monitoring tools.
Orion Web Console: The web interface you see when you log into the Orion Web Console that is used to
view, configure, and manage all of your monitored objects.
Orion server: A Microsoft Windows server that hosts the Orion Web Console and collects data from
monitored objects. Also called the Orion Main Poller or Main Polling Engine.
Orion database server: A Windows SQL server that is hosted on a dedicated server in a production
environment, separate from the Orion Application Server. It stores Orion configuration data plus collected
performance and syslog data.
Polling engine: A polling engine controls polling job scheduling, data processing, and queries your
monitored devices for performance metrics like CPU, memory, and up/down status. Additional Polling
Engines (APEs) can be licensed to provide additional scalability and capacity. By default, the Orion Server
provides one polling engine, that is often called the "main polling engine."
Node: A node is considered to be any endpoint of a given network. For example, any application, server,
device, or computer on a network is considered a node.
Template: A template is the blueprint for an application. It is a collection of component monitors designed
to monitor a server or application. You can customize numerous templates using only the component
monitors you need for a specific environment. For a list of out-of-the-box templates, see the SAM Template
Reference.
Application: An application or application monitor in SAM monitors a specific application or server using a
collection of component monitors.
page 9
Navigate your environment
SolarWinds SAM includes many resources and views you can use to manage and troubleshoot an
environment. A resource is a building block that displays on a view as a box and provides information
about different aspects of monitoring, usually in a chart or table. Some resources are intended for use on
summary views, some are suitable for detail views, and some can be useful on both view types.
The following figure shows several resources in a single summary view, including a resource with gauges
that displays statistics for multiple compontents:
Some resources and views are not visible by default and can be added by editing settings.
page 10
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Clicking Manage Nodes in the All Nodes resource opens the Manage Nodes page where you can take
action on multiple nodes.
page 11
Use the All Applications resource on the Summary page to drill down to individual applications and
component monitors of an application. The Application Details page provides details about the individual
application and actions you can perform on that application. This allows you to manage templates and
applications to node assignments, or "unmanage" (that is, stop managing) multiple applications at one
time.
Clicking Manage Applications in the All Applications resource takes you to the Manage Applications page
where you can troubleshoot and resolve issues on multiple applications.
Expand an application name to show all component monitors associated with that application. Click a
component monitor to access the Component Monitor details page to view detailed information and
perform additional actions.
page 12
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
OPTION FUNCTION
Edit Node Edit the properties of a node and the polling method used.
Unmanage Suspend polling and collecting statistics for a set period of time.
If the job scheduler is at capacity, the job may not execute immediately, but it
will execute before the next scheduled poll cycle.
page 13
OPTION FUNCTION
Rediscover Update node data such as machine type, system name, or location.
Real-time Event Display a list of system events and start monitoring events.
Log Viewer
These controls are available on the Details page of the node, application, or component in the
Management resource.
AppStack provides a more thorough analysis of root cause problems in your environment when
combined with Storage Resource Manager, Virtualization Manager, and Web Performance Monitor.
An AppStack view is also available at the application layer that only shows the relationships for that
application. This view is called the Mini-Stack.
page 14
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
2. Click an object to highlight related objects and gray out unrelated objects.
page 15
3. Click Spotlight to remove unrelated objects.
page 16
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
User accounts
This section provides information on working with user accounts:
Before you begin, consider what tasks the user must perform, and what views and menu bars are most
suitable.
Users created using default settings can log in to the Orion Web Console and see information available in
views, resources, and reports. For administration and customization tasks, users need extra rights.
TASK ACCESS
(SELECT YES FOR THIS OPTION OR DO AS INSTRUCTED)
Add and edit user accounts and reset Allow Administrator Rights
passwords.
page 17
TASK ACCESS
(SELECT YES FOR THIS OPTION OR DO AS INSTRUCTED)
Add, edit, and delete alerts. Allow Alert Management Rights
Access only a set of devices (type, Click Add Limitation and define the limitation.
location, department, and so on).
If you create a new account and do not configure the SAM User Role, you will not be able to fully
manage applications within SAM.
Create a user
Check out this video on creating users.
1. Log in to the Orion Web Console, and click Settings > All Settings.
2. Click Manage Accounts in the User Accounts grouping, and click Add New Account on the Individual
Accounts tab.
page 18
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
You can only use one authentication protocol at a time. All Windows accounts are authenticated through
MSAPI or LDAP, depending on which one is enabled.
SolarWinds offers a free analyzer tool for Active Directory that provides instantaneous visibility into
effective permissions and access rights. The tool provides a complete hierarchical view of the
effective permissions access rights for a specific file folder (NTSF) or share drive. Download it for
free from here: http://www.solarwinds.com/products/freetools/permissions_analyzer_for_active_
directory/.
page 19
Change account passwords
When you log in to the Orion Web Console for the first time, SolarWinds recommends that you change the
password for the Admin account.
1. Log in to the Orion Web Console, and click Settings > All Settings.
2. Click Manage Accounts in the User Accounts grouping.
3. Select a user, and click Change Password.
4. Enter and confirm the new password, and click Change Password.
page 20
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Get connected
This section contains information on accessing the SolarWinds Customer Portal and engaging with
THWACK, the SolarWinds community of IT pros:
Users with multiple SWIDs require only one user profile. Your user profile can be linked to multiple
SWIDs.
1. Go to customerportal.solarwinds.com.
2. Click the Register tab.
3. Enter your organization's SWID and your email address.
If you have multiple SWIDs, enter any SWID to create your profile. Later, use the User Profile
menu to link the other SWIDs to your profile.
The account administrator will review the request, and you will receive an email when it is approved.
For more information about creating an account, see this FAQ page.
page 21
Explore the Customer Portal
page 22
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
For more information about user account types and permissions, see this FAQ page.
1. Log in to the SolarWinds Customer Portal using an account with Account Administrator level access.
2. In the user account drop-down menu in the upper-right corner, click Company Account Settings.
3. Click the Add User button.
4. Enter the user's email address.
5. Specify the user's access level and click Create.
l Account Administrator: can access all areas of the Customer Portal. Can also add and remove
users, edit user profile information, and assign roles and contact types to users.
l Standard Access: can access all areas of the Customer Portal.
l No Access: cannot access the Customer Portal, but is listed as a contact on the account.
The system sends a user profile creation email to the user. The user account is listed as Pending in
the Admin portal until the user activates their account through the user profile creation email.
1. Go to thwack.solarwinds.com.
2. Click Register in the top right.
3. Enter the required information and accept the license agreement.
4. Click Create Account.
After you create a THWACK account, you will be asked if you want to link your THWACK account with
your Customer Portal account. If you link the accounts, you will see more relevant content and
messages in the Customer Portal.
page 23
Explore the THWACK site
After you create an account, complete the onboarding mission to begin exploring THWACK. Participating in
the THWACK community earns points, which you can use to purchase items in the THWACK store.
page 24
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Discover
This section contains the following discovery topics:
SAM also monitors Amazon Web Services (AWS) cloud instances and Microsoft Azure VMs. With access to
your cloud services account, SAM can poll cloud service APIs for cloud metrics and status. This data
aggregates and displays through the Orion Web Console to monitor, manage, and troubleshoot issues in
your cloud environment.
SolarWinds recommends adding a limited number of applications and servers to begin monitoring and
gauging performance, including Microsoft Exchange, IIS, SQL, Linux, and Unix. After monitoring, alerts, and
reports are set up, continue adding more applications and servers to expand your infrastructure
monitoring.
page 25
Discovery checklist
When you run the Discovery Wizard, you will be asked to provide IP addresses and credentials for the
devices you want to monitor. SolarWinds recommends that you gather this information before running the
Discovery Wizard.
Determine the protocol used to monitor your devices: SNMP or WMI. See Monitoring overview for
details.
Gather IP ranges or individual IP addresses you want the system to scan as it discovers your
network.
Collect SNMP v1/2c community strings and SNMP v3 community strings and credentials of the
devices you want to monitor.
For AWS cloud monitoring, add an AWS IAM user account (up to 10) and Account Access Key ID
and Secret Access Key for access. The account should include the following permissions:
l ec2:DescribeInstances
l ec2:DescribeAddresses
l ec2:DescribeVolumes
l ec2:DescribeVolumeStatus
l cloudwatch:GetMetricStatistics
l autoscaling:DescribeAutoScalingInstances
For additional management actions, add the following permissions to the AWS IAM user account:
l ec2:StartInstances
l ec2:StopInstances
l ec2:RebootInstances
l ec2:TerminateInstances
To set up permissions and AWS cloud accounts, see Learn more about Amazon EC2 credentials
for cloud monitoring.
For Microsoft Azure cloud monitoring, configure Azure to interact with the Orion Platform before
adding an Azure cloud account to the Orion Web Console. Each account requires sufficient Azure
Active Directory (AD) and subscription permissions to add an AD app in the Azure Portal so the
Orion Platform can retrieve status and metrics for VMs. IAM permissions must also be set up.
Visit the SolarWinds Success Center and review Configuring Microsoft Azure for cloud
monitoring in the Orion Platform for details.
page 26
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Monitoring overview
You can configure an application or template to collect data through a preferred polling method as agent
or agentless.
An agent is software that provides a communication channel between the Orion server and a Windows or
Linux computer. Products install plugins on agents to collect the data that the agents send back. Orion
agents are available for Windows and Linux. For requirements and information, see Monitoring with Orion
agents in SAM.
To monitor devices using SNMP, you must enable SNMP on those devices because it is not enabled by
default. SNMP is primarily used to monitor network devices, for example, routers, firewalls, and switches.
To enable SNMP, consult the device vendor documentation.
When configuring SNMP-enabled network devices for monitoring, note these details:
l Steps to enable SNMP communications differ by device; consult the documentation provided by your
device vendor.
l For correct device identification, monitored devices must allow access to the SysObjectID.
l Unix-based devices should use the version of Net-SNMP (5.5 or later) that is specific to the Unix-
based operating system in use.
l If SNMPv2c is enabled on a device, NMPv2c is used to poll the device for performance details by
default. To poll with SNMPv1, disable SNMPv2c on the device to be polled.
l SolarWinds SAM can monitor VMware ESX and ESXi Servers versions 4.0 and later.
l Linux/Unix servers are generally monitored with SNMP and SSH Script Monitors that require user
credentials.
VMware Tools is not required on virtual machines (VMs) running on monitored ESXi and ESX servers,
but additional details such as IP addresses are made available if VMware Tools is installed on VMs
hosted by monitored ESXi and ESX Servers.
If monitoring Windows servers, use Windows Management Instrumentation (WMI), which is usually
enabled on Windows devices by default. Capable of gathering more data than SNMP, WMI is the preferred
polling method because some SolarWinds SAM features are not available if you use SNMP.
Agentless monitoring using WMI is not recommended when the poller and the device are separated by a
firewall. To overcome this limitation, SolarWinds provides an optional agent that allows you to securely
monitor Windows servers and applications by WMI. If you want to use SNMP for Windows, then you must
install and configure an SNMP agent.
page 27
Deciding between SNPM and WMI
SNMP is typically used to monitor servers and network devices without agents. For Windows servers, WMI
usually provides better metrics than can be obtained through SNMP monitoring alone. For many Windows-
based servers and applications, agentless monitoring via the WMI gateway provides strong monitoring
capabilities.
The availability of some features depends on which Orion Platform modules are in your
environment, as well as which product versions you're using. For example, NPM supports polling via
WMI, SNMP, and agents. However, interface polling via WMI and Agent is not supported unless you
have a SAM license. You must use SNMP as a polling method to obtain interface data in an NPM-
only installation. For details, see Polling methods used by Orion.
The following table describes the pros and cons of monitoring with SNMP vs. WMI:
SNMP WMI
Bandwidth, CPU, memory Uses more bandwidth, CPU,
usage on the host/poller and memory than SNMP per poll.
To learn more, see the following the SolarWinds Customer Success Center articles:
page 28
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The first time you run the Discovery Wizard, SolarWinds recommends adding a limited number of
application servers, including Exchange, IIS, SQL, Linux, and Unix. The examples in this guide focus on
monitoring IIS and the operating system of your application server, but the same steps are applicable to
monitoring any application.
After discovery, if the status of a node is Unknown, you may need to check settings in SolarWinds
SAM. See Troubleshoot Unknown Nodes for details.
1. If the Discovery Wizard does not start automatically after configuration, click Settings > Network
Discovery.
2. Click Add New Discovery, and then click Start.
3. On the Network panel, if this is your first discovery, add a limited number of IP addresses.
As you scale your implementation, you can use the following scanning options.
Option Description
IP Ranges Use this option when you want Orion to scan one or more IP ranges.
If you have many IP ranges to scan, consider adding multiple discovery jobs rather
than including all ranges in a single job.
Subnets Use this option to scan every IP address in a subnet. SolarWinds recommends
scanning at most a /23 subnet (512 addresses max).
Scanning a subnet returns everything that responds to ping, so we recommend only
scanning subnets where the majority of devices are objects you want to monitor.
IP Use this option for a limited number of IP addresses that do not fall in a range.
Addresses Since a network discovery job can take a long time to complete, SolarWinds
recommends using this option when you are first starting out.
page 29
4. The Agents panel appears. The QoE agent monitors packet-level traffic. If there are any nodes using
agents, select the Check all existing nodes.
This setting ensures that any agents you deploy, including the one on your Orion server, are up-to-
date. If there are no nodes using agents, you can leave this option unchecked.
5. On the Virtualization panel, to discover VMware vCenter or ESX hosts on your network, enter the
credentials, and click Next.
6. On the SNMP panel, to monitor an SNMP-enabled device, enter the credentials, and click Next.
7. On the Windows panel, to discover WMI or RPC-enabled Windows devices, click Add New Credential
and provide the required information.
SolarWinds recommends that you monitor Windows devices with WMI instead of SNMP.
page 30
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
8. On the Monitoring Settings panel, SolarWinds recommends manually setting up monitoring the first
time you run discovery. This allows you to review the list of discovered objects and select the ones
you want to monitor.
When you scale monitoring, you can configure discovery to automatically start monitoring objects it
finds.
Discovery can take anywhere from 5 minutes to several hours, depending on the number of
application servers involved.
page 31
Add discovered servers and applications to SolarWinds SAM
After the Network Sonar Wizard discovers your network, the Network Sonar Results Wizard opens, allowing
you to import network elements into SolarWinds SAM. Discovered elements do not count against your
license count; only elements that you import into the Orion database count against your license.
When you run discovery manually, the system automatically selects all network elements to be monitored.
You must clear the check boxes for elements you do not want monitored. This example highlights Windows
devices with IIS.
Before you begin, ensure that you Discover your servers and applications.
If discovering your network for the first time, SolarWinds recommends monitoring a small number
of critical servers.
1. Make sure that only the device types you want to monitor are selected, and click Next.
After discovery, if the status of a node is Unknown, you may need to check settings in
SolarWinds NPM. See Troubleshoot Unknown Nodes.
2. Ensure the interfaces you want to monitor are selected, and click Next.
SolarWinds recommends that you do not monitor WAN, QoS, multi-port, and virtual NIC interfaces.
page 32
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
3. Ensure the volume types you want to monitor are selected, and click Next.
SolarWinds recommends that you do not monitor compact disks and removable disks.
page 33
5. Review the list of elements to be imported, and click Import.
Adding a single node offers more detail in monitoring and is the recommended approach when you
have a node with high latency. Do not include nodes with high latency in a discovery job.
page 34
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
4. Select the statistics and resources to monitor on the node, and click Next.
page 35
5. Review and adjust the device properties.
a. To edit the SNMP settings, change the values, and click Test.
b. To edit how often the node status, monitored statistics, or topology details are updated, change
the values in the Polling area.
For critical nodes, you may need to poll status information or collect statistics more
frequently than the default polling intervals.
Change the polling intervals if polling the nodes takes too long.
Advanced discovery
Check out this video on managing discovery jobs and performance.
At this point you have completed an initial discovery. Now you can add discoveries to include other
segments of your IT environment.
l Multiple jobs. SolarWinds recommends building as many discovery jobs as needed to scan your
network. Initially, run the jobs immediately so you can see everything on your network, and then
schedule the jobs to run periodically. Dividing the discovery into multiple jobs makes it easier to be
selective about what to monitor, and decreases the amount of time each job runs. When you have a
large environment, consider dividing discovery jobs by:
o Credentials - the more credentials you have, the longer it takes for the discovery job to
complete. Place the most common credentials at the top of the list.
page 36
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
o IP address range - use a range that consists of fewer than 2,000 IP addresses. In a range,
unresponsive IP addresses slow down discovery.
o Latency - run discoveries for remote offices separately so that you can adjust the timeout
threshold.
o Polling engine - if you have multiple polling engines, configure a discovery for a specific polling
engine.
l Discovery ranges. Although you can discover specific nodes, SolarWinds recommends using a
range of IP addresses or subnets for a more complete picture of your network. None of the
discovered elements count toward your license total or affect system performance until you begin
monitoring. You can add multiple IP ranges or subnets to the same scan, but you cannot include IP
ranges and subnets in the same scan.
l Discovery thresholds. If you run a discovery and nodes you expect to see are not found, you may
need to adjust the timeout and retry thresholds. In an environment with high latency, the default
values may not be high enough. Only adjust these values after an initial scan. The higher the
threshold value, the longer the discovery job takes to complete.
l Polling engine. If you have multiple polling engines, you will see an option to select a polling engine.
The polling engine you select runs the discovery job and monitors your network. SolarWinds
recommends that you limit a poller to 12,000 elements, so be careful not to overload one polling
engine. If you have a large environment with significant differences in latency, position the polling
engine close to the monitored objects.
page 37
l Schedule intervals. Schedule your discovery jobs to run periodically to identify new devices that
were added to your network. Unless you work in a dynamic environment where new devices are
frequently added to your network, SolarWinds recommends scheduling discovery daily. You can also
select Advanced from the Frequency drop-down menu to create a custom frequency. The schedule
interval you choose depends on how often you want to scan for changes to the network and the size
and performance of your deployment.
l Scheduled results. A manual, scheduled discovery only finds network elements, but does not
automatically start monitoring. You must select what you want the system to monitor. If the
scheduled job locates nodes that you do not want to monitor, select those nodes and click Add to
Ignore List. Ignoring hides elements from the results list the next time the discovery job runs.
Scheduled discovery profiles should not use IP address ranges that include nodes using
DHCP.
Unlike application and server discovery jobs, adding cloud instances and VMs to the Orion Platform is not
an automated process. For example, before you can monitor Azure VMs, you must configure Azure to
interact with the Orion Platform and add a cloud service account in the Orion Web Console.
The following table outlines cloud monitoring requirements. See the SAM Administrator Guide for details.
page 38
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
FUNCTIONALITY REQUIREMENTS
Monitor AWS cloud metrics To create an AWS account, see the Amazon documentation. For details
on setting up permissions and AWS cloud accounts, see Learn more
about Amazon EC2 credentials for cloud monitoring.
Credentials required to add AWS accounts to the Orion Platform and
deploy Orion agents to instances include:
l Access Key ID
l Secret Access Key
Monitor Azure cloud metrics Follow the steps in Configuring Microsoft Azure for cloud monitoring in
the Orion Platform.
Credentials required to add Azure accounts to the Orion Platform or
deploy Orion agents to VMs include:
l Subscription ID
l Tenant/Directory ID
l Client/Application ID
l Application Secret Key
After creating and configuring a cloud account, follow these steps to add the cloud account to the Orion
Platform.
page 39
5. Click Monitor AWS or Monitor Azure, depending on which provider you selected.
6. On the Cloud Settings tab, enter a Display Name for the account and provide account credentials.
7. If the SolarWinds Orion server requires a proxy server to connect to certain websites, click "Are you
behind a proxy?" to configure proxy settings.
8. (Optional) Click Test Connection.
If an error occurs, verify account credentials and confirm that accounts are configured for the
Orion Platform.
9. (Optional) Toggle Auto Monitoring off for instances/VMs added later, either manually or via
automated discovery.
10. Click Continue to complete the wizard.
With access to your cloud services account, Cloud Infrastructure Monitoring polls cloud service APIs for
cloud metrics and status. This data aggregates and displays through the Orion Web Console so you can
monitor, manage, and troubleshoot issues in your cloud environment.
page 40
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Monitor
This section includes instructions on how to configure monitoring:
Templates provide blueprints for the applications to be monitored. You can customize templates, and use
only the component monitors you need to monitor a specific environment. SolarWinds SAM provides the
following types of templates:
l AppInsight application templates are preconfigured templates that provide detailed information. If
you have business-critical Exchange, Microsoft IIS, or Microsoft SQL instances, use the AppInsight
templates to monitor these applications. These templates have their own mechanism of discovering
elements of an application dynamically. They also have special licensing.
l If you have other business-critical applications, apply one of the many preconfigured application
templates that ship with SolarWinds SAM. SolarWinds recommends deploying a single template,
making necessary edits to customize it to your environment, and then deploying the edited template
on all similar applications. You can also obtain a template from the thwack community for an
application not shipped with SAM.
l If you have a custom, homegrown application that you need to monitor, you can build a custom
template.
The following illustration explains the template and application relationship. If you make a change at the
template level, the applications based on that template will be affected. Conversely, if you make a change
at the application level, only the individual application will be affected.
This inheritance relationship is beneficial if you need to make a lot of changes. For example, rather than
making one change to 100 applications (and therefore 100 changes), you can change one item that will
affect all 100 applications based on that template.
page 41
Monitor Internet Information Services (IIS)
SolarWinds SAM includes AppInsight Applications that provide a level of detail beyond what other
templates can provide, allowing you to monitor virtually every aspect of your application. The AppInsight
for IIS application provides:
If the system did not scan for AppInsight for IIS during discovery, you can add it to monitored servers
running IIS.
This example shows how to apply the AppInsight for IIS application template to a Windows node.
page 42
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
3. Select Microsoft IIS to enable AppInsight for IIS data collection, then click Submit.
List resources shows all monitorable features of a node.
4. Click the All Applications resource to verify the addition by clicking the Applications.
page 43
5. Enter your IIS credentials when prompted, and click Configure Server.
From the Applnsight for IIS details view you can view the status and details for Sites, Applications Pools,
and Performance Counters by clicking elements in each of these resources.
page 44
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
page 45
Expert knowledge for AppInsight performance counters
General information is provided for a selected counter, in addition to possible problems and
troubleshooting steps, where applicable. Find expert knowledge on the performance counter details page.
AppInsight for IIS can help you monitor and troubleshoot IIS. However, a software monitoring solution
cannot detect failed hardware issues, such as insufficient RAM or a failed cooling fan. To detect hardware
issues, you also need to enable hardware health monitoring.
SolarWinds recommends deploying a single template, making necessary edits to customize it to your
environment, and then deploying the edited template on all similar applications. To find and add
additional templates, import templates shared by other users through THWACK. SAM provides import
options for THWACKexports and directly from files.
The following example shows how to apply the Windows Server 2003-2012 template to monitor a Windows
2012 OS.
page 46
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Windows Performance Counters use Remote Procedure Call (RPC) for communication which uses
TCP port 445. If testing fails once the template has been assigned to a node, you can use the WMI
protocol.
page 47
4. Select the Windows nodes you want to monitor for the operating system on the left pane, click the
green arrow to move it to the right pane, and click Next.
page 48
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
l VMware hosts
l HP ProLiant™
l Dell PowerEdge™
l IBM X-Series™
l HP C7000 and HP C3000 BladeSystems
l Dell M1000e Blade Enclosure
For SolarWinds SAM to monitor hardware health information, the Hardware Monitoring Agent, provided by
the software manufacturer, must be installed, configured, and enabled on each system. Once enabled
server-side, you must either:
l Run a discovery so that SolarWinds SAM can detect that the Hardware Monitoring Agent has been
enabled. SolarWinds recommends this approach if you have multiple nodes where the Hardware
Monitoring Agent has been enabled, or if you are not already monitoring those nodes.
l Go to the Node Details page, select List Resources, then check the Hardware Health option.
page 49
To configure hardware health monitoring:
page 50
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
l VMware hosts
l HP ProLiant™
l Dell PowerEdge™
l IBM X-Series™
l HP C7000 and HP C3000 BladeSystems
l Dell M1000e Blade Enclosure
l The Hardware Monitoring Agent, provided by the software manufacturer, must be installed,
configured, and enabled on each system.
l You complete the steps outlined in Configure hardware health monitoring
You may need to log in with an administrator account to perform this action.
1. On the Web Console, click My Dashboards > Home, and then locate the Hardware Health Overview
resource.
2. To view a status, click its label.
page 51
4. Review the Current Hardware Health resource. Sensors listed as Critical should be investigated.
To support hybrid environments, the Orion Platform can retrieve data from the Amazon Web Services
(AWS) and Microsoft Azure cloud service platforms to track availability, performance, applications, and
more for instances and VMs. Examples of data gathered include status, storage capacity, memory usage,
and IP addresses.
After configuring cloud accounts, you can use the Cloud Infrastructure Monitoring feature to:
l Manage hybrid environment metrics and status through a single console so you can compare
performance, locate bottlenecks, and better plan capacity and resource allocation.
l Track end user and business context for performance by gathering extended metrics that provide
visibility into cloud and on-premises systems.
l Dynamically monitor cloud instances and VMs to better handle resource churn during provisioning.
Instances and VMs can be removed as needed to support expanding environments or performance
peaks.
l Determine usage trends and troubleshoot issues. Captured metrics over time provide historical
references to track trends for resource consumption (such as CPU spikes and lulls) and help
determine when those trends become issues.
l Use cloud monitoring data, Orion alerts, and the Performance Analysis dashboard (PerfStack) to
review historical performance and pinpoint when significant usage changes began to trigger issues.
For example, add a series of EC2 cloud instances for an AWS account for the east coast. Select My
Dashboards > Cloud to review overall AWS infrastructure data and cloud details. Use the Cloud Instances
Status Summary and Cloud Server Infrastructure resources to review status and health at-a-glance. To
quickly review cloud status, metrics, and node management details, hover over any cloud instance name in
the Orion Web Console.
page 52
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The tooltip provides quick information for the cloud service and status.
Cloud instances encountering issues display in the following resources with linked instances and nodes to
investigate:
l Active Cloud Alerts lists all active alerts affecting monitoring and managed cloud instances.
l Cloud Applications with Problems lists all applications with issues on cloud instances managed as
nodes in SAM.
Select a cloud instance or VM to view its Details page. Exceeded thresholds are highlighted in warning and
critical values, charts, and graphs with hover-over points to compare collected data and linked alerts.
page 53
The following resources provide important data to determine issues, as well as track performance and
usage trends:
l Active Alerts lists all active alerts affecting the cloud instance.
l Min/Max/Average of Average CPU load displays average CPU load collected and calculated for the
cloud instance.
l Min/Max/Average of Network Utilization provides a chart of the minimum, maximum, and average
bits per second transmitted and received over a cloud instance for a custom period of time.
page 54
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
To investigate the issue, create troubleshooting projects with the Performance Analysis (PerfStack™)
dashboard that visually correlate historical and real-time data from multiple SolarWinds products and
entity types in a single view.
l Compare and analyze multiple metric types in a single view, including status, events, and statistics.
l Compare and analyze metrics for multiple entities in a single view, including, nodes, interfaces,
volumes, applications, and more.
l Correlate data from across the Orion Platform on a single, shared time line.
l Visualize hybrid data for on-premises, cloud, and everything in between.
l Share a troubleshooting project with your teams and experts to review historical data for an issue.
For SAM, the possibilities are endless for application analysis and hybrid environments:
The following example shows you how to identify a root cause for a Windows Server 2012 application
performance issue. In this scenario, the application performance has degraded to the point where users
encounter slower responses and access. As you review the Windows Server 2003-2012 template
dashboard, you find triggered alerts. These alerts notified your application owner, who escalated the issue
to system and network administrators.
Rather than digging into the alerts and multiple Node Details pages to troubleshoot the issue, create a
new troubleshooting project to investigate the issue.
1. In the Orion Web Console, select My Dashboards > Home > Performance Analysis.
This opens the Performance Analysis, or PerfStack, dashboard to build charts and graphs using
metrics pulled from monitored applications and servers in the Metric Palette. Each chart can hold
multiple metrics to directly correlate data.
2. In the New Analysis Project, click Add Entities.
Entities include all monitored and managed servers, applications, devices, services, and more in the
Orion Platform.
page 55
3. Select Entities and click Add selected items.
To get started, you need to locate and add the Windows 2012 application in distress. In the search
field, enter Windows to get a list of all monitored nodes, component monitors, and more with
Windows in the name or type. Expand and select Types or Status to filter the list.
From the list, we find the application monitor watching Windows Server 2003-2012 Services and
Counters. Select and add to the dashboard Metric Palette.
Interested in all associated nodes, applications, servers, and more to this selected node? Click
the related entities icon. All related entities display in the Metric Palette providing more
options for metrics possibly causing issues.
4. Select the Windows 2012 node to view and select metrics to drag and drop onto the dashboard. You
can drag them into the same chart to compare values between metrics.
To start investigating, pull a series of metrics for the IOPS throughput for the server. For this
scenario, add the following metrics to investigate latency and connectivity:
page 56
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The charts and graphs display with data and alerts for the Last 12 hours of metrics.
page 57
5. Add more metrics from the virtual and storage layers to investigate and confirm any bandwidth
spikes.
For example, add metrics for the IO latency from the virtual and storage layers to locate issues:
l IO Latency Write
l IO Latency Read
l IOPS Total
l Throughput Total
Analyzing the data, the issue looks to be a noisy neighbor. Basically, another server, service, or
application is consuming higher bandwidth, disk I/O, CPU, and other resources causing issues for
this specific application.
This information gives your network and system administrators a direction for further investigation
and resolving latency issues. To resolve, they can reallocate resources or move the high-consumption
application to another location.
6. Click Save and give the project a name.
The project saves as a dashboard with the selected metrics in the set date and time range.
When saved, the URL becomes a sharable link. Copy and share the link to the saved dashboard in
tickets or emails sent by the system and network administrators and the product owner. They can
access the link to review the gathered data and troubleshoot.
After reallocating resources and making network changes, reopen the dashboard to verify changes
and new usage trends for polled metrics.
page 58
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Many predefined alerts are enabled by default, so if there are problems, you are alerted as soon as you
Discover your servers and applications and Add discovered servers and applications to SolarWinds SAM.
SolarWinds recommends that you identify who will receive warning or critical alerts.
page 59
By default, alerts appear in the Active Alerts resource on the Orion Home page.
To see all alerts, you can click the All Active Alerts button in the Active Alerts resource, or you can click
Alerts & Activity > Alerts. On this page, you can:
You can create your own alerts, either by duplicating and editing a predefined alert, or by creating a
custom alert. Alerting is very powerful and can be complex, with multiple trigger conditions, reset
conditions, and actions.
page 60
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
These alerts allow you to configure additional options for actions including sending an email with event
and alert information and resetting manually or automatically according to specific settings. You can also
create copies of preconfigured alerts to customize and add triggers, conditions, actions, and more.
page 61
5. Review the list of preconfigured, enabled alerts.
Action types
You can configure an alert to trigger one or more actions, such as:
l Send an email
l Send a page
l Manage a virtual machine (for example, power on/off)
l Log the alert to send a file
A complete list of alert actions is available on the Add Action dialog box that you see when you configure
an alert.
page 62
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
1. Click Settings > All Settings, and in the Alerts & Reports section, click Configure Default Send Email
Action.
2. In the Default Recipients section, enter recipient email addresses, separated by a semicolon.
3. Under the Default Sender Details heading, provide the default Name of Sender and the default Reply
Address.
4. Under the Default SMTP Server section:
a. Provide the Host name or IP Address of the SMTP Server and the designated SMTP Port
Number.
For example, 192.168.10.124, port 25.
b. If you want to use SSL encryption for your alert emails, select Use SSL.
Selecting SSL automatically changes the SMTP port number to 465.
c. If your SMTP server requires authentication, select This SMTP Server requires Authentication,
page 63
and then provide the credentials.
d. Click Use as Default.
page 64
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
2. To view the details of the network object that triggered the alert, click an object.
page 65
3. To acknowledge an alert:
a. Click Acknowledge.
1. In the Orion Web Console, click Settings > All Settings > Manage Alerts.
2. Select an alert, and click Duplicate & Edit.
page 66
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
3. On the Properties panel, enter a name and any other properties, and click Next.
In this example, a group of IIS administrators is identified as the responsible team.
4. On the Trigger Conditions panel, select an object to alert on, and then complete the trigger condition
fields.
In this example, the first trigger condition tests for node status (Down), the second and third
conditions test for application thresholds, and the fourth condition specifies the applications to alert
on (indicated by 5 Objects).
page 67
6. Select send an Email/Page, and click Configure Action.
This is an example of creating a custom alert, as opposed to using a predefined default alert
that comes with SolarWinds SAM. You can define additional alerts that can be customized to
email specific users or email groups.
page 68
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
8. You can optionally add and configure an action to log the event to the NetPerfMon event log.
9. Enter the required information for each action, click Next, then continue through the wizard.
10. Edit the Reset Actions to send an email to the default recipients, then click Next.
11. Continue through the wizard, review the Summary, then click Submit.
The Manage Alerts page indicates the alert was created successfully.
You can run an ad-hoc report, or schedule reports to be sent to you automatically, as a PDF, a web page, or
email. For example, use a schedule when you want to receive the Asset Inventory report every Monday
morning.
SolarWinds recommends that you identify who needs to receive performance or status reports, and
how often they should receive them.
page 69
Reports populate when:
l You Discover your servers and applications and Add discovered servers and applications to
SolarWinds SAM.
l There is enough data to include in the report. Depending on the polling interval and data type, some
reports do not populate immediately. For example, it takes two weeks for baseline reports to
populate.
SolarWinds provides predefined reports for each Orion module. Click Reports > All Reports to see the
available predefined reports.
You can create your own custom reports by either editing an existing report or creating a report from
scratch. Reports can combine any number or type of Orion resources, including charts, tables, and gauges.
You can customize the size of the report, the layout, and add a logo and a footer.
page 70
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
page 71
Generate the report
The following example illustrates how to generate an asset inventory report.
1. In the Orion Web Console, click Reports > All Reports.
2. Locate the report, and click the report title.
Schedule a report
1. On the Web Console, click Reports > All Reports.
2. Click Manage Reports.
page 72
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
3. On the Report Manager tab, select a report, then click Schedule Report > Create New Schedule.
4. Configure the properties, frequency, and actions as needed in the wizard.
5. When completed, review the summary, and click Create Schedule.
You can enter more values to identify other server types. This example uses just the IIS server
type.
page 73
7. For Usage, select everything except Asset Inventory, and click Next.
page 74
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
10. In the list of Selected Nodes, click Select All, then click Select Nodes.
11. Select IIS from the drop down menu, and click Submit.
page 75
2. Select the report, and click Duplicate & Edit.
3. Enter the report name, for example, IIS Application Server Issue Rollup.
4. For the resource in the first default row, click Edit Chart, rename the chart to IIS Servers with Disks
Approaching 100% Capacity, and click Submit.
5. In the From field, select Last 7 Days.
6. Click Edit.
7. Click the plus sign (+), and click Add Simple Condition.
8. Click Select Field, and then locate and select Node > Nodes Custom Properties > Type.
page 76
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
10. Select IIS from the drop-down menu, ensuring the query reads Type is equal to IIS.
11. Add another simple condition, and locate and select Percent Used under Volume Current Statistics.
12. Click Add Column.
page 77
13. Select the is greater than operator and enter 70.
The query should read: Percent used is greater than 70.
14. Click Add to Layout.
page 78
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
15. For the resource in the second default row, in the From field, select Last 7 Days.
20. On the Layout Builder panel, click Edit Resource, and in the Title field, enter IIS Instance with
Problems.
21. Add the following SWQL filter: Application.Name='Microsoft IIS'
22. Click Submit.
23. Click Add Content > Classic Category > Summary Reports > Availability of Each Node.
page 79
24. Click Select and Continue.
25. Click Edit Resource, and in the Select a Time Period field, select Last 7 Days.
26. In the Filter Nodes (SQL) field, enter: type='IIS'.
27. Click Submit.
page 80
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
page 81
Templates
This section guides you in creating and sharing templates:
Creating a template allows you to monitor uncommon components or applications that are not included in
the pre-built application templates provided with SolarWinds SAM.
The following example shows how to create and assign a template that contains the file size component
monitor. You can add as many component monitors to a template as you need.
page 82
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
5. Select the File Size Monitor component, and click Add.
7. Enter warning and critical threshold values, and click Submit.
page 83
3. Click Manage Templates, select the template, and click Assign to Node.
4. Select the node from the left pane, click the green arrow to move it to the right pane, and click Next.
5. Choose the credentials, click Assign Application Monitor, and click Done.
SAM automatically connects with THWACK to list all available templates for import. You need a THWACK
account to download and install templates into SAM.
page 84
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Export a template
Templates can take about 5 minutes to export to THWACK. If exporting multiple templates, allow
time for SAM to complete the export.
1. On the Web Console, click Settings > All Settings > SAM Settings, and click Manage Templates.
2. Browse or select for a template in the list.
3. Click Import Export > Export to THWACK.
A message displays with the template exporting to THWACK. The template packages into an XML file
with an extension .apm-template.
Import a template
1. On the Web Console, click Settings > All Settings > SAM Settings, and click Manage Templates.
2. Click the Shared Templates on THWACK tab.
3. Search or browse the templates. Select a template file and click Import.
To view details about a template, click the link for the content exchange area on THWACK.
page 85
4. Enter your THWACK account credentials when prompted.
If you need an account, click Create Account and follow the steps.
5. The template imports into the Orion Web Console. In the dialog box, click View Imported Templates.
A list displays of all imported templates.
If you import a template with the same name as an existing template, the name of the
imported template is modified by appending n to the name, where n is an integer.
page 86
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Want THWACK points? Uploading a template to THWACK awards 50 points with an additional five
points are awarded every time you download a template.
You need a THWACK account to export and import templates into SAM. To share a template, create a user
account at thwack.com. You may need to check your internal corporate policy on sharing company
information publicly before posting to THWACK.
Export a template
You can export custom templates you create for applications and custom scripts THWACK to help other
customers. Exporting templates creates an XML file with an .apm-template extension and adds the
template to a repository accessed by SAM.
Templates can take about 5 minutes to export to THWACK. If exporting multiple templates, give SAM
time to complete the export.
1. On the Web Console, click Settings > All Settings > SAM Settings, and click Manage Templates.
2. Browse or select for a template in the list.
3. Click Import Export > Export to THWACK.
page 87
A message displays with the template exporting to THWACK. The template packages into an XML file
with an extension .apm-template.
Import a template
SAM automatically connects with THWACK to list all available templates for import. Browse and review the
descriptions of available templates to find exactly the ones you need for your monitored applications.
1. On the Web Console, click Settings > All Settings > SAM Settings, and click Manage Templates.
2. Click the Shared Templates on THWACK tab.
A page opens and populates with available templates from THWACK.
3. Search or browse the templates. Select a template file and click Import.
To view information per template from the authors, click the link for content exchange area on
THWACK.
page 88
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
5. The template imports into the Orion Web Console. In the dialog box, click View Imported Templates.
If you import a template with the same name as an existing template, the name of the
imported template is modified by appending (n) to the name, where n is an integer.
page 89
Thresholds
This section provides guidelines for editing thresholds:
Orion provides two threshold levels: critical and warning. A value that crosses a warning threshold
appears yellow, and a critical threshold appears red.
If you want to change the predefined value for a threshold, you can add a static threshold or let the system
calculate a dynamic baseline threshold.
l Static threshold. a constant value that you set for your threshold. For example, the warning
threshold for response time might be 500 ms, and the critical value might be 1000 ms. You should be
familiar with the performance of that object to know what a reasonable value for a static threshold
is.
l Dynamic baseline threshold. data for a statistic are collected for a week, and then used to
calculate mean and standard deviation. The warning and critical threshold values are defined as 2
and 3 standard deviations above the mean, respectively. For example, if the mean value for packet
loss for a specific node is 0%, the warning threshold for packet loss would be 3% (+2 standard
deviations) and the critical threshold would be 4% (+3 standard deviations). Dynamic baseline
thresholds are the most accurate way to define thresholds for a specific device.
Baselines are calculated once, after data has been collected for a week. You can recalculate baselines on
demand.
The following statistics have built-in global thresholds, which is a threshold that applies to every
monitored node in Orion:
page 90
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
1. In the Orion Web Console, click Settings > All Settings.
2. In the Thresholds & Polling group, click Orion Thresholds.
page 91
Edit a local node threshold
Alerts are triggered when a monitored value exceeds a threshold. Orion comes with predefined static
thresholds for most statistics, but you can you can override global thresholds on a per-node basis. For
example, one node might have a lower response time requirement than another, so you can set the
threshold values accordingly.
The following example shows how to modify the Memory Usage threshold.
1. On the Node Details page, in the Management resource, click Edit Node.
2. In the Alerting Threshold section, click the Override Orion General Thresholds check box.
3. Change the threshold values:
a. If you are entering a static threshold, type the Warning and/or Critical values.
b. If you are using a dynamic threshold, click Use Latest Baseline Thresholds.
page 92
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
You can edit multiple thresholds simultaneously by opening to the Manage Nodes page, multi-selecting
the nodes you want, clicking Edit, and changing the thresholds.
1. Go to the Application Details resource, and click Edit Application Monitor.
2. Expand the component monitor whose threshold you want to change.
3. Click the Override Template button.
4. Change the threshold values:
a. If you are entering a static threshold, enter the Warning and/or Critical values.
b. If you are using a dynamic threshold, click Use Latest Baseline Thresholds.
page 93
c. To understand the baselines calculated, click Latest Baseline Details.
d. Click Apply thresholds.
You can edit multiple thresholds simultaneously by multi-selecting component monitors, clicking Multi
Edit, and changing the thresholds.
1. In the Orion Web Console, click Settings > All Settings.
2. In the Product Specific Settings group, click SAM Settings.
3. In the Application Monitor Templates group, click Manage Templates.
4. Select a template, and click Edit.
page 94
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
b. If you are using a dynamic threshold, click Use thresholds calculated from baseline data.
You can edit multiple thresholds simultaneously by multi-selecting the component monitors, clicking Edit,
and then changing the thresholds.
page 95
Properties and groups
This section contains information for adding custom properties and groups:
Every object you monitor includes a list of default properties used to describe the device, such as IP
address, host name, MAC address, and so on. You can also create custom properties and use them to
create special alerts, reports, views, and groups. Applications can also have custom properties.
Read the Creative ways to use custom properties and the Custom properties and how to use them
THWACK community posts to learn how some of our customers use custom properties.
Want to learn more? Watch the Streamline your monitoring operation with custom properties
training.
Site
While the Location property is available by default and returns the city specified in the device’s
settings, you may need more granular location information.
Use: Create groups of items in the same location, build maps, or route alerting information.
Function or Type
Use: Apply special alerting criteria depending on the type of element. For example, if any Core_
Network element has problems, escalate the case immediately.
Owner
You can use multiple custom properties to specify who is responsible for an element to help route
alerts or create reports.
Examples: A group owner name, such as Networking, SQL_Admins, AD_Admins, or a specific owner.
page 96
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Uses:
l Define a Contact Email and On_Call_Phone for owners. If there is a problem with a node, the
alert can be routed to the correct person.
l Provide a custom view for owners to see their devices and create custom reports, showing only
devices they are responsible for.
Service level
Some monitored elements, such as core routers, switches, and applications, may be important
enough for someone to be notified any time of the day when there is a problem.
Examples:
Customization checklist
Before you customize your environment, answer the following questions:
How would you like to logically organize your devices? For example, Location, Site, Lab, and Rack?
Function?
What data type is each custom property? For example, boolean, integer, drop-down options only,
free-entry text?
What are your owner groups? For example, who is responsible for the Windows servers, Linux
servers, devices, applications, and so on?
What are the sites and locations you want to report and alert on?
Do you need to distinguish between high impact objects that must be addressed first (for
example, production) and low impact objects that are of lesser priority (for example,
development)?
Are there any overrides for specific objects you require for alerting?
Are there any devices, servers, applications, and so on that you want muted (continue to collect
data but not see alerts)? Do you want to stop alerts during different periods of the day or night?
This Cutting Down on Alert Noise post provides information on reducing alert noise.
Do you want to associate any assets with a purchase date, PO number, vendor contact
information, and so on?
Are there any fields you will need to add to allow for integration with other systems? This Orion
SDK post provides more information.
page 97
Tips
l You can use custom properties to define alerts, reports, and web console views. Use multiple
properties together with 'AND' and 'OR' operators for powerful filtering and definition options.
l For each custom property, decide how you are going to use it and how it will work in your
environment. For example, instead of a comment on an interface that reads "WAN Link interface -
critical interface," try two different Yes/No values, such as "Critical Interface" and "WAN link," which
could each apply to multiple interfaces. This approach makes it easier for you to filter reports and
alerts. When used together (Critical = true AND WAN link = True), it still applies to that
interface.
This example shows how to create the Device_Owner custom property and assign it to multiple nodes. You
can use this example to create an application owner, business service owner, or server type owner.
For examples of how other SolarWinds users implement custom properties, see this THWACK post.
1. Click Settings > All Settings, and in the Node & Group Management grouping, click Manage Custom
Properties.
2. Click Add Custom Property.
page 98
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
5. Select Restrict Values, add values for the property, and click Next.
page 99
7. Select the nodes for the custom property, and click Add.
To assign other values for the custom property to nodes, click Add More, and repeat steps 6-9.
You can see all custom properties assigned to a node in the Custom Properties for Nodes resource on the
Node Details view.
You can also apply custom properties by directly editing the node properties.
Create groups
A group is a collection of monitored objects. For example, you can group nodes from the same location,
group all your WAN interfaces, or group all devices owned by a certain department. Or, you can group all
Windows servers, or SQL servers, or web servers. You can then create alerts and reports or restrict access
for the group.
page 100
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The example below shows how to create a NY IT Department group and add five nodes to it.
1. Click Settings > All Settings, and in the Node & Group Management grouping, click Manage Groups.
2. Click Add New Group.
3. Provide the required information, and click Next.
4. Select the monitored objects that fit the group definition, and click Add to Group.
page 101
Click the group to display the Group Details view.
page 102
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Custom views
This section contains information on adding custom views to your dashboard:
For example, the default Summary view displays an overview of all monitored nodes. Clicking on a node in
the Summary view opens the Node Details page for that node, where you can see all of the statistics
monitored for that device.
Customize views
Customizing views can include the following activities:
To customize views and maps, the user must have the following privileges set to Yes:
page 103
Plan what should be on a view before you create it.
OPTION ACTION
Identify objects to see on the view. Select the appropriate object type, such as nodes, interfaces,
groups, applications, and so on.
Optimize the view for large screens or Create a Network Operations Center (NOC) view.
mobile devices.
Access the view from the Menu Bar. Add the view into the menu bar.
This example shows how to create the New York IT Department Summary view and add the following
resources, or widgets:
l Active Alerts
l Hardware Health Overview
l Top 10 Nodes by Current Response Time
l Custom Table
Create a view
Check out this video on creating a new view.
1. Log in to the Orion Web Console, and click Settings > All Settings.
2. Click Add New View in the Views grouping.
page 104
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
You have now created an empty view. The Customize view page opens automatically. Add resources that
contain the information you want to see or immediately add the view to a dashboard.
To open the Customize view page, click Settings > All Settings > Manage Views. Select the view,
and click Edit.
2. Select resources in the middle pane, and click Add Selected Resources.
page 105
You can limit offered resources by criteria in the Group by list, or search for a resource, or
widget, in the Search box.
3. Use the arrow icons next to the columns to move resources between columns.
page 106
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Edit a resource
The Orion Web Console provides different resources that you can add to a view, and each resource has an
Edit button, so you can change things such as the title, and other features. Different types of resources
have different things you can edit.
The example below shows how to sort and filter objects in resources.
To change the number of objects in Top N resources, click Edit, and change the Maximum Number to
Display.
page 107
3. Define how you want to display objects that do not have the selected property.
When completed, nodes in the resource are grouped according to the selected properties.
In this example, the Applications widget is filtered to include only IIS applications.
Click Show Filter Examples to display examples of SWQL queries, and node and interface
properties that can be used in the query.
Edit a view
You can modify views to suit your needs, including adding and changing columns, moving resources, and
creating subviews to help you manage the information that appears on the view.
page 108
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
This example shows how to create an AppStack subview and add an AppStack resource.
(missing or bad snippet)
To drag and drop widgets, click Preview, and then add the widgets.
You can access the subview with the resources from the view menu.
page 109
Add subviews using Enable Navigation
1. On the Customize view, select Enable Left Navigation.
To open the Customize view page, click Settings > All Settings > Manage Views. Select the view,
and click Edit.You can also click Customize Page > Page Settings on the view.
You can access the subview with the resources from the view menu.
page 110
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The example belows shows how to limit a view to display only monitored elements owned by the NY IT
Department.
1. On the Customize view, click Edit in the View Limitation area.
Now you have created the New York IT Department view. To make it accessible for users, you must first
add it to a menu bar, and assign the menu bar to the users. You cannot see the view without making it
accessible first. See Customize menu bars.
1. Locate the blank custom table widget on the New York IT Summary view added in Create a view and
add resources, or widgets.
page 111
2. Click Configure this widget.
4. Select the object you want to report on, for example, Node.
5. Define a condition that specifies the type of nodes to include, for example, all nodes owned by the
New York IT Department.
6. Click Add column, select properties, and click Add Column. This example includes the Device_Owner
and Email_Address custom properties.
page 112
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The custom table resource populates with the node status, the owner, and a contact email address.
page 113
Click My Dashboards to show the default menus.
You can customize views and labels offered in default menus for individual users.
If you do not need to see all items in menu bars, and prefer navigating to display items in a menu
bar, click My Dashboards > Collapse.
When you have a list of items you want users to access from My Dashboards, create a menu bar.
page 114
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
4. Drag views from the Available items column into Selected items.
The new menu bar is created. You can now assign it to users who will see the items in My Dashboards.
The items users see in My Dashboards and in Alerts & Activity are specified in their user accounts.
Improve performance by setting the Home Page View to a view with a limited number of resources
on it.
page 115
5. Select Yes for the items the user will see in the Alerts & Activity menu bar.
6. Select an item and use the arrows to change the order of menu bars. Select an item from the list to
specify the default Home page view.
The user can now use the specified links in My Dashboards and Alerts & Activity menu bars.
The recommended logo size is 250 x 50 pixels. The maximum allowed size is 900 x 500 pixels.
page 116
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
5. Ensure the Site Logo box is selected, and click Browse to navigate to your logo.
page 117
Reduce alerting noise
This section includes techniques for reducing alert noise:
Complex conditions are generally enabled by users who are comfortable with building normal trigger
conditions, or who have trialed alerts using the normal trigger conditions and require more control over
the trigger conditions to better refine the environmental conditions that trigger an alert.
Do not use complex conditions until you have tested the trigger conditions individually. Creating an
alert with complex conditions without testing it may prevent you from receiving important alerts.
page 118
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
A condition block can be evaluated at a different time than other condition blocks. For example, if you want
to be alerted if the backup system is active for more than an hour, you can choose to wait an hour after the
primary condition block, where the application going down is the trigger condition, before evaluating
whether the backup system is still active.
Aggregate alerts
With complex conditions enabled, you can choose to trigger alerts only when multiple objects meet the
trigger condition.
After you have enabled complex conditions, the following option is available in your trigger condition:
This setting then combines all alerts that would be sent for each object into a single alert.
Do not use this setting until you are confident that the trigger condition is correct. This setting can
prevent important alerts from triggering.
Complex conditions should be used with caution. SolarWinds recommends testing each trigger
condition individually before combining them.
On the Trigger Conditions panel, expand Advanced options, and select Enable complex conditions.
With a standard alert, you can create an alert for each of the two applications. With a complex condition,
you can create a single alert where the application would have to fail on both Server A and Server B to
generate an alert.
page 119
In this example, the primary trigger condition is written for Server A.
In this example, both conditions must resolve to TRUE in order for the alert to fire, but do not have to relate
to each. The condition blocks are evaluated at the same time. If they are all TRUE based on the conditions,
the alert triggers. You can add additional conditions to configure granular and complex alerts.
Using condition blocks is a great way to reduce alerts. Instead of receiving an alert for each element, you
can receive a single alert.
page 120
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
For example, your Exchange service usually runs at 80% RAM and 75% CPU. Occasionally, the RAM and CPU
utilization spikes to over 90%, and after 5 minutes, returns to a normal level. In this scenario you want to
be notified of prolonged spikes, so you configure an alert to trigger when CPU and RAM utilization is
greater than 90% for more than 15 minutes. This setting ensures that you are notified when the service
requires attention, and allows enough time for a technician to intervene before the service goes down.
page 121
The following example illustrates an alert that includes duration. Ensure that you select the Condition
must exist check box and enter a duration.
page 122
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
9. For devices for which you do not want to receive an alert, set the custom property to False.
page 123
10. Define the alert to trigger when the AlertOnThis custom property is equal to Yes and the Node
Status is equal to Down.
If you use the AlertOnThis custom property, every alert must include the AlertOnThis check.
Otherwise, all nodes will trigger alerts regardless of how this custom property is set.
The To: field does not have an Insert Variable button, so if you have labeled your custom
property something other than ContactEmail, open the Message section, click Insert
Variable to find the custom property, and cut and paste the variable into the To field.
page 124
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
1. Begin by creating the actual trigger condition with a double value comparison.
a. Click the plus sign.
b. Select Add Double Value Comparison.
The trigger condition fields expand, and you can enter a double value comparison trigger.
page 125
With a multiple devices go down alert, the devices reported as down are actually down. For example, you
have an application monitor for your Custom Corporate System that monitors 15 services. Each service may
go down briefly for various valid reasons. However, when more than 10 services are down, you know
something is wrong and you need to take action. The following alert checks the up and down status of all
components, but only alerts when 10 or more components are down at the same time.
Use groups
You can also use groups to alert you when multiple devices go down. In this approach, create a group and
assign related devices to it. In this scenario, an alert is only triggered when all devices in the group are
down, and not just a subset of devices. Using groups saves you time when configuring alerts, and is also
useful when you have load balanced devices and you only care when all the devices are down, not just
when some are down.
However, if you define those nodes as being dependent on the edge router, you will not get false alerts
about the status of dependent nodes when the parent object has issues.
Another example is when several IIS servers rely on the same SQL server for their database backends. If
you define those nodes as being dependent on the edge router, or the IIS servers as being dependent on
the SQL server, you will not get false alerts about the status of dependent nodes when the parent object
has issues.
page 126
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
l Dependencies themselves do not prevent alerts from being triggered. Instead, dependencies
prevent the child objects from going down, and as a result, down node alerts are not triggered. By
using dependencies, status alerts are prevented from triggering, but all other alerts are triggered.
l A child object can have several parents, and the child's status only turns to Unreachable if all
parents in all defined dependencies go down.
In this example, you will create a dependency between an IIS server and its SQL database backend.
Creating this dependency means that if the SQL database goes down, any IIS server alerts will be
suppressed, although the IIS application will continue to be monitored.
page 127
5. Type a Dependency Name, select the child entities, and click Next.
6. Review the settings for the dependency. If there are active alerts on child objects, they are listed on
this view.
7. Click Submit.
You can also display the dependency on custom views in the Orion Web Console.
Make sure to select a And then after value, which is located between the alert sections.
page 128
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
Then, in the secondary section, configure the actual trigger condition so that Node Name is equal to Node
B and Node Status is equal to Down.
page 129
Agents
This section includes information on deploying agents:
After deployment, all communication between the Orion server and the agent occur over a fixed port,
using 2048-bit TLS encryption. The agent protocol supports NAT traversal and passing through proxy
servers that require authentication.
If an agent is used, all SAM application data is collected by the agent. You can override this behavior at
both the application and template level to use another polling method. For example, if you assign an
application template that uses a User Experience Monitor and you do not want to measure response time
locally from the server where the application is installed, you can switch the application to poll without
using an agent.
Agent Communication can be deployed as either Agent Initiated or Orion Server initiated:
l Agent initiated communication: The agent initiates communication with the server on the default
port of 17778. This port must be opened on the server firewall so the agent can connect. No change
page 130
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
The following reports are configure for use with Orion agents:
l Agent Inventory
l Agent Plugin Version
Tip: Use Orion Server-initiated communication in DMZ environments or cloud scenarios such as
Azure. Use agent-initiated communication with a proxy to poll multiple computers within a single
Azure cloud service.
Server-initiated communication
This communication method is also known as a passive agent.
Any communication between your Orion server or additional polling engines and the agent is initiated by
the Orion server itself. To allow communication from the Orion server, the firewall service running on the
monitored device or the network firewall must allow incoming connections through port 17790. If the agent
is configured to use another port, update the firewall rules to allow incoming connections from the other
port.
page 131
Agent-initiated communication
This communication method is also known as an active agent. In active mode, there are no listening ports
on the agent.
Any communication between your Orion server or additional polling engines and the agent service is
initiated by the agent service itself. Update your firewall rules to allow outgoing connections through port
17778 to enable communication between the agent and the Orion server. Open port 17791 if the agent is
on Windows 2008 R2.
You cannot use agent-initiated communication through a proxy using NTLM authentication if the
agent is running on a Linux/Unix-based device.
This communication method is most useful when the agent is installed on a network separated from your
Orion server by one or more NAT devices, and you have no easy way to connect the two.
The Orion server must be able to communicate with the remote node. To monitor Linux-based
devices, TCP port 22 (outbound) must be open on the Orion server or additional polling engine and
open (inbound) on the deviceyou want to monitor.
page 132
GETTING STARTED GUIDE: SERVER & APPLICATION MONITOR
4. In the Polling hostname or IP address field, enter the IP address or fully qualified domain name
(FQDN) of the device you want to manage.
5. Select Windows & Linux Servers: Agent as the Polling Method.
6. Select the operating system type of the remote computer.
7. Choose a credential from the list, or enter new credentials, and then click Next.
l These credentials are only used to connect to the remote computer and install the agent
software. After the agent is deployed, the credentials may change with no impact to the
deployed agent.
l The credentials must have administrator or root-level privileges. On Linux-based
devices you can connect with one credential set and then use another credential to use
su or sudo for package installation. Most Linux distributions require the user's
password when using sudo. Other distributions, such as SUSE, may require the root
password. Depending on your Linux distribution, enter the required credential for the
Include Credentials with Elevated Privileges to install the package.
l For Linux-based nodes, you can choose to add SNMP credentials to collect SNMP data
for Asset Inventory and Hardware Health from the remote node.
When installation is successful and communication between the agent and the Orion server is successful,
the agent is listed on the Manage Agents page.
A single polling engine can support up to 1,000 agents. The following table details agent resource
consumption.
page 133
Bandwidth The agent consumes roughly 20% (on average)
of the bandwidth consumed by the WMI
protocol for transmission of the same
information
Storage 100 MB
Agent settings
The Agent Settings page provides access to all of the settings and tools needed to install and manage
agents. Additional agent settings can be found in the Control Panel.
On the Web Console, click Settings > All Settings > Agent Settings.
l Manage Agents: Opens the Manage Agents page so you can add a new agent, edit, update, or
reboot an existing agent.
l Download Agent Software: Opens the Agent Downloads page so you can mass deploy or manually
install an agent.
l Define Global Agent Settings: Opens the Global Agent Settings page so you can allow automatic
agent registration or allow automatic agent updates.
page 134