Skip to content

Commit 1ca4aa1

Browse files
mattmakaimattmakai
committed
Updating web frameworks logging section.
1 parent ca62694 commit 1ca4aa1

File tree

7 files changed

+56
-25
lines changed

7 files changed

+56
-25
lines changed

‎css/c.css‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎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>2013-01-20T12:30:05Z</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>2013-01-26T13:15:44Z</updated></feed>

‎index.html‎

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -362,17 +362,17 @@ <h1>Web Framework</h1>
362362
common operations include:</p>
363363
<ol class="arabic simple">
364364
<li>URL routing</li>
365-
<li>HTML, XML, JSON, and other output templating</li>
365+
<li>HTML, XML, JSON, and other output format templating</li>
366366
<li>Database manipulation</li>
367-
<li>Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection</li>
367+
<li>Security against Cross-site request forgery (CSRF) and other attacks</li>
368368
</ol>
369369
<p>Not all web frameworks include functionality for all of the above
370-
functionality. Frameworks must balance between &quot;being all things to all
371-
people but very complicated&quot; or doing only certain things well without
372-
prescription for how to do other functions.</p>
370+
functionality. Frameworks fall somewhere between simply executing a
371+
single use case and attempting to be everything to every developer with
372+
increased complexity.</p>
373373
<p>For example, the Django web application framework includes an
374374
Object-Relational Mapping (ORM) layer that abstracts relational database
375-
read, write, query, and delete operations. However, the ORM layer in Django
375+
read, write, query, and delete operations. However, Django's ORM
376376
does not work (without modification) on non-relational databases such
377377
<a class="reference external" href="http://www.mongodb.org/">MongoDB</a> and <a class="reference external" href="http://docs.basho.com/">Riak</a>.
378378
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -391,6 +391,16 @@ <h2>Web Framework Monitoring</h2>
391391
<li>Warning</li>
392392
<li>Error</li>
393393
</ol>
394+
<p>Logging errors that occur while a web framework is running is crucial to
395+
understanding how your application is performing.
396+
<a class="reference external" href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
397+
<a class="reference external" href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
398+
aggregation application. Raven provides the way to send exceptions to
399+
Sentry, which should be deployed on a separate server from your production
400+
infrastructure. Raven can also be used by Python scripts to send other
401+
log data to Sentry for aggregation. Sentry provides a clean web application
402+
interface for viewing the exceptions. Sentry can also be configured with a
403+
mail plugin to send emails when exceptions occur.</p>
394404
</div>
395405
<div class="section" id="web-framework-resources">
396406
<h2>Web Framework Resources</h2>

‎pages/web-framework.html‎

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -53,17 +53,17 @@ <h1>Web Framework</h1>
5353
common operations include:</p>
5454
<ol class="arabic simple">
5555
<li>URL routing</li>
56-
<li>HTML, XML, JSON, and other output templating</li>
56+
<li>HTML, XML, JSON, and other output format templating</li>
5757
<li>Database manipulation</li>
58-
<li>Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection</li>
58+
<li>Security against Cross-site request forgery (CSRF) and other attacks</li>
5959
</ol>
6060
<p>Not all web frameworks include functionality for all of the above
61-
functionality. Frameworks must balance between &quot;being all things to all
62-
people but very complicated&quot; or doing only certain things well without
63-
prescription for how to do other functions.</p>
61+
functionality. Frameworks fall somewhere between simply executing a
62+
single use case and attempting to be everything to every developer with
63+
increased complexity.</p>
6464
<p>For example, the Django web application framework includes an
6565
Object-Relational Mapping (ORM) layer that abstracts relational database
66-
read, write, query, and delete operations. However, the ORM layer in Django
66+
read, write, query, and delete operations. However, Django's ORM
6767
does not work (without modification) on non-relational databases such
6868
<a class="reference external" href="http://www.mongodb.org/">MongoDB</a> and <a class="reference external" href="http://docs.basho.com/">Riak</a>.
6969
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -82,6 +82,16 @@ <h2>Web Framework Monitoring</h2>
8282
<li>Warning</li>
8383
<li>Error</li>
8484
</ol>
85+
<p>Logging errors that occur while a web framework is running is crucial to
86+
understanding how your application is performing.
87+
<a class="reference external" href="http://raven.readthedocs.org/en/latest/">Raven</a> is a Python client for the
88+
<a class="reference external" href="https://github.com/getsentry/sentry">Sentry</a> exception logging and
89+
aggregation application. Raven provides the way to send exceptions to
90+
Sentry, which should be deployed on a separate server from your production
91+
infrastructure. Raven can also be used by Python scripts to send other
92+
log data to Sentry for aggregation. Sentry provides a clean web application
93+
interface for viewing the exceptions. Sentry can also be configured with a
94+
mail plugin to send emails when exceptions occur.</p>
8595
</div>
8696
<div class="section" id="web-framework-resources">
8797
<h2>Web Framework Resources</h2>

‎source/content/pages/web-framework.rst‎

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,18 @@ provide functionality to accomplish common operations for the web. These
1010
common operations include:
1111

1212
1. URL routing
13-
2. HTML, XML, JSON, and other output templating
13+
2. HTML, XML, JSON, and other output format templating
1414
3. Database manipulation
15-
4. Cross-site request forgery (CSRF) and Cross-site scripting (XSS) protection
15+
4. Security against Cross-site request forgery (CSRF) and other attacks
1616

1717
Not all web frameworks include functionality for all of the above
18-
functionality. Frameworks must balance between "being all things to all
19-
people but very complicated" or doing only certain things well without
20-
prescription for how to do other functions.
18+
functionality. Frameworks fall somewhere between simply executing a
19+
single use case and attempting to be everything to every developer with
20+
increased complexity.
2121

2222
For example, the Django web application framework includes an
2323
Object-Relational Mapping (ORM) layer that abstracts relational database
24-
read, write, query, and delete operations. However, the ORM layer in Django
24+
read, write, query, and delete operations. However, Django's ORM
2525
does not work (without modification) on non-relational databases such
2626
`MongoDB <http://www.mongodb.org/>`_ and `Riak <http://docs.basho.com/>`_.
2727
Other web frameworks such as Flask and Pyramid are generally easier to
@@ -43,6 +43,17 @@ Logging is often grouped into several categories:
4343
3. Warning
4444
4. Error
4545

46+
Logging errors that occur while a web framework is running is crucial to
47+
understanding how your application is performing.
48+
`Raven <http://raven.readthedocs.org/en/latest/>`_ is a Python client for the
49+
`Sentry <https://github.com/getsentry/sentry>`_ exception logging and
50+
aggregation application. Raven provides the way to send exceptions to
51+
Sentry, which should be deployed on a separate server from your production
52+
infrastructure. Raven can also be used by Python scripts to send other
53+
log data to Sentry for aggregation. Sentry provides a clean web application
54+
interface for viewing the exceptions. Sentry can also be configured with a
55+
mail plugin to send emails when exceptions occur.
56+
4657

4758
Web Framework Resources
4859
-----------------------

‎source/theme/static/css/c.css‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎theme/css/c.css‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)