Foglight 5.9.1 - Administration and Configuration Guide

Connection Status

The Connection Status dashboard lists the users that are logged in to the Management Server. For each user, the list shows the client IP address, login time, request name, and request time.

View Audit Information

Use the View Audit Information dashboard to explore log entries. Log entries show the users that are logged in, changes made to user security settings, or any changes made to rules, schedules, or registry variables. Select a time period for which you want to view the logs, and optionally, print the desired set of entries to a file.

IMPORTANT: The appearance of the dialog box may be different, depending on the type and version of your web browser.

IMPORTANT: If you show or hide one or more columns in the audit log table, this layout is reflected in the export file. For example, if you display only the time range and the operation name, only those columns appear in the export file.

The following table lists the operations that are audited by Foglight. In addition to the operations listed below, Foglight audits the following operations:

Online-Only Topics

Learn more about:

Cartridge Inventory and Components for Download

The Cartridge Inventory dashboard lists the cartridge that exist in your system and contains controls for installing, enabling, disabling, and uninstalling cartridges.

Installation is the first step in adding a cartridge to the Foglight Management Server. A cartridge file has the extension.car. Installing the CAR file causes the Management Server to be aware of all cartridges in the CAR file.

Use the Cartridge Inventory dashboard to install a cartridge. Alternatively, use the cartridge:install command. This fglcmd command allows you to install one or more cartridges at a time. For more information, see the Command-Line Reference Guide.

Some Foglight cartridges are license-protected, while others do not require a license. You can install any cartridges, regardless of their license requirements. However, installing a license-protected cartridge without adding its license results in that cartridge being disabled by default. For more information, see Managing Licenses.

NOTE: In some cases, there are dependencies between two or more cartridges. Enabling or disabling a cartridge may prompt you to provide further input, such as to disable or enable additional cartridges, or can inform you that the cartridge cannot be enabled due to cartridge dependency.

A cartridge must also be enabled before it is added to the Management Server. You can enable a cartridge before or after its installation.

TIP: To view only cartridges which are enabled, click the View only Enabled Cartridges check box at the bottom of the screen. In addition, you can sort by the Version and Creation Date columns.

TIP: Enabling a cartridge completes the installation process by making the cartridge components available for use by the Management Server. Alternatively, you can enable the cartridge at a later time. For details, see Enable or disable Foglight cartridges.

The Status column contains icons that indicate if a cartridge is enabled , enabled pending dependency , partially enabled , or disabled .

Enabling a cartridge completes the process of adding it to Foglight by making the cartridge’s components available for use by the Foglight Management Server.

Disabling a cartridge causes its components to no longer be available for use by the Foglight Management Server. A disabled cartridge remains installed on the Management Server. For example, Foglight automatically disables older versions of cartridges when newer versions are installed.

NOTE: It is strongly recommended that you do not disable a cartridge unless your intention is to remove it indefinitely. Although data is retained in the database, user configurations can be lost, and expired topology types are removed when cartridges are disabled and re-enabled.

A cartridge can be in one of the following states:

You can install any cartridge, regardless of the contents of your Foglight license. Installing a license-protected cartridge without adding its license results in that cartridge being disabled by default. Before enabling a license-protected cartridge, ensure that its license is installed and current. For more information, see Managing Licenses.

When you install a newer version of an existing cartridge, Foglight detects that, and automatically disables the older version.

NOTE: In some cases, there are dependencies between two or more cartridges. Enabling a cartridge may prompt you to provide further input, such as to enable additional cartridges, or can inform you that the cartridge cannot be enabled due to cartridge dependency.

TIP: The Status column contains icons that indicate if a cartridge is enabled , enabled pending dependency , partially enabled , or disabled .

6	Observe the Status column of the newly enabled cartridge. This column contains the Enabled icon , indicating a success.

NOTE: It is strongly recommended that you do not disable a cartridge unless your intention is to remove it indefinitely. Although data is retained in the database, user configurations can be lost, and expired topology types are removed when cartridges are disabled and re-enabled.

TIP: The Status column contains icons that indicate if a cartridge is enabled , enabled pending dependency , partially enabled , or disabled . To view only cartridges which are enabled, click the View only Activiated Cartridges check box at the bottom of the screen.

This column contains the Disabled icon , indicating a success.

Uninstalling a cartridge removes the cartridge files from the Foglight Management Server installation.

A .car file can contain multiple cartridges. When you remove all of the cartridges that come in a .car file, the .car file is deleted.

Before removing a cartridge, make sure that the cartridge is disabled, and that any agent instances that come with the cartridge do not collect data. Uninstalling a cartridge while its agents are still collecting data prevents the Foglight Management Server from recognizing the data that the agents collect. For more information about disabling a cartridge, see Enable or disable Foglight cartridges.

TIP: The Status column contains icons that indicate if a cartridge is enabled , enabled pending dependency , partially enabled , or disabled .

The Components for Download dashboard lists the agent components that are included with the Foglight Management Server or any of the installed cartridges, and are available for download. It also provides access to any files that you may need to download following a cartridge installation. If you have access to the browser interface, use this dashboard to view information about the available components, and to download them.

