Admin Essentials

On this page:


Admin Essentials is an all-in-one interface used to view, configure and modify all admin level properties across the Itential platform. The various features in Admin Essentials are controlled by authorization settings. Therefore, some users will not have access to all the features referenced in this guide; however, an administrator can give user access to the features as necessary.

The main features of the Admin Essentials launch page are referenced in the table below.

General Overview

Label UI Element Function
1 Icon Bar Icons for completing quick actions from anywhere within Admin Essentials. These icons (from left to right) are: Create, Import, Dashboard, Search, Current Operations, Tags, Authorization, and View Documentation.
2 Collection Lists Open the accordion menus in the sidebar to display a list of items in a corresponding collection. Users can search for items within a collection. The accordian menu list that shows on the UI is based on user permissions.
3 Quick Start Contains a series of links to important functions within Admin Essentials such as setting authorization levels and downloading IAP Blueprints.
4 Automation Platform Displays version information along with memory usage data and other system details, including uptime.
5 Task Execution Displays if a task/job is running on the system. Click the Pause Task Execution button to temporarily pause (toggle on/off) a running task.
6 Alerts Shows if an app/adapter is stopped or connectivity is down.
7 Restart Click the circular arrows icon to restart an app/adapter to bring it out of an alert state.
8 Stop Click the square icon to stop an app/adapter.

Icon Bar Permissions

The following outlines the permissions that must be applied to a user account to gain access to the Icon Bar.

Access to User Permissions
Current Operations WorkFlow Engine, activate / WorkFlow Engine, deactivate
Tags Tags, all

The following outlines the permissions that must be applied to a user account to gain access to the Menus in the sidebar.

Access to User Permissions
Profiles Profiles, getProfiles
Applications Applications, getApplications
Adapters Adapters, getAdapters
Integrations Integrations, getIntegrations
Integration Models IntegrationModels, getIntegrationModels
Pre-builts Prebuilts, getPrebuilts

Create New Item Permissions

The Create icon will open a dialog with choices for creating a new item in a collection. The choices that appear are based on user permissions as defined in the table below.

Figure: Create Icon

Create Icon

Access to User Permissions
User Groups
Must be on Local AAA with no access to Pronghorn admin role.
Profile Profiles, createProfile
Adapter Adapters, createAdapter
Integration Integrations, createIntegration
Integration Models IntegrationModels, createIntegrationModel
Tags Tags, createTags

Create Dialog

Import Permissions

The Import icon will open up a dialog with choices for uploading a new item to a collection. The Import dialog accepts a JSON file. The choices that appear are based on user permissions as defined in the table below.

Figure: Import Icon

Import Icon

Access to User Permissions
Profile Profiles, createProfile
Adapter Adapters, createAdapter
Tags Tags, createTags
Pre-builts Prebuilts, importPrebuilt

Import Dialog

View Documentation

The View Documentation icon will open a dialog that provides links to the documentation pages, in addition to providing a view for the pronghorn-core changelogs.

Figure: Documentation Icon

Documentation Icon

Collection Items

The Collection dialog displays all of the items in a collection as cards with services information relevant to the collection item displayed within the card.

Collection Dialog

Label UI Element Function
1 Collection Toggle Allows the user to switch to a different collection view.
2 Icon Bar Icons (from left to right) for completing quick actions: Refresh, Select All, Export, Delete.
3 Search and Filter Use the search bar to search for items in the collection based on filter settings. Filter the results using the icon to the left of the search bar.
4 Sort and Sort By Use the icon to sort the items in the collection based on the selected value in the dropdown.
5 Select Click to select the item for deletion or export.
6 Delete Icon to delete the selected item.
7 Paging Used to show the total number of discrete pages and to page through a collection. Also used to set how many items to show if there are too many in a collection.

Changing Application/Adapter Log Levels

A user with permissions for the generic updateAdapter and updateApplication methods can modify the log_level of an application or adapter in IAP 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).

Logging Properties

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.

Logging Tab

Changing Log Levels in Profile Properties

A user can also modify the log_level in IAP using the Admin Essentials interface 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.

Profile Logging

Profiling Feature

To help troubleshoot performance issues resulting in high CPU usage, Itential Automation Platform (IAP) now includes a built-in profiler based on profiling and simple-profiling. For more information on how to use this feature, see the Configuration section of the IAP Admin Guide.