Troubleshooting¶

Below are some pointers to help in debugging the application:

Search for modular input errors¶

Look at the output in the "Logs" dashboard inside the Network Toolkit app.

You can also run a search for the following and see if the logs indicate a problem with the modular input:

index=_internal ((sourcetype=*_modular_input OR sourcetype=*_lookup_command OR sourcetype=*_search_command) ERROR) OR (traceback AND NOT sourcetype=splunkd_ui_access)

Search for REST handler errors¶

Run a search for the following and see if the logs indicate a problem with the REST handler:

index=_internal (source=network_tools_helper_controller.log OR source= speedtest_modular_input.log OR source= ping_modular_input.log)

Input fails and generates a "ConnectionError"¶

This can happen when the following is

1. The IP address is invalid (if referring to the host by IP)
2. The domain name cannot be resolved
3. The port number provided is invalid (if a port is specified)
4. Network connectivity is lost or a firewall blocks the connection

Troubleshooting modular inputs that don't appear in the Splunk Manager¶

Look in the messages link in the top right of the page to see if you have a message like this:

Unable to initialize modular input "ping" defined inside the app "network_toolkit": Introspecting scheme=web_input: script running failed (exited with code 1).

You can search the internal log for related errors that indicate the modular input could not start:

index=_internal "ModularInputs - Unable to initialize modular input" 

The best way to identify the source of the error if the modular input cannot be loaded by Splunk is to try to load it via Splunk's python interpreter directly.

Here is an example. Consider the modular input is in the following path: /opt/splunk/etc/apps/network_tools/bin/ping.py

To test this, go to the path /opt/splunk/etc/apps/network_tools/bin/ using the CLI:

cd /opt/splunk/etc/apps/network_tools/bin

Next, run Splunk's python against the file:

/opt/splunk/bin/splunk cmd python ping.py

This should show an error, such as:

Traceback (most recent call last):
  File "ping.py", line 1, in <module>
    somethingnotdefined
NameError: name 'somethingnotdefined' is not defined

The app doesn't work when TA-Connectivity is installed¶

This app is not compatible with TA-Connectivity (https://splunkbase.splunk.com/app/1473/) because that app redefines the ping input which Network Toolkit also includes.