terratest_log_parser requires an explicit installation. See Installing the utility
binaries for installation instructions.
If you log using Terratest’s
logger package, you may notice that all the test outputs are interleaved from the
parallel execution. This may make it difficult to debug failures, as it can be tedious to sift through the logs to find
the relevant entries for a failing test, let alone find the test that failed.
Therefore, Terratest ships with a utility binary
terratest_log_parser that can be used to break out the logs.
To use the utility, you simply give it the log output from a
go test run and a desired output directory:
go test -timeout 30m | tee test_output.log terratest_log_parser -testlog test_output.log -outputdir test_output
TEST_NAME.logfor each test it finds from the test output containing the logs corresponding to that test.
summary.logfile containing the test result lines for each test.
report.xmlfile containing a Junit XML file of the test summary (so it can be integrated in your CI).
The output can be integrated in your CI engine to further enhance the debugging experience. See Terratest’s own circleci configuration for an example of how to integrate the utility with CircleCI. This provides for each build:
Terratest also ships utility binaries that you can use to improve the debugging experience (see Debugging interleaved test output). The compiled binaries are shipped separately from the library in the Releases page.
To install a binary, download the version that matches your platform and place it somewhere on your
PATH. For example
to install version 0.13.13 of
# This example assumes a linux 64bit machine # Use curl to download the binary curl --location --silent --fail --show-error -o terratest_log_parser https://github.com/gruntwork-io/terratest/releases/download/v0.13.13/terratest_log_parser_linux_amd64 # Make the downloaded binary executable chmod +x terratest_log_parser # Finally, we place the downloaded binary to a place in the PATH sudo mv terratest_log_parser /usr/local/bin
Alternatively, you can use the gruntwork-installer, which will do the above steps and automatically select the right binary for your platform:
gruntwork-install --binary-name 'terratest_log_parser' --repo 'https://github.com/gruntwork-io/terratest' --tag 'v0.13.13'
The following binaries are currently available with
|terratest_log_parser||Parses test output from the
Your entire infrastructure. Defined as code. In about a day.Explore Gruntwork.io