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?
- Accessing the dashboards
- Viewing detailed information in the Health Dashboard
- Defining thresholds for the Health Dashboard
- Exporting tabular information from the Health Dashboard
- Exporting the entire Health Dashboard
- Sending the Health Dashboard Violation Report
- Ops dashboard
- Troubleshooting the Health Dashboard
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
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
- 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. - 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
- 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. - 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).
- 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:
|
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:
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
- Display a report in tabular format
- Click Export as CSV, at top right.
The report is displayed in a comma-separated format. - 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
- In the TrueSight Server Automation console, select Configuration > Generate Support Data.
- Select Dashboard Export.
- Click Generate Data.
- Specify the location where you want to store the zip file.
- In the Object Name field, enter a name for the zip file.
- Click Save.
TrueSight Server Automation generates data and creates a zip file. Unzip the file. This file unzips to create a Dashboard\<timestamp> subdirectory. Browse to the Dashboard\<timestamp> directory 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.