Splunk® IT Service Intelligence

Administration Manual

Acrobat logo Download manual as PDF

Splunk IT Service Intelligence version 4.4.x will no longer be supported as of October 22, 2021. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see Before you upgrade IT Service Intelligence.
This documentation does not apply to the most recent version of ITSI. Click here for the latest version.
Acrobat logo Download topic as PDF

Import entities from a Splunk search in ITSI

You can import multiple entities from IT Service Intelligence (ITSI) module searches, saved searches, or ad hoc searches using any data coming into the Splunk platform. The workflow is identical to importing through a CSV file, except that you specify a search string instead of uploading a CSV file. For more information about importing entities through a CSV file, see Import entities from a CSV file in ITSI.

For Configuration Management Database (CMDB) integration, you can set up the Splunk platform to directly query the database where the CMDB data is stored so that you can use a Splunk search to import the CMDB data into ITSI as entities. You can automate the import from search for ongoing updates. For more information about CMDB integration with ITSI, see the CMDB-to-ITSI app on Splunkbase.

  1. From the ITSI top menu bar, click Configure > Entities.
  2. Click Create Entity > Import from Search.

    If your role doesn't have write access to the Global team, the Create Entity option doesn't appear.

  3. Select one of the following search types:
    Search Type Description
    Module Choose from a list of pre-defined entity discovery searches based on ITSI modules. For more information, see Auto-detect entities using ITSI modules.
    Saved Searches Choose from a list of pre-defined ITSI saved searches. For more information, see Create and manage saved searches in ITSI.
    Ad hoc Search Enter a custom search string.
  4. Enter an ad hoc search string or select a pre-defined module search or saved search. Make sure the results are presented in a table.
    In this example we want to import entities using an ad hoc search.
  5. Click the Search icon to view a preview of the search results. ImportEntity.png
  6. Click Next.
  7. Use the Select Column page to specify how to classify and store the file column entries that define your entities.
    In this example, we select to import the title column as Entity Title and the hostname column as Entity Alias. SpecifyColumns.png
  8. Configure the following options in the Settings section:
    Option Description
    Service Team

    (Only displayed if you are importing services.)

    The team to create the services in.
    Import Services As

    (Only displayed if you are importing services.)

    Whether services are enabled or disabled upon import.
    Conflict Resolution Determines how ITSI updates and stores your entity data:
    • Skip Over Existing Entities: Adds new entity data to the datastore only if the entity does not already exist. If an entity already exists, the entity is not updated.
    • Update Existing Entities: Merges the imported data and the existing data associated with the entity. Uses the Conflict Resolution field to identify the entity.
    • Replace Existing Entities: Replaces existing entity data with new entity data. Uses the Conflict Resolution field to identify the entity.
    Conflict Resolution Field The field used to merge on. Entities that have the same field value are considered to be the same entity. For example, if there is an entity defined with the same IP then merge into that entity. If Conflict Resolution is set to Update Existing Entities or Replace Existing Entities, ITSI resolves duplicate entities based on this field.
    For more information about Conflict Resolution, see Conflict Resolution examples in ITSI.
  9. In the Preview section, click Entities to be imported to confirm that your entity import configuration is correct.

    The preview shows the entity information you're importing. It doesn't show the final merged entity values.

  10. Click Import.
    A message appears confirming that the import is complete.
  11. Click the View all Entities link to confirm your imported entities appear in the Entity viewer page.
  12. (Optional) Click Set up Recurring Import to create a modular input for the CSV file. See Set up recurring import of entities in ITSI.
Last modified on 24 February, 2020
Import entities from a CSV file in ITSI
Set up a recurring import of entities in ITSI

This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.2.0, 4.2.1, 4.2.2, 4.2.3, 4.3.0, 4.3.1, 4.4.0, 4.4.1, 4.4.2, 4.4.3, 4.4.4, 4.4.5

Was this documentation topic helpful?

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters