This is not the latest version of Ivanti Workspace Control documentation.
View available documentation.

Errors

The Errors node shows information about the errors that occurred in your environment:

  • To view the properties of an event, right-click it and then select Properties in the context menu.

  • To clear the log, right-click in the event log and then select Clear.
    A confirmation prompt appears.

Search engine

By default, the first 100 log entries are automatically shown when clicking Search. When the option Show last 100 entries only is not checked, the log view will be cleared. You can then search for the desired log entries.

Clicking the More button allows you to group your search (Group By) or specify a Date / Time Filter for your search. The # incidents at the bottom of the overview is dynamic.

Summarizing repeating entries

  • If an error is logged 60 times or more within an hour on a single Agent, logging of the individual occurrences of the error is suspended and the following entry is logged:
    "Start summarizing error <error number> as it was logged 60 times since <time of first occurrence>"

  • As long as the error keeps occurring 60 times or more within an hour on that Agent, the following entry is logged once per hour:
    "Summary of error <error number>: logged <amount> times since <time summarizing started or time of previous summary>"

  • When the frequency of the error drops below 60 times per hour, the following entry is logged:
    "Stop summarizing error <error number> as it was logged only <amount> times since <time summarizing started or time of previous summary>"
    Logging individual occurrences for that error is then resumed.

  • The summarizing mechanism is in place as long as the Workspace Control Agent Service is running on the Agent that is generating the errors. If the Workspace Control Agent Service is stopped while one or more errors are being summarized, the following entry is logged for each of these errors:
    "Closed summary of error <error number>: logged <amount> times since <time summarizing started or time of previous summary>"

Export error log to CSV file

To export the information found under the Errors log as a CSV file, follow these steps:

  1. Open the Workspace Control Console and navigate to Diagnostics > Errors.

  2. Export the error log information to a CSV file using one of the following methods:

    • Right-click in the right-side pane and select Export to file from the context-menu.

    • From the main menu, select Action > Errors > Export to file.

    • From the main toolbar, select the (Export to file) button.

  3. In the Export to file window, select a location where to save the CSV file, enter an appropriate name for the file and then select Save.

Introduced in Ivanti Workspace Control 2022.2 (version 10.9.10.0).

Export error log using the command line

Ivanti recommends to test first by exporting just one or two days of data.

The error log can also be exported using the pwrtech command-line option:

pwrtech.exe /exportlog /type=errors /output=<output filepath> [/outputtype=csv] [/start=<start date>] [/end=<end date>]

/outputtype, /start and /end are optional parameters. If /outputtype is not specified, then the error log is exported as a XML file instead of a CSV file.

Replace the following with the appropriate values:

  • <output filepath> — Enter the full filepath where to save the CSV or XML file.
    For example: C:\export\errors.csv.

  • <start date> — Enter the start date to export log entries starting with the specified date.
    The format for date is YYYYMMDD. For example: 20211230.

  • <end date> — Enter the end date to export log entries up to the specified date.
    The format for date is YYYYMMDD. For example: 20220123.

For example:
pwrtech.exe /exportlog /type=errors /output=C:\export\errors.csv /outputtype=csv /start=20211230 /end=20220123

Introduced in Ivanti Workspace Control 2022.2 (version 10.9.10.0).