Join us at Experience '19: The Digital Employee Experience Conference. Learn More

cookie alert

We use cookies to offer you a better browsing experience, analyze site traffic, personalize content, and serve targeted advertisements. If you continue to use this site, you consent to our use of cookies.

Nexthink Library

Collector Configuration

Perform remote troubleshooting and maintenance of Nexthink Collectors on the devices.

Get Collector Reporter Files Get Last Remote Action Performance Reset CrashGuard Set Collector Configuration Test CrashGuard

Content

Remote actions - 5

Required Modules

Nexthink Act

Platforms

Windows

Compatibility

V6.14 and later
Install
  • 1.1.1.0 - Updated "Get Collector Reporter Files" Remote Action documentation
  • 1.1.0.1 - Reviewed "Set Collector Configuration" Remote Action
  • 1.1.0.0 - Updated "Set Collector Configuration" Remote Action to set AppStartTime configuration
  • 1.0.0.0 - Initial release

Description

Change Collector configuration parameters by using nxtcfg Collector tool, test if Collector CrashGuard is active, reset Collector CrashGuard counter, check last Remote Action performance and gather Collector Reporter files from devices.

Get Collector Reporter Files

Script Description

Using Collector Reporter, retrieves some useful information and log files from the endpoint to solve Nexthink products related issues, and stores the results in a network shared folder.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 900 seconds is recommended.

Parameters

LabelDescription
Network PathAbsolute path to the network shared folder where Collector Reporter zip file should be copied. UNC format is required (e.g. \ServerSharedFolderName)
Maximum Delay In SecondsMaximum random delay set to avoid server overload. Provide number of seconds less than 600

Outputs

LabelTypeDescription
Output Network PathStringResult output file path, based on input network path

Restrictions

Further Information

To see a complete list of elements the script gathers, please visit this page.
Collector reporter might take several minutes to gather the information. In addition, the generated file could have a considerable size (+100 MB).
During the process, CPU and network will be heavily utilized therefore execution should be planned considering performance impact to end user, virtual and network infrastructure.
To understand how to configure a network share, to work properly with Nexthink Act, please visit this page.

Get Last Remote Action Performance

Script Description

Retrieves information about the performance of the last remote action executed by the Collector on targeted device.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

LabelTypeDescription
Last Remote Action PerformanceStringListLast executed remote action performance information (UID, execution date, average CPU, etc.)

Restrictions

Further Information

Last executed remote action performance information is extracted from Collector log.
Collector debug mode must be enabled to log any remote action performance. There is no need to have Collector debug mode enabled for the execution of this very remote action, which measures the performance for the previous remote action logged.
Use Set Collector Configuration remote action for enabling/disabling Collector debug mode. Please, remember that Collector debug mode is not meant for a normal production operation.

Reset CrashGuard

Script Description

ADVANCED SCRIPTResets the Collector CrashGuard count and restarts the Collector driver. The script is designed for Windows 10 and 7.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

None.

Further Information

The status of the Collector is checked before resetting the CrashGuard.

Set Collector Configuration

Script Description

ADVANCED SCRIPT - This Remote action should be used by a certified Nexthink expert.Collector configuration is changed using Nxtcfg tool, except for 'AppStartTime'.'AppStartTime' configuration parameter change involves Registry Key changes and additional verifications done by the Remote Action.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

LabelDescription
TagOptional number to identify the installation - 2147483647
Log ModeLogging mode (0 - Silent, 1 - Verbose, 2 - Debug). It might impact performance. Use only for debugging
WM DomainsList of domains for which to report the URL of web requests (comma-separated)
IOPSEnables (1) or disables (0) IOPS monitoring beta functionality (do not enable if this is unknown to you)
PKG IntervalPeriod, in hours, in which the Collector checks for new installed packages and updates. Integer in range - 24 (0 - Never)
PrintingEnables ('enable') or disables ('disable') print monitoring
App Start TimeEnables (1) or disables (0) App Start Time feature

Outputs

LabelTypeDescription
Collector Parameters SetStringListList of Collector parameter=value set

Further Information

Please use '""' (two double-quotes) as input parameter in Finder to prevent any of the configuration values from being changed.

Test Scenarios

AppStartUpFileDoesNotExist
Test CaseAppStartTime is passed as the remote action input parameter, but appstartup.csv does not exist
EnvironmentWindows 7 VM x64 - Windows 10 VM x86/x64 (1803/1809/1903) (Multi-Language)
ResultsSuccess - A startup.csv file is created under 'C:ProgramDataNexthinkAppStartTimeBeta' folder. Configuration of AppStartTime is properly applied and Collector services are restarted.
AppStartUpFileAlreadyExists
Test CaseAppStartTime is passed as the remote action input parameter, and appstartup.csv exists
EnvironmentWindows 7 VM x64 - Windows 10 VM x86/x64 (1803/1809/1903) (Multi-Language)
ResultsSuccess - No startup.csv file is created, since it already exists. Configuration of AppStartTime is properly applied and Collector services are restarted.
AllParametersAreEmpty
Test CaseAppStartTime is passed as the remote action input parameter, with an invalid value (other than 0 or 1)
EnvironmentWindows 7 VM x64 - Windows 10 VM x86/x64 (1803/1809/1903) (Multi-Language)
ResultsSuccess - A dash (-) is displayed in CollectorParametersSet custom field in Finder. Configuration parameters of Collector are not changed and Collector services are not restarted.
InvalidAppStartTimeParameter
Test CaseAppStartTime is passed as the remote action input parameter, with an invalid value (other than 0 or 1)
EnvironmentWindows 7 VM x64 - Windows 10 VM x86/x64 (1803/1809/1903) (Multi-Language)
ResultsFailure - An error message is displayed in Finder, indicating the allowed values (0 for 'Disabled', 1 for 'Enabled'). Configuration of AppStartTime is not changed.

Test CrashGuard

Script Description

Checks whether the Collector CrashGuard count has reached the maximum value, which means that the CrashGuard protection is active. The script is designed for Windows 10 and 7.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

None.

Thank you!