Chat now with support
Chat with Support

Foglight for Infrastructure 7.1.0 - User Guide

Using Foglight for Infrastructure Monitoring log files with Foglight Log Monitor Monitoring IBM PowerVM environments
Before you begin Managing PowerVM HMC agents Monitoring your PowerVM environment
Advanced system configuration and troubleshooting Reference
Foglight for Infrastructure views Foglight Log Monitor views Rules Metrics
Appendix: Building regular expressions in Foglight

Agents

The Agents view shows all the infrastructure agents monitored in the Infrastructure environment. The Agents table refreshes when a different agent type is selected from the Selected Agent Type drop-down list.

The Agents table includes the following columns:

•
State: icon indicating the state of the agent
•
Agent Name: the name of the monitoring agent
•
Agent Type: the type of the monitoring agent
•
Target Host: the name of the host monitored by the agent

The Administration view’s toolbar includes the following buttons:

•
Edit Agent Type Defaults: allows you to edit the default agent type properties.
•
Edit Shared Agent Properties: allows you to edit the shared agent type properties.
•
Edit Agent: allows you to edit the agent properties for the selected agent or agents.
To edit the default agent type properties:
1
Click Edit Agent Type Defaults.
The Agent Type Defaults dialog box appears.
2
From the Agent Type list, select whether you want to change the default properties for a Windows, UnixAgentPlus, Unix, or MultiHostProcessMonitor agent type.
The dialog box refreshes to display the properties specific to the selected agent type. The following illustration shows the default properties for a WindowsAgent.
The following illustration shows the default properties for a UnixAgentPlus.
The following illustration shows the default properties for a UnixAgent.
The following illustration shows the default properties for a MultiHostProcessMonitorAgent.
For detailed information about Foglight for Infrastructure agents and their properties, see About the WindowsAgent, About the UnixAgentPlus, About the UnixAgent, and About the MultiHostProcessMonitorAgent.
* 
NOTE: UnixAgentPlus only supports the Linux and Solaris platforms.
* 
NOTE: MultiHostProcessMonitorAgent includes both the Windows and Linux® platforms.
3
Update the agent’s properties, by selecting other properties from the drop-down lists, by creating new shared property lists, or by editing the default existing ones.
Clicking the View button on the right side of a default property opens the Agent Property List dialog box, which lists the property rows. From here, you can click:
•
Edit: allows you to edit the currently selected property list, by adding and removing rows.
•
Copy: allows you to edit the displayed properties and save the copy as a new shared property list. When saved, the copy becomes the selected item in the drop-down list.
 
* 
IMPORTANT: When you click Save in the Agent Property List dialog box, nothing is persisted on the server. Changes (new copy or edits) are saved after Step 4.
4
Click Save to save the changes made to the default properties.
 
* 
IMPORTANT: Changes (new copy or edits) are now saved to the server, provided that the copy or edited version is the one selected in the drop-down to be used by the currently-selected agent. Changes that involve default properties that are not used by this agent are discarded.
To edit the shared agent type properties:
1
Click Edit Shared Agent Properties.
The Shared Properties dialog box appears.
2
From the Agent Type list, select whether you want to change the properties shared by Windows, UnixAgentPlus, UNIX, or MultiHostProcessMonitorAgent agents.
The dialog box refreshes to display the properties specific to the selected agent type. The following illustration shows the shared properties for Windows agents.
The following illustration shows the shared properties for UnixAgentPlus agents.
The following illustration shows the shared properties for Unix agents.
The following illustration shows the shared properties for MultiHostProcessMonitor agents.
For detailed information about Foglight for Infrastructure agents and their properties, see About the WindowsAgent, About the UnixAgentPlus, About the UnixAgent, and About the MultiHostProcessMonitorAgent.
3
Update the agent’s properties, by selecting other properties from the drop-down lists, by creating new lists, or by editing the existing ones.
Clicking the View button on the right side of a shared property opens the Agent Property List dialog box, which lists the property rows. From here, you can click:
•
Edit: allows you to edit the currently selected property list, by adding and removing rows.
•
Copy: allows you to edit the displayed properties and save the copy as a new property list. When saved, the copy becomes the selected item in the drop-down list.
 
