Plugin management

Overview

This section covers installation, uninstallation, and configuration of User Plugins.

Manage plugins

Manage AppMon Plugins through the the Plugins pane of the dynTrace Server Settings dialog box. To open the dialog box, select Tools > Manage Plugins in the AppMon Client.

Installed plugins

The installed Plugins tab provides an overview of all dynaTrace Plugins that are installed on the server.

Installed Plugins
Installed Plugins

The tab contains the columns described in the following table.

Column names may be truncated, depending on the column width. To adjust a column width, click-and-drag the column's right border. To view the full name without adjusting the column, hover over the name.

Column Description
Name The name of the Plugin, as it is referenced in System Profiles.
Plugin Type In addition to the interface type (Task, Action, Monitor), other type definitions are listed to fully describe the Plugins. For example, a Plugin type may be listed as Monitor, Monitor Metric Group.
Active Plugins that can be disabled have a check box in this column. If the check box is selected, the Plugin is active. When you clear the check box for a Plugin, all subsequent executions of that Plugin are canceled; this has the same effect as suspending the Plugin schedule. If the Plugin is currently executing when you clear the check box, it continues until execution is complete. Select the check box again to restore the Plugin to active status.
Dependencies resolved This column Indicates the installation state of a Plugin. A blue checkmark indicates that the bundle is correctly installed and all bundle requirements could be resolved. A red exclamation mark indicates that the bundle could not be resolved and is not working. Review the detailed information about a Plugin to identify dependencies that could not be resolved.
Support level A dynaTrace icon in this column means that a plugin is supported by AppMon. The community icon means that this Plugin is supplied and supported by the Dynatrace Community, which includes the AppMon development team, the Community team, partners, and customers. See Support Levels for more details.
Version The version of the installed Plugin.

You can display these details for a Plugin in a tooltip by hovering over the Plugin row. To copy any or all of the information in the tooltip, press F2 when the tooltip is displayed.

Right-click a Plugin to display a context menu that provides the following functions. Some of these functions are also available through buttons at the bottom of the pane. If a function cannot be performed on a Plugin (for example, the Plugin's properties cannot be changed), the menu item and button are disabled.

Warning

Actions marked with an asterisk ( * ) are implemented immediately, and cannot be undone by clicking the Cancel button.

Function Description
Details Displays the Plugin details in a popup window, similar to hovering over the Plugin to display a tooltip.
Install Plugin* Select a Plugin .jar file to install.
Import Folder* Select a Folder that contains a bundle to install.
Export* Download the selected Plugin from the AppMon Server and save it to the specified location. It is recommended that you export a Plugin to a backup directory before making any changes to it.
Delete* Delete the selected Plugin and its default configuration from the Server. Plugin execution stops, but the Plugin schedule is not removed. Scheduled execution resumes when you re-import the Plugin.
Checkout* Download the selected Plugin from the server, extract it to the specified location, and automatically add it to the Development page. Only the Task, Action, and Monitor Plugin types can be checked out. For all other types, the Checkout button is disabled. Some Plugins may not contain any source because of their license policies, so the checkout for these Plugins only includes the libraries but no source.
Properties Open the Plugin Properties dialog box to configure the Plugin's properties. See below for details.
Find Find a specific Plugin in the list, or filter the list to show only Plugins with the specified string in their names. Select the filter icon to display a filtered list; deselect the icon to find one search result at a time.

Plugin properties

Use the Plugin Properties dialog box to specify Server-wide default settings for the selected Plugin.

Plugin Properties
Plugin Properties

The dialog box contains the following columns.

Column Description
Name The Plugin's properties, which are specific to the Plugin.
Type The data type of the property.
Value The value assigned to the property. For properties that have Boolean values, this column contains a check box that is selected for TRUE (YES) or cleared for FALSE (NO).
Visibility You can use this column to restrict the configuration of the Plugin. Three options are available:
  • edit: This is the default option. The property's value can be modified.
  • read: The value is read-only and cannot be modified.
  • hidden: The property does not display and cannot be modified.
When the visibility is set to read or hidden, the property value is used for all Plugin instances. When the visibility is set to edit, the property value is used as the default value, but it can be modified for individual instances. Changing the visibility from read or hidden to edit restores the value on each instance that was entered before visibility was set to read or hidden.