Mercurial > kallithea
annotate docs/usage/debugging.rst @ 4936:bcc637ea79a8
template: link the last revision in the file browser to the changeset
author | Andrew Shadura <andrew@shadura.me> |
---|---|
date | Sat, 21 Mar 2015 22:23:44 +0100 |
parents | 03bbd33bc084 |
children | 4e6dfdb3fa01 |
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 =================== |
4192
e73a69cb98dc
Rename some strings examples and commands in documentation
Bradley M. Kuhn <bkuhn@sfconservancy.org>
parents:
3224
diff
changeset
|
4 Debugging Kallithea |
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 |
4192
e73a69cb98dc
Rename some strings examples and commands in documentation
Bradley M. Kuhn <bkuhn@sfconservancy.org>
parents:
3224
diff
changeset
|
7 If you encountered problems with Kallithea here are some instructions how to |
2119
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 |
4902 | 12 Enable detailed debug |
2119
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 |
4192
e73a69cb98dc
Rename some strings examples and commands in documentation
Bradley M. Kuhn <bkuhn@sfconservancy.org>
parents:
3224
diff
changeset
|
15 Kallithea uses standard python logging modules to log it's output. |
2119
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 |
4902 | 22 Enable interactive debug mode |
2119
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. |