document and extend trace analysis interface