Setting up data collection for Command Usage reports

The Command Usage reports allow you to monitor the execution of various commands on servers and can help you troubleshoot issues with particular servers. For the Command Usage built-in reports, see Command Usage reports.

This topic provides an overview of how data is collected for Command Usage reports.

Setting up the NSH Script job

You collect data for the Command Usage reports by using the collect_agent_logs.nsh script, which copies data from agent logs on specified target servers to files on the reports server. Use the script to create a TrueSight Server Automation Network Shell Script Job that you can run on a regular basis. You can execute the job for a one-time run or you can create a schedule for the job.

Do the following:

  1. Import the collect_agent_logs.nsh script in the TrueSight Server Automation application server. See  Importing collect_agent_logs script. .

  2. Create the Network Shell Script Job and add the target server for which you want to collect the agent logs. 

    The following table lists the required parameters that you must provide while creating the job. For information about how to create a Network Shell Script Job, see  Adding a Network Shell script  in the TrueSight Server Automation documentation.

    Using existing jobs

    If you want use the existing TrueSight Server Automation jobs, the following fields need to be modified:

    Script nameField/Parameter

    Host name of the server where TrueSight Server Automation - Data Warehouse is installed.






    This parameter is the TrueSight Server Automation - Data Warehouseserver name on which the agent logs are stored after they are collected from the agents/servers.
    This server name must be the same as the server on which the agent log destination folder is located. You provide that location during the product installation.


    This parameter is the directory in which the agent logs are stored.
    This location should be the same as the agent log destination folder that you provided during the product installation.
    The default location is <TSSA-DWInstallationDirectory>/AgentLogs.


    This parameter is the site ID for the TrueSight Server Automation site from which the collect_agents_logs script is being run.

    If you have multiple TrueSight Server Automation sites in your TrueSight Server Automation - Data Warehouse installation, use the site ID that you used during the TrueSight Server Automation - Data Warehouse installation.

    The site ID must be a valid ID from the BL_SITE table. You can determine the site ID using the TrueSight Server Automation - Data Warehouse console. 

  3. (Optional) Create a schedule for the job. 

  4. Run the Network Shell Script Job.

Running ETL

Once you have run the NSH Script Job, run ETL using an NSH script to transfer the data to the reports data warehouse, as described in Running ETL using an NSH script

Related topic

Command Usage reports

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