9i"%SrSSKJr SSKrSSKrSSKrSSKJrJrJ r J r SSK J r J r \ (aSSKJr SSKJr \R$"\5r"SS 5r\\\\\\4\ \\\ \/S4rS \S '"S S 5r"SS5rg)a[Metrics collection and management system for Dynamo. This module provides context managers for gathering and reporting metrics during compilation and runtime. It includes two main components: - MetricsContext: A context manager for collecting metrics during compilation, supporting nested contexts and various metric types (counters, sets, key-value pairs) - RuntimeMetricsContext: A specialized context for runtime metrics collection that doesn't require explicit context management The metrics system enables comprehensive monitoring and analysis of both compilation and execution performance. ) annotationsN)AnyCallableOptional TYPE_CHECKING)Self TypeAlias)Iterator)CapturedTracebackcD\rSrSrSrS S SjjrS SjrS SjrS SjrSr g)TopN"zW Helper to record a list of metrics, keeping only the top N "most expensive" elements. cXl/UlgNat_mostheap)selfrs ]/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/torch/_dynamo/metrics_context.py__init__ TopN.__init__'s +- c[UR5UR:a[RO[R nU"URX!45 gr)lenrrheapqheappush heappushpop)rkeyvalfns raddTopN.add+s6"499~  TopN.__iter__..4sK+Jxs +JsT)reverse)sortedrr$s r__iter__ TopN.__iter__3sK6$))T+JKKrrN))rint)rrrr2returnNone)r3r2)r3zIterator[tuple[Any, int]]) __name__ __module__ __qualname____firstlineno____doc__rr!r%r/__static_attributes__r)rrr r "s." Lrr r OnExitTypec\rSrSrSSjrSSjrSSjrSSjrSSjrSSjr SSSjjr SS jr SSS jjr SS jr SS jrSS jrSrg)MetricsContext=cHXl0UlSUlSUl/Ulg)a) Use this class as a contextmanager to create a context under which to accumulate a set of metrics, e.g., metrics gathered during a compilation. On exit of the contextmanager, call the provided 'on_exit' function and pass a dictionary of all metrics set during the lifetime of the contextmanager. rN)_on_exit_metrics_start_time_ns_level_editsron_exits rrMetricsContext.__init__>s& (* #$ @B rcURS:Xa!0Ul[R"5UlU=RS- slU$)z Initialize metrics recording. r)rCrAtimetime_nsrBr$s r __enter__MetricsContext.__enter__Ks8 ;;! DM"&,,.D  q  rc8U=RS-slURS:deURS:Xa>[R"5nURURX@R X5 gg![ a [RS5 gf=f)z. At exit, call the provided on_exit function. rIrz0Unexpected exception logging compilation metricsN) rCrJrKr@rBrA Exceptionlog exception)rexc_type exc_value _traceback end_time_nss r__exit__MetricsContext.__exit__Ws q {{a ;;!  R"lln  ''mmX   R PQ Rs# UH5upUT-(dMSSRUR55-v M7 g7f)zPrevious Traceback: N)joinformat)r*ekpreds rr+/MetricsContext._render_edits..|s8$ #4x : #bggahhj&9 9#s A)A)rhrD)rrls `r _render_editsMetricsContext._render_edits{s, $  $    rc.URS:Xa[SUS35eXR;a)U(d"[URU15SUS3-5eURR [ R"SS9U145 X RU'g) zj Set a metric to a given value. Raises if the metric has been assigned previously in the current context. r Cannot set r]z RuntimeError: Metric 'z]' has already been set in the current context (see above for current and previous traceback).rIskipN)rCr_rArnrDappendr extract)rrarb overwrites rsetMetricsContext.sets ;;! VH4PQR R ]] "9""F8,.vh7BBB  -551=xHI % frcURS:Xa[SUS35eXR;a0URU'X0RUU'g)a Treats a give metric as a dictionary and set the k and value within it. Note that the metric must be a dictionary or not present. We allow this to be called multiple times (i.e. for features, it's not uncommon for them to be used multiple times within a single compilation). rrqr]Nr^)rrarrbs r set_key_valueMetricsContext.set_key_valuesN ;;! VH4PQR R  &$&DMM& !%* fc"rcURS:Xa [S5eURR5UR5-nU(a?U(d8[UR [ UR555SUS3-5eUR R[R"SS9[ UR5545 URRU5 g)z Set multiple metrics directly. This method does NOT increment. Raises if any metric has been assigned previously in the current context and overwrite is not set to True. r1Cannot update metrics outside of a MetricsContextz RuntimeError: Metric(s) z_ have already been set in the current context. (see above for current and previous traceback).rIrrN) rCr_rAkeysrnrwrDrtr ruupdate)rvaluesrvexistings rrMetricsContext.updates ;;! RS S==%%'&++-7 I""3v{{}#560 ;BBB  -551=s6;;=?QRS V$rc~URS:Xa [S5eURS:XaURU5 gg)z1 Update, but only when at the outermost context. rr}rIN)rCr_r)rrs r update_outerMetricsContext.update_outers9 ;;! RS S ;;!  KK  rcURS:Xa[SUS35eXR;a[5URU'URUR U5 g)z( Records a metric as a set() of values. rz Cannot add r]N)rCr_rArwr!r`s r add_to_setMetricsContext.add_to_setsV ;;! VH4PQR R  &$'EDMM& ! f!!%(rcURS:XagXR;a[5URU'URURX#5 g)z+ Records a metric as a TopN set of values. rN)rCrAr r!)rrarrs r add_top_nMetricsContext.add_top_nsD ;;!    &$(FDMM& ! f!!#+r)rDrCrAr@rBNrFr;)r3r)rRzOptional[type[BaseException]]rSzOptional[BaseException]rTrr3r4)r3bool)rastrrbr2r3r4)rlzset[str]r3r)F)rarrbrrvrr3r4)rarrrrbrr3r4)rdict[str, Any]rvrr3r4)rrr3r4)rarrbrr3r4)rarrrrr2r3r4)r5r6r7r8rrLrVrYrcrnrwrzrrrrr:r)rrr=r==sj C R/R+R R  R( ' & +%$ ),rr=cF\rSrSrSSjrSS SjjrS SjrSrg) RuntimeMetricsContextc,Xl0UlSUlg)z Similar to MetricsContext, but used to gather the runtime metrics that are decoupled from compilation, where there's not a natural place to insert a context manager. rN)r@rArBrEs rrRuntimeMetricsContext.__init__s  (* #$rNcNUR(d[R"5UlXR;aSURU'URU==U- ss'U(a>UR 5H)upEX@R;dMUcMXPRU'M+ gg)r\rN)rArJrKrBitems)rrarbextrarkvs rrcRuntimeMetricsContext.incrementsy }}"&,,.D   &$%DMM& ! f&  MM)am'(MM!$& rcUR(aF[R"5nURURXRSS5 0Ulgg![ a [ RS5 N*f=f!0Ulf=f)zG Call the on_exit function with the metrics gathered so far and reset. Nz,Unexpected exception logging runtime metrics)rArJrKr@rBrOrPrQ)rrUs rfinishRuntimeMetricsContext.finishsr == #"lln  ''mmT4 !#    N LM N!# s#=AA;8A>:A;;A>> B)rAr@rBrr)rarrbr2rzOptional[dict[str, Any]]r3r4)r3r4)r5r6r7r8rrcrr:r)rrrrs8%JN))"%).F) )$ #rr)r9 __future__rrloggingrJtypingrrrrtyping_extensionsrr collections.abcr torch.utils._tracebackr getLoggerr5rPr r2dictrtype BaseExceptionr;__annotations__r=rr)rrrs #  99-(4!LL*!#tCH~x](;UV  I P,P,f*#*#r