TIP: The Component for Download URL contains a direct link to the component file that is accessible without needing to login. This can be used to download components in headless environments when browser access is not possible.

NOTE: The appearance of the dialog box varies, depending on the type and version of your web browser.

If you do not have access to the browser interface, use the Components for Download view to download agent components. The Components for Download view lists the agent components that come with the Foglight Management Server or any of the installed cartridges, and are available for download. Use this view to see which agent components are available for download, obtain more information about each component, and to download them.

NOTE: This view exists as a stand-alone page. It does not provide access to any Foglight dashboards in the browser interface. Clicking a web browser’s Back and Forward buttons while viewing this page opens the pages visited in the current browser’s session, without navigating to related Foglight dashboards.

NOTE: The list of agent components that are available for installation depends on the nature of your monitoring environment and the type and range of installed cartridges, and may not be identical to the one shown in the above screen capture.

If the row containing an agent installer shows the Manual Installer icon in the Manual Installer column , this indicates that you need to run the agent installer manually on the monitored host after downloading it to the monitored host. For complete information on how to manually install an agent component, see your cartridge documentation.

NOTE: The appearance of the dialog box varies, depending on the type and version of your web browser.

If you do not have access to the browser interface and want to use a direct URL to download agent components, you can do that either by typing the URL into the web browser address field, or use it in combination with a command-line utility such as wget.

NOTE: The appearance of the dialog box varies, depending on the type and version of your web browser.

IMPORTANT: The wget utility illustrated above is a command-line tool that can be used to retrieve a file from a URL using standard Internet protocols. This command does not come with Foglight. For more information about this command, visit http://www.gnu.org/software/wget/.

Some Foglight dashboards have reports associated with them. This allows you to run a report based on the current dashboard. You can generate the report using the Reports menu in the top-right corner.

The Cartridge Inventory dashboard is associated with the Cartridge Inventory Report. Run this report by choosing Cartridge Inventory Report from the Reports menu.

The report wizard provides more information about the Cartridge Inventory Report. For more information about reports in Foglight, see the Foglight User Help.

This dashboard is a starting point for viewing and managing Foglight Agent Managers. It displays a list of all Agent Managers that exist in your environment, and allows you to manage them. To access the Agent Managers dashboard, from the navigation panel, click Dashboards > Administration > Agents > Agent Managers.

TIP: You can navigate to the Agent Adapters dashboard from this page. To do that, in the upper-right corner, click Agent Adapters.

You can select one or more hosts and click a button just above the table to perform a desired operation on the selected host. For example, to create an agent instance and manage it by a specific Agent Manager, select an Agent Manager, and click Create Agent. The following commands are available:

The upper part of this dashboard lists the connected Agent Manager hosts. Some columns are hidden by default You can control the appearance of columns using the Customizer .

•	Alarms State: The highest severity alarm generated against the Agent Manager: Normal , Warning , Critical , or Fatal .

This area provides information about any running tasks initiated from this dashboard. For example, when you deploy an agent package, the status of that task appears in this area.

The lower part of the Agent Managers dashboard provides information about any completed or running tasks that are initiated on this dashboard. By default, the following columns are displayed:

Two additional columns are not hidden by default. You can display them in the Customizer :

This dashboard is a starting point for viewing and managing Foglight Agents. It displays a list of all monitoring agent instances that exist in your environment, and allows you to manage them. To access the Agent Status dashboard, from the navigation panel, click Dashboards > Administration > Agents > Agent Status.

You can select one or more hosts and click a button just above the table to perform a desired operation on the selected host. For example, to activate an agent instance, select it in the table, and click Activate. The following commands are available:

The upper part of this dashboard lists the available agent instances. Some columns are hidden by default. You can display the hidden columns using the Customizer .

•	State: The highest severity alarm generated against the agent instance: Normal , Warning , Critical , or Fatal .

•	Status: The status of the agent process: Active , Broken , or Deactivated . For more information, see Activate or deactivate agent instances.

•	Collecting Data: An indication of whether the agent instance is collecting data: Not Collecting Data , Collecting Data , or if the agent instance is not collecting data due to a blackout . For more information, see Start or stop data collection.

TIP: If the agent instance is not collecting data due to a blackout, click for more detailed blackout information.

•	Private Property: An indication of whether the agent instance uses private properties , or not .

This area provides information about any running tasks initiated from this dashboard. For example, when you deploy an agent package, the status of that task appears in this area.

The lower part of the Agent Managers dashboard provides information about any completed or running tasks that are initiated on this dashboard. By default, the following columns are displayed:

Two additional columns are hidden by default. You can display them using the Customizer :

An administrator uses services to help organize the monitoring environment. The Agent Status dashboard allows you to filter and display the agents that capture data about the monitored objects in the selected service(s). This option helps you better monitor the agent, like checking the agent status, stopping data collection and so on.

To filter agents by services:

2	On the Agent Status dashboard, click the filter button .