o aiy @sddlZddlZddlmZmZmZddlmZddlmZddl 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/ddlm0Z0ddl1m2Z2Gddde'ddZ3Gddde3ddZ4e'dde5iZ6dZ7dZ8Gddde5eZ9e9j:gZ;e9jde?de5fdd Z@Gd!d"d"ZAGd#d$d$ZBGd%d&d&eBZCGd'd(d(eBZDere% d;dddejEd)  + , - , . / 0 1  2dd9d4ZFdd:lGmHZHmIZImJZJmKZKmLZLmMZMdS)?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 ParamSpecTupleTypeVarUnionoverload) 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__boolrBrBP/home/ubuntu/SoloSpeech/.venv/lib/python3.10/site-packages/sentry_sdk/tracing.pyr)0s: r)F)totalc@s*eZdZUeed< eed< ded<dS)TransactionKwargssourceparent_sampledBaggagebaggageNr;rBrBrBrCrEks rEProfileContext profiler_idrIz sentry-tracec@s2eZdZdZdZdZdZdZdZde fdd Z d S) TransactionSource componentcustomroutetaskurlviewreturncC|jSN)valueselfrBrBrC__str__szTransactionSource.__str__N) r<r=r> COMPONENTCUSTOMROUTETASKURLVIEWr?rYrBrBrBrCrLsrL) endpoint function_name handler_namemethod_and_path_patternpath route_name route_pattern uri_templaterQhttp_status_coderScCs|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)rhrBrBrCget_span_status_from_http_codes4 rvc@s0eZdZdZdZdeddfddZd d d ZdS) _SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspans dropped_spansryrSNcCs|d|_g|_d|_dS)NrrxrXryrBrBrC__init__s  z_SpanRecorder.__init__spanSpancCs8t|j|jkrd|_|jd7_dS|j|dS)Nr|)lenrzry_span_recorderr{append)rXrrBrBrCaddsz_SpanRecorder.add)rrrSN)r<r=r>__doc__ __slots__intr~rrBrBrBrCrws  rwc@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+eZ,eZ-eZ.e)Z/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.r/r0 _measurementsr7_start_timestamp_monotonic_nsr3 timestamp_tags_datarr2_context_manager_state_containing_transactionr8r9r:_flags_flags_capacityNTmanualr* Optional[str]r+r,r-r.Optional[bool]r/r0r2r1r3r5r4r7r6r8Optional[sentry_sdk.Scope]r9r:rScCs||_||_||_||_||_||_|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.r/r0r3r2r8r9rrrrrrwarningswarnDeprecationWarningrnowrutc isinstancefloat fromtimestampr7rrAttributeErrorrrupdate_active_threadset_profiler_idr )rXr*r+r,r-r.r/r0r2r3r5r7r8r9r:rBrBrCr~sL    z Span.__init__rycCs|jdur t||_dSdSrU)rrwr}rBrBrCinit_span_recorder[s zSpan.init_span_recordercCs|js tj|_|jSrU)ruuiduuid4hexrWrBrBrCr*_s z Span.trace_idrVcC ||_dSrU)rrXrVrBrBrCr*f cCs |js tjdd|_|jS)N)rrrrrWrBrBrCr+jsz Span.span_idcCrrU)rrrBrBrCr+qrc 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<r/r0r*r+r,r.r9rWrBrBrC__repr__usz Span.__repr__cCs(|jpt}|j}||_||f|_|SrU)r8 sentry_sdkget_current_scoperr)rXr8old_spanrBrBrC __enter__s  zSpan.__enter__ty Optional[Any]tbcCsh|durt||r|tjt|j\}}|`||||_WddS1s-wYdSrU)r set_statusr rtr rfinishr)rXrrVrr8rrBrBrC__exit__s   "z Span.__exit__cCrT)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".)rrWrBrBrCr5s 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. r0NzEThe `description` parameter is deprecated. Please use `name` instead.rrrr.)r*r,r5rB)getrrrr get_clientoptionsNoOpSpan setdefaultr.rr*r+r5rr)rXrrconfiguration_instrumenterchild span_recorderrBrBrC 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)clsrrrBrBrCcontinue_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.rNFrB) rwarningrHfrom_incoming_headerrBAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezerr-)rrrrrIsentrytrace_kwargs transactionrBrBrCrs   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)r5rto_traceparent get_baggage serializer)rXrIrBrBrC 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)rrrrBrBrCfrom_traceparent"s zSpan.from_traceparentcCsN|jdurd}n |jdurd}nd}d|j|jf}|dur%|d|f7}|S)NT1F0z%s-%sz-%s)r.r*r+)rXr.rrBrBrCr5s  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)r5rrWrBrBrC to_baggageCs zSpan.to_baggagekeycC||j|<dSrU)rrXrrVrBrBrCset_tagKz Span.set_tagcCrrU)rrrBrBrCset_dataNrz Span.set_datadataDict[str, Any]cCs|j|dSrU)rrrXrrBrBrC update_dataQszSpan.update_dataflagresultcCs"t|j|jkr||j|<dSdSrU)rrr)rXrrrBrBrCset_flagTsz Span.set_flagcCrrUr3rrBrBrCrX 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)rVrNrrrrrXr:rVrrBrBrCset_measurement[ zSpan.set_measurement thread_id Optional[int] thread_namecCs<|dur|tjt||dur|tj|dSdSdSrU)rr THREAD_IDr? THREAD_NAMErXrrrBrBrC set_threadjs zSpan.set_threadrKcCs|dur |tj|dSdSrU)rr PROFILER_IDrXrKrBrBrCrsszSpan.set_profiler_id http_statuscCs0|dt||tj||t|dS)Nzhttp.status_code)rr?rrHTTP_STATUS_CODErrvrXrrBrBrCset_http_statusws zSpan.set_http_statuscCs |jdkS)NokrrWrBrBrC is_success~rzSpan.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)rrrrrrrrrr7rrrrrget_conversation_idrGEN_AI_OPERATION_NAMErr/ startswithr"maybe_create_breadcrumbs_from_span)rXr8r elapsedconversation_id has_ai_op is_ai_span_oprBrBrCrs4          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-r/r0r7rr9r3r measurementstagsr)r*r+r,r-r/r0r7rr9r3rrrrrr)rXrvrrrBrBrCto_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,r/r0r9r3dynamic_sampling_contextz thread.idz thread.namer)r*r+r,r/r0r9r3r5rrrrrrr)rXrrrrrBrBrCget_trace_contexts,  zSpan.get_trace_contextOptional[ProfileContext]cCs"|jtj}|dur dSd|iS)NrK)rrrrrrBrBrCget_profile_contexts zSpan.get_profile_contextcCst\}}|||dSrU)r rrrBrBrCrs zSpan.update_active_thread)NNNTNNNNNNNNrN)rSrrrrVrrrrSNrSr4)rrrrrSr)rrrrrrrSrrSr)rrrrrSr4rSrrrrSNr)rrrrrSN)rKrrSNNN)r8rr r rSrrSrrSr)rSr)rSN)0r<r=r>rrrAr?r~rrpropertyr*setterr+rrrr5rSENTRYr classmethodrrrrrrrrrrrrrrrrrrrrrr_to_traceparent _to_baggage _iter_headers_get_trace_contextrBrBrBrCrs,      B     +  +      4 # rc sveZdZdZdZdddejfdedddd 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 dPdEdFZeZeZZS)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:rFrG sample_rater _contexts_profile_continuous_profile_baggagerrNr:rGrrIrrFrzUnpack[SpanKwargs]rSc stjdi|||_||_d|_||_i|_i|_d|_d|_ ||_ |j dur+dn|j }|dur9||_ dSt |j |_ dSNrB)superr~r:rFr-rGrr.r/r0r1r_generate_sample_randr*)rXr:rGrIrFrbaggage_sample_randrrBrCr~,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:r/r*r+r,r.rFr9rWrBrBrCrHszTransaction.__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.rWrBrBrC_possibly_startedXs 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.)r7rdebugr3rr/rWr6rBrCrcs   zTransaction.__enter__rrrVrcsB|jdur |j||||jdur|jt|||dSrU)r/rr0stopr3)rXrrVrr6rBrCrrs   zTransaction.__exit__cCs|S)znThe root element of the span tree. In the case of a transaction it is the transaction itself. rBrWrBrBrCr5}s 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.)rrrrrHubr8)rXr:r< scope_or_hubrBrBrC_get_scope_from_finish_argss   z'Transaction._get_scope_from_finish_argscCs$dj|jr d|jdnd|jdS)Nz{op}transaction <{name}> r)r/r:)formatr/r:rWrBrBrC_get_log_representationsz#Transaction._get_log_representationr2r8r r r2r1rc 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_coderGevent_processorr|)rFquantityz1Discarding transaction without sampling decision.cSsg|] }|jdur|qSrU)rr).0rrBrBrC s  z&Transaction.finish..traceprofilerF)typertransaction_infocontextsrrr7rz_dropped_spansr))rr@r8rrr is_activerr.rr8 transporthas_tracing_enabledrmonitordownsample_factorrecord_lost_eventr:rr3rrrrrrBrCrrzr{rr.rrrFrr7r/validr capture_event)rXr8r r2clientreasonrI num_spansfinished_spanslen_diffr{rRprofile_contexteventr6rBrCrs              zTransaction.finishrr$cCrrrrrBrBrCrArzTransaction.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.rrBrBrC set_contextPszTransaction.set_contextrcs t||dd|idS)zySets the status of the Transaction according to the given HTTP status. :param http_status: The HTTP status code.responserIN)r3rrdrr6rBrCrZs zTransaction.set_http_statusrcs,t}|j|d<|j|d<|j|d<|S)zrrrLr[r?r~rrAr7rrr%r5r@rCrrrrdrrrrrrn _get_baggager, __classcell__rBrBr6rCr s          f rc @seZdZdefddZedHddZejfdedd 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  dQdFdGZe Ze Z e Z!e Z"eZ#dS)RrrScCs d|jjS)Nz<%s>)rr<rWrBrBrCrs zNoOpSpan.__repr__r4cCdSrUrBrWrBrBrCr5szNoOpSpan.containing_transactionrrrcKstSrU)r)rXrrrBrBrCrszNoOpSpan.start_childcCdS)NrrBrWrBrBrCrzNoOpSpan.to_traceparentrcCrsrUrBrWrBrBrCrruzNoOpSpan.to_baggagecCrsrUrBrWrBrBrCrruzNoOpSpan.get_baggagercCstdSr2)iterrWrBrBrCrszNoOpSpan.iter_headersrrVNcCrsrUrBrrBrBrCrruzNoOpSpan.set_tagcCrsrUrBrrBrBrCrruzNoOpSpan.set_datarrcCrsrUrBrrBrBrCrruzNoOpSpan.update_datacCrsrUrBrrBrBrCr ruzNoOpSpan.set_statusrcCrsrUrBrrBrBrCr ruzNoOpSpan.set_http_statuscCrt)NTrBrWrBrBrCrruzNoOpSpan.is_successcCiSrUrBrWrBrBrCrruzNoOpSpan.to_jsoncCrwrUrBrWrBrBrCrruzNoOpSpan.get_trace_contextcCrwrUrBrWrBrBrCrruzNoOpSpan.get_profile_contextrDr8rr r r2r1rcCrt)z_ The `hub` parameter is deprecated. Please use the `scope` parameter, instead. NrB)rXr8r r2rBrBrCr zNoOpSpan.finishrr:rr$cCrsrUrBrrBrBrCr(zNoOpSpan.set_measurementrccCrsrUrBrrBrBrCrd-ruzNoOpSpan.set_contextrycCrsrUrBr}rBrBrCr0ruzNoOpSpan.init_span_recorderrir&cCrsrUrB)rXrirBrBrCrn3ryz'NoOpSpan._set_initial_sampling_decisionrrrr r#r$r"ror!rp)$r<r=r>r?rr%r5rr'rrrrrrrrrrrrArrrrrrrrdrrnr)r*rqr+r,rBrBrBrCrsx             rr/r: attributestemplatefuncr/rr:r{Optional[dict[str, Any]]r|r *Callable[[Callable[P, R]], Callable[P, R]]cCrsrUrB)r}r/r:r{r|rBrBrCrNBrxrNCallable[P, R]cCrsrUrB)r}rBrBrCrNNryOptional[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_decoratorrz)sentry_sdk.tracing_utilsr)r}r/r:r{r|r decoratorrBrBrCrNTs J)rHrr4rrVrrU) r}Nr/rr:rr{r~r|r rSr)r}rrSr) r}rr/rr:rr{r~r|r rSr)Nrrrrrenumrtypingrrsentry_sdk.constsrrr r 'sentry_sdk.profiler.continuous_profilerr sentry_sdk.utilsr r rrrrcollections.abcrrrrrrrrrrrrrtyping_extensionsrr r!r"sentry_sdk._typesr#r$r%r&r'(sentry_sdk.profiler.transaction_profilerr(r)rEr?rJrrrLr^LOW_QUALITY_TRANSACTION_SOURCESrZr\SOURCE_FOR_STYLErrvrwrrrDEFAULTrNrrHrr4rrVrrBrBrBrCs     0   ; &/_X   $[