Splunk Cloud

Search Reference

Download manual as PDF

Download topic as PDF



Examine data model or data model dataset and search a data model dataset.

Use the datamodel command to return the JSON for all or a specified data model and its datasets. You can also search against the specified data model dataset.

A data model is a hierarchically-structured search-time mapping of semantic knowledge about one or more datasets. A data model encodes the domain knowledge necessary to build a variety of specialized searches of those datasets. These specialized searches are in turn used by the search to generate reports for Pivot users. For more information, see About data models and Design data models in the Knowledge Manager Manual.

The datamodel search command lets you search existing data models and their datasets from the search interface.

The datamodel command is a generating command and should be the first command in the search. Generating commands use a leading pipe character.


| datamodel [<data model name>] [<dataset name>] [<search>]

Required arguments


Optional arguments

data model name
Syntax: <string>
Description: The name of the data model to search. When only the data model is specified, the search returns the JSON for the single data model.
dataset name
Syntax: <string>
Description: The name of a data model dataset to search. Must be specified after the data model name. The search returns the JSON for the single dataset.
Syntax: <search>
Description: Indicates to run the search associated with the specified data model and object. For more information, see the search command.


The datamodel command is a generating command and should be the first command in the search. Generating commands use a leading pipe character.


The following examples are created using data from the "Data Model and Pivot Tutorial".

Example 1:

Return JSON for all data models available in the current app context.

| datamodel

Datamodel command default.png

Example 2:

Return JSON for the "Buttercup Games" data model, which has the model ID "Tutorial".

| datamodel Tutorial

Datamodel command tutorialdata.png

Example 3:

Return JSON for Buttercup Games's Client_errors dataset.

| datamodel Tutorial Client_errors

Datamodel command tutorial object.png

Example 4:

Run the search for Buttercup Games's Client_errors.

| datamodel Tutorial Client_errors search

Example 5:

Search Buttercup Games's Client_errors dataset for 404 errors and count the number of events.

| datamodel Tutorial Client_errors search | search status=404 | stats count

See also



Have questions? Visit Splunk Answers and see what questions and answers the Splunk community has about using the datamodel command.


This documentation applies to the following versions of Splunk Cloud: 7.0.0, 6.5.0, 6.5.1, 6.5.1612, 6.6.0, 6.6.1, 6.6.3

Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

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