← Back to Insights Quality Assurance · Test Log

Test Log in Software Testing: Structure, Contents and Example

· Ramin Amini

A test is only worth something if you can later trace exactly what was checked and with what result. That is what the test log is for. It is the evidence that testing took place, the basis for defect reports and, in the end, the foundation for the release decision. This article shows what belongs in a test log, what an example looks like and how it differs from a test report.

What is a test log? Definition

The ISTQB glossary describes the test log as a chronological record of relevant details about the execution of tests. In practice this means: while a tester executes a test case, they record when they did what, with which software version and in which environment, which result they expected and which result they actually got.

The terms are not always used consistently. Some teams speak of test records, test evidence or test run logs and mean the same thing. What matters is the core idea: the test log documents execution, not planning. What is to be tested is described in the test case and the test plan. What actually happened during testing is recorded in the test log.

What is a test log used for?

What belongs in a test log?

A proven structure is a header with the general conditions and a results section per test case or test step.

Header: conditions of the test run

Results section: per test case and test step

How the underlying test case is structured is described in the article how to write test cases.

Test log example: a test case from practice

The following example shows a lean test log for a manual functional test in an online shop. The values are a fictitious example.

Header

Test case TC-031: voucher is applied in the shopping cart

The example shows two typical points: the actual result is described concretely, not just as "doesn't work". And steps that cannot sensibly be executed because of a defect are explicitly marked as blocked instead of simply being left out.

Test log vs. test report: the difference

The two terms are often confused. The test log records execution in full detail and without gaps, usually per test case. It is aimed at testers and developers. The test report summarises the results of many test logs: how many test cases were executed and passed, which defects are open, which risks remain, and can a release be recommended from a testing perspective? It is aimed at project leadership, the business and management and is usually prepared by test management.

In short: the test log answers "What happened in this test?", the test report answers "What is the state of quality and can we go live?".

Test logs for manual and automated tests

With automated tests, test tools and CI pipelines usually generate the logs themselves. Here the challenge is to present the results in a readable way and store them permanently. With manual testing, on the other hand, the log is created by the tester, ideally directly during execution in a test management tool, or alternatively in a structured spreadsheet.

For exploratory tests without pre-written test cases, session notes are sufficient: the goal of the test session, areas covered, duration, defects found and open questions. That is a test log too, just in a freer form.

Tips for meaningful test logs

Test logs in acceptance testing

Test logs become particularly important in acceptance testing. This is where the client decides whether the software meets the agreed acceptance criteria. Complete logs make that decision traceable and help later if questions about warranty or rework arise. It is therefore worth agreeing in the test plan which details and evidence the logs should contain.

If your project lacks the time or people for clean test documentation, an external testing partner can help. As a software testing service provider in Hamburg we carry out manual software tests, document test execution in a traceable way and deliver a test report with a release recommendation at the end, remotely, hybrid or on site in Hamburg and across Germany.

Conclusion

A good test log is not bureaucracy for its own sake. It makes tests traceable, speeds up defect fixing and provides the evidence an acceptance decision can rely on. With a clear header, concrete actual results, an honest status per test case and targeted evidence, a lean template is often enough.

Frequently asked questions about test logs

What is the difference between a test log and a test report?

The test log documents the execution of individual tests in detail: version, environment, steps, expected and actual results and the status. The test report summarises the results of many test logs, shows open defects and risks and usually contains a release recommendation.

Who creates the test log?

The test log is created by the person who executes the test, usually the tester. With automated tests the test tool generates the log. The test report based on the logs is usually prepared by test management.

Is there a template for a test log?

There is no mandatory template. To get started, a spreadsheet with the columns test case ID, test step, expected result, actual result, status, defect ID and remarks is enough, plus a header with test object, version, environment, date and tester. In larger projects a test management tool provides this structure.

Traceable software testing for your project

We test your software manually and in a structured way, document test execution in a traceable way and deliver a test report with a release recommendation from a testing perspective.

Book an initial consultation

More about our service: Software testing & quality assurance in Hamburg →