Job Management Partner 1/Performance Management - Agent Option for Virtual Machine Description, User's Guide and Reference

7.2.5 Performance data collection and management

This subsection describes troubleshooting related to performance data collection and management procedures of Performance Management.

Organization of this subsection

(1) Even though a short data retention period was set, the size of the PFM - Agent Store database is not reduced

(2) The message "Illegal data was detected in the Store database" is output to the common message log

(3) No performance data is collected even when PFM - Agent is started

(4) There is a large time difference between Record Time and Sampling Time

(1) Even though a short data retention period was set, the size of the PFM - Agent Store database is not reduced

If the file capacity of the Store database has already reached its limit in Store Version 1.0, setting a shorter data retention period will not reduce the file size. In this case, set a shorter retention period first, back up the Store database, and then restore it.

For details about how to set the data retention period, see the chapter that explains management of operation monitoring data in the Job Management Partner 1/Performance Management User's Guide. For details about how to back up and restore the Store database, see the chapter that explains backup and restoration in the Job Management Partner 1/Performance Management User's Guide.

(2) The message "Illegal data was detected in the Store database" is output to the common message log

It is suspected that an unexpected service stoppage or machine shutdown generated invalid data in the Store database. Take the following actions:

If the Store database has been backed up, restore it.

If the Store database has not been backed up, first stop Agent Store, delete the corresponding database files (*.DB and *.IDX files), and then restart the service.

(3) No performance data is collected even when PFM - Agent is started

The items to check and the actions to be taken are described below for each monitored virtual environment.

(a) For VMware

If you are monitoring information of a virtual machine running on VMware, check the following items:

Make sure that VMware Tools is running on the monitored virtual machine.

If you change the time on a physical server on which VMware is running. performance data may not be collected in some cases. In such cases, start the mgmt-vmware service.

If the Status field value of a PD record shows ERROR, take an action based on the value in the Reason field. The table below shows the actions to be taken.

Table 7-2 Reason field value and actions to be taken

Reason field value Explanation Action

Connection failed An attempt to connect to the target virtual environment failed.

Check whether the host of the virtual environment is active.

Check whether the following items, which were specified during setup of the instance environment, are valid:^#
VM_Type
VM_Host
Security
Port

Check whether the host name (VM_Host), which was specified during setup of the instance environment, can be resolved.

If SSL is used for communication with the virtual environment (1 is set in Security), check whether a certificate has been embedded. In PFM - Agent for Virtual Machine, you must embed a certificate for each monitored host for which an instance was generated.

Check whether the communication method that was specified for Security during setup of the instance environment is permitted on the virtual environment side. For example, if Security=1 (to use SSL) is specified, HTTPS connection must be permitted on the virtual environment side.
In some cases, the virtual environment side can be set to redirect HTTP connection to HTTPS connection (httpsWithRedirect for VMware).
If redirecting is enabled, HTTPS connection will succeed, but HTTP connection will fail. Therefore, in the instance environment setup, specify Security=1 (to use SSL), and use HTTPS connection.
For details about how to set a communication method for a virtual environment, see the VMware documentation.

Make sure that the user ID that was specified for UserID during setup of the instance environment has at least read-only permissions for VMware roles. For details about how to check permissions, see the VMware documentation.

Authorization failed Authorization failed at the target virtual environment.

Check whether the host of the virtual environment is active.

Check whether the following items, which were specified during setup of the instance environment, are valid:^#
UserID
Password

Timeout Performance data collection did not end within the specified time.

Check whether the host of the virtual environment is active.

Check whether the following items, which were specified during setup of the instance environment, are valid:^#
VM_Type
VM_Host
Security
Port
UserID
Password

Check whether the host name (VM_Host) which was specified during setup of the instance environment, can be resolved.

If SSL is being used for communication with the virtual environment (1 is set in Security), make sure that a certificate has been embedded. In PFM - Agent for Virtual Machine, a certificate must be embedded in each monitored host for which an instance was generated.

If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

Collection Error A collection error occurred.

Check whether the following items that were specified during setup of the instance environment are correct:^#
HostUserID
HostPassword
HostDomain

If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

#

To check an item that has been set, execute the jpcconf inst setup command. Alternatively, on PFM - Web Console, view the Agent Configuration properties from the Agent Collector service of PFM - Agent for Virtual Machine.

In all other cases, collect maintenance data and then contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

(b) For Hyper-V

If the Status field value of a PD record shows ERROR, take action as indicated by the value in the Reason field. The table below shows the actions to be taken.

Table 7-3 Reason field value and actions to be taken

Reason field value Explanation Action

Connection failed Attempt to connect to the target virtual environment failed.

Check whether the host of the virtual environment is active.

Check whether the following items that were specified during setup of the instance environment are correct:^#
VM_Type
VM_Host
Domain

Check whether the host name (VM_Host) that was specified during setup of the instance environment can be resolved.

Check whether the WMI connection has been set up correctly. In PFM - Agent for Virtual Machine, WMI connection must be set up for each monitored host for which an instance was generated.

Authorization failed Authorization failed at the target virtual environment.

Check whether the host of the virtual environment is active.

Check whether the following items that were specified during setup of the instance environment are correct:^#
UserID
Password

