Current File : //lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l m
Z
y& d d l Z d d l m
Z
e Z Wn e k
r� e Z n Xe j e � Z i Z i Z d Z d � Z d � Z d d � Z d S(
uK
Sentry Logging Handler
======================
.. versionadded:: 0.17.0
This module provides a `Sentry`_ logging handler. Sentry is an open source
error tracking platform that provides deep context about exceptions that
happen in production. Details about stack traces along with the context
variables available at the time of the exception are easily browsable and
filterable from the online interface. For more details please see
`Sentry`_.
.. admonition:: Note
The `Raven`_ library needs to be installed on the system for this
logging handler to be available.
Configuring the python `Sentry`_ client, `Raven`_, should be done under the
``sentry_handler`` configuration key. Additional `context` may be provided
for corresponding grain item(s).
At the bare minimum, you need to define the `DSN`_. As an example:
.. code-block:: yaml
sentry_handler:
dsn: https://pub-key:secret-key@app.getsentry.com/app-id
More complex configurations can be achieved, for example:
.. code-block:: yaml
sentry_handler:
servers:
- https://sentry.example.com
- http://192.168.1.1
project: app-id
public_key: deadbeefdeadbeefdeadbeefdeadbeef
secret_key: beefdeadbeefdeadbeefdeadbeefdead
context:
- os
- master
- saltversion
- cpuarch
- ec2.tags.environment
.. admonition:: Note
The ``public_key`` and ``secret_key`` variables are not supported with
Sentry > 3.0. The `DSN`_ key should be used instead.
All the client configuration keys are supported, please see the
`Raven client documentation`_.
The default logging level for the sentry handler is ``ERROR``. If you wish
to define a different one, define ``log_level`` under the
``sentry_handler`` configuration key:
.. code-block:: yaml
sentry_handler:
dsn: https://pub-key:secret-key@app.getsentry.com/app-id
log_level: warning
The available log levels are those also available for the salt ``cli``
tools and configuration; ``salt --help`` should give you the required
information.
Threaded Transports
-------------------
Raven's documents rightly suggest using its threaded transport for
critical applications. However, don't forget that if you start having
troubles with Salt after enabling the threaded transport, please try
switching to a non-threaded transport to see if that fixes your problem.
.. _`DSN`: https://raven.readthedocs.io/en/latest/config/index.html#the-sentry-dsn
.. _`Sentry`: https://getsentry.com
.. _`Raven`: https://raven.readthedocs.io
.. _`Raven client documentation`: https://raven.readthedocs.io/en/latest/config/index.html#client-arguments
i ( t absolute_importt print_functiont unicode_literalsN( t
LOG_LEVELS( t
SentryHandleru sentryc C@ s t t k r t St S( N( t HAS_RAVENt Truet __virtualname__t False( ( ( s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyt __virtual__r s c @ sa t j j t � } t j j t � } d t k rA t j d � t Si } t d � } | d k r� yo d d l
m } m } d d l
m } | | � } | | � } | j | j � s� t d j | j � � � n Wq� t k
r� } t j d | � q� Xn | sexe d# D]Z }
t |
� } | d k rB|
| k rBt j d
|
� d S| d k rTqn | | |
<qWn | j i
t d � d 6t d � d 6t d d$ � d 6t d d% � d 6t d � d 6t d � d 6t d � d 6t d d � d 6t d � d 6| d 6� t j | � } t d � }
i } |
d k r�xV |
D]N } y | | } Wn$ t k
ret j d | � q+n X| r+| | | <q+q+W| r�| j j i | d 6� q�n y� t | � } t d d � } | rg | D] } t j | � ^ q�� d t f � f d � � Y} | j | � � n | j t t d d � � | SWn& t k
r\} t j d! d" t! �n Xd S(& u$
sets up the sentry handler
u sentry_handleru6 No 'sentry_handler' key was found in the configurationu dsni ( t TransportRegistryt default_transports( t urlparseu" Unsupported Sentry DSN scheme: {0}u8 Raven failed to parse the configuration provided DSN: %su projectu serversu
public_keyu
secret_keyu~ The required 'sentry_handler' configuration key, '%s', is not properly configured. Not configuring the sentry logging handler.Nu siteu nameu
exclude_pathsu
include_pathsu list_max_lengthu string_max_lengthu auto_log_stacksu timeouti u
processorsu contextu$ Sentry tag '%s' not found in grains.u tagsu exclude_patternst FilterExcludedMessagesc @ s e Z e � f d � � Z RS( c @ s' | j � � t � f d � � D� � S( Nc 3@ s | ] } | j � � Vq d S( N( t search( t .0t regex( t m( s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pys <genexpr>� s ( t
getMessaget any( t record( t filter_regexes( R s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyt filter� s ( t __name__t
__module__t staticmethodR ( ( R ( s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyR
� s u log_levelu erroru* Failed to setup the sentry logging handlert exc_info( u projectu serversu
public_keyu
secret_key( ( (" t saltt loadert grainst __opts__t minion_modst logt debugR t get_config_valuet Nonet raven.transportR
R t raven.utils.urlparseR t supported_schemet schemet
ValueErrort formatt infot updatet ravent Clientt KeyErrort contextt mergeR t ret compilet objectt addFiltert setLevelR R ( t
__grains__t __salt__t optionst dsnR
R R t transport_registryt urlt exct keyt config_valuet clientR/ t context_dictt tagt tag_valuet handlert exclude_patternst patternR
( ( R s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyt setup_handlersx s�
" c C@ s t d j | | � S( u?
returns a configuration option for the sentry_handler
u sentry_handler( R t get( t namet default( ( s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyR" � s ( t __doc__t
__future__R R R t loggingR1 t salt.loaderR t salt.logR R, t raven.handlers.loggingR R R t ImportErrorR t getLoggerR R R6 R7 R R RF R# R" ( ( ( s@ /usr/lib/python2.7/site-packages/salt/log/handlers/sentry_mod.pyt <module>W s$
v
Mini Shell