Using the Health and Value dashboards


This topic explains how to access the Health and Value dashboards, and it provides some simple user instructions. This topic contains the following sections:

What are the Health and Value dashboards?

Through the TrueSight Server Automation console or through a web browser, you can access the following two dashboards: 

  • The Health Dashboard provides a single interface that gathers information about TrueSight Server Automation system components and assesses how well they are functioning. 
  • The Value Dashboard provides metrics on the potential value that can be realized by your organization by using TrueSight Server Automation.

Health Dashboard

health_dashboard.png 

Accessing the dashboards

The Health and Value Dashboards can be accessed from:

  • The Quick Start page
  • The Configuration menu
  • A browser, by entering a URL

Before you begin

To view the dashboards, some prerequisites must be satisfied:

  • To access the dashboards through the TrueSight Server Automation console, you must be logged in as the BLAdmins role.
  • Currently, the following browsers are supported:
    • Google Chrome 90.0
    • Mozilla Firefox 88.0.1
  • To launch the Health dashboard, ensure that your default Internet browser has the relevant SSL or TLS options enabled.
  • To launch the Value Dashboard, you must first define a connection to a TrueSight Smart Reporting for Server Automation server. Use the following blasadmin command to provide a URL and a port:
    blasadmin set AppServer TSSADWServerURL protocol://tssadw_server:port
    The default port is 9443.
  • (Required for both Health and Value Dashboards) If the database server is running on SQL Server, the bladelogic database schema owner used by TrueSight Server Automation must be granted the following permission for obtaining data (such as database sizing data) to populate the dashboards:
    GRANT VIEW SERVER STATE TO <BLADELOGIC_DB_SCHEMA_OWNER>

To access dashboards from the Quick Start page

  1. Display the  Quick Start page for TrueSight Server Automation. 
    The Quick Start page displays when you first open the console. You can also select Configuration > Quick Start to launch the Quick Start page.
  2. Click one of the tabs at top to open a dashboard:
    • Health Dashboard
    • Value Dashboard

To access dashboards from a menu

Select one of the following:

  • Configuration > Health Dashboard
  • Configuration > Value Dashboard

To access dashboards from a web browser

  1. Use a web browser to access the following URL:
    https://<Application_Server>:<port>/dashboard

    <Application_Server>  is the fully qualified name or IP address of the primary Application Server that supports the dashboards, and on which the Tomcat service has been enabled (as described in Enabling-web-services ).
    <port>  is the port on the Application Server on which the Tomcat service is running. The default port is 9843.

    For example, https://aus-bsa-004:9843/dashboard 
    A login page opens.
    DashboardLogin.png
  2. Enter a login ID, password, and authentication method.
    When accessing the dashboards from a web browser, all authentication methods are supported except for PKI and AD/Kerberos.

To refresh information on the Health Dashboard

To populate or refresh the dashboard, do one of the following:

  • Run the Dashboard Update Job from the console (Jobs > BMC Maintenance > Dashboard >  Dashboard Update Job).
    dashboard_report_job.gif
  • Execute the following BLCLI command:
    blcli -v <profile name> -r BLAdmins Utility generateDashboardReport

Each time you run the job or execute the command, the dashboard, it obtains and displays fresh information.

Viewing detailed information in the Health Dashboard

Buttons on the left of the Health Dashboard provide detailed information about each category of information the dashboard offers:

Category

Description

Application Servers

Identifies all Application Servers associated with this installation of TrueSight Server Automation and provides the status of each.

Database Server

Provides statistics about the database server and information you can use for troubleshooting problems.

Important:

  • If the value of the Run DBM Offline option is Yes and you run the offline database cleanup utility, run the online database cleanup utility after that to gather the health statistics related to the cleanup.
  • Starting from version 21.02.01, the Table With Max Rows parameter in this category is deprecated. Instead, to view information about the table growth or cleanup performance, use the Database section in the Operations-dashboard.

