Skip to content
A Nginx module to dump backtrace when a worker process exits abnormally
C
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
README.markdown
config
ngx_backtrace_module.c

README.markdown

Name

  • Backtrace module. It comes from Tengine, an Nginx distribution with quite a few advanced features.

Description

  • It can be used to dump backtrace of nginx in case a worker process exits abnormally, e.g. when some signal is received (SIGABR, SIGBUS, SIGFPE, SIGILL, SIGIOT, SIGSEGV). It's quite handy for debugging purpose.
  • This module requires the backtrace(3) function in glibc. You can't enable it on systems lack of this function (FreeBSD, Darwin).

Directives

backtrace_log

Syntax: backtrace_log log_path Default: backtrace_log error.log Context: main

Specify the log file name of backtrace. backtrace_log /path/to/backtrace.log

backtrace_max_stack_size

Syntax: backtrace_max_stack_size size Default: backtrace_max_stack_size 30 Context: main

Specify the maximum stack depth for backtrace

Something went wrong with that request. Please try again.