o pf<@sddlZddlmZmZmZmZmZmZddlm Z m Z m Z dZ e dZe dZe dZGd d d ZGd d d eZeZGd ddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZdS)N)DictListOptionalSequenceTupleUnion)ExemplarSample Timestamp)countergaugesummary histogramgaugehistogramunknowninfostatesetz^[a-zA-Z_:][a-zA-Z0-9_:]*$z^[a-zA-Z_][a-zA-Z0-9_]*$z^__.*$c @seZdZdZddedededefddZdded eeefd ed ee e efd ee dd f ddZ de defddZdefddZddZd 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 documentationtypunitcCsv|r|d|s|d|7}t|std|||_||_||_|dkr)d}|tvr3td|||_g|_ dS)N_zInvalid metric name: untypedrzInvalid metric type: ) endswithMETRIC_NAME_REmatch ValueErrorrrr METRIC_TYPEStypesamples)selfrrrrr$W/home/ertert/spirit/venv/lib/python3.10/site-packages/prometheus_client/metrics_core.py__init__s     zMetric.__init__Nlabelsvalue timestampexemplarreturncCs|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% 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__5szMetric.__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#r7r"mr$r6r%_restricted_metric>s zMetric._restricted_metric)rNN)__name__ __module__ __qualname____doc__strr&rfloatrrr r r-objectboolr1r3r:r$r$r$r%rs< 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&rtuple _labelnames add_metricr#rrr(r'rr$r$r%r&M 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 rdictziprJr#r'r(r)r$r$r%rK]s(zUnknownMetricFamily.add_metricNNrr/ r<r=r>r?r@rrArr&rr rKr$r$r$r%rEHs"  0rEc @seZdZdZ    ddededeedeeedeed ef d d Z  ddeededeed ee e efd df ddZ dS)CounterMetricFamilyzIA single counter and its samples. For use by custom collectors. Nrrrr(r'createdrcCst|dr |dd}t|||d||dur |dur td|dur&g}t||_|dur8|g||dSdS)N_totalir rG)rrr&rrIrJrK)r#rrr(r'rVrr$r$r%r&ps  zCounterMetricFamily.__init__r)r+cCs`|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. rWN_createdrO)r#r'r(rVr)r$r$r%rKs( ,zCounterMetricFamily.add_metricNNNrr;rTr$r$r$r%rUjs@  rUc @rD)GaugeMetricFamilyzGA single gauge and its samples. For use by custom collectors. Nrrrr(r'rcCrF)Nr rGrHrLr$r$r%r&rMzGaugeMetricFamily.__init__r)r+cCrN)z|Add a metric to the metric family. Args: labels: A list of label values value: A float NrOrRr$r$r%rKs(zGaugeMetricFamily.add_metricrSr/rTr$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.rGrH)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_sumNrO)r#r'r\r]r)r$r$r%rKs(,zSummaryMetricFamily.add_metricrYr/) r<r=r>r?r@rintrArr&rr rKr$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.rH)r#rrrbr]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 rrPlistrQrJrA) r#r'rbr]r)bbucketr(r*r$r$r%rKs( &z HistogramMetricFamily.add_metricrYr/)r<r=r>r?r@rrrrrAr r&r rKr$r$r$r%ras>$   rac @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. Nrrrrb gsum_valuer'rcCs^t|||d||dur|durtd|durg}t||_|dur-|g||dSdS)NrrcrH)r#rrrbrnr'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. rfrg_gcountrhr_gsumN) r"r,r rrPrjrQrJextend)r#r'rbrnr)rlr(r$r$r%rK7s & z%GaugeHistogramMetricFamily.add_metricrYr/) r<r=r>r?r@rrrrAr&rr rKr$r$r$r%rm s>  rmc @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)NrrGrHr#rrr(r'r$r$r%r&X 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 _inforNrOrRr$r$r%rKgs   zInfoMetricFamily.add_metricr;r/) r<r=r>r?r@rrrr&rr rArKr$r$r$r%rrR.   rrc @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'cCrs)NrrGrHrtr$r$r%r&ruzStateSetMetricFamily.__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) rIsorteditemsr"r,r rrPrQrJ)r#r'r(r)stateenabledvr$r$r%rKs  zStateSetMetricFamily.add_metricr;r/)r<r=r>r?r@rrrCrr&rr rArKr$r$r$r%rxzrwrx)retypingrrrrrrr"r r r r compilerMETRIC_LABEL_NAME_RERESERVED_METRIC_LABEL_NAME_RErrEUntypedMetricFamilyrUrZr[rarmrrrxr$r$r$r%s"    9, ,>2(