Installation¶

Step 1: Verify Compatibility & Install App¶

You will need a PLM that supports an IP connection in order for Splunk to get the data. Supported devices include the original Hub (2242-222) and the new Hub Pro (2243-222). The Hub II (2245-222) is not supported because it lacks the API necessary for external systems to get the Insteon traffic.

Step 2: Setup Input¶

Make a new instance of an input to get the Insteon data by navigating to the data inputs page in Splunk Enterprise and making a new instance of an "Insteon PLM" input (Settings » Data inputs » Insteon PLM).

Once you make an input, you should see data with the following search:

sourcetype=insteon_plm

If you do not see events, look at the logs from the following search to see why the input is failing:

index=_internal sourcetype=insteon_plm_modular_input

Step 3: Configure Device Data¶

You'll need to provide a list of the devices to the Splunk Insteon App so that it can identify the type of device that is communicating. To do this, just press the set button on each device to put it into linking more. Once in linking mode, the device will send its information to Splunk and Splunk will automatically store the information. You can see a list of devices that have not yet provided the information in the report titled "Devices Lacking Identification" (under the "Health" drop-down in the Insteon App).

Note: that it may take a few minutes for Splunk to recognize the data from the device; give Splunk a few minutes to recognize the data after you made the device enter linking mode

Warning: this doesn't work correctly on Windows platforms due to a problem in Splunk itself which prevents searches from updating lookup files. Thus, Windows hosts will not recognize the devices unless you edit the lookup file manually.

Step 4: Setup Thermostat to Send Data (optional)¶

1. Shutdown any existing connections to the PLM (since it will allow only one connection at a time).
2. Run HouseLinc and connect to the PLM.
3. Register the thermostat with HouseLinc (by pressing the set button and having HouseLinc look for the device)
4. Create an alert in the Houselinc. This is done simply to make sure that HouseLinc sets up the thermostat with the PLM such that all of the events are monitored. You can disable the alert after you create it.