To create, activate agent instances, and start their data collection:
1. Log in to the Foglight Evolve Cloud browser interface.
2. On the navigation panel, under
Dashboards, choose
Hyper-V | Hyper-V Agent Administration.
Hyper-V Agent Administration dashboard
3. On the
Administration tab, under
Agents, open the
Hyper-V Agents, the
SCVMM Agents tab, or the
SOFS Agents tab, as required.
4. Click
Add to launch the
Agent Setup wizard.
The
Agent Setup wizard appears, showing the
Prepare page.
5. Review the information on this page.
- If you want to configure WinRM settings automatically, download the appropriate script, and follow the instructions provided with the scripts.
- To configure these settings manually, see the Agent Manager Guide.
When done, click
Next.
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 HyperV Agent package.
6. Select the Agent Manager on which you want to create the Hyper-V Agent instance, and click Next.
7.
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.
Select one of the following options:
- 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
a. Provide the following information, and then click Next.
- 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
NOTE: In FIPS-compliant mode, you need to import the CA certificate or the self-signed certificate to the KeyStore of FMS to use this option
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.
b. Select one or more Hyper-V Servers that you want to monitor and click Next.
The Agent Setup wizard refreshes, showing the Agent Properties page.
c. By default, the options for collecting CPU, disk, memory, and network metrics are selected. Review these settings, and make any changes, if required. When done, click
Next.
d. Proceed to
Step c .
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.
8. SCVMM Agents only. On the Input Agent Properties page that appears, type the name of the SCVMM server, and click Next
9. 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 12 .
- 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 10 .
- 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 11
IMPORTANT: Credentials are security data that provide the Infrastructure agent with the permission to monitor system resources, such as a host or a range of hosts
10 . Create a new credential.
a. On the
Credential Type page that appears, select the credential type from the available options
b. Click
NextThe
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 Evolve Cloud installations, using the default
System lockbox should be sufficient.
NOTE: If a lockbox is password protected and is not released to the target Foglight Agent Manager, you can provide the lockbox password on the last page of the wizard.
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 12 .
Use an existing credential.
a On the
Credential page that appears, select an existing credential to contain this host.
b. Click
NextThe
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 12 .
. 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.
13. On the
Summary page that appears, review the information provided about the host and the monitoring agent.
14. Click
Finish.
The new host is added to the Hosts dashboard after a short delay. The monitoring agent is created. If the operation is successful, the
Agent Setup message box appears. Review the information and close the message box.
The agent instances created to monitor the new host appear on the
Administration tab, in the
Agents area.
Close the dialog box. The Agent Management dashboard refreshes, showing the newly created Hyper-V Agent in the list.
15. If required, reconfigure the agent properties or credentials. For example, you can specify the name of the monitored Hyper-V server or the authentication schema.
When an agent connects to the Management Server, it is provided with sets of properties that it uses to configure its correct running state. Hyper-V Monitoring in Foglight Evolve Cloud stores agent properties on the Management Server.
a Select an agent and click Edit Properties.
The Edit Agent Tab Manager dialog box appears, showing the Hyper-V Agent properties on the Agent Properties tab
NOTE: When multiple agents are selected, you can only edit the properties that are common to all selected agents
b. Review and edit the agent properties, as required.
c. Open the Credentials tab, and review the available credentials.
d. If required, you can create a new credential for this agent, or associate it with an existing credential.
- New credentials. Click New Credential and use the Create Credential Wizard that appears to provide the required information. For more details, see Step 10.
- 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 11 .
16 Activate one or more agents.
On the Agent Management dashboard, select the agents that you want to activate and click
Activate.
17. Start the data collection for one or more agents.
On the Agent Management dashboard, select the agents whose data collection you want to start and click
Start Data Collection.
18. Click
Refresh.
The
Active and
Data Collection columns show green check marks indicating that the agents are active and collecting data.
If the agent unexpectedly fails or stops, this is an indicator of an incorrect configuration. Unknown host names or invalid WinRM configuration can cause the agent to fail. Incorrect configuration causes the agent to stop. If this happens, the agent generates an observation containing a message with more information about the failure. You can view the message contents in the Data Browser. For example, to find out any massages related to the Hyper-V Agent, in the Data Browser, navigate to
Hyper-V | Hyper-V Agents | HYPER-V AGENT INSTANCE | Messages | History | MESSAGE. For more information about the Data Browser, see the
Data Model Guide
