tnig ddlZddlZddlmZmZmZddlmZddlmZddl Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZerddlmZmZmZdd lmZmZmZmZm Z m!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/m0Z0ddlm1Z1ddl2m3Z3Gdde(dZ4Gdde4dZ5e(dde6iZ7dZ8dZ9Gdde6eZ:e:j;gZe:j;e:j=e:j>e:j>e:j>d Z?de@de6fdZAGd d!ZBGd"d#ZCGd$d%eCZDGd&d'eCZEer0e& d9dddejFd( d:d2ZGe&d;d4ZG d9dddejFd( drErFrGrJrJls=  PPrFrJProfileContext profiler_idrNz sentry-tracec2eZdZdZdZdZdZdZdZde fdZ d S) TransactionSource componentcustomroutetaskurlviewreturnc|jSN)valueselfs rG__str__zTransactionSource.__str__s zrFN) r?r@rA COMPONENTCUSTOMROUTETASKURLVIEWrBr_rErFrGrRrRsMI F E D C DrFrR) endpoint function_name handler_namemethod_and_path_patternpath route_name route_pattern uri_templaterWhttp_status_coderYc|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)rns rGget_span_status_from_http_coder}s, #}  & & & &3 & & & & & s " "/ /  $ $' '  $ $0 0  $ $1 1  $ $- -  $ $, ,. .  & & & &3 & & & & & s " "/ /  $ $+ +  $ $) ), ,  ##rFc.eZdZdZdZdeddfdZd d ZdS) _SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspans dropped_spansrrYNc6|dz |_g|_d|_dS)Nrrr^rs rG__init__z_SpanRecorder.__init__s$ qj #% "#rFspanSpanct|j|jkrd|_|xjdz c_dS|j|dS)Nr)lenrr_span_recorderrappend)r^rs rGaddz_SpanRecorder.addsU tz??T[ ( ("&D    ! #     J  d # # # # #rF)rrrYN)r?r@rA__doc__ __slots__intrrrErFrGrrsU??4I$s$t$$$$$$$$$$rFrceZdZdZdZ 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+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/r0r1r2r3 _measurementsr:_start_timestamp_monotonic_nsr6 timestamp_tags_datarr5_context_manager_state_containing_transactionr;r<r=_flags_flags_capacityNTmanualr- Optional[str]r.r/r0r1Optional[bool]r2r3r5r4r6r8r7r:r9r;Optional[sentry_sdk.Scope]r<r=rYc||_||_||_||_||_||_|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/r0r1r2r3r6r5r;r<rrrrrrwarningswarnDeprecationWarningrnowrutc isinstancefloat fromtimestampr:rrAttributeErrorrrupdate_active_threadset_profiler_idr )r^r-r.r/r0r1r2r3r5r6r8r:r;r<r=s rGrz Span.__init__s"" ,&<# .;   <>13 ') '=$)+ ! ? MP"     0syDJ  "&l8<88OO  / / T&4_hlSSO. 2A1B1BD . .    D 049= !!### _../////sD D)(D)rc@|jt||_dSdSr[)rrrs rGinit_span_recorderzSpan.init_span_recorder\s)   &"/"7"7D    ' &rFcX|jstjj|_|jSr[)ruuiduuid4hexr]s rGr-z Span.trace_id`s$~ .!Z\\-DN~rFr\c||_dSr[)rr^r\s rGr-z Span.trace_idgs rFch|js%tjjdd|_|jS)N)rrrrr]s rGr.z Span.span_idks-} 2 JLL,RSS1DM}rFc||_dSr[)rrs rGr.z Span.span_idrs  rFcd|jjd|jd|jd|jd|jd|jd|jd|jd S) N) __class__r?r2r3r-r.r/r1r<r]s rG__repr__z Span.__repr__vsc'''     ###    rFch|jptj}|j}||_||f|_|Sr[)r; sentry_sdkget_current_scoperr)r^r;old_spans rG __enter__zSpan.__enter__s7        ' VD,G,V   %   e $ $ $ rFenvironMapping[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 rGcontinue_from_environzSpan.continue_from_environs%(01H1HSSFSSSrF _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.rNFrE) rwarningrMfrom_incoming_headerrBAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezerr0)rrrrrNsentrytrace_kwargs transactions rGrzSpan.continue_from_headerss$ KLLL. KK+ , ,<     *G45555 KK0 1 1    ) MM, - - - NN   !++F++ -2 *rFIterator[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)r8rto_traceparent get_baggage serializer)r^rNs rG iter_headerszSpan.iter_headerss *  F&(;(;(=(=====-99;;EEGG  /%w. . . . . . / /rF 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 rGfrom_traceparentzSpan.from_traceparent#s= 4(s( %{ 3  7=   rFcp|jdurd}n|jdurd}nd}|jd|j}||d|z }|S)NT1F0-)r1r-r.)r^r1rs rGrzSpan.to_traceparent6s` <4  GG \U " "GGG!% =   KGG- -KrFOptional[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)r8rr]s rG to_baggagezSpan.to_baggageDs)  & =.::<< <trFkeyc||j|<dSr[)rr^rr\s rGset_tagz Span.set_tagL 3rFc||j|<dSr[)rrs rGset_dataz Span.set_dataOr rFdataDict[str, Any]c:|j|dSr[)rrr^r s rG update_datazSpan.update_dataRs $rFflagresultcXt|j|jkr ||j|<dSdSr[)rrr)r^rrs rGset_flagz Span.set_flagUs4 t{  d2 2 2 &DK    3 2rFc||_dSr[r6rs rGrzSpan.set_statusYs  rFunitr&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 rGset_measurementzSpan.set_measurement\C       .3D#A#A4   rF thread_id Optional[int] thread_namec|Q|tjt||$|tj|dSdSdSr[)r r THREAD_IDrB THREAD_NAMEr^rr!s rG set_threadzSpan.set_threadksZ  MM(,c)nn = = =& h2K@@@@@ ! '&rFrPcN|"|tj|dSdSr[)r r PROFILER_IDr^rPs rGrzSpan.set_profiler_idts-  " MM(. < < < < < # "rF http_statusc|dt||tj||t |dS)Nzhttp.status_code)rrBr r HTTP_STATUS_CODErr}r^r*s rGset_http_statuszSpan.set_http_statusxs_ K 0 0    h/=== 6{CCDDDDDrFc|jdkS)Nokrr]s rG is_successzSpan.is_successs{d""rF end_timestamp Optional[Union[float, datetime]]c|jdS |r %4 8 mU33X$,$:=(,$W$WM!.)++d.PP!%!5 !(4999" 8 8 8%\(,77DNNN 87577*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/r0r2r3r:rr<r6r measurementstagsr )r-r.r/r0r2r3r:rr<r6rrrrrr)r^rvr:r s rGto_jsonz Span.to_jsons |"1&*&A'+#3k  ; /;BxL#';DJx t! " "Q & &!%!3B~ z  BvJ DK    DJ  BvJ rFc|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/r2r3r<r6dynamic_sampling_contextz thread.idz thread.namer )r-r.r/r2r3r<r6r8rr>rrr r#r$)r^r;r rr!s rGget_trace_contextzSpan.get_trace_contexts |"1'+k    ; ';BxL  & +7799RRTT ) *JNN8#566  )D jnnX%9::  ""-D   BvJ rFOptional[ProfileContext]cZ|jtj}|dSd|iS)NrP)rrr r(r)s rGget_profile_contextzSpan.get_profile_contexts4jnnX%9::  4 ;  rFcTt\}}|||dSr[)rr&r%s rGrzSpan.update_active_threads,!8!:!: ;  ;/////rF)NNNTNNNNNNNNrN)rYrrrr\rrrrYNrYr7)rrrrrYr)rrrrrrrYrrYr)rrrrrYr7rYrr r rYNr)rr r!rrYN)rPrrYNNN)r;rr2r3rYrrYr rYr)rYr@)rYN),r?r@rArrrDrBrrrpropertyr-setterr.rrrr8rSENTRYr classmethodrrrrrrrr rrrrrr&rr.r1rr<r?rBrrErFrGrrs: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<@'+':'  ''''R!!!!F@    000000rFrc feZdZdZdZdddejfdedddd 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@d6ZxZS)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=rKrL sample_rater _contexts_profile_continuous_profile_baggagerrNr=rLrrNrrKrzUnpack[SpanKwargs]rYc Dtjdi|||_||_d|_||_i|_i|_d|_d|_ ||_ |j dn|j }| ||_ dSt|j |_ dSNrE)superrr=rKrRrLrrSrTrUrVr_generate_sample_randr-)r^r=rLrNrKrbaggage_sample_randrs rGrzTransaction.__init__s ""6"""  .2,<>+--1 BF  M)DDt}/I/I/K/K   * 3D    5dm D DD   rFcd|jjd|jd|jd|jd|jd|jd|jd|jd |j d S) Nrz(name=z, op=rrrrz , source=rr) rr?r=r2r-r.r/r1rKr<r]s rGrzTransaction.__repr__8si'''   ###     rFc&|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)rr1r]s rG_possibly_startedzTransaction._possibly_startedHs"$.G$,%2GGrFc|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.)r^rdebugrYrrT)r^rs rGrzTransaction.__enter__Ssi%%''  L>     = $ M # # % % % rFrrr\rc|j|j||||j|jt |||dSr[)rTrrUstoprY)r^rr\rrs rGrzTransaction.__exit__bsg = $ M " "2ub 1 1 1  # /  $ ) ) + + + UB'''''rFc|S)znThe root element of the span tree. In the case of a transaction it is the transaction itself. rEr]s rGr8z"Transaction.containing_transactionms  rF 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^rdrf scope_or_hubs rG_get_scope_from_finish_argsz'Transaction._get_scope_from_finish_argsxs!   M_"     #L lJN 3 3 & MV"      % %rFcbd|jr d|jzdznd|jS)Nz{op}transaction <{name}>rz> r)r2r=)formatr2r=r]s rG_get_log_representationz#Transaction._get_log_representations=)00(,7dg $$Rty1   rFr5r;r2r3r5r4rc 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 backpressurerRr) 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_codersevent_processorr)rrquantityz1Discarding transaction without sampling decision.cDg|]}|j |Sr[)rr<).0rs rG z&Transaction.finish..s2   ~) LLNN)))rFtraceprofilerK)typertransaction_infocontextsr:rr:r_dropped_spansr9))rrkr;rrr is_activerr1rr` transporthas_tracing_enabledrmonitordownsample_factorrecord_lost_eventr=rrYrrrr r,rmrnrrrrrSr?rBrKrr:rTvalidr capture_event)r^r;r2r5clientreasonru num_spansfinished_spanslen_diffrrprofile_contexteventrs rGrzTransaction.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)))rFrr&cXtjdtd||d|j|<dSrrrs rGrzTransaction.set_measurement1rrFrdict[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)rSrs rG set_contextzTransaction.set_context@s$srFr*czt||dd|idS)zySets the status of the Transaction according to the given HTTP status. :param http_status: The HTTP status code.responseruN)rYr.r)r^r*rs rGr.zTransaction.set_http_statusJs>  ,,, m[%ABBBBBrFr 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     rF)rYrrD)rdrerfrerYrrJr;rr2r3r5r4rYrrIrKrL)rYrMrr(rYN)r?r@rArrrRrarBrrrDr^rrrMr8rkrnrrrrrr.r<r?rr __classcell__)rs@rGrrs<" 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 ccccccccrFrc ^eZdZdefdZed3dZejfdeddddfdZ 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 rGrzNoOpSpan.__repr__s///rFr7cdSr[rEr]s rGr8zNoOpSpan.containing_transactionstrFrrrc tSr[)r)r^rrs rGrzNoOpSpan.start_childszzrFcdS)NrrEr]s rGrzNoOpSpan.to_traceparentsrrFrcdSr[rEr]s rGrzNoOpSpan.to_baggagetrFcdSr[rEr]s rGrzNoOpSpan.get_baggagerrFrc tdSrX)iterr]s rGrzNoOpSpan.iter_headerss BxxrFrr\NcdSr[rErs rGrzNoOpSpan.set_tag rFcdSr[rErs rGr zNoOpSpan.set_datarrFr r cdSr[rErs rGrzNoOpSpan.update_datarrFcdSr[rErs rGrzNoOpSpan.set_statusrrFr*cdSr[rEr-s rGr.zNoOpSpan.set_http_statusrrFcdS)NTrEr]s rGr1zNoOpSpan.is_successrrFciSr[rEr]s rGr<zNoOpSpan.to_json rFciSr[rEr]s rGr?zNoOpSpan.get_trace_contextrrFciSr[rEr]s rGrBzNoOpSpan.get_profile_contextrrFror;rr2r3r5r4rcdS)z_ The `hub` parameter is deprecated. Please use the `scope` parameter, instead. NrE)r^r;r2r5s rGrzNoOpSpan.finish  rFrr=rr&cdSr[rErs rGrzNoOpSpan.set_measurement  rFrcdSr[rErs rGrzNoOpSpan.set_contextrrFrcdSr[rErs rGrzNoOpSpan.init_span_recorderrrFrr(cdSr[rE)r^rs rGrz'NoOpSpan._set_initial_sampling_decisionrrFrErGrFrHrKrLrJrrIr)r?r@rArBrrMr8rrOrrrrrrr rrrr.rDr1r<r?rBrrrrrrrErFrGrrs0#0000X#/"5AF   3 u      C  $               3 4    D /3<@  +/   +  :  (       BD   % ->      s +;            1       rFrr2r= attributestemplatefuncr2rr=rOptional[dict[str, Any]]rr *Callable[[Callable[P, R]], Callable[P, R]]cdSr[rE)rr2r=rrs rGr{r{'rrFCallable[P, R]cdSr[rE)rs rGr{r{3rrFOptional[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)rr2r=rrr decorators rGr{r{9sXT?>>>>>%%  I yrF)rMrrZrrr6r[) rNr2rr=rrrrr rYr)rrrYr) rrr2rr=rrrrr rYr)Orrrrrenumrtypingrrsentry_sdk.constsrr r r 'sentry_sdk.profiler.continuous_profilerr sentry_sdk.utilsr rrrrrcollections.abcrrrrrrrrrrrrrr typing_extensionsr!r"r#r$sentry_sdk._typesr%r&r'r(r)(sentry_sdk.profiler.transaction_profilerr*r,rJrBrOrrrRrdLOW_QUALITY_TRANSACTION_SOURCESr`rbSOURCE_FOR_STYLErr}rrrrDEFAULTr{rrMrrZrrr6rErFrGrs 2222222222 NNNNNNNNNNNNCCCCCClAAAAAAAAAA                          43333333 #A A JIIIII@@@@@@9a9a9a9a9aYe9a9a9a9av Q Q Q Q QJe Q Q Q QY 3 N )     T   # "+&0%/06  !#-&,%+  "  #$S#$S#$#$#$#$L$$$$$$$$.W0W0W0W0W0W0W0W0tUUUUU$UUUpN N N N N tN N N b    # $15#/#7          /  !   6    X     X (,V -1+3 VV $V V  V + V  VIVVVVvrF