> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logging and Diagnostics

> Configure log verbosity, inspect active settings, and collect diagnostics.

Use this page when you need more detail about what Entire is doing locally or need to confirm which settings are active.

Most diagnostic output is local to your machine. Turn on debug logging temporarily unless the whole team needs the same verbosity.

## Start Here If

Use this page to:

* turn on debug logging while investigating an issue
* confirm which settings Entire is using
* run a repository health check
* view logs or create a diagnostic bundle

## Log Level

`log_level` controls how much detail Entire writes to operational logs. The default is `info`; use `debug` while investigating.

**Temporary Override**

Use `ENTIRE_LOG_LEVEL` when you need debug output for one command or one shell session.

```bash theme={null}
ENTIRE_LOG_LEVEL=debug entire status
```

`ENTIRE_LOG_LEVEL` takes precedence over settings files.

**Local Settings**

Use local settings for temporary debug logging or machine-specific troubleshooting.

```json .entire/settings.local.json theme={null}
{
  "log_level": "debug"
}
```

**Project Settings**

Use project settings only when the whole repository should use the same log level.

```json .entire/settings.json theme={null}
{
  "log_level": "debug"
}
```

Supported values are `debug`, `info`, `warn`, and `error`.

## Inspect Active Settings

Run:

```bash theme={null}
entire status --detailed
```

Use this after editing settings to confirm Entire is reading the value you changed and to see which settings file supplied it.

## Check Repository Health

Run:

```bash theme={null}
entire doctor
```

Use `entire doctor` when sessions look stuck, Git hooks are not firing, checkpoint data is not syncing, or `entire status` shows warnings. It checks repository setup, hook state, checkpoint metadata, and common session problems.

## View or Share Diagnostics

Entire writes local diagnostic logs under `.entire/logs/`. Keep logs local unless someone asks for a specific file or bundle while troubleshooting.

**View Logs**

Show recent operational logs with:

```bash theme={null}
entire doctor logs
```

To stream new log lines while you reproduce an issue, run:

```bash theme={null}
entire doctor logs --follow
```

**Create Bundle**

Create a diagnostic bundle for an issue report with:

```bash theme={null}
entire doctor bundle
```

Diagnostic bundles are redacted by default. Use `--raw` only when support has asked for an unredacted bundle.

For other local runtime files under `.entire/`, see [Entire-Generated Files](/guides/configuration/entire-files).

## Trace Slow Hooks

Hooks that take 1.5 seconds or longer trace themselves by default, at WARN level, so a slow hook records its own breakdown with no configuration. Reproduce the slow Git command, then run:

```bash theme={null}
entire doctor trace
```

Use this when `git commit` or `git push` works but feels slower than expected.

Set `ENTIRE_PERF_SLOW_MS=0` to turn automatic tracing off. A [log level](#log-level) above WARN also hides these traces. To trace every hook, including fast ones, set the log level to `debug`.

See [`entire doctor trace`](/cli-reference/doctor#doctor-trace) for `--summary`, `--slow`, and the other flags.

## Verify Logging Changes

After changing logging settings, rerun the command you were investigating and check the logs:

```bash theme={null}
entire doctor logs
```