Bolt supports multiple log levels. You can configure the log level from the CLI,
or in a project configuration file. Supported logging levels, in order from most
to least information logged, are
By default, Bolt logs a debug-level log to a
bolt-debug.log file in the root
of your project directory. You can also configure custom logs from your project
Each time you run a Bolt command, Bolt prints a debug-level log to a
bolt-debug.log file in the root of your project directory.
You can disable the log file by specifying the following in your
log: bolt-debug.log: disable
Setting log level
You can set Bolt's log level from the CLI or use a configuration file.
Setting log level on the CLI
To set the log level from the CLI, use the
log-level option along with the
desired level. Available log levels are
fatal. For example:
*nix shell command
bolt command run whoami -t target1 --log-level trace
Invoke-BoltCommand -Command whoami -Targets target1 -LogLevel trace
Setting log level in a configuration file
To set the log level for the console, add a
log map with a
to your project configuration file.
level key to set the log level. For example:
# bolt-project.yaml name: lotsalogs log: console: level: debug
If you want to write a log to a file, add a map with the file destination to the
log mapping. For example, the following
bolt-project.yaml file writes
trace level logs to a
logs directory in the Bolt project:
# bolt-project.yaml name: lotsalogs log: "logs/trace.log": append: false level: trace "logs/info.log": append: false level: info
append key to
false if you want to overwrite the file on each run,
true if you want to append to the existing file.
Note: The directory you set for logging must exist, and Bolt must have permission to write to it.
Trace logs contain the most detailed information for actions run on individual targets. For example, the logs include each command run on a target, each step of compiling a puppet code file (manifest) for an apply block, and information about establishing connections with targets.
Trace logs are useful when you're trying to troubleshoot a problem with Bolt. They contain information about what exactly Bolt is doing when it runs an action on each target.
Debug logs contain information for target-specific steps and detailed information about where Bolt is loading data from. For example, debug logs include information on how Bolt locates the project to load, where different content is loaded from, and information about actions run on each individual target.
Debug logs are useful for troubleshooting a problem with a plan or the way you're using Bolt. You can use debug logs for a high-level understanding of what actions Bolt is running on individual targets, or to find out where Bolt is loading data from.
Info logs give you a high-level overview of what Bolt is doing. For example, an info log contains information about which Bolt project is loaded, when different actions run on targets start and finish, and results from actions run on targets.
Info logs are useful when you want to see the results for an action in a Bolt execution. They're also useful for a high-level understanding of what Bolt is doing.
Warn logs contain warnings about deprecations and potentially harmful situations that might affect your Bolt run, even though they don't prevent Bolt from executing. For example, Bolt warns you if your inventory file includes an unsupported transport configuration that might result in Bolt connecting to targets in a way that you don’t expect.
Bolt prints warnings to the console by default.
Use a warn log if you're trying to find out if you're using Bolt in a way that might result in unexpected behavior, or to see if you're using a deprecated feature.
Error logs contain messages for errors that Bolt encountered during execution. For example, Bolt prints an error if a PuppetDB query fails.
Bolt prints errors to the console by default.
Use an error log if you want to see errors that Bolt raised during a Bolt run.
Fatal logs contain
critical messages from a Puppet code file
(manifest) or apply block.
Use a fatal error log if you want to see fatal errors raised by issues in your Puppet code.
The following Bolt commands include the
--verbose CLI option:
bolt command run
bolt task run
bolt plan run
bolt script run
bolt file upload
bolt file download
The following PowerShell cmdlets include the
Verbose output is useful when you want to see the results for Bolt actions on your targets that are
usually not printed to standard out (stdout). Verbose isn't a log level, but is a way of telling
Bolt to output additional information in a human-readable format. Verbose output is particularly
useful for debugging your tasks and plans - if you're not sure why something is failing, try running
--verbose to get more information.
📖 Related information