Splunk® Enterprise

Search Tutorial

Acrobat logo Download manual as PDF

Splunk Enterprise version 6.x is no longer supported as of October 23, 2019. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see How to upgrade Splunk Enterprise.
This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
Acrobat logo Download topic as PDF

Save and share your reports

In the last few parts of this tutorial, you learned the basics of searching using the Splunk software, how to use a subsearch, and how to add fields from lookup tables. Part 6 shows you how to save and share your searches and explores more detailed search examples.

Save a search as a report

Reports are created whenever you save a search. After you create a report, you can do a lot with it.

1. Set the time range to Yesterday and run the following search.

This is the same search that you ran in the section Search with field lookups.

sourcetype=access_* status=200 action=purchase [search sourcetype=access_* status=200 action=purchase | top limit=1 clientip | table clientip] | stats count AS "Total Purchased", dc(productId) AS "Total Products", values(productName) AS "Product Names" BY clientip | rename clientip AS "VIP Customer"

Note: If your search does not return results, increase the time range of the search. For example, you can run search over the time range Last week or All Time.

2. Click Save as above the search bar and select Report.

This screen image shows the list of "Save as" options.  The list includes Report, Dashboard, and Alert.  Report is highlighted..

3. In the Save As Report dialog box for Title type VIP Customer.

4. For Description, type Buttercup Games most frequent shopper.

This screen image shows the Save As Report dialog box with the Title and Description fields filled in as described in the steps.

5. For Time Range Picker, click Yes.

When you include a Time range picker in a report, it gives you the option of running the report with a different time range.

6. Click Save.

A confirmation dialog box opens confirming that your report has been created. From this dialog box you can perform the following actions.
  • Continue Editing. To refine the search and report format.
  • Add to Dashboard. To add the report to a new or existing dashboard.
  • View. To view the report.

7. Click View.

This screen image shows the VIP Customer report. The title, description, and time range picker appear in the upper left corner of the report.
The title and description that you specified appear at the top of the report. Time range picker is also included at the top of the report.

View and edit reports

You can view and edit reports that you have saved. You edit a report directly from within the report.

1. In VIP Customer report, click Edit.

This screen image shows the options under the Edit drop-down menu.
The options are to open the report in the Search view, or to edit the report description, permissions, schedule, and acceleration. You can also clone, embed, and delete the report from this menu.

2. Click More Info to view information about the report.

This screen image shows the options under the More Info drop-down menu.
From the More Info menu, you can view and edit different properties of the report, including its schedule, acceleration, permissions, and embedding.

3. Look at the time range picker, located at the upper left corner of the window.

With the Time range picker, you can change the time period to run this search. For example, you can use this time range picker to run this search for the VIP Customer Week to date, Last 60 minutes, or Last 24 hours just by selecting the Preset time range or defining a custom time range.
This screen image shows the options in the time range picker.

Find and share reports

You can access your reports using the App bar.

1. Click Reports to open the Reports page and view the list of reports.

This screen image shows the Reports page. The VIP Customer report you created is listed at the bottom.  The other reports in the list are built-in reports that come with Splunk software.
When you save a report, Sharing is set to Private. Only you can view and edit the report. You can allow other apps to view, edit, or both view and edit the report by changing the report permission.

1. For the VIP Customer report, under Actions click Edit.

2. Select Edit Permissions.

This screen image shows the list of options under the Edit drop-down menu.

3. In the Edit Permissions dialog box, set Display For to App.

The display expands to show more settings.

4. For Everyone, mark the check box under Read.

This screen image shows the Edit Permissions dialog box. The permission for Everyone is set to Read.
This action gives everyone who has access to this app the permission to view the report.

5. Click Save.

The Reports page appears. The Sharing setting for the VIP Customer report now reads App instead of Private.
This screen image shows the Reports page.

Next step

Learn more about searches, charts, and reports.

See also

In the Reporting Manual

About reports
Accelerate reports
Last modified on 01 November, 2016
Search with field lookups
Search, chart, and report examples

This documentation applies to the following versions of Splunk® Enterprise: 6.4.0, 6.4.1, 6.4.2, 6.4.3, 6.4.4, 6.4.5, 6.4.6, 6.4.7, 6.4.8, 6.4.9, 6.4.10, 6.4.11

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