\jy ddlZddlZddlmZmZmZddlmZddlmZddl Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZerwddlmZmZmZdd 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'dde5iZ6dZ7dZ8Gdde5eZ9e9jtgZ;e9jxe9jxe9jxe9jze9jte9jxe9jze9jze9jzd Z>de?de5fdZ@Gd d!ZAGd"d#ZBGd$d%eBZCGd&d'eBZDer/e% d-dddejd( d.d)ZFe%d/d*ZF d-dddejd( d0d+ZFdd,lGmHZHmIZImJZJmKZKmLZLmMZMy)1N)datetime timedeltatimezone)Enum) TYPE_CHECKING) INSTRUMENTERSPANDATA SPANSTATUS SPANTEMPLATE)get_profiler_id)capture_internal_exceptionsget_current_thread_metais_valid_sample_rateloggernanosecond_timeshould_be_treated_as_error)CallableMappingMutableMapping) AnyDictIteratorListOptional ParamSpecTupleTypeVarUnionoverload) TypedDictUnpackPR)EventMeasurementUnitMeasurementValueSamplingContext)ContinuousProfile)ProfileceZdZUeed< eed< eed< eed< eed< eed< eed< ded < eed < d ed < d ed< ded< eed< eed<y) SpanKwargstrace_idspan_idparent_span_idsame_process_as_parentsampledop descriptionOptional[sentry_sdk.Hub]hubstatusOptional[Transaction]containing_transaction Optional[Union[datetime, float]]start_timestampzsentry_sdk.ScopescopeoriginnameN__name__ __module__ __qualname__str__annotations__boolr?r@ COMPONENTCUSTOMROUTETASKURLVIEWrAr^rDrErFrQrQs,I F E D C DrErQ) endpoint function_name handler_namemethod_and_path_patternpath route_name route_pattern uri_templaterVhttp_status_coderXc\|dkrtjSd|cxkrdkrnn|dk(rtjS|dk(rtjS|dk(rtjS|dk(rtj S|dk(rtj S|dk(rtjStjSd|cxkrd krantjS|d k(rtjS|d k(rtjS|d k(rtjStjStjS) 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 "// /  $'' '  $00 0  $11 1  $-- -  $,, ,.. .  &3 &  # ## s "// /  $++ +  $)) ),, ,  # ##rEc,eZdZdZdZdeddfdZddZy) _SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspans dropped_spansrrXNc4|dz |_g|_d|_y)Nrrr]rs rF__init__z_SpanRecorder.__init__s qj #% "#rEct|j|jkDrd|_|xjdz c_y|jj |y)Nr)lenrr_span_recorderrappend)r]spans rFaddz_SpanRecorder.addsA tzz?T[[ ("&D    ! #  JJ  d #rE)rSpanrXN)r>r?r@__doc__ __slots__intrrrDrErFr~r~s"?4I$s$t$$rEr~ceZdZdZdZ dEddddddded d d dd dd ddddddddddeddddfdZdeddfdZ e defdZ e jdeddfdZ e defdZ e jdeddfd Z defd!ZdFd"Z dGd#Ze dHd$Zej&fd%ed&d'ddfd(Ze dId)Zedd* dJd+ZdKd,Ze dLd-Zdefd.ZdMd/Zd0edd'ddfd1Zd0edd'ddfd2ZdNd3Zd4ed5eddfd6Zdeddfd7Z dOdede!d8d9ddfd:Z" dPd;Z#dQd<Z$d=eddfd>Z%defd?Z& dR dSd@Z'dTdAZ(dUdBZ)dVdCZ*dWdDZ+eZ,eZ-eZ.e)Z/y)XrakA 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_capacityNr, Optional[str]r-r.r/r0Optional[bool]r1r2r4r3r5r7r6r9r8r:Optional[sentry_sdk.Scope]r;r<rXc||_||_||_||_||_||_|xs||_| |_||_| |_ | |_ i|_ i|_ i|_ | |_i|_d|_|;t#j$dt&d|jxs |j|_ | $t)j*t,j.} n4t1| t2r$t)j4| t,j.} | |_ t9|_d|_d|_ |jC|jEtGy#t<$rYCwxYw)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__sK"" ,&<# .;   <>13 ') '=$)+ ! ? MMP"  0syyDJ  "&ll8<<8O  /&44_hllSO. 2A1BD . 049= !!# _./   sE"" E.-E.rc>|jt||_yyrZ)rr~rs rFinit_span_recorderzSpan.init_span_recorder[s    &"/"7D  'rEcx|js#tjj|_|jSrZ)ruuiduuid4hexr\s rFr,z Span.trace_id_s&~~!ZZ\--DN~~rEr[c||_yrZ)rr]r[s rFr,z Span.trace_idfs rEc~|js&tjjdd|_|jS)N)rrrrr\s rFr-z Span.span_idjs-}} JJL,,RS1DM}}rEc||_yrZ)rrs rFr-z Span.span_idqs  rEcd|jjd|jd|jd|jd|j d|j d|jd|jd S) N) __class__r>r1r2r,r-r.r0r;r\s rF__repr__z Span.__repr__usP''    ##    rEc|jxstj}|j}||_||f|_|SrZ)r: sentry_sdkget_current_scoperr)r]r:old_spans rF __enter__zSpan.__enter__s; #>     ' ' VD,G,G,V,V     e $ rEc @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. ) Transactioncontinue_from_headersEnvironHeaders)clsenvironrs rFcontinue_from_environzSpan.continue_from_environs(001HSFSSrE _sample_randc Xtjdtj|j t |}|j t |it|j t}|!|j ||jtdi|}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.rFrD) rwarningrLfrom_incoming_headerrBAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezerr/)rheadersrrrMsentrytrace_kwargs transactions rFrzSpan.continue_from_headerss$ KL.. KK+ ,<   *G455 KK0 1   ) MM, - NN !+F+ -2 *rEc#K|jsyt|jf|jjj }|r t |fyyw)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_headerssZ ** &(;(;(===--99;EEG %w. . sAAc :|sy|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)r traceparentrs rFfrom_traceparentzSpan.from_traceparent"s/(s(( %{ 3 7=  rEc|jdurd}n|jdurd}nd}|jd|j}||d|z }|S)NT1F0-)r0r,r-)r]r0rs rFrzSpan.to_traceparent5sT <<4 G \\U "GG!% =   G- -KrEcP|jr|jjSy)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%  & &..::< <rEkeyc"||j|<yrZ)rr]rr[s rFset_tagz Span.set_tagK 3rEc"||j|<yrZ)rrs rFset_dataz Span.set_dataNrrEc:|jj|yrZ)rrr]datas rF update_datazSpan.update_dataQs $rEflagresultcht|j|jkr||j|<yyrZ)rrr)r]r r s rFset_flagz Span.set_flagTs, t{{ d22 2 &DKK  3rEc||_yrZr5rs rFrzSpan.set_statusXs  rEunitr%c`tjdtd||d|j|<yz .. 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[0    .3D#A4 rEc|M|jtjt||!|jtj|yyyrZ)rr THREAD_IDrA THREAD_NAMEr] thread_id thread_names rF set_threadzSpan.set_threadjsF  MM(,,c)n =& h22K@' !rEcJ|!|jtj|yyrZ)rr PROFILER_IDr]rOs rFrzSpan.set_profiler_idss!  " MM(.. < #rE http_statusc|jdt||jtj||j t |y)Nzhttp.status_code)rrArr HTTP_STATUS_CODErr|r]r!s rFset_http_statuszSpan.set_http_statusws@ K 0  h//= 6{CDrEc |jdk(S)Nokrr\s rF is_successzSpan.is_success~s{{d""rEc|jy |r> % 8mU3$,$:$:=(,,$WM!.)+d.P.PP!%!5!5 !(49" 7557 335  66$**DI GG4/""5)JTWW-?-? -J M 6H*5$7# 8%\\(,,7DN 8sA6D661E*)E*c ,|j|j|j|j|j|j |j |j|jd }|jr(|j|d<|j|jd<t|jdkDr|j|d<|j}|r||d<i}|j|j|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]rvr6rs rFto_jsonz Span.to_jsons ||"11&*&A&A''++#33kk  ;;;;BxL#';;DJJx t!! "Q &!%!3!3B~ zz BvJ DKK  DJJ BvJ rEc|j|j|j|j|j|j d}|j r|j |d<|jr+|jjj|d<i}|jjtj}|||d<|jjtj}|||d<|r||d<|S)N)r,r-r.r1r2r;r5dynamic_sampling_contextz thread.idz thread.namer)r,r-r.r1r2r;r5r7rr:rrr rr)r]r7rrrs rFget_trace_contextzSpan.get_trace_contexts ||"11''++kk   ;;;;BxL  & &++779RRT ) *JJNN8#5#56  )D jjnnX%9%9:  ""-D  BvJ rEcb|jjtj}|yd|iS)NrO)rrr rr s rFget_profile_contextzSpan.get_profile_contexts4jjnnX%9%9:   ;  rEcBt\}}|j||yrZ)rrrs rFrzSpan.update_active_threads!8!: ;  ;/rE)NNNTNNNNNNNNmanualN)rXrr Optional[Any]r[rArrArXNrXr6)rMapping[str, str]rrrXr)rrCrrrrrXrrXzIterator[Tuple[str, str]])rrrrrXr6rXOptional[Baggage]rDict[str, Any]rXN)rz Optional[int]rrrXN)rOrrXNNN)r:rr/ Optional[Union[float, datetime]]rXrrXrHrXr)rXzOptional[ProfileContext])rXN)0r>r?r@rrrCrArrrpropertyr,setterr-rrrr7rSENTRYr classmethodrrrrrrrrr r rrrrrr%r(rr8r;r=r_to_traceparent _to_baggage _iter_headers_get_trace_contextrDrErFrrs:I8%)#'*.'+$("'+*."&:>>B.2 $>0!>0!>0( >0 !% >0 " >0 >0%>0(>0 >0!8>0<>0,>0>0>0 !>0D888# __cd  ^^ST  #   "! "*9 "?N "  ",,#/"5"5))AF) )VT$TT  TT* )- )$)& )  )  ))V/& $   !   $   3 u   C  $  'S'$'4'BD B B % B-> B  BA(A7FA A=E3E4E#D# /3<@2+2:2  2h!F@ 0 %OK M*rErc reZdZdZdZdddej fdedddd d ed d d df fd Zd efdZ d e fdZ d%fd Z d&fd Z ed%dZ d'dZd efdZ d(dd d)fdZ d*dededdd dfdZdeddd dfdZded dffd Zd+fd! Zd,fd" Zd-d#Z d.d$ZeZeZxZS)/raiThe 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_baggagerrJNr<rKrrMrFrJrzUnpack[SpanKwargs]rXc :t|di|||_||_d|_||_i|_i|_d|_d|_ ||_ |jdn|jj}|||_ yt|j|_ yNrD)superrr<rJrXrKrrYrZr[r\r_generate_sample_randr,)r]r<rKrMrJrbaggage_sample_randrs rFrzTransaction.__init__,s "6"  .2,<>+--1 BF  MM)Dt}}/I/I/K   * 3D  5dmm DD rEcd|jjd|jd|jd|jd|j d|j d|jd|jd |jd S) Nrz(name=z, op=rrrrz , source=rr) rr>r<r1r,r-r.r0rJr;r\s rFrzTransaction.__repr__HsU''   ##     rEc>|jduxs|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|jstjdt||j |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.)rdrdebugr_rrZ)r]rs rFrzTransaction.__enter__csL%%' LL>   == $ MM # # % rEr[c|j|jj||||j|jjt||||yrZ)rZrr[stopr_)r]rr[rrs rFrzTransaction.__exit__rsT == $ MM " "2ub 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  rEc|}|tjdtd|}t|tj r(tjdtd|j S|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. zMThe `hub` parameter is deprecated. Please use the `scope` parameter, instead.rzDPassing a Hub to finish is deprecated. Please pass a Scope, instead.)rrrrrHubr:)r] scope_arghub_arg scope_or_hubs rF_get_scope_from_finish_argsz'Transaction._get_scope_from_finish_argssb!   MM_"  #L lJNN 3 MMV"   %% %rEcxdj|jrd|jzdznd|jS)Nz{op}transaction <{name}>rz> rJ)r1r<)formatr1r<r\s rF_get_log_representationz#Transaction._get_log_representations8)00(,dgg $Rtyy1  rEr4c v|jy|j||}|xs"|jxstj}tj }|j sy|j|jdurtjdntjd|jryt|jrd|jr|jjdkDrd}nd}|jj!|d |jj!|d y|j"stj$d d |_t&|Q|||j*j-t.j0}|||jd vrtjdj3|j5|j*t.j0|jd |jr]|jj!dd t7|jj8dz}|jj!dd |d|_|js"|jtj$dy|jj8Dcgc]}|j|j; } }t7|jj8t7| z } | |jj<z} d|_i} | j?|j@| j?d|jCi|jE} | | j?d| id|j"d|jFi| |jH|j|jJ| d}| dkDr| |d<|jL0|jLjOr|jL|d<d|_&|jP|d<|jS|Scc}w)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 backpressurerXr) 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_coderxevent_processorr)rwquantityz1Discarding transaction without sampling decision.traceprofilerJ)typertransaction_infocontextsr6rr9r_dropped_spansr5)*rrpr:rrr is_activerr0rrf transporthas_tracing_enabledrmonitordownsample_factorrecord_lost_eventr<rr_rrrr r#rrrsrrr8rrrYr;r=rJrr9rZvalidr capture_event)r]r:r/r4clientreasonrz num_spansrfinished_spanslen_diffrrprofile_contexteventrs rFrzTransaction.finishs* >> %/3.N.N 3/ EEz'C'C'E&&(!    &||u$ MN i$7$G>>fnn&F&F&J+F*F  2262W  2262Pyy NNU 2DI um,jjnnX%>%>?  #v~~.IJJ LLqxx,0,H,H,J $ 8+D+D E.4nn3/x   22%]3  3 3 9 9:Q>   22%Vi3!DL||||#RS++11 ~~) LLN  t**001C4GG 4#6#6#D#DD #'$"8"8":;<224  & OOY8 9"99!)4;; 7 JJ#33#   1 &3E" # == $)<)<)>#}}E)  DM $ 2 2n""5))U s>#P6rr%c`tjdtd||d|j|<yrrrs rFrzTransaction.set_measurementArrErdict[str, Any]c"||j|<y)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)rYrs rF set_contextzTransaction.set_contextPs$srEr!cLt|||jdd|iy)zySets the status of the Transaction according to the given HTTP status. :param http_status: The HTTP status code.responserzN)r_r%r)r]r!rs rFr%zTransaction.set_http_statusZs'  , m[%ABrEc~t|}|j|d<|j|d<|j|d<|S)z">"@#6>>2 DL  << #$T\\2D  **+;<= -FNN+ ,-= > $$45A!!12^^$89 $K B NN`gg,Ch  !DL  - >>   6>>#C#C C C  LLQXX,C$FNN$6$67G$HI== Y !DL ((4+;+;; << LL>EE,CF  LLPWW,C $ 0 0W rE)rXrr@)rm1Optional[Union[sentry_sdk.Scope, sentry_sdk.Hub]]rnrrXrrKr:rr/rLr4r3rXrrIrMrN)rXrLrr'rXN)r>r?r@rrrQr`rArrrCrdrrrOr7rprsrrrrrr%r8r;rr _get_baggagerV __classcell__)rs@rFrr s" I +/'+'.. EE)E% E  E ' E E8 # H4 H  (! (*9 (?N (  (FE & @  /3<@R* +/ R*+R*:R* ( R*  R*jBD B B % B-> B  B$s$+;$$C3C4C c 1c cLL*rErc teZdZdefdZed$dZejfdeddddfdZ defdZ d%d Z d%d Z d&d Z d ed dddfdZd ed dddfdZd'dZd eddfdZdeddfdZdefdZd(dZd)dZd)dZ d*dd d+dZ d,ded eddddfdZd ed dddfd Zd!eddfd"Z d-d#Ze Ze Z e Z!e Z"eZ#y).rrXc4d|jjzS)Nz<%s>)rr>r\s rFrzNoOpSpan.__repr__s////rEcyrZrDr\s rFr7zNoOpSpan.containing_transactionsrErrrc tSrZ)r)r]rrs rFrzNoOpSpan.start_childs zrEcy)NrJrDr\s rFrzNoOpSpan.to_traceparentsrEcyrZrDr\s rFrzNoOpSpan.to_baggagerEcyrZrDr\s rFrzNoOpSpan.get_baggagerrEctdSr^)iterr\s rFrzNoOpSpan.iter_headerss BxrErr[NcyrZrDrs rFrzNoOpSpan.set_tag rEcyrZrDrs rFrzNoOpSpan.set_datarrEcyrZrDrs rFr zNoOpSpan.update_datarrEcyrZrDrs rFrzNoOpSpan.set_status rrEr!cyrZrDr$s rFr%zNoOpSpan.set_http_status rrEcy)NTrDr\s rFr(zNoOpSpan.is_successrrEciSrZrDr\s rFr8zNoOpSpan.to_json rEciSrZrDr\s rFr;zNoOpSpan.get_trace_contextrrEciSrZrDr\s rFr=zNoOpSpan.get_profile_contextrrErtcy)z_ The `hub` parameter is deprecated. Please use the `scope` parameter, instead. NrD)r]r:r/r4s rFrzNoOpSpan.finish rEr<rr%cyrZrDrs rFrzNoOpSpan.set_measurement( rErcyrZrDrs rFrzNoOpSpan.set_context-rrErcyrZrDrs rFrzNoOpSpan.init_span_recorder0rrEcyrZrD)r]rs rFrz'NoOpSpan._set_initial_sampling_decision3rrErBrErDrGrMrNrKrrIr)$r>r?r@rArrOr7rrQrrrrrrrr rrr%rCr(r8r;r=rrrrrrrSrTrrUrVrDrErFrrs0#0#/"5"5AF   3 u   C  $      3 4 D /3<@  +/  +  :  (    BD  % ->   s +;      1  %OKL M*rErr1r< attributestemplatecyrZrD)funcr1r<rrs rFr}r}BrrEcyrZrD)rs rFr}r}NrrEc>ddlm}|||||}|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 rFr}r}Ts3T?%  I rE)rLrr`rrr.rZ) rNr1rr<rrOptional[dict[str, Any]]rr rXz*Callable[[Callable[P, R]], Callable[P, R]])rCallable[P, R]rXr) rzOptional[Callable[P, R]]r1rr<rrrrr rXzAUnion[Callable[P, R], Callable[[Callable[P, R]], Callable[P, R]]])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~rrrDEFAULTr}rrLrr`rrr.rDrErFrsu 22 NNCAA   4#A A J@9aYe9av QJe Q 3 N ) T # "++&00%//066  ! !#--&,,%++  " " #$S#$S#$L$$.h+h+VY+$Y+xU+tU+p   # $15#/#7#7         /  !   6      (,V -1+33 V $V V  V + V  VIVvrE