Skip to content

Commit 774cb22

Browse files
mattmakaimattmakai
committed
cleaning up logging page
1 parent 06d21d6 commit 774cb22

File tree

3 files changed

+34
-28
lines changed

3 files changed

+34
-28
lines changed

‎feeds/all.atom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2014-06-01T08:38:09Z</updated></feed>
2+
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2014-06-01T08:42:28Z</updated></feed>

‎logging.html‎

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,14 @@
3939
</div> <div class="row">
4040
<div class="col-md-8">
4141
<h1>Logging</h1>
42-
<p>Logging is a mechanism for monitoring web applications written with a
43-
web framework. Runtime exceptions that prevent code from running are
44-
important to log to investigate and fix the source of the problems.
45-
Informational and debugging logging also helps to understand how the
46-
application is performing even if code is working as intended.</p>
42+
<p>Logging saves output such as errors, warnings and event information to
43+
files for debugging purposes. </p>
44+
<h2>Why is logging important?</h2>
45+
<p>Runtime exceptions that prevent code from running are important to log to
46+
investigate and fix the source of the problems. Informational and debugging
47+
logging also helps to understand how the application is performing even if
48+
code is working as intended.</p>
49+
<h2>Logging levels</h2>
4750
<p>Logging is often grouped into several categories:</p>
4851
<ol>
4952
<li>Information</li>
@@ -52,15 +55,7 @@ <h1>Logging</h1>
5255
<li>Error</li>
5356
</ol>
5457
<p>Logging errors that occur while a web framework is running is crucial to
55-
understanding how your application is performing.
56-
<a href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
57-
<a href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
58-
aggregation application. Raven provides the way to send exceptions to
59-
Sentry, which should be deployed on a separate server from your production
60-
infrastructure. Raven can also be used by Python scripts to send other
61-
log data to Sentry for aggregation. Sentry provides a clean web application
62-
interface for viewing the exceptions. Sentry can also be configured with a
63-
mail plugin to send emails when exceptions occur.</p>
58+
understanding how your application is performing. </p>
6459
<h2>Logging Aggregators</h2>
6560
<p>When you are running your application on several servers, it is helpful
6661
to have a monitoring tool called a "logging aggregator". You can configure
@@ -94,6 +89,13 @@ <h3>Log Aggregator Third Party Services</h3>
9489
<h3>Open Source Log Aggregators</h3>
9590
<ul>
9691
<li>
92+
<p><a href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
93+
<a href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
94+
aggregation application. Raven can also be used by Python scripts to send
95+
other log data to Sentry for aggregation. Sentry provides a clean web
96+
application interface for viewing the exceptions. </p>
97+
</li>
98+
<li>
9799
<p><a href="http://graylog2.org/">Graylog2</a> provides a central server for log
98100
aggregation as well as a GUI for browsing and searching through log events.
99101
There are libraries for most major languages, including python. Saves data

‎source/content/pages/08-monitoring-analytics/0801-logging.markdown‎

Lines changed: 17 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -17,12 +17,18 @@ choice4text:
1717

1818

1919
# Logging
20-
Logging is a mechanism for monitoring web applications written with a
21-
web framework. Runtime exceptions that prevent code from running are
22-
important to log to investigate and fix the source of the problems.
23-
Informational and debugging logging also helps to understand how the
24-
application is performing even if code is working as intended.
20+
Logging saves output such as errors, warnings and event information to
21+
files for debugging purposes.
2522

23+
24+
## Why is logging important?
25+
Runtime exceptions that prevent code from running are important to log to
26+
investigate and fix the source of the problems. Informational and debugging
27+
logging also helps to understand how the application is performing even if
28+
code is working as intended.
29+
30+
31+
## Logging levels
2632
Logging is often grouped into several categories:
2733

2834
1. Information
@@ -32,14 +38,6 @@ Logging is often grouped into several categories:
3238

3339
Logging errors that occur while a web framework is running is crucial to
3440
understanding how your application is performing.
35-
[Raven](http://raven.readthedocs.org/en/latest/) is a Python client for the
36-
[Sentry](https://github.com/getsentry/sentry) exception logging and
37-
aggregation application. Raven provides the way to send exceptions to
38-
Sentry, which should be deployed on a separate server from your production
39-
infrastructure. Raven can also be used by Python scripts to send other
40-
log data to Sentry for aggregation. Sentry provides a clean web application
41-
interface for viewing the exceptions. Sentry can also be configured with a
42-
mail plugin to send emails when exceptions occur.
4341

4442

4543
## Logging Aggregators
@@ -71,6 +69,12 @@ certain threshold.
7169

7270

7371
### Open Source Log Aggregators
72+
* [Raven](http://raven.readthedocs.org/en/latest/) is a Python client for the
73+
[Sentry](https://github.com/getsentry/sentry) exception logging and
74+
aggregation application. Raven can also be used by Python scripts to send
75+
other log data to Sentry for aggregation. Sentry provides a clean web
76+
application interface for viewing the exceptions.
77+
7478
* [Graylog2](http://graylog2.org/) provides a central server for log
7579
aggregation as well as a GUI for browsing and searching through log events.
7680
There are libraries for most major languages, including python. Saves data

0 commit comments

Comments
 (0)