NGINX Unit

Troubleshooting§

Logging§

Unit maintains a single general-purpose log for diagnostics and troubleshooting (not to be confused with the access log). To find out its default location in your Unit installation:

$ unitd --help

    unit options:
    ...
    --log FILE           set log filename
                         default: "/path/to/unit.log"

The --log option overrides the default value; if Unit is already running, check whether this option is set:

$ ps ax | grep unitd
    ...
    unit: main v1.12.0 [/path/to/unitd ... --log /path/to/unit.log ...]

If Unit isn’t running, see its system startup scripts or configuration files to check if --log is set, and how.

Debug Log§

Unit log has two verbosity modes: common and debug; steps to enable the latter vary by install method.

Warning

Debug log is meant for developers; it grows rapidly, so enable it only for detailed reports and inspection.

Installation From Our Repositories§

Our repositories provide a debug version of unitd called unitd-debug within the unit package:

# unitd-debug <command line options>

Note

Also, there are debug symbol packages for core dump analysis; their names end in -dbg, like unit-dbg.

Installation From Source§

To enable debug-level logging when installing from source, use the --debug option:

$ ./configure --debug <other options>

Then recompile and reinstall Unit and your specific language modules.

Getting Support§

Post your questions to our mailing list at unit@nginx.org; to subscribe, email unit-subscribe@nginx.org or sign up here. You can also visit our GitHub repo to report an issue, suggest a feature, or share a problem.

In addition, we offer commercial support.