Traces » History » Revision 11
Revision 10 (Jaroslav Kysela, 2019-02-26 15:41) → Revision 11/13 (Jaroslav Kysela, 2019-02-26 15:41)
h1. Traces - verbose debugging
Please, *read this whole information*. If you *don't see [TRACE] lines in the log file*, you *misconfigured* something and we will ask you for new feedback which slows down the help process.
It is quite usual that a developer asks you to provide more verbose logs using the trace (verbose logs for development) which tvheadend includes. If you see --trace <comma_separated_list_of_subsystems> you need to follow this.
Compile tvheadend using --enable-trace option for the configure script see [[Building]] to compile tvheadend directly from sources. The traces are enabled by default, but packages - except debug versions - disable this functionality.
*!!! The [TRACE] lines are written only to the log file. You will not see them on console or syslog output. Please, enter the log file. !!!*
h2. Command-line
The first way to enable traces is from the command-line options (to specify the log file and all subsystems to debug), like:
<pre>
./build.linux/tvheadend -l /tmp/tvheadend.log --trace htsp,subscription,pat,pmt,bat
</pre>
h2. Web UI
The second way is to use the debugging tab in the configuration (this settings is not preserved):
!debugging.png!
h2. h3. Example
You should see [ TRACE] lines in your log file (these lines are not in syslog file or journal)!
<pre>
2017-09-14 15:39:07.670 [ TRACE]:httpc: 0004: finishing
2017-09-14 15:39:07.672 [ TRACE]:mpegts: table: mux 0x283ea64430 destroy pmt 02/FF (2) pid 044C (1100)
2017-09-14 15:39:07.673 [ TRACE]:pcr: S23.5E/12343.5H/CT 1 HD: change : 1532541106
2017-09-14 15:39:07.673 [ TRACE]:mpegts: input SAT>IP DVB-S Tuner #4 (192.168.100.237) got 68432 bytes
2017-09-14 15:39:07.673 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [16/0x7fc64400a900]
2017-09-14 15:39:07.674 [ TRACE]:mpegts: table: mux 0x283ea64430 free pmt 02/FF (2) pid 044C (1100)
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0456 (1110) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0460 (1120) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0461 (1121) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0462 (1122) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0463 (1123) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 046A (1130) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 047E (1150) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0488 (1160) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - stopping mux
2017-09-14 15:39:07.674 [ DEBUG]:satip: SAT>IP DVB-S Tuner #4 (192.168.100.237) - stopping 12343.5H in S23.5E
2017-09-14 15:39:07.674 [ TRACE]:mpegts: SAT>IP DVB-S Tuner #4 (192.168.100.237) - flush subscribers
2017-09-14 15:39:07.674 [ TRACE]:mpegts: 12343.5H in S23.5E - flush tables
2017-09-14 15:39:07.674 [ TRACE]:descrambler: mux 0x283ea64430 - flush tables
</pre>
Please, *read this whole information*. If you *don't see [TRACE] lines in the log file*, you *misconfigured* something and we will ask you for new feedback which slows down the help process.
It is quite usual that a developer asks you to provide more verbose logs using the trace (verbose logs for development) which tvheadend includes. If you see --trace <comma_separated_list_of_subsystems> you need to follow this.
Compile tvheadend using --enable-trace option for the configure script see [[Building]] to compile tvheadend directly from sources. The traces are enabled by default, but packages - except debug versions - disable this functionality.
*!!! The [TRACE] lines are written only to the log file. You will not see them on console or syslog output. Please, enter the log file. !!!*
h2. Command-line
The first way to enable traces is from the command-line options (to specify the log file and all subsystems to debug), like:
<pre>
./build.linux/tvheadend -l /tmp/tvheadend.log --trace htsp,subscription,pat,pmt,bat
</pre>
h2. Web UI
The second way is to use the debugging tab in the configuration (this settings is not preserved):
!debugging.png!
h2. h3. Example
You should see [ TRACE] lines in your log file (these lines are not in syslog file or journal)!
<pre>
2017-09-14 15:39:07.670 [ TRACE]:httpc: 0004: finishing
2017-09-14 15:39:07.672 [ TRACE]:mpegts: table: mux 0x283ea64430 destroy pmt 02/FF (2) pid 044C (1100)
2017-09-14 15:39:07.673 [ TRACE]:pcr: S23.5E/12343.5H/CT 1 HD: change : 1532541106
2017-09-14 15:39:07.673 [ TRACE]:mpegts: input SAT>IP DVB-S Tuner #4 (192.168.100.237) got 68432 bytes
2017-09-14 15:39:07.673 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [16/0x7fc64400a900]
2017-09-14 15:39:07.674 [ TRACE]:mpegts: table: mux 0x283ea64430 free pmt 02/FF (2) pid 044C (1100)
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0456 (1110) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0460 (1120) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0461 (1121) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0462 (1122) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0463 (1123) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 046A (1130) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 047E (1150) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0488 (1160) [8/0x283ea64d00]
2017-09-14 15:39:07.674 [ DEBUG]:mpegts: 12343.5H in S23.5E - stopping mux
2017-09-14 15:39:07.674 [ DEBUG]:satip: SAT>IP DVB-S Tuner #4 (192.168.100.237) - stopping 12343.5H in S23.5E
2017-09-14 15:39:07.674 [ TRACE]:mpegts: SAT>IP DVB-S Tuner #4 (192.168.100.237) - flush subscribers
2017-09-14 15:39:07.674 [ TRACE]:mpegts: 12343.5H in S23.5E - flush tables
2017-09-14 15:39:07.674 [ TRACE]:descrambler: mux 0x283ea64430 - flush tables
</pre>