Agents

Provides summary information about the health of all RSCD agents.

Jobs

Provides summary information about jobs that are failing or running slowly.

Repositories

Provides information about the file server.

Ping Test

Lists ping statistics for servers that are components of the TrueSight Server Automation system.

Product Usage Trends



Enables you to view the TrueSight Server Automation license usage against the various licensing that you have purchased. There are two sections to the report:

  • License Usage Trends–This graph provides information about the number of TrueSight Server Automation licenses purchased against the number of licenses actually being used.
  • Agent Deployment Trends –This graph provides information about the number of TrueSight Server Automation agents that have been added against the number of agents that have been decommissioned over a period of time.

For more information, see Evaluating-license-and-product-usage-trends.

TSSA-DW

Accesses TrueSight Server Automation - Data Warehouse. The first time you access TrueSight Server Automation - Data Warehouse, you are prompted for credentials.

Note: To enable this option, you must define a connection to a TrueSight Smart Reporting for Server Automation server.

Advanced Options

Provides information that can be used for diagnosing the health of a TrueSight Server Automation system, such as details about database cleanup and patching.

Defining thresholds for the Health Dashboard

You can define specific thresholds for different properties in the recommendedValues.properties file. The file is located at the following location:

Microsoft Windows

<InstallDirectory>\NSH\br\

Linux

<InstallDirectory>/NSH/br/

The recommendedValues.properties file contains the following settings that you can modify to set specific thresholds:

Name  

Description

Affects which part of the dashboard 

Recommended values

AGENTS.AGENT_ALIVE

Percentage of live agents out of total servers enrolled

Home tab, Agents tab

>95 %of total

AGENTS.AGENTS_TOUCHED_IN_LAST_30_DAYS

Count of agents that are used in last 30 days out of total servers enrolled

Home tab, Agents tab

>80 %of total

AGENTS.LATEST_AGENT_VERSION_COUNT

Count of agents with the latest version out of total servers enrolled

Home tab, Agents tab

>80 %of total

APPSERVER.FREE_JVM_MEMORY

Available or free JVM memory in the system

Application Servers details tab

>= 1 GB

APPSERVER.JOBEXECUTION_CONNECTION

Count of Job execution connections in the system

Application Servers details tab

>= 200.0

APPSERVER.KEYSTORE_FILES

Count of keystore files (configured) in the system

Application Servers details tab

The value should match across all servers.

APPSERVER.MAX_CONCURRENT_JOBS

Maximum count of concurrent jobs configured in the system

Application Servers details tab

<= 50

APPSERVER.MAX_FILE_DESC

Maximum count of file descriptors configured in the system

Application Servers details tab

 - 

APPSERVER.MAX_JVM_MEMORY

Maximum JVM memory configured in the system

Application Servers details tab

>= 3.5 GB

APPSERVER.NO_OF_WORKITEM_THREADS

Count of work item threads configured in the system

Application Servers details tab

<=100

TSSADW.APACHE_STATUS

Running status of Apache web server

TSSA-DW tab

Up and Running

TSSADW.AUTH_STATUS

Running status of the authentication server

TSSA-DW tab

Up and Running

TSSADW.ETL_TIME

Last run details for ETL script

TSSA-DW tab

 - 

TSSADW.FREE_DB_SIZE

Available or free DB space

TSSA-DW tab

>= 30 %

DATABASE.DB_ACTIVE_RESOURCE_PLAN

Displays the Database Edition that is used. For example, Enterprise, Desktop, Standard and so on.

Database Server tab

 - 

DATABASE.DB_CHECKLIST

Checklist of database related task or metric with values

Database Server tab

Manual checklist available for download.

DATABASE.DB_FRAGMENTATION

Details of tables with high fragmentation

Database Server tab

<=30 %

DATABASE.DB_SIZE

Total size of TrueSight Server Automation database

Database Server tab

< 500 GB