Timeout Performance data collection did not end within the specified time.

Check whether the host of the virtual environment is active.

Check whether the following items that were specified during setup of the instance environment are correct:^#
VM_Type
VM_Host
UserID
Password
Domain

Check whether the host name (VM_Host) that was specified during setup of the instance environment can be resolved.

Check whether the WMI connection has been set up correctly. In PFM - Agent for Virtual Machine, WMI connection must be set up for each monitored host for which an instance was generated.

If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

Collection Error A collection error occurred.

Check whether the following items that were specified during setup of the instance environment are correct:^#
HostUserID
HostPassword
HostDomain

If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

#

Use the jpcconf inst setup (jpcinssetup) command to check what has been set for an item. Alternatively, the Agent Configuration properties from the Agent Collector service of PFM - Agent for Virtual Machine can be viewed on PFM - Web Console.

In all other cases, collect maintenance data and then contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

Reason field value	Explanation	Action
Connection failed	An attempt to connect to the target virtual environment failed.	Check whether the host of the virtual environment is active. Check whether the following items, which were specified during setup of the instance environment, are valid:^# VM_Type VM_Host Security Port Check whether the host name (VM_Host), which was specified during setup of the instance environment, can be resolved. If SSL is used for communication with the virtual environment (1 is set in Security), check whether a certificate has been embedded. In PFM - Agent for Virtual Machine, you must embed a certificate for each monitored host for which an instance was generated. Check whether the communication method that was specified for Security during setup of the instance environment is permitted on the virtual environment side. For example, if Security=1 (to use SSL) is specified, HTTPS connection must be permitted on the virtual environment side. In some cases, the virtual environment side can be set to redirect HTTP connection to HTTPS connection (httpsWithRedirect for VMware). If redirecting is enabled, HTTPS connection will succeed, but HTTP connection will fail. Therefore, in the instance environment setup, specify Security=1 (to use SSL), and use HTTPS connection. For details about how to set a communication method for a virtual environment, see the VMware documentation. Make sure that the user ID that was specified for UserID during setup of the instance environment has at least read-only permissions for VMware roles. For details about how to check permissions, see the VMware documentation.
Authorization failed	Authorization failed at the target virtual environment.	Check whether the host of the virtual environment is active. Check whether the following items, which were specified during setup of the instance environment, are valid:^# UserID Password
Timeout	Performance data collection did not end within the specified time.	Check whether the host of the virtual environment is active. Check whether the following items, which were specified during setup of the instance environment, are valid:^# VM_Type VM_Host Security Port UserID Password Check whether the host name (VM_Host) which was specified during setup of the instance environment, can be resolved. If SSL is being used for communication with the virtual environment (1 is set in Security), make sure that a certificate has been embedded. In PFM - Agent for Virtual Machine, a certificate must be embedded in each monitored host for which an instance was generated. If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.
Collection Error	A collection error occurred.	Check whether the following items that were specified during setup of the instance environment are correct:^# HostUserID HostPassword HostDomain If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

Reason field value	Explanation	Action
Connection failed	Attempt to connect to the target virtual environment failed.	Check whether the host of the virtual environment is active. Check whether the following items that were specified during setup of the instance environment are correct:^# VM_Type VM_Host Domain Check whether the host name (VM_Host) that was specified during setup of the instance environment can be resolved. Check whether the WMI connection has been set up correctly. In PFM - Agent for Virtual Machine, WMI connection must be set up for each monitored host for which an instance was generated.
Authorization failed	Authorization failed at the target virtual environment.	Check whether the host of the virtual environment is active. Check whether the following items that were specified during setup of the instance environment are correct:^# UserID Password
Timeout	Performance data collection did not end within the specified time.	Check whether the host of the virtual environment is active. Check whether the following items that were specified during setup of the instance environment are correct:^# VM_Type VM_Host UserID Password Domain Check whether the host name (VM_Host) that was specified during setup of the instance environment can be resolved. Check whether the WMI connection has been set up correctly. In PFM - Agent for Virtual Machine, WMI connection must be set up for each monitored host for which an instance was generated. If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.
Collection Error	A collection error occurred.	Check whether the following items that were specified during setup of the instance environment are correct:^# HostUserID HostPassword HostDomain If the cause cannot be determined, collect maintenance data and contact the system administrator. For details about how to collect maintenance data, see the chapter that explains troubleshooting in the Job Management Partner 1/Performance Management User's Guide.

(4) There is a large time difference between Record Time and Sampling Time

Because Sampling Time is the time in the monitored virtual environment, a slight time deviation may occur in normal operations. If the time deviation is large enough to cause an operational problem, check the following items:

Is the time set on the agent host different from that set in the monitored virtual environment?
If they are different, they need to be synchronized. Before changing the time settings, carefully read the notes related to the OS of the agent host and the virtual environment software.

If SSL is being used for communication with the virtual environment, has a certificate been embedded?
If a certificate has not been embedded correctly, information collection may be delayed. See 2.5.1 For VMware, and correctly embed a certificate in the agent host. For details about how to embed a certificate in a monitored virtual environment, see the documentation for the virtual environment software.

[Contents][Back][Next]

[Trademarks]