* 
IMPORTANT: When you click Save in the Agent Property List dialog box, nothing is persisted on the server. Changes (new copy or edits) are saved after Step 4.
Clicking the Delete button on the right side of a shared property deletes the property list currently selected in the drop-down. Default property lists cannot be deleted from the system.
4
Click Save to save the changes made to the shared properties.
 
* 
IMPORTANT: Changes (new copy or edits) are now saved to the server, provided that the copy or edited version is the one selected in the drop-down to be used by the currently-selected agent. Changes that involve shared properties that are not used by this agent are discarded.
To edit the agent properties for a single agent:
1
Select the check box for that agent on the Agents table.
2
Click Edit Agent.
The Edit Agent dialog box appears.
3
Update the agent’s properties, then click Save.
The list of properties may vary depending on the agent type. The following illustration shows the properties for a WindowsAgent.
The following illustration shows the properties for a UnixAgentPlus.
The following illustration shows the properties for a UnixAgent.
The following illustration shows the properties for a MultiHostProcessMonitorAgent.
For detailed information about Foglight for Infrastructure agents and their properties, see About the WindowsAgent, About the UnixAgentPlus, About the UnixAgent, and About the MultiHostProcessMonitorAgent.
To edit the agent properties for multiple agents:
1
Select the check boxes for these agents on the Agents table.
 
* 
NOTE: The selected agents must be monitored by the same Foglight for Infrastructure agent type.
2
Click Edit Agent.
 
* 
NOTE: If the agents selected are monitored by a mix of Windows® and UNIX® agents, a warning message is displayed.
The Edit Agent Properties dialog box appears. The list of properties may vary depending on the agent type. The following illustration shows the properties for WindowsAgent.
The following illustration shows the properties for UnixAgentPlus.
The following illustration shows the properties for UnixAgent.
The following illustration shows the properties for MultiHostProcessMonitorAgent.
For detailed information about Foglight for Infrastructure agents and their properties, see About the WindowsAgent, About the UnixAgentPlus, About the UnixAgent, and About the MultiHostProcessMonitorAgent.
3
Select the monitoring agent that should be used as a starting point for editing the properties for this agent type. From the drop-down list, select Use Agent Type Defaults or one of the available host names.
The Edit Agent Properties dialog box refreshes to show the properties for the selected agent.
4
Update the agent’s properties, as needed. Select the check boxes for the fields that need to be edited, then select the options you want from the drop-down lists.
Clicking the View button on the right side of a property opens a pop-up which lists the property rows.
5
Click Save to save the changes made to the agent properties.

Rule Configuration

The Rule Configuration view of the Infrastructure Environment dashboard contains links to rules and alarms tasks that you can use to manage Infrastructure rules and alarms.

* 
NOTE: This Rule Configuration view is only available in the Foglight Management Server 5.9.2 or later.

The Rule Configuration view consists of the following:

•
Rules view
•
Enabling/Disabling rule(s)
•
Adding a custom rule
•
Removing custom rule(s)
Rules view

By default, the following columns are displayed in the Rules view:

•
Enabled: Indicates if the rule is enabled or disabled . You can sort the list of rules by state, by clicking the Enabled column.
•
Rule: Contains the rule name. Click the rule name to start the workflow for viewing and editing rule details.
•
Fatal , Critical , and Warning thresholds (multiple-severity rules only):
•
For expressions that include one registry variable, these columns contain the current value of that variable. Click the value to edit it.
•
For expressions that include multiple registry variables, the column contains an icon . Clicking that icon shows the list of referenced registry variables and their values. Click a value to edit it.
•
For expressions that do not include any registry variables, this column contains an icon . Clicking that icon navigates to the Edit Rule dashboard.
•
For rule states that do not have a conditional expression defined, this column is empty.
•
Alarms: Contains the number of alarms (multiple-severity rules only) generated by the rule. Clicking that column shows a list of alarms indicating for each alarm its severity, when the alarm was generated, and the alarm message.
•
Applies to: Shows the object name that is applied to this custom rule.
•
Description: Contains the rule description.
Enabling/Disabling rule(s)

The Rule Configuration dashboard shows a list of existing rules and a set of rule management commands at the top of the list. Use the Enable Rule and Disable Rule buttons to activate or deactivate one or multiple rules at once.

