By default any compile errors are logged to the standard log /tmp/mtail.INFO
unless otherwise redirected. (You can emit to standard out with
--logtostderr flag.) Program errors are also printed on the HTTP status
handler, by default at porrt 3903.
If you want more debugging information, mtail provides a few flags to assist with testing your program in standalone mode.
The compile_only flag will run the mtail compiler, print any error messages, and then exit.
You can use this to check your programs are syntactically valid during the development process.
mtail --compile_only --progs ./progs
This could be added as a pre-commit hook to your source code repository.
The one_shot flag will compile and run the mtail programs, then feed in any
logs specified from the beginning of the file (instead of tailing them), then
print to the log all metrics collected.
You can use this to check that your programs are giving the expected output against some gold standard log file samples.
mtail --one_shot --progs ./progs --logs testdata/foo.log
If you wish, send a PR containing your program, some sample input, and a golden output to be run as a test in http://github.com/google/mtail/blob/master/ex_test.go to ensure that mtail never breaks your program (or that your program gets any updates if the language changes.)
To have a syntax-only compile test, merely send in a PR with the program in the examples directory.
The TestExamplePrograms behaves like the one_shot flag, and
TestCompileExamplePrograms tests that program syntax is correct.
For more information about debugging mtail programs, see the tips under Troubleshooting