Commands¶
The ksconf command documentation is provided in the following ways:
- A detailed listing of each sub-command is provided in this section. This includes relevant background descriptions, typical use cases, examples, and discussion of relevant topics. An expanded descriptions of CLI arguments and their usage is provided here. If you’ve not used a particual command before, start here.
- The Command line reference provides a quick an convenient reference when the command line is unavailable. The same information is available by typing
ksconf --help
. This is most helpful if you’re already familiar with a command, but need a quick refresher.
Warning
Apologies for the dust
The command docs are currently undergoing reorganization. We’re considering a topical layout rather than a per-command layout. Feedback and technical writing / organization contributions are highly welcomed.
Command | Maturity | Description |
---|---|---|
ksconf check | stable | Perform basic syntax and sanity checks on .conf files |
ksconf combine | beta | Combine configuration files across multiple source directories into a single destination directory. This allows for an arbitrary number of splunk configuration layers to coexist within a single app. Useful in both ongoing merge and one-time ad-hoc use. |
ksconf diff | stable | Compare settings differences between two .conf files ignoring spacing and sort order |
ksconf filter | alpha | A stanza-aware GREP tool for conf files |
ksconf merge | stable | Merge two or more .conf files |
ksconf minimize | beta | Minimize the target file by removing entries duplicated in the default conf(s) |
ksconf promote | beta | Promote .conf settings from one file into another either in batch mode (all changes) or interactively allowing the user to pick which stanzas and keys to integrate. Changes made via the UI (stored in the local folder) can be promoted (moved) to a version-controlled directory. |
ksconf rest-export | beta | Export .conf settings as a curl script to apply to a Splunk instance later (via REST) |
ksconf snapshot | alpha | Snapshot .conf file directories into a JSON dump format |
ksconf sort | stable | Sort a Splunk .conf file creating a normalized format appropriate for version control |
ksconf unarchive | beta | Install or upgrade an existing app in a git-friendly and safe way |