asterisk/configs/samples/ast_debug_tools.conf.sample

#
# This file is used by the Asterisk debug tools.
# Unlike other Asterisk config files, this one is
# "sourced" by bash and must adhere to bash semantics.
#

# A list of coredumps and/or coredump search patterns.
# Bash extended globs are enabled and any resulting files
# that aren't actually coredumps are silently ignored
# so you can be liberal with the globs.
#
# If your patterns contains spaces be sure to only quote
# the portion of the pattern that DOESN'T contain wildcard
# expressions.  If you quote the whole pattern, it won't
# be expanded and the glob characters will be treated as
# literals.
#
# The exclusion of files ending ".txt" is just for
# demonstration purposes as non-coredumps will be ignored
# anyway.
COREDUMPS=(/tmp/core[-._]asterisk!(*.txt) /tmp/core[-._]$(hostname)!(*.txt))

# Date command for the "running" coredump and tarballs.
# DATEFORMAT will be executed to get the timestamp.
# Don't put quotes around the format string or they'll be
# treated as literal characters.  Also be aware of colons
# in the output as you can't upload files with colons in
# the name to Jira.
#
# Unix timestamp
#DATEFORMAT='date +%s.%N'
#
# Unix timestamp on *BSD/MacOS after installing coreutils
#DATEFORMAT='gdate +%s.%N'
#
# Readable GMT
#DATEFORMAT='date -u +%FT%H-%M-%S%z'
#
# Readable Local time
DATEFORMAT='date +%FT%H-%M-%S%z'

# A list of log files and/or log file search patterns using the
# same syntax as COREDUMPS.
#
LOGFILES=(/var/log/asterisk/messages* /var/log/asterisk/queue* \
	/var/log/asterisk/debug* /var/log/asterisk/security*)

# ast_loggrabber converts POSIX timestamps to readable format
# using this Python strftime format string.  If not specified
# or an empty string, no format covnersion is done.
LOG_DATEFORMAT="%m/%d-%H:%M:%S.%f"

# The timezone to use when converting POSIX timestamps to
# readable format.  It can be specified in "<continent>/<city>"
# format or in abbreviation format such as "CST6CDT".  If not
# specified, the "local" timezone is used.
# LOG_TIMEZONE=
debug_utilities: Create the ast_coredumper utility This utility allows easy manipulation of asterisk coredumps. * Configurable search paths and patterns for existing coredumps * Can generate a consistent coredump from the running instance * Can dump the lock_infos table from a coredump * Dumps backtraces to separate files... - thread apply 1 bt full -> <coredump>.thread1.txt - thread apply all bt -> <coredump>.brief.txt - thread apply all bt full -> <coredump>.full.txt - lock_infos table -> <coredump>.locks.txt * Can tarball corefiles and optionally delete them after processing * Can tarball results files and optionally delete them after processing * Converts ':' in coredump and results file names '-' to facilitate uploading. Jira for instance, won't accept file names with colons in them. Tested on Fedora24+, Ubuntu14+, Debian6+, CentOS6+ and FreeBSD9+[1]. [1] For *BSDs, the "devel/gdb" package might have to be installed to get a recent gdb. The utility will check all instances of gdb it finds in $PATH and if one isn't found that can run python, it prints a friendly error. Change-Id: I935d37ab9db85ef923f32b05579897f0893d33cd 2017-01-10 17:10:39 -07:00			`#`
			`# This file is used by the Asterisk debug tools.`
			`# Unlike other Asterisk config files, this one is`
			`# "sourced" by bash and must adhere to bash semantics.`
			`#`

			`# A list of coredumps and/or coredump search patterns.`
			`# Bash extended globs are enabled and any resulting files`
			`# that aren't actually coredumps are silently ignored`
			`# so you can be liberal with the globs.`
			`#`
			`# If your patterns contains spaces be sure to only quote`
			`# the portion of the pattern that DOESN'T contain wildcard`
			`# expressions. If you quote the whole pattern, it won't`
			`# be expanded and the glob characters will be treated as`
			`# literals.`
			`#`
			`# The exclusion of files ending ".txt" is just for`
			`# demonstration purposes as non-coredumps will be ignored`
			`# anyway.`
			`COREDUMPS=(/tmp/core[-._]asterisk!(.txt) /tmp/core[-._]$(hostname)!(.txt))`

			`# Date command for the "running" coredump and tarballs.`
			`# DATEFORMAT will be executed to get the timestamp.`
			`# Don't put quotes around the format string or they'll be`
			`# treated as literal characters. Also be aware of colons`
			`# in the output as you can't upload files with colons in`
			`# the name to Jira.`
			`#`
			`# Unix timestamp`
			`#DATEFORMAT='date +%s.%N'`
			`#`
			`# Unix timestamp on *BSD/MacOS after installing coreutils`
			`#DATEFORMAT='gdate +%s.%N'`
			`#`
			`# Readable GMT`
			`#DATEFORMAT='date -u +%FT%H-%M-%S%z'`
			`#`
			`# Readable Local time`
			`DATEFORMAT='date +%FT%H-%M-%S%z'`
debug_utilities: Create ast_loggrabber ast_loggrabber gathers log files from customizable search patterns, optionally converts POSIX timestamps to a readable format and tarballs the results. Also a few tweaks were made to ast_coredumper. Change-Id: I8bfe1468ada24c1344ce4abab7b002a59a659495 (cherry picked from commit 5fa1c56d7e76999aa14f133a33f6b168e7c3b99c) 2017-01-13 10:03:15 -07:00
			`# A list of log files and/or log file search patterns using the`
			`# same syntax as COREDUMPS.`
			`#`
			`LOGFILES=(/var/log/asterisk/messages* /var/log/asterisk/queue* \`
			`/var/log/asterisk/debug* /var/log/asterisk/security*)`

			`# ast_loggrabber converts POSIX timestamps to readable format`
			`# using this Python strftime format string. If not specified`
			`# or an empty string, no format covnersion is done.`
			`LOG_DATEFORMAT="%m/%d-%H:%M:%S.%f"`

			`# The timezone to use when converting POSIX timestamps to`
			`# readable format. It can be specified in "<continent>/<city>"`
			`# format or in abbreviation format such as "CST6CDT". If not`
			`# specified, the "local" timezone is used.`
			`# LOG_TIMEZONE=`