Troubleshoot Splunk App for VMware

1. Review the release notes to determine if the trouble you are experiencing is a known issue.
2. Consider enabling the troubleshooting logs on data collection nodes to facilitate root cause investigation. See Enable troubleshooting logs.
3. Review the following problems for advice on how to resolve them.

Can't edit worker inputs on the remote node, connect to splunkd, or retrieve EAI_new descriptor

• If you are getting "Problem editing the number of worker inputs on the remote node" error in splunk_for_vmware_setup.log
• If you are getting "could connect to splunkd but failed to auth check username and password" error in hydra_scheduler_ta_vmware_collection_scheduler_puff.log
• If you are getting "unable to retrieve the EAI _new descriptor for entity: configs/conf-hydra_metadata" error in splunkd.log
• On scheduler, if you are unable to update or validate the configurations on collection configuration page.

Cause

Splunk user of schedular and DCN does not have admin_all_objects capability added to the splunk_vmware_admin role.

Resolution

Follow the below steps on schedular and DCN.

1. Splunk user which is used to configure the collection configurations and the Splunk user of DCN which is used to configure the DCN must have splunk_vmware_admin role.
2. splunk_vmware_admin role should have admin_all_objects capabilities.

Splunk App for VMware doesn't make read-only API calls to vCenter Server systems

Cause

You do not have the appropriate vCenter Server service login credentials for each vCenter Server.

Resolution

Obtain vCenter Server service login credentials for each vCenter server. See vSphere requirements.

vpxd.stats.maxQueryMetrics error prevents data collection from vCenters

Cause

As of version 6.0 VMware vCenter has added a limitation to the number of performance metrics collected by the vpxd.stats.maxQueryMetrics function. The vCenter 6.0 maxQuerySize limit is 64 metrics per query. This 64 metric limit is calculated by mulltiplying the number of metrics queried by the number of entities (virtual machines) being queried. For example, querying 8 entities (virtual machines) for 10 metrics from each entity (virtual machine) equals a query size of 80.

Resolution

To adjust the maxQuerySize limit:

1. Navigate to the advanced settings of vCenter Server, or vCenter Server Appliance.
2. Edit the config.vpxd.stats.maxQueryMetrics key.
3. Edit the web.xml file.

See the VMware documentation for more information.

You have configured vCenter Server 5.0 in Splunk App for VMware, but no data is coming in

Cause

vCenter Server 5.0 and 5.1 are missing WSDL files that are required for Splunk App for VMware to make API calls to vCenter Server.

• reflect-message.xsd
• reflect-types.xsd

Resolution

Install the missing VMware WSDL files as documented in the vSphere Web Services SDK WSDL workaround in the VMware documentation. Note that the programdata folder is typically a hidden folder.

The individual tests in the deployment section work, but the Splunk App for VMware main dashboard is empty

Cause

This is typically caused by one of two issues:

• Time synchronization issues between the indexer, DCN, and vCenter Server
• Incorrect permissions assignments in Splunk Enterprise

Resolution

• Check for time gaps between the indexer, DCN, and vCenter Server. See Validate vCenter Servers time synchronization settings for details. To adjust or disable the Network Time Protocol (NTP) on your DCN, see Configure additional settings for a DCN.

• Make sure that you have assigned the correct roles to users of Splunk Enterprise.

User	Role
admin user	splunk_vmware_admin
all users of the Splunk App for VMware	splunk_vmware_user

The DCNs are forwarding data using index=_internal tests, but the app is not collecting any API data

Cause

This is typically caused by one of two issues:

• Network connectivity issues from the Scheduler to the DCNs.
• You have not changed the DCN admin account password from its default value.

Resolution

• In the Splunk for VMware App Settings page, verify the accuracy of the settings in the collection page.
• Verify that the admin password for each DCN is not set to changeme.
• Verify that each DCN has a fixed IP address. If Splunk App for VMware uses DCN host names instead of fixed IP addresses, verify that DNS lookups resolve to the correct IP addresses.

Splunk App for VMware works for 60 days, then stops

Cause

The 60-day trial license for Splunk App for VMware has expired.

Resolution

Configure the DCN to join your Splunk Enterprise license pool.

splunk edit licenser-localslave -master_uri https://myhost:8089

Splunk App for VMware seems to be collecting only partial data. Hosts are missing, and so on

Cause

There are insufficient DCNs to handle the data volume coming from the ESXi environment.

Resolution

1. From the Settings page in Splunk App for VMware, review the list of hosts for each vCenter Server environment.

1. Verify that each DCN polls information for up to 40 ESXi hosts and 1,000 virtual machines (30/750 is recommended), based on the specifications for a 4 core DCN (the one configured with the OVA for VMware). Based on this sizing, a site that pulls information from 200 hypervisors and 5,000 VMs needs at least 5 DCNs.

