15.3 Log Location

Go To Top

Return to Logging and Observability

The Repository should define predictable log locations. Developers and reviewers should not need to search through temporary directories, container internals, or local machine paths to find logs.

The recommended Repository location for local logs is:

logs/

The team may organize logs by run, script, Node, container, or Evidence collection activity. A representative structure is:

logs/
    setup/
    generation/
    build/
    run/
    nodes/
    containers/
    tests/

Runtime logs that form part of acceptance Evidence should be copied or exported to the approved Evidence location. The recommended Evidence location is:

evidence/

The team should normally keep transient logs out of Git. Logs may be added to Git only when they are part of reviewed acceptance Evidence or a controlled example. The .gitignore file should reflect this distinction.