Splunk® Edge Hub OS

Setup and Configuration Guide

For documentation on other necessary components for Splunk Edge Hub, see the Splunk App for Edge Hub documentation, Splunk Edge Hub mobile app documentation, and Splunk Edge Hub hardware documentation.

Troubleshoot Splunk Edge Hub products

Try the following steps to troubleshoot issues with your Splunk Edge Hub OS, the Splunk Edge Hub mobile app, Splunk App for Edge Hub, and Splunk Edge Hub device.

Troubleshoot Splunk Edge Hub OS

Troubleshoot Splunk Edge Hub OS connectivity using the advanced settings page. You can check if Splunk Edge Hub OS is connected to Splunk services, DNS servers, and the network in the Edge Hub Advanced Settings page. See Access the Edge Hub Advanced Settings page to learn how to navigate to the page.

Each test checks the following connections:

Connectivity test Description Troubleshooting steps
Check Splunk Services Checks if Splunk Edge Hub OS is connected to Spacebridge. Spacebridge connects your Splunk Edge Hub OS to your Splunk platform instance. If Splunk Edge Hub OS isn't connected to Spacebridge, the HEC endpoint might be unreachable. Try using HTTP instead of HTTPS.
Check DNS servers Checks if Splunk Edge Hub OS is able to connect to public DNS services such as Cloudflare and Google. This test checks for network connection. If Splunk Edge Hub isn't able to connect to DNS services, reset your Splunk Edge Hub device to its factory settings and troubleshoot your network connection by checking your VPN or firewall settings.
Check internet connections Checks if Splunk Edge Hub OS is able to connect to to popular websites. This test checks for network connection. If Splunk Edge Hub OS isn't able to connect to popular websites, reset your Splunk Edge Hub device to its factory settings and troubleshoot your network connection by checking your VPN or firewall settings.

Troubleshoot Splunk Edge Hub mobile app

See the following table to troubleshoot the Splunk Edge Hub mobile app:

Issue Troubleshooting steps
Unable to register mobile device If you run into issues while registering your mobile device, make sure you've set things up correctly. See Installation and configuration overview for Splunk Edge Hub OS to review the configuration steps.


If you experience an issue when selecting the Splunk Edge Hub mobile app to register to Splunk Secure Gateway, restart your browser and try again.

If the issue persists, restart your Splunk platform instance and verify all settings.

Unable to connect to WiFi Navigate to Settings then Clear saved WiFi passwords and try again.
App doesn't open or displays blank screen. Make sure you've installed the latest Splunk Edge Hub mobile app version.
Unable to manage Splunk Edge Hub devices, scan Splunk Edge Hub QR codes, or other app issues If you're experience Splunk Edge Hub mobile app issues, log out and restart the app:
  1. Select Logout at the top-right corner of the Splunk Edge Hub Mobile app to log out.
  2. Restart the app.
  3. Login using your Splunk credentials.
  4. Try performing the task again.

Troubleshoot the Splunk App for Edge Hub

See the following table to troubleshoot the Splunk App for Edge Hub:

Issue Troubleshooting steps
HEC name is not valid and the Test Connection results fail during index configuration Open a proper port for the HEC. Use port 8088 for Splunk Enterprise. Use port 403 for Splunk Cloud platform.
Indexes are not created when configuring HEC endpoint Restart your Splunk platform instance and try configuring the HEC endpoint again.
Data collection node host is interrupted or terminates during configuration Restore the node and make sure the HEC is running. Unplug and replug your Splunk Edge Hub power source. The Splunk deployment server contains your host configuration information, and the KV store contains your Splunk Edge Hub configuration, so the Splunk Edge Hub should continue to send data.

Troubleshoot the HTTP Event Collector (HEC) endpoint configuration

The Test Configuration function might not validate all settings depending on your deployment type or network settings. If you encounter issues when using this function, run the following search in the Search and Reporting app to view internal logs and investigate errors:

index=_internal sourcetype=splunk_app_ar_internal_log

Troubleshoot the Splunk Edge Hub device

For hardware troubleshooting steps, such as performing a factory reset, see the troubleshooting section in https://www.edgehubcentral.com/product/user-manual.

Last modified on 06 November, 2024
Manually update Splunk Edge Hub OS  

This documentation applies to the following versions of Splunk® Edge Hub OS: 1.4.2, 1.5.0, 1.6.0, 1.7.0, 1.8.0, 1.8.1, 1.9.0, 2.0.0


Was this topic useful?







You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters