Chat now with support
Chat with Support

Foglight for OpenStack 5.7.4 - User Guide

Using Foglight for OpenStack Interacting with Foglight for OpenStack dashboards Reference

Set Alarm Sensitivity Level

Sets the level of alarms that the system generates, stores, and displays.

To set the alarm sensitivity level:
1
Log in to the Foglight browser interface. On the navigation panel, click Dashboards > OpenStack Environment.
2
On the OpenStack Environment dashboard that appears in the display area, open the Administration tab.
3
On the Administration tab, click Set Alarm Sensitivity Level.
The Set Alarm Sensitivity Level dialog box appears.
4
In the Set Alarm Sensitivity Level dialog box, select the desired sensitivity level: Essential, Normal, or Tuning.
5
Click Save.
The Set Alarm Sensitivity Level dialog box closes.

Review Instances

Review existing OpenStack object instances. The list displays the Object Type and Count.

Review Expired Data

Review and delete OpenStack object instances that are no longer needed.

To review and delete expired data:
1
On the OpenStack Environment dashboard, open the Administration tab.
2
On the Administration tab, click Review Expired Data.
The Expired Data Removal Wizard dialog box appears.
3
In the Expired Data Removal Wizard dialog box, select the object type that you want to review, and type the number of days during which the object instances were not updated.
4
Click Next.
The Expired Data Removal Wizard dialog box refreshes, showing the object instances that meet the specified requirements.
5
Observe the results.
•
If you want to delete all the object instances, click Next.
•
If you want to modify your search, click Previous, make your changes, and observe your results again. For example, to show fewer instances, click Previous, and increase the time period. When satisfied, click Next.
•
If you do not want to delete any objects, click Next.
The Expired Data Removal Wizard dialog box refreshes.
6
To delete the selected object instances, select the check box.
7
Click Finish.

Agents view

The Agents view has three tabs for embedded agents. Each tab shows a list of existing agent instances and agent management buttons at the top of the table.

Foglight Agents tab

Foglight for OpenStack uses agents to collect information about the monitored hosts.

The Foglight Agents view shows a list of all configured Foglight agent instances. The following buttons are available on the table:

•
Add — starts a workflow for creating agent instances.
•
Refresh — refreshes the list of agent instances and their states.
•
Activate­—activates one or more selected agent instances. Activating an agent instance starts the agent process on the machine on which the agent is installed.
•
Deactivate — deactivates one or more selected agent instances. Deactivating an agent stops the agent process on the machine on which the agent is installed.
•
Start Data Collection — the active Foglight Agent begins to monitor your OpenStack environment and send data about it to the Foglight Management Server.
•
Stop Data Collection — stops the data collection for one or more selected agent instances.
•
Remove — deletes the selected agent instance.
•
Update Agent — upgrades the agent to a new version, after a new cartridge is installed.
* 
NOTE: When a newer Foglight for OpenStack version is installed on your system, the Agent Version column in the Agents table is updated to read Update Agent. To apply the new features, update the agents to the latest version. You can upgrade the agents one by one, by selecting from the table and clicking the corresponding Update Agent link in the Agent version column. You can upgrade all agents at once by selecting all the listed agents and clicking the Update Agent button at the top of the list.
To perform an agent management command, select one or more check boxes in the left-most column and click the appropriate button. For example, to start an agent’s data collection, select the check box in the agent row and click Start Data Collection.
To edit the properties of an agent:
1
Click the Edit Properties icon associated with that agent.
The Edit Properties dialog box appears.
2
Modify the fields, as necessary:
•
User Name — user name, the agent uses to connect to the monitored OpenStack. This user should have administrative privileges to OpenStack.
•
Password — user password.
•
Project — the project on which the user has been granted a role.
•
User domain name — the domain to which the user is associated.
* 
NOTE: Defaults to ‘Default’ if not specified.
•
Project domain name — the domain to which the project is associated.
3
Click Save.
The new settings are saved for the selected agent.

The Download Log button offers a convenient way to get the current log file of the corresponding agent, for review and diagnostics.

