Chat now with support
Chat with Support

Foglight for Hyper-V 5.8.3 - User Guide

About Foglight for Hyper-V Agent administration Performance monitoring with the Hyper-V Environment dashboard Performance investigation with the Hyper-V Explorer Foglight for Hyper-V alarms Appendix: Hyper-V Agent error codes

Configuring monitoring agents

Foglight® for Hyper-V uses the Hyper-V, SCVMM, and SOFS agents to collect information about your virtual environment:

Hyper-V Agents collect information from monitored Hyper-V servers. A Hyper-V server is a physical component required to begin building a virtual infrastructure. Hyper-V servers provide hypervisor-based architecture for controlling and managing resources for the virtual machines that run on it.
SCVMM Agents collect information from Virtual Machine Managers (VMM). A VMM allows you to manage host, networking, and storage resources when creating and deploying virtual machines to virtual clouds.
SOFS Agents collect information from monitored SOFS servers. A SOFS server is a Windows Server cluster with some form of shared storage. SOFS servers provide highly available file-based storage for applications and general use.

When Hyper-V, SCVMM, and SOFS agent packages are successfully deployed, you can create agent instances, activate them, and start their data collection. To perform these steps in a single operation for one or more monitored hosts, use the Agents area on the Administration tab .

When you add an agent instance, the agent process is created on the Agent Manager host. Activating the agent instance starts that agent process. When you start an agent’s data collection, the agent process starts collecting data from the monitored host and to sends it to Foglight for Hyper-V.

2
On the navigation panel, under Dashboards, choose Hyper-V > Hyper-V Environment.
4
On the Administration tab, under Agents, open the Hyper-V Agents, the SCVMM Agents tab, or the SOFS Agents tab, as required.
5
Click Add to launch the Agent Setup wizard.
The Agent Setup wizard appears, showing the Prepare page.
The Agent Setup wizard refreshes, showing the Select FglAM Client page. The page shows a list of all hosts that already have the Agent Manager installed and running, and to which you can deploy the Hyper-V Agent package.
8
Hyper-V Agents only. On the Discover or Manual page that appears, you can indicate if you want to manually specify the Hyper-V Server that you want to monitor, or to choose between the servers running in a given domain.
Discover. Select this option if you want to choose from the available Hyper-V Servers running in the desired domain. Click Next and proceed to Step a.
Manual. Select this option if you want to manually specify the name of the Hyper-V Server. Click Next and proceed to Step b.
a
Discovering Hyper-V Servers only. On the Enter Domain Credentials page that appears, specify the information needed to search for the running Hyper-V Servers.
Domain: Type the fully qualified name of a domain to search for the Hyper-V Server. For example, myDomain.com.
User: Type the user name to be used by the agent to be used to query Active Directory on the selected domain using the syntax Domain\UserName. For example, myDomain\jsmith.
Password: Type the password associated with the above user name.
Enable SSL for LDAP. Select this option to enable SSL for LDAP connection.
The Agent Setup wizard refreshes, showing the Select Servers page. The page shows a list of all Hyper-V servers that you have access to, based on the domain name and user credentials you provided in this step.
The Agent Setup wizard refreshes, showing the Agent Properties page.
b
Manually specifying a Hyper-V Server only. On the Manual Agent Properties page that appears, specify the information needed to search for the running Hyper-V servers.
Click Next.
c
On the Credential Verification page that appears, review the existing set of credentials. If the wizard determines that the selected Agent Manager has any credentials configured for the host on which the Hyper-V Server is running, they appear listed on this page.
9
SCVMM Agents only. On the Input Agent Properties page that appears, type the name of the SCVMM server, and click Next.
10
On the Credentials Verification page that appears, select one of the following options:
Do not configure a credential: Select this option if you want to configure the credential for this resource at a later time. Click Next and continue with Step 13.
Add host(s) to a new credential: Select this option if you want to add the host to a new credential. This option is suitable if none of the existing credentials have the connection details needed to access the new host. Click Next and continue with Step 11.
Add host(s) to an existing credential: Select this option if you want to add the host to an existing credential. This option is suitable if an existing credential has the security data needed to access the new host, but you need to edit its resource mappings to include this host. Click Next and continue with Step 12.
a
On the Credential Type page that appears, select the credential type from the available options.
b
Click Next.
The Credential Properties page appears.
c
On the Credential Properties page, type the required properties, and click Next.
The Credential Name and Lockbox page appears.
d
On the Credential Name and Lockbox page, provide a name to uniquely identify the credential, and select a lockbox in which you want to keep the credential. A lockbox can be used to group credentials for access and/or security. In smaller Foglight installations, using the default System lockbox should be sufficient.
Click Next.
The Resource Mapping page appears.
e
On the Resource Mapping page, indicate which hosts you want to associate with this credential. Click Next.
The Policies page appears.
f
Optional—On the Policies page, define one or more policies for this credential. A policy defines the number of times a credential can be used, the number of allowed authentication failures, the time range during which the credential is valid, or the length of time the credential data can be cached on the client. For example, you can specify the number of times the credential can be used, or the time period during which it can be used. For complete information about the available credential policies, see the Administration and Configuration Help.
g
Click Next and proceed to Step 13.
a
On the Credential page that appears, select an existing credential to contain this host.
b
Click Next.
The Resource Mapping page appears.
c
On the Resource Mapping page, indicate which hosts you want to associate with this credential. You can either select the host that you are about to start monitoring, all monitored hosts, or hosts whose name contains a specific text string.
d
Click Next and proceed to Step 13.
13
On the Connectivity Diagnostic page that appears, select the Hyper-V servers you want to diagnose connectivity and click Next to perform diagnostic. If no connectivity diagnostic is required, unselect any Hyper-V servers and click Next.
Wait for a few seconds until the Connectivity Diagnostic Result page appears. Click the Diagnostic Result and the Connectivity Diagnostic Result Detail page appears. Click on the failed items to see the possible reasons.
Click Next after connectivity diagnostic completes.
14
On the Summary page that appears, review the information provided about the host and the monitoring agent.
15
Click Finish.
Close the dialog box. The Administration tab dashboard refreshes, showing the newly created Hyper-V Agent in the list.
a
The Edit Agent Tab Manager dialog box appears, showing the Hyper-V Agent properties on the Agent Properties tab.
c
Open the Credentials tab, and review the available credentials.
New credentials. Click New Credential and use the Create Credential Wizard that appears to provide the required information. For more details, see Step 11.
Existing credentials. Click Add to Existing Credential and use the Create Credential Wizard that appears to provide the required information. For more details, see Step 12.
19
Click Refresh.
The Active and Data Collection columns show green check marks indicating that the agents are active and collecting data.

