Mercurial > kallithea

annotate docs/usage/debugging.rst @ 4954:14f063657078

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
i18n: updated translation for Dutch (Belgium) Currently translated at 0.8% (9 of 1077 strings)
author Sam Jaques <sam.jaques@me.com>
date Tue, 31 Mar 2015 16:25:49 +0000
parents 03bbd33bc084
children 4e6dfdb3fa01
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 ===================
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
03bbd33bc084 docs: rework stuff
Mads Kiilerich <madski@unity3d.com>
parents: 4192
diff changeset
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
03bbd33bc084 docs: rework stuff
Mads Kiilerich <madski@unity3d.com>
parents: 4192
diff changeset
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.