Create a Foglight Agent

After installing the Foglight for OpenStack cartridge, you must create a Foglight Agent to communicate with the OpenStack System. Foglight Agents retrieve data about your OpenStack infrastructure resources.

NOTE: Foglight Agents do not retrieve performance data. After creating Foglight Agents, you must configure credentials for the found hosts to retrieve performance data.
To create a Foglight Agent:
1
Click the Add button on the Foglight Agents tab.
The Create Foglight Agent wizard appears, showing the Select Agent Host page.
A list of available Foglight Agent Manager hosts that can be used to collect data is displayed.
2
Select a Foglight Agent Manager host and click Next.
The Select OpenStack Server page is displayed.
3
On the Select OpenStack Server page, enter the following, and then click Next:
•
Server Name — OpenStack (Keystone host) name or IP address.
•
Port — through which a remote host communicates with the system running the Identity service.
* 
NOTE: Pre-populated with the default port for the Identity service (Keystone).
•
Use HTTPS — (optional) use secure communications with the OpenStack server.
The Enter User Credentials page is displayed.
4
On the Enter User Credentials page, enter the following, and then click Next:
•
User Name — user name. The user should have administrative privileges to OpenStack.
•
Password — user password.
•
Project — the project on which the user has been granted a role.
•
User domain name — the domain to which the user is associated.
* 
NOTE: Defaults to ‘Default’ if not specified.
•
Project domain name — the domain to which the project is associated.
* 
NOTE: Defaults to ‘Default’ if not specified.
The Configure Embedded Agents page is displayed.
5
Carefully read the message on the dialog box and then click Finish.
A progress message appears.

When the agent is created, a message indicating successful completion appears.

The Administration tab refreshes, showing the newly created instance of the Foglight Agent in the list.

The agent is activated and data collection starts.

Host Agents tab

After you have completed setting up the Foglight Agent, you start receiving OpenStack topology data which can be viewed by going to the OpenStack Dependency dashboard and navigating down the topology tree on the Infrastructure tab.

The next step is to obtain performance data by setting up host agents.

NOTE: Host Agents collect most but not all the performance data displayed on OpenStack dashboards. Instance Agents are required to retrieve some additional metrics.

The Host Agents tab displays a list of all discovered hosts with the statuses for the embedded agents. A set of host management buttons are available:

•
Refresh — refreshes the list of host agents and their statuses.
•
Credentials — adds or removes the credentials of one or more host agents.
•
Activate — installs the host agent.
•
Deactivate — deletes the host agent.

The Download Log button offers a convenient way to get the current log file of the corresponding agent, for review and diagnostics.

A host agent begins to return performance data from a host once that agent has been assigned the correct credentials.

To configure the credentials for new hosts:
1
Click the Credentials button on the Host Agents tab.
The Embedded Agents Credentials wizard appears.
A list of available host groups is displayed.
2
Click Add.
The Create a New Credential Group wizard appears.
3
Enter a Credential Group Name.
4
Click Add Hosts.
A list of all discovered hosts is displayed.
5
Choose one or more hosts and click Select.
The Create a New Credential Group wizard displays with a refreshed list of related objects.
6
Click Assign a Credential.
7
Choose credentials listed in the Credential Selector dialog box and click Select.
The Create a New Credential Group wizard displays with a refreshed list of assigned credentials.
* 
NOTE: To add more Credentials, go to the Administration dashboard and click Credentials > Manage Credentials > Add.
* 
NOTE: You must provide root credentials for installing the agents into OpenStack compute hosts.
8
Click Save.
The new credential group appears in the Embedded Agents Credentials dialog box.
9
Click Close.
Instance Agents tab
Configure credentials for new instances

The Instance Agents tab shows a list of Instance Agents and a set of management buttons at the top of the list. The following buttons are available:

•
Refresh — refreshes the list of Instance Agents and their statuses.
•
Credentials — adds or removes the credentials of one or more Instance Agents.

The workflow to configure credentials for new instances is the same as clicking the Credentials button on the Host Agents tab. For more information, see Host Agents tab .

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating