jy ~ddlZddlZddlmZmZmZddlmZddlmZddl Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZerddlmZmZmZdd lmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'm(Z(e!d Z)e#d Z*dd l+m,Z,m-Z-m.Z.m/Z/ddlm0Z0ddl1m2Z2Gdde'dZ3Gdde3dZ4e'dde5iZ6dZ7dZ8Gdde5eZ9e9j:gZ;e9j<e9j<e9j<e9j=e9j:e9j<e9j=e9j=e9j=d Z>de?de5fdZ@Gd d!ZAGd"d#ZBGd$d%eBZCGd&d'eBZDer0e% d9dddejEd( d:d2ZFe%d;d4ZF d9dddejEd( dr?r@ COMPONENTCUSTOMROUTETASKURLVIEWrAr^rDrErFrQrQsMI F E D C DrErQ) endpoint function_name handler_namemethod_and_path_patternpath route_name route_pattern uri_templaterVhttp_status_coderXc|dkr tjSd|cxkrdkr{nnx|dkr tjS|dkr tjS|dkr tjS|dkr tjS|dkr tjS|dkr tjStjSd|cxkrd krEnnB|d kr tj S|d kr tj S|d kr tj Stj Stj S) z Returns the Sentry status corresponding to the given HTTP status code. See: https://develop.sentry.dev/sdk/event-payloads/contexts/#trace-context iiiiiiiiiXiii)r OKPERMISSION_DENIED NOT_FOUNDRESOURCE_EXHAUSTEDFAILED_PRECONDITIONUNAUTHENTICATEDALREADY_EXISTSINVALID_ARGUMENTDEADLINE_EXCEEDED UNIMPLEMENTED UNAVAILABLEINTERNAL_ERROR UNKNOWN_ERROR)rms rFget_span_status_from_http_coder|s, #}  & & & &3 & & & & & s " "/ /  $ $' '  $ $0 0  $ $1 1  $ $- -  $ $, ,. .  & & & &3 & & & & & s " "/ /  $ $+ +  $ $) ), ,  ##rEc.eZdZdZdZdeddfdZd d ZdS) _SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspans dropped_spansrrXNc6|dz |_g|_d|_dS)Nrrr]rs rF__init__z_SpanRecorder.__init__s$ qj #% "#rEspanSpanct|j|jkrd|_|xjdz c_dS|j|dS)Nr)lenrr_span_recorderrappend)r]rs rFaddz_SpanRecorder.addsU tz??T[ ( ("&D    ! #     J  d # # # # #rE)rrrXN)r>r?r@__doc__ __slots__intrrrDrErFr~r~sU??4I$s$t$$$$$$$$$$rEr~ceZdZdZdZ d\ddddd dd ed d d ddddddddddddddeddddfdZdeddfdZ e defdZ e j deddfd Z e defd!Z e j deddfd"Z defd#Zd]d$Z d^d(Ze d_d)Zejfd*ed+d,ddfd-Ze d`d1Zedd2 dad5Zdbd7Ze dcd9Zdefd:Zddd<Zd=edd,ddfd>Zd=edd,ddfd?ZdedBZdCedDeddfdEZdeddfdFZ dfdede!dHdIddfdJZ" dgdNZ#dhdPZ$dQeddfdRZ%defdSZ& di djdVZ'dkdWZ(dldXZ)dmdZZ*dnd[Z+eZ,eZ-eZ.e)Z/dS)orakA span holds timing information of a block of code. Spans can have multiple child spans thus forming a span tree. :param trace_id: The trace ID of the root span. If this new span is to be the root span, omit this parameter, and a new trace ID will be generated. :param span_id: The span ID of this span. If omitted, a new span ID will be generated. :param parent_span_id: The span ID of the parent span, if applicable. :param same_process_as_parent: Whether this span is in the same process as the parent span. :param sampled: Whether the span should be sampled. Overrides the default sampling decision for this span when provided. :param op: The span's operation. A list of recommended values is available here: https://develop.sentry.dev/sdk/performance/span-operations/ :param description: A description of what operation is being performed within the span. .. deprecated:: 2.15.0 Please use the `name` parameter, instead. :param name: A string describing what operation is being performed within the span. :param hub: The hub to use for this span. .. deprecated:: 2.0.0 Please use the `scope` parameter, instead. :param status: The span's status. Possible values are listed at https://develop.sentry.dev/sdk/event-payloads/span/ :param containing_transaction: The transaction that this span belongs to. :param start_timestamp: The timestamp when the span started. If omitted, the current time will be used. :param scope: The scope to use for this span. If not provided, we use the current scope. ) _trace_id_span_idr.r/r0r1r2 _measurementsr9_start_timestamp_monotonic_nsr5 timestamp_tags_datarr4_context_manager_state_containing_transactionr:r;r<_flags_flags_capacityNTmanualr, Optional[str]r-r.r/r0Optional[bool]r1r2r4r3r5r7r6r9r8r:Optional[sentry_sdk.Scope]r;r<rXc||_||_||_||_||_||_|p||_| |_||_| |_ | |_ i|_ i|_ i|_ | |_i|_d|_|/t#jdt&d|j p|j |_ | t)jt,j} n4t1| t2rt)j| t,j} | |_ t9|_n#t<$rYnwxYwd|_d|_ |!|"tGdS)N z>The `hub` parameter is deprecated. Please use `scope` instead. stacklevel)$rrr.r/r0r1r2r5r4r:r;rrrrrrwarningswarnDeprecationWarningrnowrutc isinstancefloat fromtimestampr9rrAttributeErrorrrupdate_active_threadset_profiler_idr )r]r,r-r.r/r0r1r2r4r5r7r9r:r;r<s rFrz Span.__init__s"" ,&<# .;   <>13 ') '=$)+ ! ? MP"     0syDJ  "&l8<88OO  / / T&4_hlSSO. 2A1B1BD . .    D 049= !!### _../////sD D)(D)rc@|jt||_dSdSrZ)rr~rs rFinit_span_recorderzSpan.init_span_recorder[s)   &"/"7"7D    ' &rEcX|jstjj|_|jSrZ)ruuiduuid4hexr\s rFr,z Span.trace_id_s$~ .!Z\\-DN~rEr[c||_dSrZ)rr]r[s rFr,z Span.trace_idfs rEch|js%tjjdd|_|jS)N)rrrrr\s rFr-z Span.span_idjs-} 2 JLL,RSS1DM}rEc||_dSrZ)rrs rFr-z Span.span_idqs  rEcd|jjd|jd|jd|jd|jd|jd|jd|jd S) N) __class__r>r1r2r,r-r.r0r;r\s rF__repr__z Span.__repr__usc'''     ###    rEch|jptj}|j}||_||f|_|SrZ)r: sentry_sdkget_current_scoperr)r]r:old_spans rF __enter__zSpan.__enter__s7        ' VD,G,V   %   e $ $ $ rEenvironMapping[str, str] Transactionc @tjt|fi|S)ag DEPRECATED: Use :py:meth:`sentry_sdk.continue_trace`. Create a Transaction with the given params, then add in data pulled from the ``sentry-trace`` and ``baggage`` headers from the environ (if any) before returning the Transaction. This is different from :py:meth:`~sentry_sdk.tracing.Span.continue_from_headers` in that it assumes header names in the form ``HTTP_HEADER_NAME`` - such as you would get from a WSGI/ASGI environ - rather than the form ``header-name``. :param environ: The ASGI/WSGI environ to pull information from. )rcontinue_from_headersEnvironHeaders)clsrrs rFcontinue_from_environzSpan.continue_from_environs%(01H1HSSFSSSrE _sample_randheadersrc tjdtj|t |}|t |it|t}|)||| tdi|}d|_ |S)a DEPRECATED: Use :py:meth:`sentry_sdk.continue_trace`. Create a transaction with the given params (including any data pulled from the ``sentry-trace`` and ``baggage`` headers). :param headers: The dictionary with the HTTP headers to pull information from. :param _sample_rand: If provided, we override the sample_rand value from the incoming headers with this value. (internal use only) z2Deprecated: use sentry_sdk.continue_trace instead.rNFrD) rwarningrLfrom_incoming_headerrBAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezerr/)rrrrrMsentrytrace_kwargs transactions rFrzSpan.continue_from_headerss$ KLLL. KK+ , ,<     *G45555 KK0 1 1    ) MM, - - - NN   !++F++ -2 *rEIterator[Tuple[str, str]]c#K|jsdSt|fV|j}|r t |fVdSdS)z Creates a generator which returns the span's ``sentry-trace`` and ``baggage`` headers. If the span's containing transaction doesn't yet have a ``baggage`` value, this will cause one to be generated and stored. N)r7rto_traceparent get_baggage serializer)r]rMs rF iter_headerszSpan.iter_headerss *  F&(;(;(=(=====-99;;EEGG  /%w. . . . . . / /rE traceparentc 4|sdS|jt|ifi|S)z DEPRECATED: Use :py:meth:`sentry_sdk.continue_trace`. Create a ``Transaction`` with the given params, then add in data pulled from the given ``sentry-trace`` header value before returning the ``Transaction``. N)rr)rrrs rFfrom_traceparentzSpan.from_traceparent"s= 4(s( %{ 3  7=   rEcp|jdurd}n|jdurd}nd}|jd|j}||d|z }|S)NT1F0-)r0r,r-)r]r0rs rFrzSpan.to_traceparent5s` <4  GG \U " "GGG!% =   KGG- -KrEOptional[Baggage]cF|jr|jSdS)zReturns the :py:class:`~sentry_sdk.tracing_utils.Baggage` associated with this ``Span``, if any. (Taken from the root of the span tree.) N)r7rr\s rF to_baggagezSpan.to_baggageCs)  & =.::<< <trEkeyc||j|<dSrZ)rr]rr[s rFset_tagz Span.set_tagK 3rEc||j|<dSrZ)rrs rFset_dataz Span.set_dataNrrEdataDict[str, Any]c:|j|dSrZ)rrr]r s rF update_datazSpan.update_dataQs $rEflagresultcXt|j|jkr ||j|<dSdSrZ)rrr)r]rrs rFset_flagz Span.set_flagTs4 t{  d2 2 2 &DK    3 2rEc||_dSrZr5rs rFrzSpan.set_statusXs  rEunitr%cXtjdtd||d|j|<dSz .. deprecated:: 2.28.0 This function is deprecated and will be removed in the next major release. zq`set_measurement()` is deprecated and will be removed in the next major version. Please use `set_data()` instead.rr)r[rNrrrrr]r<r[rs rFset_measurementzSpan.set_measurement[C       .3D#A#A4   rE thread_id Optional[int] thread_namec|Q|tjt||$|tj|dSdSdSrZ)r r THREAD_IDrA THREAD_NAMEr]rr s rF set_threadzSpan.set_threadjsZ  MM(,c)nn = = =& h2K@@@@@ ! '&rErOcN|"|tj|dSdSrZ)r r PROFILER_IDr]rOs rFrzSpan.set_profiler_idss-  " MM(. < < < < < # "rE http_statusc|dt||tj||t |dS)Nzhttp.status_code)rrAr r HTTP_STATUS_CODErr|r]r)s rFset_http_statuszSpan.set_http_statusws_ K 0 0    h/=== 6{CCDDDDDrEc|jdkS)Nokrr\s rF is_successzSpan.is_success~s{d""rE end_timestamp Optional[Union[float, datetime]]c|jdS |r %4 8 mU33X$,$:=(,$W$WM!.)++d.PP!%!5 !(4999" 8 8 8%\(,77DNNN 87577 3355  I 6$*DI G4/""5))JTW-?-? -J-J  IM I 6HHH*5$777tsA4B-B0/B0c |j|j|j|j|j|j|j|j|jd }|j r|j |d<|j |j d<t|j dkr |j |d<|j }|r||d<i}| |j| |j|r||d<|S)z5Returns a JSON-compatible representation of the span.) r,r-r.r/r1r2r9rr;r5r measurementstagsr )r,r-r.r/r1r2r9rr;r5rrrrrr)r]rvr?r s rFto_jsonz Span.to_jsons |"1&*&A'+#3k  ; /;BxL#';DJx t! " "Q & &!%!3B~ z  BvJ DK    DJ  BvJ rEc|j|j|j|j|j|jd}|jr |j|d<|jr.|j |d<i}|j tj }|||d<|j tj}|||d<|r||d<|S)N)r,r-r.r1r2r;r5dynamic_sampling_contextz thread.idz thread.namer )r,r-r.r1r2r;r5r7rrCrrr r"r#)r]r@r rr s rFget_trace_contextzSpan.get_trace_contexts |"1'+k    ; ';BxL  & +7799RRTT ) *JNN8#566  )D jnnX%9::  ""-D   BvJ rEOptional[ProfileContext]cZ|jtj}|dSd|iS)NrO)rrr r'r(s rFget_profile_contextzSpan.get_profile_contexts4jnnX%9::  4 ;  rEcTt\}}|||dSrZ)rr%r$s rFrzSpan.update_active_threads,!8!:!: ;  ;/////rE)NNNTNNNNNNNNrN)rXrrrr[rrrrXNrXr6)rrrrrXr)rrrrrrrXrrXr)rrrrrXr6rXrr r rXNr)rrr rrXN)rOrrXNNN)r:rr1r2rXrrXr rXr)rXrE)rXN)0r>r?r@rrrCrArrrpropertyr,setterr-rrrr7rSENTRYr classmethodrrrrrrrr rrrrrr%rr-r0rrArDrGr_to_traceparent _to_baggage _iter_headers_get_trace_contextrDrErFrrs:I8%)#'*.'+$("'+*."&:>>B.2 $>0>0!>0!>0( >0 !% >0 " >0 >0%>0(>0 >0!8>0<>0,>0>0>0 !>0>0>0>0D888888#X _cd_X  ^ST^  #      "! "*9 "?N "  " " " ",,,X,#/"5)))AF) ))))VT$TT  TTT[T* )- ))$)& )  )  )))[)V////& $   !    [ $      3 u      C  $        'S'$'4''''BD B B B % B-> B  B B B BA(A7FA AAAA====E3E4EEEE#D#### /3<@2+2:2  2222h!!!!F@    0000 %OK M*rErc neZdZdZdZdddejfdedddd d ed d d df fd Zd efdZ d e fdZ d7fd Z d8fd Z ed7dZ d9dZd efdZ d:dd d;fd%Z dfd1 Zd?d3Z d@d6ZeZeZxZS)AraiThe Transaction is the root element that holds all the spans for Sentry performance instrumentation. :param name: Identifier of the transaction. Will show up in the Sentry UI. :param parent_sampled: Whether the parent transaction was sampled. If True this transaction will be kept, if False it will be discarded. :param baggage: The W3C baggage header value. (see https://www.w3.org/TR/baggage/) :param source: A string describing the source of the transaction name. This will be used to determine the transaction's type. See https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations for more information. Default "custom". :param kwargs: Additional arguments to be passed to the Span constructor. See :py:class:`sentry_sdk.tracing.Span` for available arguments. ) r<rJrK sample_rater _contexts_profile_continuous_profile_baggagerrNr<rKrrMrrJrzUnpack[SpanKwargs]rXc Dtjdi|||_||_d|_||_i|_i|_d|_d|_ ||_ |j dn|j }| ||_ dSt|j |_ dSNrD)superrr<rJr[rKrr\r]r^r_r_generate_sample_randr,)r]r<rKrMrJrbaggage_sample_randrs rFrzTransaction.__init__,s ""6"""  .2,<>+--1 BF  M)DDt}/I/I/K/K   * 3D    5dm D DD   rEcd|jjd|jd|jd|jd|jd|jd|jd|jd |j d S) Nrz(name=z, op=rrrrz , source=rr) rr>r<r1r,r-r.r0rJr;r\s rFrzTransaction.__repr__Hsi'''   ###     rEc&|jdup|jduS)zReturns whether the transaction might have been started. If this returns False, we know that the transaction was not started with sentry_sdk.start_transaction, and therefore the transaction will be discarded. NF)rr0r\s rF_possibly_startedzTransaction._possibly_startedXs"$.G$,%2GGrEc|stjdt|j|j|S)NzTransaction was entered without being started with sentry_sdk.start_transaction.The transaction will not be sent to Sentry. To fix, start the transaction bypassing it to sentry_sdk.start_transaction.)rgrdebugrbrr])r]rs rFrzTransaction.__enter__csi%%''  L>     = $ M # # % % % rErrr[rc|j|j||||j|jt |||dSrZ)r]rr^stoprb)r]rr[rrs rFrzTransaction.__exit__rsg = $ M " "2ub 1 1 1  # /  $ ) ) + + + UB'''''rEc|S)znThe root element of the span tree. In the case of a transaction it is the transaction itself. rDr\s rFr7z"Transaction.containing_transaction}s  rE scope_arg1Optional[Union[sentry_sdk.Scope, sentry_sdk.Hub]]hub_argrc|}|tjdtd|}t|tjr#tjdtd|jS|S)z Logic to get the scope from the arguments passed to finish. This function exists for backwards compatibility with the old finish. TODO: Remove this function in the next major version. NzMThe `hub` parameter is deprecated. Please use the `scope` parameter, instead.rzDPassing a Hub to finish is deprecated. Please pass a Scope, instead.)rrrrrHubr:)r]rmro scope_or_hubs rF_get_scope_from_finish_argsz'Transaction._get_scope_from_finish_argss!   M_"     #L lJN 3 3 & MV"      % %rEcbd|jr d|jzdznd|jS)Nz{op}transaction <{name}>rz> r)r1r<)formatr1r<r\s rF_get_log_representationz#Transaction._get_log_representations=)00(,7dg $$Rty1   rEr4r:r1r2r4r3rc h|jdS|||}|p|jptj}tj}|sdS|j|jdurtj dntj d|j rht|j rT|jr|jjdkrd}nd}|j |d |j |d dS|jstjd d |_t'|||jt.j}|||j d vrtj d||jt.j|j d |j rU|j dd t7|jjdz}|j dd |d|_|js|jtjddSd|jjD}t7|jjt7|z } | |jjz} d|_i} | |j| d| i|!} | | d| id|jd|j"i| |j#|j|j$|d} | dkr| | d<|j%*|j%&r|j%| d<d|_%|j'| d<|(| S)auFinishes the transaction and sends it to Sentry. All finished spans in the transaction will also be sent to Sentry. :param scope: The Scope to use for this transaction. If not provided, the current Scope will be used. :param end_timestamp: Optional timestamp that should be used as timestamp instead of the current time. :param hub: The hub to use for this transaction. This argument is DEPRECATED. Please use the `scope` parameter, instead. :return: The event ID if the transaction was sent to Sentry, otherwise None. NFz.Discarding transaction because sampled = FalsezSDiscarding transaction because it was not started with sentry_sdk.start_transactionr backpressurer[r) data_categoryrzCTransaction has no name, falling back to ``.ztrace_ignore_status_codesz[Tracing] Discarding {transaction_description} because the HTTP status code {status_code} is matched by trace_ignore_status_codes: {trace_ignore_status_codes})transaction_description status_coder|event_processorr)r{quantityz1Discarding transaction without sampling decision.cDg|]}|j |SrZ)rrA).0rs rF z&Transaction.finish..s2   ~) LLNN)))rEtraceprofilerJ)typertransaction_infocontextsr?rr9r_dropped_spansr>))rrtr:rrr is_activerr0rri transporthas_tracing_enabledrmonitordownsample_factorrecord_lost_eventr<rrbrrrr r+rvrwrrrrr\rDrGrJrr9r]validr capture_event)r]r:r1r4clientreasonr~ num_spansfinished_spanslen_diffrrprofile_contexteventrs rFrzTransaction.finishs* > %4/3.N.N 3/ / EEz'C'E'E&((!! 4   &|u$$ MNNNN i Q$7$G$G Q>+fn&F&J&J+FF*F 2262WWW 2262PPP4y 2 NU   2DI um,,,jnnX%>??  #v~.IJJJ Lqxx,0,H,H,J,J $ 8+D E.4n3/x     22%]3  3 9::Q>  22%Vi3!DL| |#RSSS4  +1    t*011C4G4GG 4#6#DD #'''$"8"8":":;<<<2244  & OOY8 9 9 9"9!)4; 7 J#3#    1  &3E" # = $)<)<)>)> $#}E)  DM $ 2n""5)))rErr%cXtjdtd||d|j|<dSrrrs rFrzTransaction.set_measurementArrErdict[str, Any]c||j|<dS)aSets a context. Transactions can have multiple contexts and they should follow the format described in the "Contexts Interface" documentation. :param key: The name of the context. :param value: The information about the context. N)r\rs rF set_contextzTransaction.set_contextPs$srEr)czt||dd|idS)zySets the status of the Transaction according to the given HTTP status. :param http_status: The HTTP status code.responser~N)rbr-r)r]r)rs rFr-zTransaction.set_http_statusZs>  ,,, m[%ABBBBBrEr ct}|j|d<|j|d<|j|d<|S)z">"@"@#6>22  DL F < #$T\22D  F**+;<<==  ,FN+ ,-= > > > $$45A!!122^$89 $K BBB  N`gg,Ch    !DL F -- > D   6>#C C C    LQXX,C$FN$6$67G$H$HII><<= Y   !DL F(4+;; <  L>EE,CF      LPWW,C $ 0W     rE)rXrrI)rmrnrornrXrrOr:rr1r2r4r3rXrrNrPrQ)rXrLrr'rXN)r>r?r@rrrQr`rArrrCrgrrrRr7rtrwrrrrrr-rArDrr _get_baggagerY __classcell__)rs@rFrr s>" I +/'+'. EEE)E% E  E ' E EEEEEE8 #    H4 H H H H       (! (*9 (?N (  ( ( ( ( ( (XFE & @     /3<@R* +/ R*R*+R*:R* ( R*  R*R*R*R*R*R*jBD B B B % B-> B  B B B B$s$+;$$$$$C3C4CCCCCC    c 1c ccccLL*rErc reZdZdefdZed3dZejfdeddddfdZ defd Z d4d Z d4d Z d5dZ deddddfdZdeddddfdZd6dZdeddfdZdeddfdZdefdZd7dZd8dZd8dZ d9dd d:d&Z d;d(eded)d*ddfd+Zdedd,ddfd-Zd.eddfd/Z d)rr>r\s rFrzNoOpSpan.__repr__s///rEr6cdSrZrDr\s rFr7zNoOpSpan.containing_transactionstrErrrc tSrZ)r)r]rrs rFrzNoOpSpan.start_childszzrEcdS)NrrDr\s rFrzNoOpSpan.to_traceparentsrrErcdSrZrDr\s rFrzNoOpSpan.to_baggagetrEcdSrZrDr\s rFrzNoOpSpan.get_baggagerrErc tdSra)iterr\s rFrzNoOpSpan.iter_headerss BxxrErr[NcdSrZrDrs rFrzNoOpSpan.set_tag rEcdSrZrDrs rFr zNoOpSpan.set_datarrEr r cdSrZrDrs rFrzNoOpSpan.update_datarrEcdSrZrDrs rFrzNoOpSpan.set_status rrEr)cdSrZrDr,s rFr-zNoOpSpan.set_http_status rrEcdS)NTrDr\s rFr0zNoOpSpan.is_successrrEciSrZrDr\s rFrAzNoOpSpan.to_json rEciSrZrDr\s rFrDzNoOpSpan.get_trace_contextrrEciSrZrDr\s rFrGzNoOpSpan.get_profile_contextrrErxr:rr1r2r4r3rcdS)z_ The `hub` parameter is deprecated. Please use the `scope` parameter, instead. NrD)r]r:r1r4s rFrzNoOpSpan.finish  rErr<rr%cdSrZrDrs rFrzNoOpSpan.set_measurement(  rErcdSrZrDrs rFrzNoOpSpan.set_context-rrErcdSrZrDrs rFrzNoOpSpan.init_span_recorder0rrErr'cdSrZrD)r]rs rFrz'NoOpSpan._set_initial_sampling_decision3rrErJrLrKrMrPrQrOrrNr)$r>r?r@rArrRr7rrTrrrrrrr rrrr-rCr0rArDrGrrrrrrrVrWrrXrYrDrErFrrs0#0000X#/"5AF   3 u      C  $               3 4    D /3<@  +/   +  :  (       BD   % ->      s +;            1     %OKL M*rErr1r< attributestemplatefuncr1rr<rOptional[dict[str, Any]]rr *Callable[[Callable[P, R]], Callable[P, R]]cdSrZrD)rr1r<rrs rFrrBrrECallable[P, R]cdSrZrD)rs rFrrNrrEOptional[Callable[P, R]]AUnion[Callable[P, R], Callable[[Callable[P, R]], Callable[P, R]]]cJddlm}|||||}|r ||S|S)a Decorator to start a child span around a function call. This decorator automatically creates a new span when the decorated function is called, and finishes the span when the function returns or raises an exception. :param func: The function to trace. When used as a decorator without parentheses, this is the function being decorated. When used with parameters (e.g., ``@trace(op="custom")``, this should be None. :type func: Callable or None :param op: The operation name for the span. This is a high-level description of what the span represents (e.g., "http.client", "db.query"). You can use predefined constants from :py:class:`sentry_sdk.consts.OP` or provide your own string. If not provided, a default operation will be assigned based on the template. :type op: str or None :param name: The human-readable name/description for the span. If not provided, defaults to the function name. This provides more specific details about what the span represents (e.g., "GET /api/users", "process_user_data"). :type name: str or None :param attributes: A dictionary of key-value pairs to add as attributes to the span. Attribute values must be strings, integers, floats, or booleans. These attributes provide additional context about the span's execution. :type attributes: dict[str, Any] or None :param template: The type of span to create. This determines what kind of span instrumentation and data collection will be applied. Use predefined constants from :py:class:`sentry_sdk.consts.SPANTEMPLATE`. The default is `SPANTEMPLATE.DEFAULT` which is the right choice for most use cases. :type template: :py:class:`sentry_sdk.consts.SPANTEMPLATE` :returns: When used as ``@trace``, returns the decorated function. When used as ``@trace(...)`` with parameters, returns a decorator function. :rtype: Callable or decorator function Example:: import sentry_sdk from sentry_sdk.consts import OP, SPANTEMPLATE # Simple usage with default values @sentry_sdk.trace def process_data(): # Function implementation pass # With custom parameters @sentry_sdk.trace( op=OP.DB_QUERY, name="Get user data", attributes={"postgres": True} ) def make_db_query(sql): # Function implementation pass # With a custom template @sentry_sdk.trace(template=SPANTEMPLATE.AI_TOOL) def calculate_interest_rate(amount, rate, years): # Function implementation pass r)create_span_decoratorr)sentry_sdk.tracing_utilsr)rr1r<rrr decorators rFrrTsXT?>>>>>%%  I yrE)rLrrcrrr8rZ) rNr1rr<rrrrr rXr)rrrXr) rrr1rr<rrrrr rXr)Nrrrrrenumrtypingrrsentry_sdk.constsrr r r 'sentry_sdk.profiler.continuous_profilerr sentry_sdk.utilsr rrrrrcollections.abcrrrrrrrrrrrrrtyping_extensionsr r!r"r#sentry_sdk._typesr$r%r&r'r((sentry_sdk.profiler.transaction_profilerr)r+rIrArNrrrQrcLOW_QUALITY_TRANSACTION_SOURCESr_raSOURCE_FOR_STYLErr|r~rrrDEFAULTrrrLrrcrrr8rDrErFrs 2222222222 NNNNNNNNNNNNCCCCCCkAAAAAAAAAA                        43333333 #A A JIIIII@@@@@@9a9a9a9a9aYe9a9a9a9av Q Q Q Q QJe Q Q Q QY 3 N )     T   # "+&0%/06  !#-&,%+  "  #$S#$S#$#$#$#$L$$$$$$$$.h+h+h+h+h+h+h+h+VY+Y+Y+Y+Y+$Y+Y+Y+xU+U+U+U+U+tU+U+U+p    # $15#/#7          /  !   6    X     X (,V -1+3 VV $V V  V + V  VIVVVVvrE