Important

   

This space contains documentation for TrueSight Server Automation 8.9.03 and the later service packs for 8.9. For earlier releases, see BMC Server Automation 8.9.

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

 

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 48 or later
    • Mozilla Firefox 44 or later
  • 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.
  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).
  • 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:

CategoryDescription
Application Servers

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

Database ServerProvides statistics about the database server and information you can use for troubleshooting problems.
AgentsProvides summary information about the health of all RSCD agents.
JobsProvides summary information about jobs that are failing or running slowly.
RepositoriesProvides 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 Smart Reporting for Server Automation. The first time you access TrueSight Smart Reporting for Server Automation, 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  DescriptionAffects which part of the dashboard Recommended values
AGENTS.AGENT_ALIVEPercentage of live agents out of total servers enrolledHome tab, Agents tab>95 %of total
AGENTS.AGENTS_TOUCHED_IN_LAST_30_DAYSCount of agents that are used in last 30 days out of total servers enrolledHome tab, Agents tab>80 %of total
AGENTS.LATEST_AGENT_VERSION_COUNTCount of agents with the latest version out of total servers enrolledHome tab, Agents tab>80 %of total
APPSERVER.FREE_JVM_MEMORYAvailable or free JVM memory in the systemApplication Servers details tab>= 1 GB
APPSERVER.JOBEXECUTION_CONNECTIONCount of Job execution connections in the systemApplication Servers details tab>= 200.0
APPSERVER.KEYSTORE_FILESCount of keystore files (configured) in the systemApplication Servers details tabThe value should match across all servers.
APPSERVER.MAX_CONCURRENT_JOBSMaximum count of concurrent jobs configured in the systemApplication Servers details tab<= 50
APPSERVER.MAX_FILE_DESCMaximum count of file descriptors configured in the systemApplication Servers details tab - 
APPSERVER.MAX_JVM_MEMORYMaximum JVM memory configured in the systemApplication Servers details tab>= 3.5 GB
APPSERVER.NO_OF_WORKITEM_THREADSCount of work item threads configured in the systemApplication Servers details tab<=100
TSSADW.APACHE_STATUSRunning status of Apache web serverTSSA-DW tabUp and Running
TSSADW.AUTH_STATUSRunning status of the authentication serverTSSA-DW tabUp and Running
TSSADW.ETL_TIMELast run details for ETL scriptTSSA-DW tab - 
TSSADW.FREE_DB_SIZEAvailable or free DB spaceTSSA-DW tab>= 30 %
DATABASE.DB_ACTIVE_RESOURCE_PLANDisplays the Database Edition that is used. For example, Enterprise, Desktop, Standard and so on.Database Server tab - 
DATABASE.DB_CHECKLISTChecklist of database related task or metric with valuesDatabase Server tabManual checklist available for download.
DATABASE.DB_FRAGMENTATIONDetails of tables with high fragmentationDatabase Server tab<=30 %
DATABASE.DB_SIZETotal size of TrueSight Server Automation databaseDatabase Server tab< 500 GB
DATABASE.DB_TABLE_MAX_ROWSTable with the maximum number of rows Database Server tab<=40 Million
DATABASE.FREE_DB_SIZEAvailable or free DB spaceDatabase Server tab>= 30 %
DATABASE.SHOULD_RUN_DBMOFFLINEDBM 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_CLEANUPDatabase cleanup run routineDatabase Server tab<=8 days
DATABASE.WITHOUT_HARD_DELETED_SHARED_CLEANUPRoutine hard delete of shared objectsDatabase Server tab<=8 days
DATABASE.WITHOUT_HISTORICAL_CLEANUPHistorical cleanup run routineDatabase Server tab<=3 days
JOBS.COUNT_10_PERCENT_FAILED_TARGETCount of jobs with more than 10% failed targets for any particular jobJobs tab0
JOBS.COUNT_LONGEST_RUNNING_JOBSCount of the longest running job > 8 hrsJobs tab0
JOBS.COUNT_SERVERS_FAILED_ACROSS_JOBSCount of servers that have failed across multiple jobsJobs tab0
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 tab0
JOBS.NO_TIMEOUT_JOBSCount of jobs with no time-out. This property ensures that resources should be utilized effectivelyJobs tab0
REPOSITORIES.FILE_SERVER_FREE_DISK_SPACEFree disk space on the file serverRepositories 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\<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>

Troubleshooting the Health Dashboard

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

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Gabriel Echegollen

    Hi,

    It will be good to know if there is any default or recomended port for this command:

    blasadmin set AppServer TSSADWServerURL protocol://tssadw_server:port


    Thanks

    Oct 02, 2020 02:18
    1. Bipin Inamdar

      Hi Gabriel,

      I have mentioned the default port for the specified command.

      Regards,

      Bipin Inamdar

      Oct 05, 2020 12:56