Video Tutorial

Note:  The cloud account setup referenced in the video is no longer available. See the on-premises SentryOne Portal Configuration article for more information about browser-based access to your SentryOne environment.

Launching the SentryOne Client

When you launch the SentryOne client for the first time, you interact with the Onboarding wizard. The Onboarding wizard helps you understand and configure features in SentryOne. Once the onboarding process is complete, add your first monitored target, and jump right in to tuning your environment! During onboarding, you're introduced to:

  • Applying your license 
  • Setting up a user for alerting purposes
  • Enabling your email server
  • Configuring email notifications for Advisory Conditions

Note:  During the onboarding process you can skip steps that may not be applicable to you, and you can always change any options at a later time with the SentryOne client.

Onboarding Wizard:  License Configuration

Launch the SentryOne client. Select Continue, then select Paste license to paste your key in the client from the SentryOne portal.

SentryOne License Configuration Paste License

Select Save to save your license information.

SentryOne License Configuration Save License

Next you're prompted to enter your user information. Enter your email, first name, and last name into their respective fields. Select Save to save your information.

SentryOne Tell Us More About Yourself

Onboarding Wizard:  Enabling Email Alerts

During the onboarding process, you have the ability to enable email alerts. Enter the domain name or IP address of the SMTP server that you want to be used for routing SentryOne email notifications in the SMTP Server address field.  If using localhost, keep in mind this will be the local SMTP server on the machine where the SentryOne monitoring service is installed, since it's responsible for sending all notifications. The SentryOne Client doesn't send any notifications.

SentryOne On-boarding Enable Email Alerts

The Email From Address is the address that appears on the from line of all email notifications sent by SentryOne. You can also specify a user name and password if authentication is required by your SMTP server. This isn't usually required in most environments. Select Test to generate a test email for a specific address. Select Save to save your information.

Note:  You may need to contact your network administrator first to ensure that the IP address of the monitoring service computer has been granted both connect and relay permissions for the specified SMTP server.

Important:  For the most accurate SMTP test, use the client installed on the SentryOne monitoring service computer to send the test message. If you use a client on a different computer, such as your local workstation, the results may be different. For example, your SMTP server may allow relay from your workstation but not from the SentryOne monitoring service computer, in which case the test from your workstation would succeed, but the SentryOne monitoring service would be unable to deliver notifications.

Onboarding Wizard:  Advisory Conditions

 You will be prompted to set the default advisory conditions for which you receive email alerts. Choose the appropriate conditions by selecting their corresponding box. Select Save to save your settings.

SentryOne On-boarding Advisory Conditions

Onboarding Wizard:  Finalization

Select Let's Go! to launch the client.

SentryOne Welcome Screen

Success: You've configured SentryOne for your environment! Once the onboarding process is complete, you'll want to add your first monitored target as described below.

Adding Targets and Instances to Watch

On the Add Target screen, select the type of target from the target type drop-down box. Enter the name of the target you'd like to monitor in the box below.

SentryOne On-boarding Add Target

Important:  For Azure SQL Database and Azure SQL Data Warehouse, provide the database or data warehouse name in addition to the Target name (which is the full URL to the endpoint). Both Azure features require credentials to be provided. These credentials are the SQL logins defined for the database server or data warehouse; they are not Azure account credentials. In addition, the firewall rules must allow access to the monitoring service, either directly over the internet; or through a configured VNet. Azure SQL Database and Azure SQL Data Warehouse only support access through port 1433.

 Select Connect to test the target for feature availability. If the connection is successful, the categories listed show green lights next to them.

SentryOne On-boarding Target Added

 Otherwise, if there's limited access, you may be unable to collect data for some or all of the given categories:

  • Disk Activity
  • Disk Space
  • Performance Counters
  • Windows Dashboard
  • Windows Processes

It's recommended that you try to fix these limited access issues, though in some cases limited access is your only option (such as using a cloud-hosted SQL Server instance). Because you won't have access to the operating system, this would fall under Limited Access. After reviewing the feature availability chart, run this check again with Retry, or select Next to continue. Once the initialization process has completed, select Open to monitor the target.

SentryOne Watch Status Window

Note:  If errors occur while adding targets or instances, it may be due to problems with security, network connectivity, and/or name resolution. For more information, see the Security and the SentryOne Server topic.

For more information about configuration options, see the Getting Started Cheat Sheet.

Success: Congratulations, you have successfully installed SentryOne, configured global notification settings, and you are now ready to start using the SentryOne client for managing events across your enterprise. Use the different options on the Get Started screen to start exploring the features in SentryOne.


Just as with any other SQL Server database, it is important that regular maintenance activities be performed on the SentryOne database to ensure optimal performance. For more information, see the SentryOne Database Maintenance topic.

Important:  The SentryOne client allows you to reconfigure your settings at any time by re-running the Onboarding wizard. To run the Onboarding wizard, select Tools > Run On-boarding Wizard (requires client restart), and then select Yes from the On-boarding Wizard dialog box.

SentryOne Run On-boarding Wizard