To enable a rule:
1
Log in to the Foglight browser interface.
2
Ensure that the navigation panel is open.
To open the navigation panel, click the right-facing arrow on the left.
3
On the navigation panel, under Dashboards, click Infrastructure.
The Infrastructure dashboard opens.
4
Click Administration > Rule Configuration.
The Rule Configuration dashboard opens.
5
On the Rules list, select one or more check boxes in the left-most column, and then click Enable Rule.
The Enable Rules dialog box opens.
6
In the Enable Rules dialog box, click Yes.
The Rules list refreshes with the rules’ status updated automatically.
To disable a rule:
1
Log in to the Foglight browser interface.
2
Ensure that the navigation panel is open.
To open the navigation panel, click the right-facing arrow on the left.
3
On the navigation panel, under Dashboards, click Infrastructure.
The Infrastructure dashboard opens.
4
Click Administration > Rule Configuration.
The Rule Configuration dashboard opens.
5
On the Rules list, select one or more check boxes in the left-most column, and then click Disable Rule.
The Disable Rules dialog box opens.
6
In the Disable Rules dialog box, click Yes.
The Rules list refreshes with the rules’ status updated automatically.
Adding a custom rule

The Rule Configuration dashboard shows a list of existing rules and a set of rule management commands at the top of the list. Use the Add Custom Rule button to create a new rule as needed.

To customize a rule:
1
Log in to the Foglight browser interface.
2
Ensure that the navigation panel is open.
To open the navigation panel, click the right-facing arrow on the left.
3
On the navigation panel, under Dashboards, click Infrastructure.
The Infrastructure dashboard opens.
4
Click Administration > Rule Configuration.
The Rule Configuration dashboard opens.
5
Click Add Custom Rule on the Rules table.
The Create Custom Rule dialog box opens.
6
In the Create Custom Rule dialog box, specify the following:
a
Alarm Type:
a
Type the name of custom rule in the Name field.
b
Select an Object Type, and then select a metric from the Metric drop-down list. The value of Metric varies from the Object Type.
c
Select either Threshold or % Change, and then specify the following values as needed.
•
Threshold: Specify Condition, Time Period, Severity, and then specify whether or not fire actions if the specified data attempts are reached. The value of Condition cannot be negative.
•
% Change: Specify Condition, Time Period, and Severity Label. The value of Condition cannot be negative.
b
(Optional) Scope: Choose the objects to which you want to apply this rule. If no objects are selected in this step, the custom rule will apply to all objects which type is the Object Type specified in Step 6.
c
(Optional) Notifications: Click Add New, then the Edit Notification Config - Dialog box appears. In this dialog box, type the E-mail Address and Description as needed, and then click Add.
7
Click Save.
The Rules table refreshes automatically to show the newly added rule.
Removing custom rule(s)

The Rule Configuration dashboard shows a list of existing rules and a set of rule management commands at the top of the list. Use the Remove Custom Rule button to delete existing custom rule(s) as needed.

To remove a custom rule:
1
Log in to the Foglight browser interface.
2
Ensure that the navigation panel is open.
To open the navigation panel, click the right-facing arrow on the left.
3
On the navigation panel, under Dashboards, click Infrastructure.
The Infrastructure dashboard opens.
4
Click Administration > Rule Configuration.
The Rule Configuration dashboard opens.
5
Click Remove Custom Rule on the Rules table.
The Remove dialog box opens.
6
Click Yes.
The Rules table refreshes automatically and removes the selected rule.

Using Foglight for Infrastructure agents

Foglight for Infrastructure uses agents to collect information about the monitored hosts. Agents communicate with the Foglight Management Server using the Foglight Agent Manager.

For more information, see these topics:

•
Configuring Multiple Instances for Monitoring using Silent Installation
•
Using the UnixAgentPlus
•
Monitoring remote hosts
•
Deploying Foglight for Infrastructure agents
•
Creating agent instances
•
Defining credentials
•
Activating the agent
•
Monitoring the infrastructure
•
Adding a monitored host
•
Adding multiple monitored hosts

Configuring Multiple Instances for Monitoring using Silent Installation

