n d( Z> G d) d*e? Z@ G d+ d,e: ZA G d- d. ee@ ZB eB ZCe7D eC dS )/ N)datetime)contextmanager)with_metaclass) INSTRUMENTERScope)Client)Profile)NoOpSpanSpan TransactionBAGGAGE_HEADER_NAMESENTRY_TRACE_HEADER_NAME)Session)has_tracing_enablednormalize_incoming_data)exc_info_from_errorevent_from_exceptionlogger
ContextVar)
TYPE_CHECKING)Union)Any)Optional)Tuple)Dict)List)Callable) Generator)Type)TypeVar)overload)ContextManager) Integration)EventHint
BreadcrumbBreadcrumbHintExcInfo)ClientConstructorTc | S N )xs E/opt/cloudlinux/venv/lib64/python3.11/site-packages/sentry_sdk/hub.pyr" r" > s sentry_current_hubc |r|rt d |Et j | }t | r || n<| | n&|r"t j | } |j di | n| }|S )Nz cannot provide scope and kwargsr. ) TypeErrorcopycallableupdate_from_scopeupdate_from_kwargs)base scope_change scope_kwargs final_scopes r0
_update_scoper= F s ; ;9::: ioo L ! ! 8 L % % % % ) ), 7 7 7 7 ioo & &66 6666 r1 c F t j j } | sdS | j d S )NFsend_default_pii)Hubcurrentclientoptions)rB s r0 _should_send_default_piirD X s'
[
F u >, --r1 c e Zd Zd Zd Zd ZdS )
_InitGuardc || _ d S r- )_client)selfrB s r0 __init__z_InitGuard.__init__a s
r1 c | S r- r. rI s r0 __enter__z_InitGuard.__enter__e s r1 c D | j }|| d S d S r- )rH close)rI exc_type exc_valuetbcs r0 __exit__z_InitGuard.__exit__i s& L =
GGIIIII =r1 N__name__
__module__ __qualname__rJ rM rT r. r1 r0 rF rF ` sA r1 rF c t j d d } | dk s| dk r3t j d dj | t j d d S d S )N ) )r[ z1sentry-sdk 2.0.0 will drop support for Python %s.z{}.{}zQPlease upgrade to the latest version to continue receiving upgrades and bugfixes.)sys version_infor warningformat)versions r0 _check_python_deprecationsrc p sv rr"G&Gv - - ? GNG $
_
. -r1 c t | i |}t j | t t | }|S )zsInitializes the SDK and optionally integrations.
This takes the same arguments as the client constructor.
)r r@ rA bind_clientrc rF )argskwargsrB rvs r0 _initri ~ sJ T
$V
$
$FKF### F B
Ir1 c e Zd ZdS )initN)rV rW rX r. r1 r0 rk rk s r1 rk c t S r- )ri r. r1 r0 rm s E r1 c : e Zd Zed Zed ZdS )HubMetac t d }|.t t }t | |S )z(Returns the current instance of the hub.N)_localgetr@
GLOBAL_HUBset)clsrh s r0 rA zHubMeta.current s9 ZZ
:Z B JJrNNN r1 c t S )z%Returns the main instance of the hub.)rs )ru s r0 mainz HubMeta.main s
r1 N)rV rW rX propertyrA rw r. r1 r0 ro ro sH
X X r1 ro c e Zd Zd Zd Zd ZdS )
_ScopeManagerc j || _ t |j | _ |j d | _ d S N)_hublen_stack
_original_len_layer)rI hubs r0 rJ z_ScopeManager.__init__ s* __jn r1 c ( | j d }|J |S )N )r )rI scopes r0 rM z_ScopeManager.__enter__ s A r1 c L t | j j }|| j k r t j d| j |z
d S || j k r5t j d|| j z
| j j | j d | j j | j dz
}| j j | j dz
d = |d | j d k r)t j d|d | j d d S |d | j d k rd}t j | d S d S )Nz1Scope popped too soon. Popped %s scopes too many.zLeaked %s scopes: %sr z2Wrong scope found. Meant to pop %s, but popped %s.r zinit() called inside of pushed scope. This might be entirely legitimate but usually occurs when initializing the SDK inside a request handler or task/job function. Try to initialize the SDK as early as possible instead.)r r~ r r r errorr` r )rI rP rQ rR current_lenlayerr` s r0 rT z_ScopeManager.__exit__ sL $)*++ + + + LC"[0
F
4-
-
- N&d 00 !3!5!56
!3a!78 I T /! 3 5 5 6 8t{1~ % % LDa A
1XQ
'
'4
N7 # # # # # (
'r1 NrU r. r1 r0 rz rz sA % % % $ $ $ $ $r1 rz c e Zd ZdZdZerdZdZ d&dZd Z d Z
d Z d Z e
d Ze
d Zd
Zd Zd&d Zd&d
Zd&dZd Zd&dZdej fdZdej fdZd'dZe d(d Z e d Z d)dZ d Z e d(d Z e d Z d)dZ d*d Z d Z!d Z"d Z# d&d!Z$d" Z%d# Z&d(d$Z'd(d%Z(dS )+r@ zThe hub wraps the concurrency management of the SDK. Each thread has
its own hub but the hub might transfer with the flow of execution if
context vars are available.
If the hub is used with a with statement it's temporarily activated.
Nc t |t r)|}|j d \ }}|t j | }n|}|t }||fg| _ d | _ g | _ d S r| )
isinstancer@ r r5 r _last_event_id _old_hubs)rI
client_or_hubr r rB other_scopes r0 rJ z Hub.__init__ st mS ) ) # C"%*R. FK} +.."F =GGE ' "r1 c | j t j t | | S r- )r appendr@ rA rq rt rL s r0 rM z
Hub.__enter__ s1 ck***
4 r1 c l | j }t | d S r- )r poprq rt )rI rP rQ rR olds r0 rT z Hub.__exit__ s* n ""
3r1 c N | 5 | cddd S # 1 swxY w Y dS )z~Runs a callback in the context of the hub. Alternatively the
with statement can be used on the hub directly.
Nr. rI callbacks r0 runzHub.run sw 8:: s
c t |t r|}n |j |j }nt d | j }| |j | }||S dS dS )a Returns the integration for this hub by name or class. If there
is no client bound or the client does not have that integration
then `None` is returned.
If the return value is not `None` the hub is guaranteed to have a
client attached.
NzIntegration has no name)r str
identifier
ValueErrorrB integrationsrr )rI
name_or_classintegration_namerB rh s r0 get_integrationzHub.get_integration s~ mS ) ) 8 ,
%
1 , 7 677 7 $(()9::B~ ~r1 c ( | j d d S )z&Returns the current client on the hub.r} r r rL s r0 rB z
Hub.client7 {2q!!r1 c ( | j d d S )z%Returns the current scope on the hub.r} r r rL s r0 r z Hub.scope= r r1 c | j S )zReturns the last event ID.)r rL s r0
last_event_idzHub.last_event_idC s
""r1 c D | j d }||d f| j d< dS )z Binds a new client to the hub.r} r Nr )rI newtops r0 re zHub.bind_clientH s&
k"o A- Br1 c | j d \ }}t ||| }|=| d dk }| ||| }| |s|| _ |S dS )z
Captures an event.
Alias of :py:meth:`sentry_sdk.Client.capture_event`.
:param scope_args: For supported `**scope_args` see
:py:meth:`sentry_sdk.Scope.update_from_kwargs`.
r} Ntype transaction)r r= rr
capture_eventr ) rI eventhintr
scope_argsrB top_scopeis_transactionrh s r0 r zHub.capture_eventP ss !KO i
;; "YYv . .- ?N%%eT599B~n~&(#Itr1 c B | j dS |d} | j ||dfd|i|S )a
Captures a message.
:param message: The string to send as the message.
:param level: If no level is provided, the default level is `info`.
:param scope: An optional :py:class:`sentry_sdk.Scope` to use.
:param scope_args: For supported `**scope_args` see
:py:meth:`sentry_sdk.Scope.update_from_kwargs`.
:returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).
Ninfo)messagelevelr )rB r )rI r r r r s r0 capture_messagezHub.capture_messaged sR ; 4 =E!t! % 0 0
8=
AK
r1 c ( | j }|dS |t | }nt j }t ||j \ }} | j |f||d|S # t $ r) | t j Y nw xY wdS )ah Captures an exception.
:param error: An exception to catch. If `None`, `sys.exc_info()` will be used.
:param scope_args: For supported `**scope_args` see
:py:meth:`sentry_sdk.Scope.update_from_kwargs`.
:returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).
N)client_options)r r ) rB r r^ exc_infor rC r Exception_capture_internal_exception)rI r r r rB r r r s r0 capture_exceptionzHub.capture_exception| s >4 *511HH|~~H*8FNSSS t =%4%eR$eRRzRR R = = = , ,S\^^ < < < < < = ts A 0BBc 2 t j d| dS )z
Capture an exception that is likely caused by a bug in the SDK
itself.
These exceptions do not end up in Sentry and are just logged instead.
z Internal error in sentry_sdk)r N)r r )rI r s r0 r z Hub._capture_internal_exception s 3hGGGGGGr1 c | j d \ }}|t j d dS t |pd }| | |sdS t |pd }| d t
j |d< | d d|d< |j d |j d || }n|}||j
| nt j d | |j d
}t |j |k r3|j t |j |k 1dS dS ) a
Adds a breadcrumb.
:param crumb: Dictionary with the data as the sentry v7/v8 protocol expects.
:param hint: An optional value that can be used by `before_breadcrumb`
to customize the breadcrumbs that are emitted.
r} Nz*Dropped breadcrumb because no client boundr. timestampr defaultbefore_breadcrumbz)before breadcrumb dropped breadcrumb (%s)max_breadcrumbs)
r r r dictupdaterr r utcnowrC _breadcrumbsr r popleft)rI crumbr rg rB r new_crumbr s r0 add_breadcrumbzHub.add_breadcrumb sk B
> KD E E E FU[b!!
V FDJB 99[ ! ! )!) !2!2E+ 99V $ %E&M >- . :;':;E4HHII I % %i 0 0 0 0 KCU K K K .):;%$%%77 & & ( ( ( %$%%777777r1 c | j o| j j d }||k rt S t |t sd|v r|d}t |t r)t j | | | S d|v r8t j | | d } | j d
d|i|S ||S | d| | j
j }|
|j d
i |S d|vr:|
}|r| d d nd}|||d< t d
i |S ) a
Start a span whose parent is the currently active span or transaction, if any.
The return value is a :py:class:`sentry_sdk.tracing.Span` instance,
typically used as a context manager to start and stop timing in a `with`
block.
Only spans contained in a transaction are sent to Sentry. Most
integrations start a transaction at the appropriate time, for example
for every incoming HTTP request. Use
:py:meth:`sentry_sdk.start_transaction` to start a new transaction when
one is not already in progress.
For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`.
instrumenterr zcDeprecated: use start_transaction to start transactions and Transaction.start_child to start spans.nameNr trace_id-r r. )rB rC r r r
r r` start_transactionr
setdefaultr span start_childget_traceparentsplitr ) rI r r rg configuration_instrumenterdeprecation_msgr traceparentr s r0
start_spanzHub.start_span s " &*[%XT[5H 5X" 5 5 5::
dK ( ( CMV,C,C:
$ ,,
4///--d333 &&/// zz-00-t-BB4B6BBB K%&&&z #4#--f-- - V # # ..00K4?I{((--a00TH#%-z"~~f~~ r1 c F | j o| j j d }||k rt S | di }|"| d| t d i |}| |j d}| | | | t || }| | |j rD| j o$| j j d d pd
}|
| |S )
a
Start and return a transaction.
Start an existing transaction if given, otherwise create and start a new
transaction with kwargs.
This is the entry point to manual tracing instrumentation.
A tree structure can be built by adding child spans to the transaction,
and child spans to other spans. To start a new child span within the
transaction or any span, call the respective `.start_child()` method.
Every child span must be finished before the transaction is finished,
otherwise the unfinished spans are discarded.
When used as context managers, spans and transactions are automatically
finished at the end of the `with` block. If not using context managers,
call the `.finish()` method.
When the transaction is finished, it will be sent to Sentry with all its
finished child spans.
For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Transaction`.
r custom_sampling_contextNr )transaction_contextparent_sampled)sampling_context)r _experiments max_spansi )maxlenr. )rB rC r r r r
to_jsonr r _set_initial_sampling_decisionr
sampledrr init_span_recorder) rI r r rg r r r profiler s r0 r zHub.start_transaction sO 8 &*[%XT[5H 5X" 5 5 5:: "(**-F"K"K eT * * *%////K
$/#6#6#8#8 ) 8
788822DT2UUU+4000..@P.QQQ = T 3N C G G T T
* *) * < < <r1 c | 5 }| | ddd n # 1 swxY w Y t j t | ||| }|S )ze
Sets the propagation context from environment or headers and returns a transaction.
N)opr source)configure_scope generate_propagation_contextr
continue_from_headersr )rI environ_or_headersr r r r r s r0 continue_tracezHub.continue_traceB s
!
!
#
# Cu . ./A B B B C C C C C C C C C C C C C C C "7 #$6 7 7
s 7;;c d S r- r. r s r0
push_scopezHub.push_scopeR
r1 c d S r- r. r s r0 r zHub.push_scopeY r r1 Tc F |9| 5 } || ddd n # 1 swxY w Y dS | j d \ }}t j | }|r| ||f}| j | t | S )a.
Pushes a new layer on the scope stack.
:param callback: If provided, this method pushes a scope, calls
`callback`, and pops the scope again.
:returns: If no `callback` is provided, a context manager that should
be used to pop the scope again.
Nr} )r r r5 r r rz )rI r r r rB new_scope new_layers r0 r zHub.push_scope` s ""
e
4 B
Ie$$ 5 2 2 4 4 4Y' 9%%% T"""s /33c Z | j }| j s
J d |S )z{
Pops a scope layer from the stack.
Try to use the context manager :py:meth:`push_scope` instead.
z"stack must have at least one layer)r r )rI rh s r0 pop_scope_unsafezHub.pop_scope_unsafe s0 [__
{@@ @@@{ r1 c d S r- r. r s r0 r zHub.configure_scope r r1 c d S r- r. r s r0 r zHub.configure_scope r r1 c | j d \ |r | | dS t fd } | S )z
Reconfigures the scope.
:param callback: If provided, call the callback with the current scope.
:returns: If no callback is provided, returns a context manager that returns the scope.
r} Nc 3 < K V d S t V d S r- r )rB r s r0 innerz"Hub.configure_scope..inner s- ! gg
r1 )r r r )rI r r r rB r s @@r0 r zHub.configure_scope s B
1 . . 0 0 0 !4
uwwr1 applicationc | | j d \ }}t |r
|j d nd|r
|j d nd|j | |_ dS )zStarts a new session.r} releaseN environment)r r user session_mode) end_sessionr r rC _user_session)rI r rB r s r0
start_sessionzHub.start_session so
B
17AFN9--T9?I}55T%
r1 c | j d \ }}|j }d| j _ |-| || | dS dS dS )z)Ends the current session if there is one.r} N)r r r rO capture_session)rI rB r sessions r0 r zHub.end_session se B
. "
MMOOO!&&w///// !!r1 c \ | | j d \ }}d|_ dS )zStops automatic session tracking.
This temporarily session tracking for the current scope when called.
To resume session tracking call `resume_auto_session_tracking`.
r} FN)r r _force_auto_session_trackingrI rB r s r0 stop_auto_session_trackingz Hub.stop_auto_session_tracking s3
B
-2***r1 c 4 | j d \ }}d|_ dS )zResumes automatic session tracking for the current scope if
disabled earlier. This requires that generally automatic session
tracking is enabled.
r} N)r r r s r0 resume_auto_session_trackingz Hub.resume_auto_session_tracking s! B
-1***r1 c X | j d \ }}|| || S dS )z>
Alias for :py:meth:`sentry_sdk.Client.flush`
r} N)timeoutr )r flush)rI r r rB r s r0 r z Hub.flush s7 B
<<(<CC C r1 c | j Ct | j j r*| j j | j j S | j S )zX
Returns the traceparent either from the active span or from the scope.
)rB r rC r r to_traceparentr rL s r0 r zHub.get_traceparent sT
; ""4;#677
8DJON ++--
*1133
r1 c |t j d d}| }||dt d|dz
}| }||dt
d|dz
}|S )z
Return meta tags which should be injected into HTML templates
to allow propagation of trace information.
NzaThe parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future. z )r r` r r r r )rI r meta sentry_tracer s r0 trace_propagation_metazHub.trace_propagation_meta+ s Ns
++-- # D(((
D
""$$ D###
D
r1 )NN)NNNr- )NT)r ))rV rW rX __doc__r r rA rw rJ rM rT r r rx rB r r re r r r r r r SENTRYr r r r" r r r r r r r r r r r! r& r. r1 r0 r@ r@ s F ( 0 " " X"
" " X"
# # #
( ( ( (
0 6
H
H
H') ') ') ')R # 1D 6 6 6 6 r \-@< < < <|
X
X
# # # #@
X
X
" " " "J )
0
0
0 3 3 32 2 2 D D D D , , , & * r1 r@ )Er5 r^ r
contextlibr sentry_sdk._compatr sentry_sdk.constsr sentry_sdk.scoper sentry_sdk.clientr sentry_sdk.profilerr
sentry_sdk.tracingr r r
r r sentry_sdk.sessionr sentry_sdk.tracing_utilsr r sentry_sdk.utilsr r r r sentry_sdk._typesr typingr r r r r r r r r r! r" r# sentry_sdk.integrationsr$ r% r& r' r( r) r* r+ rq r= rD objectrF rc ri rk r ro rz r@ rs rt r. r1 r0 r7 s_
% % % % % % - - - - - - * * * * * * " " " " " " $ $ $ $ $ $ ' ' ' ' ' ' ' & & & & &
, + + + + + %%%%%%333333 433333 AA
( ) ) $. . .
, + + + + +
*
MM D d $-$ -$ -$ -$ -$F -$ -$ -$`e e e e e ..
!
! e e e P SUU
: r1