Plug-Ins

 

Plug-ins provide a framework for adding user-defined metrics to AppFormix. Metrics provided by a plug-in are available for charting and alarming. Plug-ins can be configured using the Ansible playbooks, as described in Plug-Ins.

Plug-In Configuration Panel

After a plug-in is added to the AppFormix Platform, you can make modifications to the plug-in configuration from the settings panel on the dashboard. Figure 1 shows the plug-in configuration panel.

Figure 1: Plug-In Configuration Panel
Plug-In Configuration
Panel

Plug-In Grammar

A plug-in of type command is a Nagios-Style plug-in that outputs metrics as a string. A command plug-in may be any executable that outputs a string in the following format.

Table 1 describes the fields.

Table 1: Command Plug-In Fields

Field

Description

metric value

Must contain only digits and optional decimal point: [0-9]+\.?[0-9]

metric.units

Must be a valid string that starts with a letter.

metric.name

Must be a valid string that starts with a letter.

For example:

Plug-In Metrics Charts

After a plug-in is installed, you can navigate to the host chart page and the metrics will be visible in the charting panel on the hosts where the plug-in is enabled. Figure 2 shows a plug-in metric chart displaying instances and NICs, color-coded and sorted by start and end date, as well a times.

Figure 2: Plug-In Metrics Chart
Plug-In Metrics Chart

Plug-In Metrics Alarms

An alarm can be configured for any plug-in metric from the panel for the alarm configuration. If the plug-in is enabled the plug-in metrics are also available on the alarm panel. Figure 3 shows a list of these metric alarms.

Figure 3: Plug-In Metric Alarms
Plug-In Metric Alarms