Appliance Health in the U-Series Appliance

On the Diagnostics pages, you can keep track of U-Series Appliance services, hardware faults, and performance metrics.

Monitor the Health Dashboard

View dynamic, real-time U-Series Appliance metrics, including:

  • Used disk space on the C: drive
  • CPU usage
  • SQL Server memory usage
  • RAM usage
  • SQL Server CPU usage
  • Services running and stopped
  • Analyzer reporting

Image of Diagnostics Dashboard Home

View health metrics on BeyondTrust components and services running in your environment.

If you use your own SQL Server deployment rather than the SQL Server version that ships with the U-Series Appliance, then the SQL Server metrics are not displayed on the health dashboard.

Monitor Services and Hardware

The U-Series Appliance periodically checks the running state of the services to make sure that they are in the expected state, considering the current roles that are set. Additionally, alerts can be triggered when the service control manager raises errors, such as when a service fails to start or terminates unexpectedly.

The U-Series Appliance also monitors the hardware. Alerts can be triggered when an error is raised by Dell OpenManage monitoring software.

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Appliance Health.
  3. Turn on the alerts, then click Apply Updated Settings.

Check Services

BeyondTrust U-Series Appliance Diagnostics Health page

You can manage U-Series Appliance services.

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Appliance Health.
Refresh service icon Restart the service.
Start service icon Start the service.
Stop service icon Stop the service.

Configure Counters for Performance Metrics

You can configure the threshold values for performance metrics. When the threshold is exceeded, email alerts can be sent to the email account configured on the notifications page.

For example, you might not want CPU usage over 50% for too long. In this case, you might set the thresholds to:

  • Low: 50
  • Medium: 65
  • High: 70
  • Threshold Duration: 10 minutes

If the running average reads at 52%, then a low level alert is sent.

After a counter alerts at a certain level, it does not generate further alerts for that level (or below) until it is reset. An alert is considered in a reset state when the average is below the reset threshold for the specified time span.

If a metric in an alerted state goes below the configured reset threshold for the specified time, the alert is cleared, and a reset alert is generated. At this point, the performance counter receives alerts if it exceeds the threshold again.

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Performance Counters.
  3. Select notification settings:
    • Generate Alerts for Monitored Performance Data: Turns on email notification for alerts.
    • Generate Daily Summaries of Performance Data: Collects performance metrics every two hours and emails them on a daily basis.
  4. By default, four base counters are listed: SQL Server Memory Percentage, CPU Overall Usage, SQL Server CPU Usage, and Disk Usage. You may select additional counters from the list, and then click Add to List.
  5. Adjust the performance and reset thresholds.
  6. Click Apply Updated Settings.

Configure Notifications

You can set notifications for the following types of events:

  • Health monitoring: includes performance thresholds, service alerts, hardware alerts, and daily performance summaries.
  • High availability monitoring: includes failover alerts, connection alerts, no partner alerts, and off state alerts.
  • High availability mirror change: includes suspend and resume activities on SQL mirroring.
  • Backup monitoring: includes backup success and failure alerts and restore success alerts.

To configure email notifications:

Diagnostics: Configure icon

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. At the top right, click the Notifications icon, and then click the Configure Appliance Notifications icon.

 

Configure email notifications

  1. Under Email Notification Settings, for each event type, click Email These Users, and select the users who you want to receive notifications.
  2. Click Apply Updated Settings.

 

Set Up Health Event Forwarding

BeyondInsight 6.0 or higher is required to use this feature.

Health Event Forwarding settings page

You can send alerts from the U-Series Appliance to your BeyondInsight management console for further analysis.

Health events are about the hardware or software services that are generated by your appliance. If you require these events to be integrated with third-party monitoring products, you can forward these events to BeyondInsight.

BeyondInsight has a wide variety of third-party connectors that allow you to integrate your monitoring needs (for example, SNMP, SIEM tools, Microsoft Operations Manager, etc.).

In addition to choosing an option on this page, there must be a Syslog Event Forwarder connector from the BeyondInsight Management Console so that BeyondInsight can import health events.

