annotate docs/usage/debugging.rst @ 4147:1c8f818787b3 rhodecode-2.2.5-gpl

old style: show the full link box on summary page - no overlap or truncation
author Mads Kiilerich <madski@unity3d.com>
date Wed, 02 Jul 2014 19:03:23 -0400
parents 8b8edfc25856
children e73a69cb98dc
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2119
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
1 .. _debugging:
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
2
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
3 ===================
2125
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
4 Debugging RhodeCode
2119
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
5 ===================
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
6
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
7 If you encountered problems with RhodeCode here are some instructions how to
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
8 possibly debug them.
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
9
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
10 ** First make sure you're using the latest version available.**
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
11
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
12 enable detailed debug
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
13 ---------------------
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
14
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
15 RhodeCode uses standard python logging modules to log it's output.
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
16 By default only loggers with INFO level are displayed. To enable full output
3224
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2125
diff changeset
17 change `level = DEBUG` for all logging handlers in currently used .ini file.
2125
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
18 This change will allow to see much more detailed output in the logfile or
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
19 console. This generally helps a lot to track issues.
2119
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
20
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
21
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
22 enable interactive debug mode
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
23 -----------------------------
4d076981a7b1 docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24
2125
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
25 To enable interactive debug mode simply comment out `set debug = false` in
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
26 .ini file, this will trigger and interactive debugger each time there an
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
27 error in browser, or send a http link if error occured in the backend. This
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
28 is a great tool for fast debugging as you get a handy python console right
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
29 in the web view. ** NEVER ENABLE THIS ON PRODUCTION ** the interactive console
097327aaf2ad more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents: 2119
diff changeset
30 can be a serious security threat to you system.