The return data from the Highstate command is a standard data structure which is parsed by the highstate outputter to deliver a clean and readable set of information about the HighState run on minions.
Two configurations can be set to modify the highstate outputter. These values
can be set in the master config to change the output of the
salt command or
set in the minion config to change the output of the
The highstate outputter has six output modes,
full, which will display many lines of detailed information for each executed chunk.
terseis used, then the output is greatly simplified and shown in only one line.
mixedis used, then terse output will be used unless a state failed, in which case full output will be used.
mixed_idis used, then the mixed form will be used, but the value for
namewill be drawn from the state ID. This is useful for cases where the name value might be very long and hard to read.
changesis used, then terse output will be used if there was no error and no changes, otherwise full output will be used.
filteris used, then either or both of two different filters can be used:
exclude, state.highstate expects a list of states to be excluded (or
None) followed by
Truefor terse output or
Falsefor regular output. Because of parsing nuances, if only one of these is used, it must still contain a comma. For instance: exclude=True,.
terse, state.highstate expects simply
False. These can be set as such from the command line, or in the Salt config as state_output_exclude or state_output_terse, respectively.
state_output: filter is set in the configuration file:
salt '*' state.highstate exclude=None,True
means to exclude no states from the highstate and turn on terse output.
salt twd state.highstate exclude=problemstate1,problemstate2,False
means to exclude states
from the highstate, and use regular output.
Example output for the above highstate call when
top.sls defines only
one other state to apply to minion
twd: Summary for twd ------------ Succeeded: 1 (changed=1) Failed: 0 ------------ Total states run: 1
Example output with no special settings in configuration files:
myminion: ---------- ID: test.ping Function: module.run Result: True Comment: Module function test.ping executed Changes: ---------- ret: True Summary for myminion ------------ Succeeded: 1 Failed: 0 ------------ Total: 0
The HighState Outputter is only meant to be used with the state.highstate function, or a function that returns highstate return data.