Foglight for Infrastructure silent installation uses scripts and a CSV file to setup multiple Infrastructure agents on a given Foglight Agent Manager (FglAM). The CSV file defines the instances to be created. For more information, see Contents of the Input CSV File .

* 
NOTE: Foglight for Infrastructure silent installation only supports the following agent types: WindowsAgent, UnixAgent, and UnxiAgentPlus.
Prerequisite
•
A running Foglight Management Server
•
At least one FglAM process running on the selected Foglight Management Server
•
An Infrastructure cartridge installed

To add multiple agents using the silent installation through a command line interface:

1
Navigate to Administration > Cartridges > Components for downloads.
2
Download the Infrastructure_Command_Line_Installer file to a temporary folder.
The Infrastructure_Command_Line_Installer.zip file contains the following files:
•
README.txt
•
infrastructure_agents_silent_install.groovy
A groovy script file that runs the command line installation. This file should be extracted to the <FMS_HOME>/bin/ directory.
•
infrastructure_agents_input_template.csv
A template file that serves as the basis for the input CSV file. This file can be extracted to any folder of your choice, provided that the instance file name points to the selected path.
3
Extract the Infrastructure_Command_Line_Installer.zip file to a temporary folder.
4
Extract infrastructure_agents_silent_install.groovy to the <FMS_HOME>/bin/ directory.
5
Go to the command line and run the command: <FMS_HOME>/bin/fglcmd -srv <fms_host_name> -port <fms_url_port> -usr <fms_user_name> -pwd <fms_user_password> -cmd script:run -f infrastructure_agents_silent_install.groovy fglam_name <fglam_name> instances_file_name <instances_file_name> lockbox_name <lockbox_name> lockbox_password <lockbox_password>
The descriptions of the flags and parameters in this command are as follows:
•
<FMS_HOME>: The Foglight Management Server installation directory.
•
<fms_host_name>: The host name where the Foglight Management Server is installed.
•
<fms_url_port>: The Foglight Management Server port.
•
<fms_user_name>: The user name used for connecting to the Foglight Management Server.
•
<fms_user_password>: The password of the specified user.
•
<fglam_name>: The name of the selected FglAM to add the new agents.
•
<instances_file_name>: The full path and the name of the input CSV file.
* 
NOTE: If the full path contains spaces, instances_file_name must be quoted.
•
<lockbox_name>: Optional - Specifies the name of an existing lockbox that would be used.
•
<lockbox_password>: Optional - The selected lockbox's password.
Contents of the Input CSV File

The CSV file contains data regarding a list of instances to monitor.

 
 
Table 1. Input CSV File
Name

Description

Agent Name (Optional)

The required Infrastructure agent name.

If no value is entered in this field, a default value from the template will be imported as follows: Monitor@ + hostName.

For example: for the host name MyHost, an agent will be created with the name Monitor@MyHost

Host Name

The target host name or IP address to be monitored.

Host Name Override (Optional)

The host name to be used to store this host’s data in the Foglight data model.

OS Type

The operating system of the monitored host.

The possible value includes: Windows, Linux, Solaris, AIX, and HP-UX.

Virtual/Guest (Optional)

Specifies whether the monitored host is a virtual machine.

The possible values are either True or False.

If no value is entered in this field, the default value False will be used.

If this filed is set to True, it will not collect metrics for CPU, Memory, Network, and Disk.

SSH Port (Optional)

SSH port the agent is connected to.

If no value is entered in this field, it will use the default value 22.

OS Domain (Optional)

The domain name of your Windows environment (if configured in your environment).

OS User Name

The user name required for connecting to the operating system.

OS Password

The password for the user of the operating system specified above.

Contents of the Installation Command Line Output File
 
 
Table 2. Command Line Output File
Name

Description

Status

A CSV file that specifies the monitoring output of all given instances from the input CSV file: original file name + output.csv.

Agent Name

The name of the monitored Infrastructure agent.

Agent Type

The agent type of the monitored Infrastructure agent.

Target Host

The target host name or IP address monitored by Infrastructure agent.

Creation Status

Specifies whether the Infrastructure agent was created successfully or failed. The possible values are either Successful or Failed.

Credential Error Message

An error message in case the credential creation failed.

Creation Error Message

An error message in case the agent creation failed.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating