fix start_trace
improve log messages
add comments on how to use trace functions