To get started with the Splunk for DHCPD, please perform the following configuration:
By default, permissions are set at the app level - users in the 'admin' role have read and write permissions, while users in the 'dhcpd' role have read-only permissions.
You can change the app level permissions by navigating to Manager >> Apps >> dhcp "Permissions". Use caution!
To ensure that field extractions are working properly, you will need to ensure that the correct source type is linked to the field extractions and lookups.
By default, the app will already work if your dhcpd events are coming in under the source types "syslog" or "dhcpd".
Otherwise, you should copy $SPLUNK_HOME/etc/apps/dhcpd/default/props.conf to $SPLUNK_HOME/etc/apps/dhcpd/local/props.conf, and change one of the existing stanzas ([dhcpd] or [syslog]) to the source type that your dhcpd data is in while deleting the other props.conf stanza.
For example, to set the field extractions and lookups to work with the source type foobar, $SPLUNK_HOME/etc/apps/dhcpd/local/props.conf should look as follows:
[foobar]
TRANSFORMS-dhcpd=set-dhcpd-sourcetype
REPORT-dhcpd=dhcpack_type1,dhcpack_type2,dhcpnak,dhcprequest,dhcpdiscover,dhcpoffer,dhcpinform,dhcprelease,dhcp_forward_map_failed,dhcp_added_reverse_map,dhcp_added_forward_map,dhcp_removed_reverse_map,dhcp_leases,dhcp_decls,dhcp_deleted_decls,dhcp_dyn_plus_stat_line1,dhcp_dyn_plus_stat_line2,dhcp_dyn_plus_stat_line3,dhcp_rrset_no_exists,dhcp_rrset_exists,dhcp_duplicate,dhcp_abandon_ip,dhcp_icmp_reply_lease_valid,dhcp_xing_on,src_mac_prefix
LOOKUP-dhcpd=dhcpd_mac-vendorname src_mac_prefix OUTPUT src_mac_vendor
LOOKUP-dhcpd=dhcpd_cef-lookup eventtype OUTPUT cef_version cef_dvendor cef_dproduct cef_dversion cef_sid cef_name cef_severity
Most of the saved searches and dashboards depend on the event type "dhcpd_event" being defined correctly. By default, this event type is defined as "process=dhcpd", so if you have performed the initial step of getting the field extractions to work, you should be all set. If you still have problems, please post to answers.splunk.com using the link on this page.
The alert "dhcpd_alert_new_mac_address_15m" will email you when a new host shows up on your network. The results contained in this alert will be fairly verbose the first few times that it runs, as it takes a while for a baseline to be established, so you might want to consider disabling the action to send you an email for a day or two.
In any case, you will want to change the "Email address(es)" from "example@example.com" to your desired email address or distribution list.
As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps from Splunk, our partners and our community. Find an app for most any data source and user need, or simply create your own with help from our developer portal.