o ٰiP @sddlZddlZddlmZmZmZddlmZddlmZddl 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/m0Z0ddlm1Z1ddl2m3Z3Gddde(ddZ4Gddde4ddZ5e(dde6iZ7dZ8dZ9Gddde6eZ:e:j;gZe:j;e:j=e:j>e:j>e:j>d Z?de@de6fdd ZAGd!d"d"ZBGd#d$d$ZCGd%d&d&eCZDGd'd(d(eCZEere& d;dddejFd)  + , - , . / 0 1  2dd9d4ZGdd:lHmIZImJZJmKZKmLZLmMZMmNZNdS)?N)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 ParamSpecSetTupleTypeVarUnionoverload) TypedDictUnpackPR)EventMeasurementUnitMeasurementValueSamplingContext)ContinuousProfile)Profilec@seZdZUeed< eed< eed< eed< eed< eed< eed< ded < eed < d ed < d ed< ded< eed< eed<dS) 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__boolrCrCF/home/ubuntu/.local/lib/python3.10/site-packages/sentry_sdk/tracing.pyr*1s: r*F)totalc@s*eZdZUeed< eed< ded<dS)TransactionKwargssourceparent_sampledBaggagebaggageNr<rCrCrCrDrFls rFProfileContext profiler_idrJz sentry-tracec@s2eZdZdZdZdZdZdZdZde fdd Z d S) TransactionSource componentcustomroutetaskurlviewreturncC|jSN)valueselfrCrCrD__str__szTransactionSource.__str__N) r=r>r? COMPONENTCUSTOMROUTETASKURLVIEWr@rZrCrCrCrDrMsrM) endpoint function_name handler_namemethod_and_path_patternpath route_name route_pattern uri_templaterRhttp_status_coderTcCs|dkrtjSd|krdkr@nn-|dkrtjS|dkr!tjS|dkr(tjS|dkr/tjS|dkr6tjS|dkr=tjStjSd|krJd krfntj S|d krUtj S|d kr\tj S|d krctj 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)rirCrCrDget_span_status_from_http_codes4 rwc@s0eZdZdZdZdeddfddZd d d ZdS) _SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspans dropped_spansrzrTNcCs|d|_g|_d|_dS)NrryrYrzrCrCrD__init__s  z_SpanRecorder.__init__spanSpancCs8t|j|jkrd|_|jd7_dS|j|dS)Nr})lenr{rz_span_recorderr|append)rYrrCrCrDaddsz_SpanRecorder.add)rrrTN)r=r>r?__doc__ __slots__intrrrCrCrCrDrxs  rxc@seZdZdZdZ              dzddddd dd ed d d ddddddddddddddeddddfddZdeddfddZ e defd d!Z e j d"eddfd#d!Z e defd$d%Z e j d"eddfd&d%Z defd'd(Zd{d)d*Z + , " , - ,  d|d.d/Ze d}d0d1Zejfd2ed3d4ddfd5d6Ze 7 8 3 4  9d~d:d;Zedd< 8 >  3 4  9dd?d@ZddBdCZe D  3 4  ddEdFZdefdGdHZddJdKZdLed"d4ddfdMdNZdLed"d4ddfdOdPZddSdTZdUedVeddfdWdXZd"eddfdYdZZ [dded"e!d\d]ddfd^d_Z" ` a b   ddcddZ#ddfdgZ$dheddfdidjZ%defdkdlZ&  d  m n  ddodpZ'ddqdrZ(ddsdtZ)ddvdwZ*ddxdyZ+dS)rakA 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.r/r0r1 _measurementsr8_start_timestamp_monotonic_nsr4 timestamp_tags_datarr3_context_manager_state_containing_transactionr9r:r;_flags_flags_capacityNTmanualr+ Optional[str]r,r-r.r/Optional[bool]r0r1r3r2r4r6r5r8r7r9Optional[sentry_sdk.Scope]r:r;rTcCs||_||_||_||_||_||_|p||_| |_||_| |_ | |_ i|_ i|_ i|_ | |_i|_d|_|durHtjdtdd|j pF|j |_ | durSttj} n t| tr_t| tj} | |_zt|_Wn tyqYnwd|_d|_ |!|"t#dS)N z>The `hub` parameter is deprecated. Please use `scope` instead. stacklevel)$rrr-r.r/r0r1r4r3r9r:rrrrrrwarningswarnDeprecationWarningrnowrutc isinstancefloat fromtimestampr8rrAttributeErrorrrupdate_active_threadset_profiler_idr )rYr+r,r-r.r/r0r1r3r4r6r8r9r:r;rCrCrDrsL    z Span.__init__rzcCs|jdur t||_dSdSrV)rrxr~rCrCrDinit_span_recorder\s zSpan.init_span_recordercCs|js tj|_|jSrV)ruuiduuid4hexrXrCrCrDr+`s z Span.trace_idrWcC ||_dSrV)rrYrWrCrCrDr+g cCs |js tjdd|_|jS)N)rrrrrXrCrCrDr,ksz Span.span_idcCrrV)rrrCrCrDr,rrc Cs*d|jj|j|j|j|j|j|j|jfS)Nz^<%s(op=%r, description:%r, trace_id=%r, span_id=%r, parent_span_id=%r, sampled=%r, origin=%r)>) __class__r=r0r1r+r,r-r/r:rXrCrCrD__repr__vsz Span.__repr__cCs(|jpt}|j}||_||f|_|SrV)r9 sentry_sdkget_current_scoperr)rYr9old_spanrCrCrD __enter__s  zSpan.__enter__ty Optional[Any]tbcCsh|durt||r|tjt|j\}}|`||||_WddS1s-wYdSrV)r set_statusr rur rfinishr)rYrrWrr9rrCrCrD__exit__s   "z Span.__exit__cCrU)zThe ``Transaction`` that this span belongs to. The ``Transaction`` is the root of the span tree, so one could also think of this ``Transaction`` as the "root span".)rrXrCrCrDr6s zSpan.containing_transaction instrumenterkwargsrcKs|ddurtjdtddtjd}||krtS|d|j t d |j |j |j d|}|j o8|j j}|r@|||S) a Start a sub-span from the current span or transaction. Takes the same arguments as the initializer of :py:class:`Span`. The trace id, sampling decision, transaction pointer, and span recorder are inherited from the current span/transaction. The instrumenter parameter is deprecated for user code, and it will be removed in the next major version. Going forward, it should only be used by the SDK itself. r1NzEThe `description` parameter is deprecated. Please use `name` instead.rrrr/)r+r-r6rC)getrrrr get_clientoptionsNoOpSpan setdefaultr/rr+r,r6rr)rYrrconfiguration_instrumenterchild span_recorderrCrCrD start_childs,  zSpan.start_childenvironMapping[str, str] TransactioncKstjt|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)clsrrrCrCrDcontinue_from_environszSpan.continue_from_environ _sample_randheadersrcKsltdtj|t|d}|t|it|t}|dur*||| t di|}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.rNFrC) rwarningrIfrom_incoming_headerrBAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezerr.)rrrrrJsentrytrace_kwargs transactionrCrCrDrs   zSpan.continue_from_headersIterator[Tuple[str, str]]ccs>|jsdSt|fV|j}|rt|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)r6rto_traceparent get_baggage serializer)rYrJrCrCrD iter_headersszSpan.iter_headers traceparentcKs|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)rrrrCrCrDfrom_traceparent#s zSpan.from_traceparentcCsN|jdurd}n |jdurd}nd}d|j|jf}|dur%|d|f7}|S)NT1F0z%s-%sz-%s)r/r+r,)rYr/rrCrCrDr6s  zSpan.to_traceparentOptional[Baggage]cCs|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)r6rrXrCrCrD to_baggageDs zSpan.to_baggagekeycC||j|<dSrV)rrYrrWrCrCrDset_tagLz Span.set_tagcCrrV)rrrCrCrDset_dataOrz Span.set_datadataDict[str, Any]cCs|j|dSrV)rrrYrrCrCrD update_dataRszSpan.update_dataflagresultcCs"t|j|jkr||j|<dSdSrV)rrr)rYrrrCrCrDset_flagUsz Span.set_flagcCrrVr4rrCrCrDrY zSpan.set_statusunitr%cC$tjdtdd||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)rWrNrrrrrYr;rWrrCrCrDset_measurement\ zSpan.set_measurement thread_id Optional[int] thread_namecCs<|dur|tjt||dur|tj|dSdSdSrV)rr THREAD_IDr@ THREAD_NAMErYrrrCrCrD set_threadks zSpan.set_threadrLcCs|dur |tj|dSdSrV)rr PROFILER_IDrYrLrCrCrDrtszSpan.set_profiler_id http_statuscCs0|dt||tj||t|dS)Nzhttp.status_code)rr@rrHTTP_STATUS_CODErrwrYrrCrCrDset_http_statusxs zSpan.set_http_statuscCs |jdkS)NokrrXrCrCrD is_successrzSpan.is_success end_timestamp Optional[Union[float, datetime]]cCs|jdurdSz%|rt|trt|tj}||_nt|j}|j t |dd|_Wnt y<t tj|_Ynw|pBt }|}|rjtj|jv}|jduo_|jdp_|jd}|sd|rj|d|t||dS)aD Sets the end timestamp of the span. Additionally it also creates a breadcrumb from the span, if the span represents a database or HTTP request. :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. :return: Always ``None``. The type is ``Optional[str]`` to match the return value of :py:meth:`sentry_sdk.tracing.Transaction.finish`. Ni) microsecondszai.zgen_ai.zgen_ai.conversation.id)rrrrrrrrrr8rrrrrget_conversation_idrGEN_AI_OPERATION_NAMErr0 startswithr"maybe_create_breadcrumbs_from_span)rYr9r elapsedconversation_id has_ai_op is_ai_span_oprCrCrDrs4          z Span.finishc Cs|j|j|j|j|j|j|j|j|jd }|j r#|j |d<|j |j d<t |j dkr/|j |d<|j }|r8||d<i}| |j| |j|rL||d<|S)z5Returns a JSON-compatible representation of the span.) r+r,r-r.r0r1r8rr:r4r measurementstagsr)r+r,r-r.r0r1r8rr:r4rrrrrr)rYrvrrrCrCrDto_jsons0     z Span.to_jsoncCs|j|j|j|j|j|jd}|jr|j|d<|jr#|j |d<i}|j t j }|dur4||d<|j t j}|durC||d<|rI||d<|S)N)r+r,r-r0r1r:r4dynamic_sampling_contextz thread.idz thread.namer)r+r,r-r0r1r:r4r6rrrrrrr)rYrrrrrCrCrDget_trace_contexts,  zSpan.get_trace_contextOptional[ProfileContext]cCs"|jtj}|dur dSd|iS)NrL)rrrrrrCrCrDget_profile_contexts zSpan.get_profile_contextcCst\}}|||dSrV)r rrrCrCrDrs zSpan.update_active_thread)NNNTNNNNNNNNrN)rTrrrrWrrrrTNrTr5)rrrrrTr)rrrrrrrTrrTr)rrrrrTr5rTrrrrTNr)rrrrrTN)rLrrTNNN)r9rr r rTrrTrrTr)rTr)rTN),r=r>r?rrrBr@rrrpropertyr+setterr,rrrr6rSENTRYr classmethodrrrrrrrrrrrrrrrrr rrrrrrCrCrCrDrs$      B     +  +      4 #  rc sneZdZdZdZdddejfdedddd d ed d d df fdd Zd efddZ d e fddZ dGfdd Z       dHfdd Z edGddZ    !dId"d#Zd efd$d%Z  dJdd& ! ( ) * + ,dKfd-d.Z dLdeded/d0d dfd1d2Zd3edd4d dfd5d6Zd7ed dffd8d9 ZdMfd;d< ZdNfd>d? ZdOdAdBZ C D dPdEdFZZS)QraiThe 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;rGrH sample_rater _contexts_profile_continuous_profile_baggagerrNr;rHrrJrrGrzUnpack[SpanKwargs]rTc stjdi|||_||_d|_||_i|_i|_d|_d|_ ||_ |j dur+dn|j }|dur9||_ dSt |j |_ dSNrC)superrr;rGr*rHrr+r,r-r.r_generate_sample_randr+)rYr;rHrJrGrbaggage_sample_randrrCrDr's zTransaction.__init__c Cs.d|jj|j|j|j|j|j|j|j|j f S)Nzb<%s(name=%r, op=%r, trace_id=%r, span_id=%r, parent_span_id=%r, sampled=%r, source=%r, origin=%r)>) rr=r;r0r+r,r-r/rGr:rXrCrCrDrCszTransaction.__repr__cCs|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)rr/rXrCrCrD_possibly_startedSs zTransaction._possibly_startedcs4|s tdt|jdur|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.)r4rdebugr0rr,rXr3rCrDr^s   zTransaction.__enter__rrrWrcsB|jdur |j||||jdur|jt|||dSrV)r,rr-stopr0)rYrrWrr3rCrDrms   zTransaction.__exit__cCs|S)znThe root element of the span tree. In the case of a transaction it is the transaction itself. rCrXrCrCrDr6xs z"Transaction.containing_transaction scope_arg1Optional[Union[sentry_sdk.Scope, sentry_sdk.Hub]]hub_argrcCsF|}|durtjdtdd|}t|tjr!tjdtdd|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.)rrrrrHubr9)rYr7r9 scope_or_hubrCrCrD_get_scope_from_finish_argss   z'Transaction._get_scope_from_finish_argscCs$dj|jr d|jdnd|jdS)Nz{op}transaction <{name}> r)r0r;)formatr0r;rXrCrCrD_get_log_representationsz#Transaction._get_log_representationr3r9r r r3r2rc sp|jdurdS|||}|p|jpt}t}|s dS|jdur]|jdur0t dnt d|j r[t |j r[|jrI|jjdkrId}nd}|j j|dd |j j|d d dS|jsht d d |_t|||jtj}|dur||j d vrt dj||jtj|j d d|j r|j jddd t|jjd}|j jdd |dd|_|js|jdurt ddSdd|jjD}t|jjt|} | |jj} d|_i} | |j| d| i|!} | dur| d| id|jd|j"i| |j#|j|j$|d} | dkr| | d<|j%dur.|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_coderDevent_processorr})rCquantityz1Discarding transaction without sampling decision.cSsg|] }|jdur|qSrV)rr).0rrCrCrD s  z&Transaction.finish..traceprofilerG)typertransaction_infocontextsrrr8r{_dropped_spansr))rr=r9rrr is_activerr/rr5 transporthas_tracing_enabledrmonitordownsample_factorrecord_lost_eventr;rr0rrrrrr?r@rr{r|rr+rrrGrr8r,validr capture_event)rYr9r r3clientreasonrF num_spansfinished_spanslen_diffr|rOprofile_contexteventr3rCrDrs              zTransaction.finishrr%cCrrrrrCrCrDr<rzTransaction.set_measurementrdict[str, Any]cCs||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+rrCrCrD set_contextKszTransaction.set_contextrcs t||dd|idS)zySets the status of the Transaction according to the given HTTP status. :param http_status: The HTTP status code.responserFN)r0rrarr3rCrDrUs zTransaction.set_http_statusrcs,t}|j|d<|j|d<|j|d<|S)zr?rrrMr\r@rrrBr4rrr&r6r=r@rrrrarrrrrrk __classcell__rCrCr3rDrs         rc @sreZdZdefddZedHddZejfdedd ddfd d Z defd d Z dIddZ dIddZ dJddZ dedd ddfddZdedd ddfddZdKdd Zdeddfd!d"Zd#eddfd$d%Zdefd&d'ZdLd(d)ZdMd*d+ZdMd,d-Z  dNdd. 0 1 2 3 4  5dOd6d7Z 8dPd9eded:d;ddfdddfd?d@ZdAeddfdBdCZ D E  dQdFdGZdS)RrrTcCs d|jjS)Nz<%s>)rr=rXrCrCrDrs zNoOpSpan.__repr__r5cCdSrVrCrXrCrCrDr6szNoOpSpan.containing_transactionrrrcKstSrV)r)rYrrrCrCrDrszNoOpSpan.start_childcCdS)NrrCrXrCrCrDrzNoOpSpan.to_traceparentrcCrorVrCrXrCrCrDrrqzNoOpSpan.to_baggagecCrorVrCrXrCrCrDrrqzNoOpSpan.get_baggagercCstdSr/)iterrXrCrCrDrszNoOpSpan.iter_headersrrWNcCrorVrCrrCrCrDrrqzNoOpSpan.set_tagcCrorVrCrrCrCrDrrqzNoOpSpan.set_datarrcCrorVrCrrCrCrDrrqzNoOpSpan.update_datacCrorVrCrrCrCrDrrqzNoOpSpan.set_statusrcCrorVrCrrCrCrDrrqzNoOpSpan.set_http_statuscCrp)NTrCrXrCrCrDr rqzNoOpSpan.is_successcCiSrVrCrXrCrCrDr rqzNoOpSpan.to_jsoncCrsrVrCrXrCrCrDr rqzNoOpSpan.get_trace_contextcCrsrVrCrXrCrCrDrrqzNoOpSpan.get_profile_contextrAr9rr r r3r2rcCrp)z_ The `hub` parameter is deprecated. Please use the `scope` parameter, instead. NrC)rYr9r r3rCrCrDr zNoOpSpan.finishrr;rr%cCrorVrCrrCrCrDrzNoOpSpan.set_measurementr`cCrorVrCrrCrCrDra$rqzNoOpSpan.set_contextrzcCrorVrCr~rCrCrDr'rqzNoOpSpan.init_span_recorderrfr'cCrorVrC)rYrfrCrCrDrk*ruz'NoOpSpan._set_initial_sampling_decisionrr rr!r$r%r#rlr"rm)r=r>r?r@rr&r6rr(rrrrrrrrrrrrBr rrrrrrrarrkrCrCrCrDrsn            rr0r; attributestemplatefuncr0rr;rwOptional[dict[str, Any]]rxr *Callable[[Callable[P, R]], Callable[P, R]]cCrorVrC)ryr0r;rwrxrCrCrDrK2rtrKCallable[P, R]cCrorVrC)ryrCrCrDrK>ruOptional[Callable[P, R]]AUnion[Callable[P, R], Callable[[Callable[P, R]], Callable[P, R]]]cCs,ddlm}|||||d}|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_decoratorrv)sentry_sdk.tracing_utilsr)ryr0r;rwrxr decoratorrCrCrDrKDs J)rIrr1rrSrrV) ryNr0rr;rrwrzrxr rTr{)ryr|rTr|) ryr}r0rr;rrwrzrxr rTr~)Orrrrrenumrtypingrrsentry_sdk.constsrrr r 'sentry_sdk.profiler.continuous_profilerr sentry_sdk.utilsr r rrrrcollections.abcrrrrrrrrrrrrrrtyping_extensionsr r!r"r#sentry_sdk._typesr$r%r&r'r((sentry_sdk.profiler.transaction_profilerr)r*rFr@rKrrrMr_LOW_QUALITY_TRANSACTION_SOURCESr[r]SOURCE_FOR_STYLErrwrxrrrDEFAULTrKrrIrr1rrSrrCrCrCrDs     4  ; &)[Q   $[