Applications

The Platform interface for Admin Essentials → Applications consists of the Configuration and Logging tabs, as described below. Please note that available views, features, and interactions in the UI are limited based on user permissions.

Configuration Tab

This is the landing page for the Application details view. If your application has properties to edit, they will be displayed here in a form. If not, logging can be edited in the Advanced view (if user permission has been granted in the Applications - updateApplication permission method) or in the Logging tab. To enable the Advanced editing view, use the toogle switch (top upper-right corner).

Figure 1: Admin Essentials Config Editor

Profiling Feature

To help troubleshoot performance issues resulting in high CPU usage, Itential Platform now includes a built-in profiler based on V8.dev profiling and simple-profiling. For more information on how to use this feature, see the Service Configuration for Profiling.

Filter Variable Data on Job Events

Beginning in the 2023.1.12 release version, Itential added a new property, compactJobEvents, to Workflow Engine. When a customer enables this property, it will remove all user-defined job/task variable values, thereby reducing the size of the job event and improving application performance.

Figure 2: Compact Job Events Property

Logging Tab

You can view the changelog of an application from the Logging tab. Use the Select Log dropdown to view the changelog for a particular release. From this tab you can also change the log level settings.

Figure 3: Log Settings

Changing Log Levels (Apps & Adapters)

A user with permissions for the generic updateAdapter and updateApplication methods can modify the log_level of an application or adapter in Itential Platform using the Advanced View switch located in the upper-right corner of the interface.

To access this feature, navigate to: Admin Essentials→ Adapters (or Applications) → adapter/application name → Logging (tab)→ Advanced View (switch).

For example, to change the log_level to debug:

• Replace the value of the log_level property by changing info to debug.
• Click the SAVE button (lower-left corner).

Of note, the specific details logged at each level (i.e. what information is logged and what messages are returned) is determined by the application developer and defined within the adapter code.

Additional log level properties for Syslog are saved in the Log Settings view shown below. If the Syslog properties are not configured in the Advanced View of an application or adapter page, the user will be unable to change that property in the Logging tab.

Figure 4: Logging Tab

Changing Log Levels in Profile Properties

For software versions prior to the Platform 6 release, you can also modify the log_level in Itential Platform by navigating to: Admin Essentials→ Profiles→ profile name→ Edit Profile Properties→ loggerProps. Previously, changing a profile's logging was done via code editor; it is now done using a form as shown in the image below.