Map to CIM
In Map to CIM, map the fields from your data to the fields in one of the predefined common information models (CIM) to normalize data at search time.
The Splunk Common Information Model add-on is required to use this feature.
- Download the Splunk Common Information Model add-on from Splunkbase.
- For details about installation, see Install the Splunk Common Information Model Add-on.
Before you apply CIM mapping to your add-on, you must configure one or more source types for your add-on by creating a data input, by adding data from a sample file, or by adding indexed data from Splunk.
To map fields to the CIM
- On your add-on homepage, click Map to CIM on the Add-on Builder navigation bar.
- On the CIM Mapping page, click New CIM Mapping.
- On the CIM Mapping >> Define Event Type page, define an event type to generate events from which to extract fields:
- Enter a name for the event type.
- Select a source type from which to generate events.
- Enter a search to select events. By default, the search selects all events for the source type you selected, but you can apply additional search criteria as needed.
- Click Save.
- On the CIM Mapping >> CIM Mapping Details page, click Select CIM Models.
- On the CIM Mapping >> Select CIM Models page, select the CIM fields to use for mapping:
- From the center panel, select one or more CIM models to use. You can also select individual datasets within a CIM model. Fields from your event type are displayed for reference, and fields from the selected CIM models are also displayed.
- When you have finished selecting CIM models, click Select.
- On the CIM Mapping >> CIM Mapping Details page, click New Knowlege Object and select the type of mapping to create:
- Select FIELDALIAS to map a field from the CIM model to a field from your event type.
- Select EVAL to map a field from the CIM model to an expression based on a field from your event type.
- Define a field alias or expression in the new row that was added to the CIM Mapping List:
- If you are defining a field alias, click one field name from the CIM Model Fields list and one from the Event Type Fields list, and then click OK at the end of the new row in the CIM Mapping List.
- If you are defining an expression, click one field name from the CIM Model Fields list and one or more fields from the Event Type Fields list. Edit the expression in the Event Type Field or Expression column, then click OK at the end of the new row in the CIM Mapping List.
- Repeat steps 6-7 as needed.
- Click Done when you have finished CIM mapping.
The CIM Mapping page displays an entry for the mapping you just completed.
Learn more
For more information, see the following Splunk Enterprise documentation:
- About event types in the Knowledge Manager Manual
- About tags and aliases in the Knowledge Manager Manual
- eval in the Search Reference manual.
- Use the CIM to normalize data at search time in the Common Information Model Add-on Manual
Extract fields | Create alert actions |
This documentation applies to the following versions of Splunk® Add-on Builder: 2.1.0, 2.1.1, 2.1.2
Feedback submitted, thanks!