# blackbox

Contents

- Description
- Commands
  - Repository maintenance

log repository events to a blackbox for debugging

# Description

Logs event information to .hg/blackbox.log to help debug and diagnose problems. The events that get logged can be configured via the blackbox.track and blackbox.ignore config keys.

Examples:

    [blackbox]
    track = *
    ignore = pythonhook
    # dirty is *EXPENSIVE* (slow);
    # each log entry indicates `+` if the repository is dirty, like :hg:`id`.
    dirty = True
    # record the source of log messages
    logsource = True

    [blackbox]
    track = command, commandfinish, commandexception, exthook, pythonhook

    [blackbox]
    track = incoming

    [blackbox]
    # limit the size of a log file
    maxsize = 1.5 MB
    # rotate up to N log files when the current one gets too big
    maxfiles = 3

    [blackbox]
    # Include microseconds in log entries with %f (see Python function
    # datetime.datetime.strftime)
    date-format = %Y-%m-%d @ %H:%M:%S.%f

# Commands

## Repository maintenance

### blackbox

view the recent repository events:

    hg blackbox [OPTION]...

view the recent repository events

Options:

`-l, --limit <VALUE>`
| the number of events to show (default: 10)