Chat now with support
Chat with Support

Foglight for Infrastructure 5.9.5 - 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:

•
Using the PowerVM HMC agent
•
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

Using the PowerVM HMC agent

Foglight™ for PowerVM allows you to monitor IBM® PowerVM® environments. Foglight alerts you about infrastructure problems as soon as they develop, enabling you to resolve issues pro actively before end users are affected. Early intervention ensures consistent application performance at established service levels. Foglight for PowerVM monitors the health of your virtual system by tracking the levels of resource utilization such as CPU, network, and memory consumption of individual objects in your integrated environment.

To monitor a collection of PowerVM® servers, you need a running instance of the PowerVM HMC Agent. This agent is provided with Foglight for PowerVM.

For detailed information about monitoring a PowerVM infrastructure, see Monitoring IBM PowerVM environments.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating