Cisco Networks Add-on for Splunk Enterprise
Overview
Details
Install this Add-On on your search head and indexers/heavy forwarders. Install the Cisco Networks (cisco_ios) App on your search head.
Supported Cisco Devices:
* Any Cisco Catalyst switch or router. Specific examples below:
* Cisco Catalyst series switches (1000, 1200, 1300, 2960, 3650, 3750, 4500, 6500, 6800, 7600, 9000 etc.)
* Cisco ASR - Aggregation Services Routers (900, 1000, 5000, 9000 etc.)
* Cisco ISR - Integrated Services Routers (800, 1900, 2900, 3900, 4451 etc.)
* Cisco Nexus Data Center switches (1000V, 2000, 3000, 4000, 5000, 6000, 7000, 9000 etc.)
* Cisco Carrier Routing System
* Other Cisco IOS based devices (Metro Ethernet, Industrial Ethernet, Blade Switches, Connected Grid etc.)
* Cisco Access Points
* Cisco WLC - WLAN Controller
The Cisco Networks Add-on (TA-cisco_ios) sets the correct sourcetype and fields used for identifying data from Cisco IOS, IOS XE, IOS XR, NX-OS devices using Splunk® Enterprise.
Install this Add-on on your search head and indexers/heavy forwarders. Install the Cisco Networks (cisco_ios) App on your search head.
Supported data inputs:
- Syslog
Please post a question on Splunk Answers and tag it with "Cisco Networks Add-on" if there is anything you would like to see in this app.
Application Details
Sourcetype(s): cisco:ios
Supported Technologies: Cisco IOS, IOS-XE, NX-OS, IOS XR, WLC devices
Installation Instructions
The Cisco Networks Add-on can be downloaded, installed, and configured to receive Cisco IOS and WLC data by either using the Splunk app setup screen or by manually installing and configuring the app.
This app does not add any new inputs, it merely rewrites syslog events matching the IOS format. You need to already have IOS events coming in as the syslog OR cisco:ios sourcetype.
Setup and configuration
- Install in $SPLUNK_HOME/etc/apps/TA-cisco_ios
- Configure inputs:
- Option 1: Configure Splunk Connect 4 Syslog to receive syslog data and forward this data to Splunk.
- Option 2: Create a UDP input on one of your Splunk servers or a forwarder with sourcetype set to syslog or cisco:ios. A regex match will be performed to rewrite the events to the cisco:ios sourcetype.
- Configure your Cisco devices to send their syslogs to the UDP input created in step 2 with logging level informational.
- Restart Splunk
Getting Help
- Consult Splunk Answers
- Contact the author: [email protected]
Release Notes
Version 2.7.5
Version 2.7.3
New features
Cisco Networks Add-on includes the following new features:
Fixed issues
Version 2.7.3 of the Cisco Networks Add-on fixes the following issues:
- Optional whitespace in the general regex to match events from certain devices/software versions with inconsistent logging
- Splunk Cloud no longer requires a restart due to eventgen.conf.
Known issues
Version 2.7.3 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.7.2
Fixed issues
Version 2.7.2 of the Cisco Networks Add-on fixes the following issues:
- Splunk Cloud no longer requires a restart due to eventgen.conf.
Version 2.7.1
This release is ONLY compatibly with Splunk 8.1+. For compatibility with older versions, please use version 2.6.2.
Fixed issues
Version 2.7.0 of the Cisco Networks Add-on fixes the following issues:
- Corrections for Splunk Connect for Syslog data ingest
- Added initial support for Cisco Telemetry data
- Network Interface short names are now normalized OOTB without macros thanks to Splunk 8.1 EVAL lookups
- Excludes Cisco FTD events from being part of field extractions and sourcetype rewrites
- Adds ACI field extraction (for Faults)
Version 2.6.2
Fixed issues
Version 2.6.2 of the Cisco Networks Add-on fixes the following issues:
- Corrections for Splunk Connect for Syslog data ingest
- Excludes Cisco FTD events from being part of field extractions and sourcetype rewrites
- Adds ACI field extraction (for Faults)
- This will be the LAST release of this app compatible with Splunk 8.0 and lower
Version 2.7.0
This release is ONLY compatibly with Splunk 8.1+. For compatibility with older versions, please use version 2.6.1.
Fixed issues
Version 2.7.0 of the Cisco Networks Add-on fixes the following issues:
- Corrections for Splunk Connect for Syslog data ingest
- Added initial support for Cisco Telemetry data
- Network Interface short names are now normalized OOTB without macros thanks to Splunk 8.1 EVAL lookups
- Excludes Cisco FTD events from being part of field extractions and sourcetype rewrites
- Adds ACI field extraction (for Faults)
Version 2.6.1
Fixed issues
Version 2.6.1 of the Cisco Networks Add-on fixes the following issues:
- Corrections for Splunk Connect for Syslog data ingest
- Excludes Cisco FTD events from being part of field extractions and sourcetype rewrites
- Adds ACI field extraction (for Faults)
- This will be the LAST release of this app compatible with Splunk 8.0 and lower
Version 2.6.0
Excludes Cisco FTD events from being extracted and transformed
Version 2.5.8
New features
Cisco Networks Add-on includes the following new features:
Fixed issues
Version 2.5.8 of the Cisco Networks Add-on fixes the following issues:
- Removed a lot of FIELDALIAS that are no longer working as of Splunk 7.2
Known issues
Version 2.5.8 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.5.7
Fixed issues
Version 2.5.7 of the Cisco Networks Add-on fixes the following issues:
- Removed a lot of FIELDALIAS that are no longer working as of Splunk 7.2
Version 2.5.4
New features
Cisco Networks Add-on includes the following new features:
- App certification
- ACI field extractions
Fixed issues
Version 2.5.4 of the Cisco Networks Add-on fixes the following issues:
- Removed cisco_ios_apptype lookup as it is just a static value. Replaced with an eval instead.
- Brought back the optional index force transform
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
- Removed cisco_ios_vendor lookup as it is just a static value. Replaced with an eval instead
Known issues
Version 2.5.4 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.5.2
New features
Cisco Networks Add-on includes the following new features:
- App certification
- ACI field extractions
Fixed issues
Version 2.5.2 of the Cisco Networks Add-on fixes the following issues:
- Removed cisco_ios_apptype lookup as it is just a static value. Replaced with an eval instead.
- Brought back the optional index force transform
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
- Removed cisco_ios_vendor lookup as it is just a static value. Replaced with an eval instead
Version 2.5.1
New features
Cisco Networks Add-on includes the following new features:
- App certification
- ACI field extractions
Fixed issues
Version 2.5.1 of the Cisco Networks Add-on fixes the following issues:
- Removed cisco_ios_apptype lookup as it is just a static value. Replaced with an eval instead.
- Brought back the optional index force transform
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
- Removed cisco_ios_vendor lookup as it is just a static value. Replaced with an eval instead
Version 2.5.0
Fixed issues
Version 2.5.0 of the Cisco Networks Add-on fixes the following issues:
- Removed cisco_ios_apptype lookup as it is just a static value. Replaced with an eval instead.
- Brought back the optional index force transform
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
- Removed cisco_ios_vendor lookup as it is just a static value. Replaced with an eval instead
Version 2.3.4
NOTE: The OPTIONAL index transform was removed by mistake. If you use this feature please stay on your current version. This will be re-added in 2.3.5
New features
Cisco Networks Add-on includes the following new features:
- App certification
Fixed issues
Version 2.3.4 of the Cisco Networks Add-on fixes the following issues:
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
Known issues
Version 2.3.4 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.3.3
New features
Cisco Networks Add-on includes the following new features:
- None
Fixed issues
Version 2.3.3 of the Cisco Networks Add-on fixes the following issues:
- Improvements to the general extractions contributed by m4dc0w
- Better handling of NGFW events
- Fixes for IOS-XE extractions
- Extra Nexus VIM IF_ATTACHED extraction (Thanks rsethre)
Known issues
Version 2.3.3 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.3.2
Fixed issues
Version 2.3.2 of the Cisco Networks Add-on fixes the following issues:
- Improvements to the general extractions contributed by m4dc0w
Known issues
Version 2.3.2 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.3.0
New features
Cisco Networks Add-on includes the following new features:
- Direct AP logging now supported. product field can now hold a value of IOS, WLC or IOS
- IP version agnostic IP extractions
- Lookup of ICMP codes and types in ACL logs
Fixed issues
Version 2.3.0 of the Cisco Networks Add-on fixes the following issues:
- Transform corrected in case of missing reported_hostname. General field extraction also edited.
- EVAL searchmatch action lookup not working correctly due to conflict with vendor_action lookup. Will need to be fixed by moving all the searchmatches to vendor_action_lookup
- Field extractions for Nexus interface admin changes + tags
- Normalization of src_int in case it contains whitespaces, i.e. "vlan 3333" is now "vlan3333"
Known issues
Version 2.3.0 of the Cisco Networks Add-on has the following known issues:
- None known
Version 2.2.1
New features
Cisco Networks Add-on includes the following new features:
- Moved a few extractions to transforms.conf.
- Added extraction for SEC_LOGIN-1-QUIET_MODE_ON
- Regex routing contributions from seismiccollission
- product field lookup now done based on presence of fields. This results in WLC or IOS as the two possible products
Version 2.2.0
New features
Cisco Networks Add-on includes the following new features:
- Five new extractions: ARP Inspection, IP Source guard, Storm Control
Fixed issues
Version 2.2.0 of the Cisco Networks Add-on fixes the following issues:
- Removed cisco_ios_hosts_last_period lookup
- ap_mac and src_mac issues for wireless resolved
Known issues
Version 2.2.0 of the Cisco Networks Add-on has the following known issues:
- EVAL searchmatch action lookup not working correctly due to conflict with vendor_action lookup
Version 2.1.0
+++ 2.1.0 (2014-11-10)
Features:
NAME CHANGED to Cisco Networks Add-on.
RFC5424 support (untested). Rewrites sourcetype rfc5424_syslog to cisco:ios if it matches. Also extracts fields
Version 2.0.0
++ What's New
+++ 2.0.0 (2014-09-19)
Features:
* CIM compliance
MAKE SURE YOU REMOVE EARLIER VERSIONS OF THIS APP BEFORE INSTALLING THIS VERSION!
Version 1.6.0
++ What's New
+++ 1.6.0 (2014-07-21)
Features:
Lots of new extractions
Nexus ACL extractions
IOS Firewall extracts. Thanks Patrick Preuss!
Cisco IOS XE extraction fix for 4451. Thanks
Bug fixes:
* Cisco IOS Messages CSV file moved from this app to the Cisco IOS app.
Version 1.5.0
++ What's New
+++ 1.5.0 (2014-05-08)
Features:
* Added lookup file for Cisco System Messages for the following devices:
- Nexus 7000, MDS 9000
- Catalyst 2960, 3750 etc
- Catalyst 4500
- Catalyst 6500
- WLC 5500
There are duplicates. I will review them at a later time
Version 1.2.2
+++ 1.2.2 (2014-04-23)
Features:
* 16 new extractions:
extract_cisco_ios-ILPOWER-3-CONTROLLER_PORT_ERR
extract_cisco_ios-SYS-CPUHOG
extract_cisco_ios-SYS-CPUHOG-2
extract_cisco_ios-LDP-5-SP
extract_cisco_ios-DHCP-6-ADDRESS_ASSIGN
extract_cisco_ios-CLEAR-5-COUNTERS
extract_cisco_ios-OSPF-4-ERRRCV
extract_cisco_ios-CERM-4-RX_TX_BW_LIMIT
extract_cisco_ios-SYS-5-PRIV_I
extract_cisco_ios-UDLD-4-UDLD_PORT_DISABLED
extract_cisco_ios-AUTHMGR-5-SECURITY_VIOLATION
extract_cisco_ios-TRACKING-5-STATE
extract_cisco_ios-RTT-6-SAATHRESHOLD
extract_cisco_ios-EC-5-L3DONTBNDL
extract_cisco_ios-EC-5-PORTDOWN
extract_cisco_ios-EC-5-STAYDOWN
Version 1.2.1
+++ 1.2.1 (2014-02-17)
Features:
This app must now be installed on both the search head AND indexer
We no longer rewrite the indexer to the "ios" index
+++ 1.2.0 (2014-01-09)
Features: Added props, transforms, tags to this app for CIM compliance
Version 1.0.4
+++ 1.0.4 (2013-09-20)
Features: IOS XR support
Version 1.0.3
+++ 1.0.3 (2013-08-12)
Bug fixes: Don't capture ACS events, be stricter on capturing
Version 1.0.2
+++ 1.0.2 (2013-06-07)
Bug fixes:
* Don't capture UCSM events
Version 1.0.1
+++ 1.0.1 (2013-04-23)
Bug fixes:
* Fixed extraction of mnemonic and facility with integers in it