Overview
The Command History report lists all commands executed on each agent enabled computer over the last 90 days (by default). The report is history based and commands that have been executed after 3am will not be included on the report until the daily maintenance is completed (this occurs at 3am every night). To change the amount of history retained, enter the number of days to retain in the Commands field in the Dashboard > Config > System.
This report can be run for all clients or by client, location, computer type, computer or group. Additional filters are available to run the report based on specific criteria.
The purpose of this document is to show you how to use the report specific filters and how to understand the data provided by the report. A sample page of the report is included at the end of this document with each section explained separately.
| Image may be NSFW. Clik here to view.  |
NOTE: If you are running the report and you do not have full access to all clients (clients, computers and locations) the report will only show information for what you have permission to access. |
Filter Options
Filters allow you to run reports based on specific criteria. The filters are separated into two sections. On the left, there are the basic filters to limit the report by client, location, computer type, computer or group. On the right, there are report specific filters that will further narrow your report results (e.g., output, statusresult, etc.). Refer to the following table for information on how to use these filters.
Table 1: Command History Report Filter Descriptions
| Filter | Description |
| DateExecuted | Filters based on the date the command was executed. To filter on the date the command ran, select the checkbox to the right of the field and enter the 'From' and 'To' dates. |
| OutPut | Filters based on the descriptive results of the command (e.g., Configurations, Schedules and all templates have been updated). Enter the result description and select a comparison from the drop-down to return results. The available options are: Like, Equals, In, Not Like, Not Equal and Not In. Wildcards ('?' for a single character or '*' for multiple characters) and the multiple select search can also be used in this field. |
| Command Name | Filters based on the command name (e.g., Update Configs). Enter the command name and select a comparison from the drop-down to return results. The available options are: Like, Equals, In, Not Like, Not Equal and Not In. Wildcards ('?' for a single character or '*' for multiple characters) and the multiple select search can also be used in this field. |
| StatusResult | Filters based on the result of the command (Pending, Executing, Success, Failure and unknown). Enter the command result and select a comparison from the drop-down to return results. The available options are: Like, Equals, In, Not Like, Not Equal and Not In. Wildcards ('?' for a single character or '*' for multiple characters) can also be used in this field. |
| CommandUser | Filters based on the user that executed the command. Enter the user's name and select a comparison from the drop-down to return results. The available options are: Like, Equals, In, Not Like, Not Equal and Not In. Wildcards ('?' for a single character or '*' for multiple characters) can also be used in this field. |
| Image may be NSFW. Clik here to view.  |
TIP: For a multiple select search, click on the Image may be NSFW. Clik here to view.  icon (if available) and then click on the Find button to list the available options. Select the desired option and use the arrow buttons to slide the option to the right, indicating you want to filter the data based on this selection. Click OK when done. If a multiple select search icon is not available, you can also create a multiple select search by using the following pattern: 'First Search','Second Search', etc. Each search must be enclosed in a single quote separated by a comma (no spaces). |
| Image may be NSFW. Clik here to view. |
TIP: Wildcards can be used for several of the filters. Use '?' for a single character wildcard. Use '*' for multiple wildcards. |
Previewing the Command History Report
The Command History report can be scheduled to run at specific times or it can be run manually. To run the report manually, right-click on the client, location or group from the navigation tree and select View Report > LabTech Reports > Command History. However, it is recommended that all reports be scheduled by using the Report Manager. For step-by-step instructions on scheduling reports, refer to the Scheduling/Printing Reports documentation.
To preview the Command History report:
- From the Control Center, select Tools > Reporting > Report Manager.
- Expand LabTech Reports on the navigation tree and then select Command_History.
Figure 1: Command History Report Setup
Image may be NSFW.
Clik here to view.![fig01 16C.51.147.CommandHistory]()
- Select the Client, Location, Computer Type, Computer or Group from the drop-downs. For all clients, leave all of these fields at the default setting of 'Not Specified'.
- Add any desired additional filters from the right-column to filter your results even further. Refer to the Filter Options section for more information.
- Click on the Print Preview button to preview the report. If you wish to print without previewing the report, click on the Print button. To email the report as a PDF attachment, click the Email Report button and complete the email form, as necessary. Otherwise, to schedule the report to run for a later or recurring date and time, click on the Schedule button.
Sample Report
The Command History report lists all commands executed on each agent enabled computer over the last 30 days.
This report can be grouped and filtered using the controls in the Report Manager.
Figure 2: Command History Sample Report
Image may be NSFW.
Clik here to view.
Figure 3: Report Legend
Image may be NSFW.
Clik here to view.
| Image may be NSFW. Clik here to view. |
NOTE: Each section of the above report has been extracted (indicated by the letters to the left of the report) to provide a clearer view of the information. These extracted sections are shown below. |
Figure 4: Section A - Report Header
Image may be NSFW.
Clik here to view.
The Report Header (section A) will display the client name, report title, your company logo and the date the report was printed.
Figure 5: Section B - Location Information
Image may be NSFW.
Clik here to view.
The Location Information section (section B) displays the agent machine's location, name, operating system, date added to LabTech and current status.
Figure 6: Section C - Command History
Image may be NSFW.
Clik here to view.
The Command History section contains information for all commands that were executed on the agent, including the date and time the command was executed and by whom, the type of command, the result of the command and the descriptive results of the command. If the command resulted in failure, the Result field will be noted in red.
Figure 7: Section D—Report Footer
Image may be NSFW.
Clik here to view.
The Report Footer (section D) contains the page number, company name, title and the date and time the report ran.
Figure 8: Section E - Report Legend
Image may be NSFW.
Clik here to view.
The Report Legend (section E) will appear on the last page of the report. If you used any filters when creating the report, these will display in the Current Parameters section.
Document Revision History
| Date | Notes |
| 09/19/2011 | New Document |
| 09/20/2012 |
Updated for 2012 SP1
|
Image may be NSFW.
Clik here to view.