Overview

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.

Main Navigation/Dashboard

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

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

Menu Permissions

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

Access to	User Permissions
User 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

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

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

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

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.

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).

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.

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.

Profiling Feature

To help troubleshoot performance issues resulting in high CPU usage, Itential Automation Platform (IAP) 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 Configuration section of the IAP Admin Guide.