icon/x Created with Sketch.

Splunk Cookie Policy

We use our own and third-party cookies to provide you with a great online experience. We also use these cookies to improve our products and services, support our marketing campaigns, and advertise to you on our website and other websites. Some cookies may continue to collect information after you have left our website. Learn more (including how to update your settings) here.
Accept Cookie Policy

We are working on something new...

A Fresh New Splunkbase
We are designing a New Splunkbase to improve search and discoverability of apps. Check out our new and improved features like Categories and Collections. New Splunkbase is currently in preview mode, as it is under active development. We welcome you to navigate New Splunkbase and give us feedback.
Log4Shell Vulnerability: Information and guidance for you. Get resources.

Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading ES Choreographer
SHA256 checksum (es-choreographer_110.tgz) bacd8df379c1ae677e26f38ce3a6d8a48a8f8ff33a44ca7c3878a731bb55358c
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate


ES Choreographer

Splunk Cloud
Tools to ease the maintenance of correlation searches:
* user-friendly peer review and change tracking system for correlation searches
* simple in-splunk task management system
* framework to encourage compliance with best practices
* morning checks checks stub

Demonstrated in SEC1441A at .conf21: "How We Maintain Our Correlations in Splunk Enterprise Security at Thales UK"


Install GV-Utils on your ES search head(s).

(Optionally) install the Lookup Editor app on the same search head(s).

Install SA-ES-Choreographer, again on the same search head(s).

Navigate to the app and choose "initial setup" in the menu. Click "do full setup" and let it run its searches. This populates lookups that are otherwise maintained by various scheduled searches.

Go the the status dashboard, click on the question mark ? to expand the sliding drawer and click to open the bulk review tool. Tick disabled (as well as enabled) and pass the review. This is setting the first version of all your correlations, including the currently disabled ones.

Optionally: you might want to specify your search head(s) in the ESC_ES_search_heads macro: settings > advanced search > macros > edit ESC_ES_search_heads. It is used to narrow down some searches with host=`ESC_ES_search_heads` so use a pattern that will work in this context.

To get the most from the app, some functionality needs to be customised to your team, your deployment and your desires. This is optional but unfortunately requires editing the source of some dashboards. Please refer to the documentation.

Quick start

If you're curious to see the peer review / change tracking in action:
- go to ES's content management
- modify a correlation search (enable/disable, change the schedule and/or the SPL, etc)
- go back to the status dashboard in ES choreographer and set it for peer review by clicking the corresponding button
- click "quick correlation data refresh" - your search should appear as pending review
- click the "pending" - the diff should show your changes

From there, test the task management system:
- click the TODO/Done navigation button to go to the TODO page for that correlation.
- use the form to add a TODO
- navigate back to the status dashboard and refresh it. Maybe set it for TODOs. Your TODO should appear in the list.

Navigate to the Best Practices dashboard:
- click on a line in the main table
- scroll down and click on the question marks ? to slide out more documentation about what the dashboard is doing.

The morning checks checks dashboard is there as a stub for your own checks.

Full Documentation

Please check out the documentation page on my blog.

This app was introduced and demonstrated in SEC1441A at .conf21 "How We Maintain Our Correlations in Splunk Enterprise Security at Thales UK": pdf/mp4

Release Notes

Version 1.1.0
Feb. 17, 2022

First version on splunkbase. Compared to bitbucket version:

  • made compatible with splunkbase's version of GV-Utils
  • added contributor to the peer review dashboards
  • made the quick refresh on the status dashboard work more obvious
  • added a basic navigation menu
  • improved bulk peer review dashboard: can now restrict it to show only changes affecting specified fields and no other
  • fixed minor bugs (broken links, left-over debug output, table formatting...)

Subscribe Share

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps from Splunk, our partners and our community. Find an app for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
Splunk, Splunk>,Turn Data Into Doing, Data-to-Everything, and D2E are trademarks or registered trademarks of Splunk Inc. in the United States and other countries. All other brand names,product names,or trademarks belong to their respective owners.