1. Verify that the number of worker processes must be one fewer than the number of CPU cores the vCenter Server system granted to the DCN. For example, if the DCN has four CPU cores, the number of worker processes is three.

1. In the Splunk App for VMware configuration pane for the DCN, make sure that the number of worker processes is one fewer than the number of CPU cores assigned to the machine.

The DCNs are not delivering data to the Splunk Enterprise indexers

Cause

If the DCNs are configured correctly, this problem is typically the result of a connectivity issue.

Resolution

• Make sure that the DCN has an IP address and can resolve DNS.
• Verify that no firewalls are preventing communication between the DCN and port 9997 on the indexers and that the Scheduler can connect to ports 8089 and 8008 on each DCN. On the search head, search index=_internal host=DCN-hostname-here.

Events error in "Host Detail" view when using Splunk Enterprise version 6.0 or later

In the Host Detail view of Splunk Enterprise version 6.0 or later, you see the following warning message:

Events may not be returned in sub-second order due to search memory limits configured in limits.conf:[search]:max_rawsize_perchunk. See search.log for more information.

Or, in search.log of Splunk Enterprise version 6.0 or later, you see the following warning message:

02-06-2014 15:47:04.353 ERROR databasePartitionPolicy - Max Raw Size Limit Exceeded
02-06-2014 15:47:04.467 INFO  UnifiedSearch - Error in 'databasePartitionPolicy': Max Raw Size Limit Exceeded
02-06-2014 15:47:04.467 WARN  CursoredSearch - Events may be returned not in exact sub-second order: M=1368 > N=1250, where M is the number of events read in the 1390841799th second, and N is max number of events to read in a single span. Note that N was scaled back because we exceeded limits.conf:[search]:max_rawsize_perchunk value=100000000

Cause

A bug: non-surppressed error message (SOLNVMW-3587)

Resolution

1. On indexers, add the following configuration in the limits.conf file in the $SPLUNK_HOME/etc/system/local directory:

limits.conf
[search]
max_rawsize_perchunk = 800000000

2. Restart the indexer.

3. Test to you if still see the error message in Splunk App for VMware Host Detail view.

Note that setting the value of max_rawsize_perchunk = 400000000 surppresses the warning message in the Host Detail view. However, in the search.log file, you will still see the following message:

02-07-2014 14:52:43.008 ERROR databasePartitionPolicy - Max Raw Size Limit Exceeded
02-07-2014 14:52:43.127 INFO  UnifiedSearch - Error in 'databasePartitionPolicy': Max Raw Size Limit Exceeded

To mitigate the appearance of these error messages, set the max_rawsize_perchunk to at least 600000000.

Incomplete or no data coming from vCenters that are configured and connected by a DCN

Incomplete or no data coming from vCenters that are configured and connected by a DCN. Data collection tasks are failing and/or connections between DCN and vCenter are closing before all data is transferred. This could be due to one of two issues.

• The collection tasks taking longer than the vCenter and app are expecting.
• Collection intervals are currently overloading your Data Collection Nodes (DCNs) and your vCenters.

Resolution

Change collection intervals in order to reduce the load on your Data Collection Nodes (DCNs) and your vCenters

Change the time interval for your host inventory job.

1. On the instance where your scheduler is running, navigate to \etc\apps\Splunk_TA_vmware\default\.
2. Open the ta_vmware_collection.conf file.
3. Change hostinv_interval and hostinv_expiration from the 900 second default to a larger number (maximum 2700 seconds). Keep hostinv_interval and hostinv_expiration at the same number of seconds.
4. Save your changes and exit.

Change the time interval for host performance data.

1. On the instance where your scheduler is running, navigate to \etc\apps\Splunk_TA_vmware\local\.
2. Open the ta_vmware_collection.conf file.
3. Change hostvmperf_interval and hostvmperf_expiration from the 180 second default to a larger number (maximum 1200 seconds). Keep hostvmperf_interval and hostvmperf_expiration at the same number of seconds.
4. Save your changes and exit.

Increase the timeout period in the vpxd file on your vCenter.

1. Open the vpxd.cfg file, located in C:\Documents and Settings\All Users\Application Data\VMware\VMware VirtualCenter\vpxd.cfg file (C:\ProgramData\VMware\VMware VirtualCenter\vpxd.cfg on Windows 2008) using a text editor.
2. Add the below information in the <vpxd> tags:

<heartbeat>
<notRespondingTimeout>180</notRespondingTimeout>
</heartbeat>

1. Restart your VMware VirtualCenter Server service.

VMware App sets SSL for WebUI as Default

Resolution

Disable WebUI SSL in the Splunk App for VMware to prevent web.conf from overriding your deployment's SSL settings.

Navigate to $SPLUNK_HOME/etc/system/local/ and make the following change to web.conf

[settings]
enableSplunkWebSSL = false