DATABASE.DB_TABLE_MAX_ROWS

Table with the maximum number of rows 

Database Server tab

<=40 Million

DATABASE.FREE_DB_SIZE

Available or free DB space

Database Server tab

>= 30 %

DATABASE.SHOULD_RUN_DBMOFFLINE

DBM offline is a utility to clean up the database while the Application Server is down. This is used in case of cleanup of databases.

Database Server tab

 -

DATABASE.WITHOUT_DATABASE_CLEANUP

Database cleanup run routine

Database Server tab

<=8 days

DATABASE.WITHOUT_HARD_DELETED_SHARED_CLEANUP

Routine hard delete of shared objects

Database Server tab

<=8 days

DATABASE.WITHOUT_HISTORICAL_CLEANUP

Historical cleanup run routine

Database Server tab

<=3 days

JOBS.COUNT_10_PERCENT_FAILED_TARGET

Count of jobs with more than 10% failed targets for any particular job

Jobs tab

0

JOBS.COUNT_LONGEST_RUNNING_JOBS

Count of the longest running job > 8 hrs

Jobs tab

0

JOBS.COUNT_SERVERS_FAILED_ACROSS_JOBS

Count of servers that have failed across multiple jobs

Jobs tab

0

JOBS.HIGH_VERBOSITY_JOBS

Count of high verbosity jobs.

Jobs with a high number of logs can cause Job_Run_Event table to grow significantly resulting in poor performance for DB operations.

Jobs tab

0

JOBS.NO_TIMEOUT_JOBS

Count of jobs with no time-out. This property ensures that resources should be utilized effectively

Jobs tab

0

REPOSITORIES.FILE_SERVER_FREE_DISK_SPACE

Free disk space on the file server

Repositories tab

> 25 %

Exporting tabular information from the Health Dashboard

The Health Dashboard presents some types of information in a tabular form. For example, Advanced Options such as Patch Job run counts appear in tabular format.

You can export any information in tabular format to a comma-separated value (CSV) format. After exporting to CSV, you can easily import that information into a spreadsheet.


To export tabular information

  1. Display a report in tabular format
  2. Click Export as CSV, at top right.
    The report is displayed in a comma-separated format.
  3. Using your browser, save the report locally as a file.

Exporting the entire Health Dashboard

You can export the entire Health Dashboard in a zip format. When you extract the zip file, the extracted folder appears which contains HTML and CSV files. Before you export the dashboard, access it at least once by using the methods mentioned in Accessing the dashboards section.

To export Health Dashboard

  1. In the TrueSight Server Automation console, select Configuration > Generate Support Data.
  2. Select Dashboard Export.
  3. Click Generate Data.
  4. Specify the location where you want to store the zip file.
  5. In the Object Name field, enter a name for the zip file.
  6. Click Save.

TrueSight Server Automation generates data and creates a zip file. Unzip the file. This file unzips to create a Dashboard\<timestampsubdirectory. Browse to the Dashboard\<timestampdirectory and open Home.html in any web browser.

The version of the Health Dashboard that is, exported in a HTML format, depends on the dashboard schedule.

Sending the Health Dashboard Violation Report

You can send the Health Dashboard Violation report to different users through a system-generated email. To send the report, run the following command in the blasadmin console and restart the Application Server:

set Dashboard RecommendationEmailAddress <valid email address>

where <valid email address> is the address to which the mail should be sent.

If you do not set the value of this attribute, the report is sent to the email address set in the following attribute:

set emailconfig fromaddress <valid email address>

Ops dashboard

NEW IN 20.02.01 On the Health Dashboard, click the Ops Dashboard link to navigate to the Ops dashboard that displays the consolidated status of jobs in your environment. For details, see Operations-dashboard.

Troubleshooting the Health Dashboard

For tips on solving problems with the Health Dashboard, see Troubleshooting-the-Health-Dashboard-and-Value-Dashboard.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*