Service configuration
When Itential Platform starts a service (application or adapter), the service loads its configuration data for start-up. Service configuration is managed from the Service Config editor in Admin Essentials.
This guide covers two service configuration topics: profiling logs and maximum memory size.
Profiling
To help troubleshoot performance issues resulting in high CPU usage, Itential Platform has a built-in profiler based on V8 profiling and Node.js simple profiling.
Profiling can be enabled for Itential Platform and select applications and adapters in release version 2020.1 and higher.
Itential strongly recommends that profiling is not enabled for production deployments due to possible performance impacts.
Prerequisites
You must have write permission to the working directory to create profiling logs.
Set profiling in Itential Platform
When running Itential Platform in a Docker environment, set the following in /docker/startContainer:
When running Itential Platform directly in shell, use the --prof CLI option:
Enable profiling for apps and adapters
To enable profiling for adapters and applications running on a development server:
Select the service
Expand the Applications or Adapters menu in the left sidebar and select the appropriate adapter or application.
Enable Advanced View
From the Configuration tab, switch the toggle in the upper-right corner to turn on Advanced View and display the Service Config editor.
Process profiler logs
The profiler writes data to a file named isolate-*-v8.log in the working directory.
To convert the log into a readable format, use the Node.js --prof-process CLI option:
Open the output file in your preferred editor or viewer to inspect the profiling data.
Remove profiler logs
After analyzing the profile data, remove the log files to reclaim disk space.
System properties
System properties control service-level internal settings such as V8 and Node.js properties for a service process. Add them to the Service Config page (under Applications or Adapters) as a top-level systemProps property.
Max memory size
As memory consumption approaches the limit for a service process, use maxOldSpaceSize to increase the memory limit. Navigate to Admin Essentials → Applications → Configuration → Service Config to add this property.
Sample configuration
