o :Di<@sddlmZmZmZmZmZmZddlmZm Z m Z m Z ddl m Z dZGdddZGdd d eZeZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZdS))DictListOptionalSequenceTupleUnion)ExemplarNativeHistogramSample Timestamp)_validate_metric_name)countergaugesummary histogramgaugehistogramunknowninfostatesetc@seZdZdZddedededefddZdded eeefd ed ee e efd ee dee dd fddZ dedefddZdefddZddZd S)MetriczA single metric family and its samples. This is intended only for internal use by the instrumentation client. Custom collectors should use GaugeMetricFamily, CounterMetricFamily and SummaryMetricFamily instead. name documentationtypunitcCsh|r|d|s|d|7}t|||_||_||_|dkr"d}|tvr,td|||_g|_dS)N_untypedrzInvalid metric type: ) endswithr rrr METRIC_TYPES ValueErrortypesamples)selfrrrrr$W/var/www/Datamplify/venv/lib/python3.10/site-packages/prometheus_client/metrics_core.py__init__s   zMetric.__init__Nlabelsvalue timestampexemplarnative_histogramreturnc Cs|jt||||||dS)z?Add a sample to the metric. Internal-only, do not use.N)r"appendr )r#rr'r(r)r*r+r$r$r% add_sample#szMetric.add_sampleothercCsFt|to"|j|jko"|j|jko"|j|jko"|j|jko"|j|jkSN) isinstancerrrr!rr")r#r/r$r$r%__eq__)s      z Metric.__eq__cCsd|j|j|j|j|jS)NzMetric({}, {}, {}, {}, {}))formatrrr!rr")r#r$r$r%__repr__1szMetric.__repr__cs8fdd|jD}|rt|j|j|j}||_|SdS)zMBuild a snapshot of a metric with samples restricted to a given set of names.csg|] }|dvr|qS)rr$).0snamesr$r% <sz-Metric._restricted_metric..N)r"rrrr!)r#r8r"mr$r7r%_restricted_metric:s zMetric._restricted_metric)rNNN)__name__ __module__ __qualname____doc__strr&rfloatrrr r r r.objectboolr2r4r;r$r$r$r%r sD rc @neZdZdZ   ddededeedeeedef d d Zddeeded ee e efd dfd dZ dS)UnknownMetricFamilyzOA single unknown metric and its samples. For use by custom collectors. Nrrrr(r'rcC\t|||d||dur|durtd|durg}t||_|dur,|g|dSdS)Nr1Can only specify at most one of value and labels.rr&r tuple _labelnames add_metricr#rrr(r'rr$r$r%r&I zUnknownMetricFamily.__init__r)r,cC(|jt|jtt|j|||dS)zAdd a metric to the metric family. Args: labels: A list of label values value: The value of the metric. Nr"r-r rdictziprKr#r'r(r)r$r$r%rLYs(zUnknownMetricFamily.add_metricNNrr0 r=r>r?r@rArrBrr&rr rLr$r$r$r%rFDs"  0rFc@seZdZdZ     ddededeedeeedeed ed eefd d Z   ddeededeed ee e efd eeddf ddZ dS)CounterMetricFamilyzIA single counter and its samples. For use by custom collectors. Nrrrr(r'createdrr*cCsx|dr |dd}t|||d||dur |dur td|dur&g}t||_|dur:|jg|||ddSdS)N_totalirrH)r*)rrr&r rJrKrL)r#rrr(r'rWrr*r$r$r%r&ls  zCounterMetricFamily.__init__r)r,cCsb|jt|jdtt|j|||||dur/|jt|jdtt|j|||dSdS)zAdd a metric to the metric family. Args: labels: A list of label values value: The value of the metric created: Optional unix timestamp the child was created at. rXN_createdrP)r#r'r(rWr)r*r$r$r%rLs*,zCounterMetricFamily.add_metric)NNNrNr<) r=r>r?r@rArrBrr r&rr rLr$r$r$r%rVfsL  rVc @rE)GaugeMetricFamilyzGA single gauge and its samples. For use by custom collectors. Nrrrr(r'rcCrG)NrrHrIrMr$r$r%r&rNzGaugeMetricFamily.__init__r)r,cCrO)z|Add a metric to the metric family. Args: labels: A list of label values value: A float NrPrSr$r$r%rLs(zGaugeMetricFamily.add_metricrTr0rUr$r$r$r%rZs"  0rZc @s~eZdZdZ    ddededeedeedeeed ef d d Z ddeededed ee ee fd df ddZ dS)SummaryMetricFamilyzIA single summary and its samples. For use by custom collectors. Nrrr count_value sum_valuer'rcCst|||d||du|dukrtd|dur!|dur!td|dur'g}t||_|dur=|dur?|g||dSdSdS)Nrz4count_value and sum_value must be provided together.rHrI)r#rrr\r]r'rr$r$r%r&s zSummaryMetricFamily.__init__r)r,cCsT|jt|jdtt|j||||jt|jdtt|j|||dS)zAdd a metric to the metric family. Args: labels: A list of label values count_value: The count value of the metric. sum_value: The sum value of the metric. _count_sumNrP)r#r'r\r]r)r$r$r%rLs(,zSummaryMetricFamily.add_metricNNNrr0) r=r>r?r@rArintrBrr&rr rLr$r$r$r%r[s>  r[c@seZdZdZ    ddededeeeeee feee e ffdee deeed ef d d Z ddeedeeeee feee e ffdee d eee e fd df ddZ dS)HistogramMetricFamilyzKA single histogram and its samples. For use by custom collectors. Nrrrbucketsr]r'rcCsvt|||d||dur|durtd|dur!|dur!td|dur'g}t||_|dur9|g||dSdS)Nrz-sum value cannot be provided without buckets.3Can only specify at most one of buckets and labels.rI)r#rrrcr]r'rr$r$r%r&s zHistogramMetricFamily.__init__r)r,c Cs|D]2}|dd\}}d}t|dkr|d}|jt|jdttt|j|d|fg|||qt |dddkrq|durs|jt|jdtt|j||dd ||jt|jd tt|j|||dSdSdS) azAdd a metric to the metric family. Args: labels: A list of label values buckets: A list of lists. Each inner list can be a pair of bucket name and value, or a triple of bucket name, value, and exemplar. The buckets must be sorted, and +Inf present. sum_value: The sum value of the metric. N_bucketlerr^rr_) lenr"r-r rrQlistrRrKrB) r#r'rcr]r)bbucketr(r*r$r$r%rLs( &z HistogramMetricFamily.add_metricr`r0)r=r>r?r@rArrrrrBr r&r rLr$r$r$r%rbs>$   rbc @seZdZdZ    ddededeeeeefdeedeeed ef d d Z ddeedeeeefdeed ee ee fd df ddZ dS)GaugeHistogramMetricFamilyzQA single gauge histogram and its samples. For use by custom collectors. Nrrrrc gsum_valuer'rcCs^t|||d||dur|durtd|durg}t||_|dur-|g||dSdS)NrrdrI)r#rrrcror'rr$r$r%r&#s z#GaugeHistogramMetricFamily.__init__r)r,c Cs|D]\}}|jt|jdttt|j|d|fg||q|jt|jdtt|j||dd|t|jdtt|j|||gdS)aAdd a metric to the metric family. Args: labels: A list of label values buckets: A list of pairs of bucket names and values. The buckets must be sorted, and +Inf present. gsum_value: The sum value of the metric. rgrh_gcountrir_gsumN) r"r-r rrQrkrRrKextend)r#r'rcror)rmr(r$r$r%rL4s & z%GaugeHistogramMetricFamily.add_metricr`r0) r=r>r?r@rArrrrBr&rr rLr$r$r$r%rns>  rnc @szeZdZdZ  d dededeeeefdeeefddZ ddeedeeefd ee e e fd dfd d Z dS)InfoMetricFamilyzFA single info and its samples. For use by custom collectors. Nrrr(r'cCZt|||d|dur|durtd|durg}t||_|dur+|g|dSdS)NrrHrIr#rrr(r'r$r$r%r&U zInfoMetricFamily.__init__r)r,c Cs8|jt|jdttt|j|fi|d|dS)zAdd a metric to the metric family. Args: labels: A list of label values value: A dict of labels _inforNrPrSr$r$r%rLds   zInfoMetricFamily.add_metricNNr0) r=r>r?r@rArrrr&rr rBrLr$r$r$r%rsO.   rsc @szeZdZdZ  d dededeeeefdeeefddZ ddeedeeefd ee e e fd dfd d Z dS)StateSetMetricFamilyzJA single stateset and its samples. For use by custom collectors. Nrrr(r'cCrt)NrrHrIrur$r$r%r&}rvzStateSetMetricFamily.__init__r)r,c Cs`t|}t|D]#\}}|rdnd}|jt|jtt|j |jf||f||q dS)zAdd a metric to the metric family. Args: labels: A list of label values value: A dict of string state names to booleans rrN) rJsorteditemsr"r-r rrQrRrK)r#r'r(r)stateenabledvr$r$r%rLs  zStateSetMetricFamily.add_metricrxr0)r=r>r?r@rArrrDrr&rr rBrLr$r$r$r%rzwryrzN)typingrrrrrrr"r r r r validationr rrrFUntypedMetricFamilyrVrZr[rbrnrsrzr$r$r$r%s  8. ,=2(