Configuring agent properties

 

The Hyper-V, SCVMM, and SOFS Agents collect data from your virtual infrastructure and sends it to the Management Server. The agents keep track of resource utilization metrics and alerts you when certain pre-defined thresholds are reached.

When an agent connects to Foglight Management Server, it is provided with sets of properties that it uses to configure its correct running state. Each agent is provided with a combination of two types of properties: agent properties and shareable properties.

Default versions of these properties are installed with Foglight® for Hyper-V. However, you can edit the default shareable and agent properties, configure agent properties that apply only to a specific agent instance, and create edited clones of shareable properties that are used by a subset of agents of a certain type.

There are two ways to access the Hyper-V, SCVMM, and SOFS Agent properties:

On the Hyper-V Environment dashboard, on the Administration tab, select an agent instance and click Edit Properties (see Configuring monitoring agents ).
NOTE: This method only allows you to edit the Configuration properties, but not the Data Collection Scheduler properties.
On the Agent Status dashboard, select an agent instance and click Edit Properties. This method provides access to the full set of Hyper-V Agent properties, and is described in this topic.

For more information about working with agent properties, see the Administration and Configuration Help.

To modify the Hyper-V/SCVMM/SOFS Agent agent properties using the Agent Status dashboard:
a
On the navigation panel, under Dashboards, select Administration > Agents > Agent Status.
The position of the Properties pane depends on the dashboard you used to access agent properties. If you used the Agent Properties dashboard, the Properties pane appears to the right of the Namespace > Type pane in the display area. If you used the Agent Status dashboard, the Properties pane appears across the display area.

Setting the Hyper-V Agent Configuration properties

To monitor a desired Hyper-V® server, ensure the Hyper-V Agent’s Configuration properties are set up as required.

1
Locate the Hyper-V Agent’s Configuration properties.
2
Set the Configuration properties as follows:
Host Name: Type the fully qualified host name of the machine on which the monitored Hyper-V Server is running.
Collect CPU metrics: Select this option if you want to collect CPU metrics from the monitored Hyper-V environment.
Collect disk metrics: Select this option if you want to collect disk metrics from the monitored Hyper-V environment.
Collect memory metrics: Select this option if you want to collect memory metrics from the monitored Hyper-V environment.
Collect network metrics: Select this option if you want to collect network metrics from the monitored Hyper-V environment.
Enable FSM Integration: Select this option if you want to enable the integration with Foglight for Storage Management.
Enable Storage Space Direct Collection. Select this option if you want to collect Storage Space Direct (S2D) metrics from the monitored Hyper-V environment.
Connection Type. Specify the connection type. Quest recommends using WinRM as the connection type, as DCOM will be removed in future release.
WinRM port. Type the port number of WinRM.
Use HTTPs. Select this option if you want to use the HTTPS protocol.
Inventory update request timeout (sec): Type the number of seconds after an inventory collection times out.
Connection timeout (sec): Type the number of seconds after a connection times out.
WMI request timeout (sec): Type the number of seconds after a WMI request times out.

Setting the SCVMM Agent Configuration properties

To monitor a desired System Center Virtual Machine Manager (SCVMM), ensure the SCVMM Agent’s Configuration properties are set up as required.

1
Locate the SCVMM Agent’s Configuration properties.
2
In the Configuration area, in the SCVMM Host Name box, type the name of the machine on which the Virtual Machine Manager is running.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating