You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 lines
2.3 KiB
Python
75 lines
2.3 KiB
Python
from typing import Dict, NamedTuple, Optional, Sequence, Union
|
|
|
|
|
|
class Timestamp:
|
|
"""A nanosecond-resolution timestamp."""
|
|
|
|
def __init__(self, sec: float, nsec: float) -> None:
|
|
if nsec < 0 or nsec >= 1e9:
|
|
raise ValueError(f"Invalid value for nanoseconds in Timestamp: {nsec}")
|
|
if sec < 0:
|
|
nsec = -nsec
|
|
self.sec: int = int(sec)
|
|
self.nsec: int = int(nsec)
|
|
|
|
def __str__(self) -> str:
|
|
return f"{self.sec}.{self.nsec:09d}"
|
|
|
|
def __repr__(self) -> str:
|
|
return f"Timestamp({self.sec}, {self.nsec})"
|
|
|
|
def __float__(self) -> float:
|
|
return float(self.sec) + float(self.nsec) / 1e9
|
|
|
|
def __eq__(self, other: object) -> bool:
|
|
return isinstance(other, Timestamp) and self.sec == other.sec and self.nsec == other.nsec
|
|
|
|
def __ne__(self, other: object) -> bool:
|
|
return not self == other
|
|
|
|
def __gt__(self, other: "Timestamp") -> bool:
|
|
return self.nsec > other.nsec if self.sec == other.sec else self.sec > other.sec
|
|
|
|
def __lt__(self, other: "Timestamp") -> bool:
|
|
return self.nsec < other.nsec if self.sec == other.sec else self.sec < other.sec
|
|
|
|
|
|
# BucketSpan is experimental and subject to change at any time.
|
|
class BucketSpan(NamedTuple):
|
|
offset: int
|
|
length: int
|
|
|
|
|
|
# Timestamp and exemplar are optional.
|
|
# Value can be an int or a float.
|
|
# Timestamp can be a float containing a unixtime in seconds,
|
|
# a Timestamp object, or None.
|
|
# Exemplar can be an Exemplar object, or None.
|
|
class Exemplar(NamedTuple):
|
|
labels: Dict[str, str]
|
|
value: float
|
|
timestamp: Optional[Union[float, Timestamp]] = None
|
|
|
|
|
|
# NativeHistogram is experimental and subject to change at any time.
|
|
class NativeHistogram(NamedTuple):
|
|
count_value: float
|
|
sum_value: float
|
|
schema: int
|
|
zero_threshold: float
|
|
zero_count: float
|
|
pos_spans: Optional[Sequence[BucketSpan]] = None
|
|
neg_spans: Optional[Sequence[BucketSpan]] = None
|
|
pos_deltas: Optional[Sequence[int]] = None
|
|
neg_deltas: Optional[Sequence[int]] = None
|
|
nh_exemplars: Optional[Sequence[Exemplar]] = None
|
|
|
|
|
|
class Sample(NamedTuple):
|
|
name: str
|
|
labels: Dict[str, str]
|
|
value: float
|
|
timestamp: Optional[Union[float, Timestamp]] = None
|
|
exemplar: Optional[Exemplar] = None
|
|
native_histogram: Optional[NativeHistogram] = None
|