To set up health event forwarding:

  1. From the sidebar menu, click Integrations, and then select Health Event Forwarding.
  2. Select an option:
    • None: No events are forwarded.
    • Local: Forward events to the local BeyondInsight installation.
    • Remote: Forward events to a remote BeyondInsight server, specified by IP Address or DNS Name.
  3. If using the Remote option, two additional fields appear. You must export a certificate from the remote server and import the certificate to the local U-Series Appliance.
  4. If the remote server is another U-Series Appliance, log in to that U-Series Appliance's website.

    • On the sidebar menu, click LA (if you are in the new environment only).
    • Export Client Certificate dialog

    • Under Export Client Certificate, enter a password and click Export and Download Certificate.
    • Import the certificate on the local U-Series Appliance.
    • Return to the Health Event Forwarding page, under the Remote option, enter a Server Address, and select a Certificate from the list.
  5. If the remote server is a software install of BeyondInsight, use the BeyondInsight Configuration Tool to create and export the certificate.
  6. Click Save Health Event Forwarding Settings.

You must also create a connector from the BeyondInsight management console.

Choose Events to Forward dialog

  1. Log in to BeyondInsight.
  2. Select Configuration from the menu, and then select Connectors.
  3. Click + and select Syslog Event Forwarding.
  4. Enter the details for the U-Series Appliance, including IP address, protocol, and facility.
  5. Check the Appliance Health box.
  6. By default, all severity levels are included. You may select an alternate level if needed.

For more information on importing a certificate to the U-Series Appliance, please see Upload SSL Certificate.

View Notifications

Notifications icon

To view notifications,click the icon at the top right of the Legacy App environment.

 

Notification icon shows the number of notifications received

After notifications are received, a green number indicates the number of notifications. Click the icon to view more information about the notifications.

The bar next to the notification indicates severity.

Color Legend

Notifications. Blue info color Info
Notifications. Yellow low color Low
Notifications. Orange medium color Medium
Notifications. Red high color High

Diagnose Network Connectivity Issues

You can view network configuration information and use ping to assist with diagnosing network connectivity issues.

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Tools.
  3. Under Network Configuration, click Refresh to view the results from IPConfig /all.
  4. To ping a server, enter the fully qualified domain name, hostname, or IP address in the Ping section, and then press Enter.

Download Log Files

Downloading log files is typically done when troubleshooting a recent issue.

Download Individual Log Files

To download individual log files:

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Appliance Logs.
  3. At the right of a log entry, click the Download button.

Download All Log Files

The "download all" process includes the last three months of logs.

To download all log files:

  1. On the sidebar menu, click LA (if you are in the new environment only).
  2. From the Diagnostics menu, select Appliance Logs.
  3. At the bottom right of the log entries list, click Download All.

Export Log Files

Log File Export page

Log file exporting facilitates making appliance log files available to third-party tools for analysis. The U-Series Appliance can be configured to generate a set of log files and save them to an external location, on a specified schedule.

By default, the Export Log File to Remote Location option is on. When it is turned off, none of the setup options are visible.

The file cannot be saved on the U-Series Appliance.

To set up log file export and authentication:

  1. On the sidebar menu, click Integrations, and then select Log File Export.
  2. Enter a Log File Export Location.
  3. If the log file export location requires authentication, check the box.
    • Enter the Log File Export Location Username.
    • (Optional). Enter a Log File Export Location Password.
    • (Optional). Enter the Domain.
    • To verify the authentication, click Test Credentials.
  4. Select a Log File Schedule option. The default is Set Interval.
    • If using the default Set Interval option, enter the number of Minutes, as per the instructions onscreen. The interval should not be set to less than the number of minutes it takes to export all of your files.
    • Click Save Log File Export Settings.
  5. Log File Export Once a day options

  6. If using the Once a Day option, the day and time options appear.
    • Select a day option, and then enter the Export Hour.
    • Click Save Log File Export Settings.

At any time after the settings are initially configured, you can click Export Log Files Now to save the log file to the share.