Manage asset and identity upon upgrade
When you upgrade the Splunk Enterprise Security app to versions 6.0 or higher, you may see the following issues:
- The Asset and Identity Management navigation bar and page does not display if you have customized the menu bar in Splunk Enterprise Security. See Restore the default navigation or Recover the new view of Assets and Identities Navigation page.
- The Asset and Identity page merges the data for your assets and identities after the upgrade. For more information on how to avoid merged rows to display, see Avoid merged assets and identities data.
- The asset and identity collections, search previews, and search results may display differently from before the upgrade. To restore the previous view that you had prior to the upgrade, see Recover the new view of Assets and Identities Navigation page.
- The Asset and Identity page does not turn on access to some of your previously saved macros. You may no longer be able to access saved macros if they were not documented for public use.
Recover Asset and Identity Management page
You may not see the Asset and Identity Management page after you upgrade to Enterprise Security 6.0 or higher, especially if you customized the menu bar in the Splunk Enterprise Security app. You have the option to restore the default Assets and Identity Management page or revert to your previous Asset and Identity Management page.
For more information on how to restore the default navigation menu bar for assets and identities, see Restore the default navigation.
Avoid merged assets and identities data
When you upgrade to Splunk Enterprise Security 6.2 or higher, your asset collection may not retain the settings that were specified in your .csv files. Instead, your assets and identities may be merged into rows, which potentially contain overlapping or duplicate information. This happens because the app automatically overwrites the old assets and identity collections.
For example, consider a source file with duplicates in the key field of nt_host
, such as the following:
192.0.2.2,,host1,,,,,,,,,,,,,,
192.0.2.120,,host1,,,,,,,,,,,,,,
192.0.2.135,,host1,,,,,,,,,,,,,,
192.0.2.242,,host2,,,,,,,,,,,,,,
192.0.2.65,,host2,,,,,,,,,,,,,,
In this example, host1
is assigned to three different IP addresses and host2
assigned to two different IP addresses. In previous versions of Splunk Enterprise Security, the display of the Asset and Identity management page would retain the correlations established in the .csv files of the asset collection as follows:
asset | ip | nt_host | pci_domain |
---|---|---|---|
192.0.2.2 host1 |
192.0.2.2 | host1 | untrust |
192.0.2.120 host1 |
192.0.2.120 | host1 | untrust |
192.0.2.135 host1 |
192.0.2.135 | host1 | untrust |
192.0.2.242 host2 |
192.0.2.242 | host2 | untrust |
192.0.2.65 host2 |
192.0.2.65 | host2 | untrust |
However, post upgrade the three rows with nt_host
of host1
will be merged into one asset, and the two rows with host2
may be merged into another asset as follows:
asset | ip | nt_host | pci_domain |
---|---|---|---|
192.0.2.2 192.0.2.120 |
192.0.2.2 192.0.2.120 |
host1 | untrust |
192.0.2.242 192.0.2.65 |
192.0.2.242 192.0.2.65 |
host2 | untrust |
To avoid merged rows from being displayed in the Assets and Identities page, you may clean up the source data. For more information on cleaning your source data, see Maintain data hygiene.
Alternatively, you have the option of disabling the merge so that the collection remains the same as the source file and you do not see merged rows in your display. However, you must upgrade to Splunk Enterprise Security 6.2.0 to turn off the merge. For more information on enabling or disabling the merge, see Turn off merge for assets or identities.
Finally, you may also limit the maximum number of merges for each row by upgrading to Splunk Enterprise Security versions 6.0.2 or 6.1.1. For more information on upgrading to Enterprise Security 6.0.2 or 6.1.1, see Upgrade to Splunk Enterprise Security 6. 0.2 or 6.1.1.
Maintain data hygiene by cleaning source data
Avoid merged rows and maintain data hygiene by cleaning asset and identity source data and removing duplicate fields or values. Long merged rows of data should be cleaned to avoid performance issues.
Splunk Enterprise Security versions 6.1.1 and higher may truncate the long merged rows of data based on the multivalue limits set for each field. However, for Splunk Enterprise Security versions 6.0.2 truncation may be possible without configuring the multivalue limits.
Rows may be merged when any of the following scenarios occur:
- If the source data has two separate rows, which contain
dns="splunk.com"
, then the rows are merged post upgrade. - If you input any of the following values
"NULL"
,"null"
,"N/A"
,"blank"
, or"none"
in one of the four "key" fieldsnt_host
,ip
,mac
, ordns
, and if these values are not empty zero-byte string, the values are merged to avoid duplication.
For Splunk Enterprise Security 6.1.1 and 6.2.0, the following input values: "null"
, "n/a"
, "unknown"
, "undefined"
are not merged, but ignored.
- If there are multiple rows with
dns="undefined"
and other rows withnt_host="undefined"
, all rows in the lookup may be merged even though the IP addresses are different. The resulting merged row may cause search performance issues.
Upgrade to Splunk Enterprise Security 6.0.2 or 6.1.1
If you do not have the option to clean you source data, you may limit the maximum number of merges for each row. You may do this by upgrading to Splunk Enterprise Security versions 6.0.2 or 6.1.1 and including the maximum limit values for the distributed lookups.
If you prefer not to restore the default navigation menu, you can append the following path to your Splunk server URL to go directly to the new Assets and Identities Navigation page: /app/SplunkEnterpriseSecuritySuite/ess_entity_management
Extract asset and identity data in Splunk Enterprise Security | Manage asset lookup configuration policies in Splunk Enterprise Security |
This documentation applies to the following versions of Splunk® Enterprise Security: 8.0.0
Feedback submitted, thanks!