|
LSST Applications g013ef56533+63812263fb,g083dd6704c+a047e97985,g199a45376c+0ba108daf9,g1fd858c14a+fde7a7a78c,g210f2d0738+db0c280453,g262e1987ae+abed931625,g29ae962dfc+058d1915d8,g2cef7863aa+aef1011c0b,g35bb328faa+8c5ae1fdc5,g3fd5ace14f+64337f1634,g47891489e3+f459a6810c,g53246c7159+8c5ae1fdc5,g54cd7ddccb+890c8e1e5d,g5a60e81ecd+d9e514a434,g64539dfbff+db0c280453,g67b6fd64d1+f459a6810c,g6ebf1fc0d4+8c5ae1fdc5,g7382096ae9+36d16ea71a,g74acd417e5+c70e70fbf6,g786e29fd12+668abc6043,g87389fa792+8856018cbb,g89139ef638+f459a6810c,g8d7436a09f+1b779678e3,g8ea07a8fe4+81eaaadc04,g90f42f885a+34c0557caf,g97be763408+9583a964dd,g98a1a72a9c+028271c396,g98df359435+530b675b85,gb8cb2b794d+4e54f68785,gbf99507273+8c5ae1fdc5,gc2a301910b+db0c280453,gca7fc764a6+f459a6810c,gd7ef33dd92+f459a6810c,gdab6d2f7ff+c70e70fbf6,ge410e46f29+f459a6810c,ge41e95a9f2+db0c280453,geaed405ab2+e3b4b2a692,gf9a733ac38+8c5ae1fdc5,w.2025.43
LSST Data Management Base Package
|
Public Member Functions | |
| __init__ (self, str name, *MonAgent|logging.Logger args, _TagsType|None tags=None, int log_level=logging.INFO) | |
| None | add_values (self, **int|float values) |
| Timer | start (self) |
| Timer | stop (self) |
| Timer | dump (self) |
| tuple[float, float, float] | accumulated (self) |
| dict[str, int|float] | as_dict (self, str prefix="") |
| str | __str__ (self) |
| Timer | __enter__ (self) |
| Any | __exit__ (self, type|None exc_type, Any exc_val, Any exc_tb) |
Protected Attributes | |
| _name = name | |
| list | _mon_agents = [] |
| list | _loggers = [] |
| _tags = tags | |
| _log_level = log_level | |
| float | _startReal = -1.0 |
| float | _startUser = -1.0 |
| float | _startSys = -1.0 |
| float | _sumReal = 0.0 |
| float | _sumUser = 0.0 |
| float | _sumSys = 0.0 |
| dict | _extra_values = {} |
Instance of this class can be used to track consumed time.
Parameters
----------
name : `str`
Timer name, will be use for reporting to both monitoring and logging.
Typically the name should look like an identifier for ease of use with
downstream monitoring software.
*args : `MonAgent` or `logging.Logger`
Positional arguments can include a combination of `MonAgent` and
`logging.Logger` instances. They will be used to report accumulated
times on exit from context or by calling `dump` method directly.
tags : `~collections.abc.Mapping` [`str`, `str` or `int`], optional
Keyword argument, additional tags added to monitoring report and
logging output.
log_level : `int`, optional
Keyword argument, level used for logging output, default is
`logging.INFO`.
Notes
-----
This class is also a context manager and can be used in a `with` statement.
By default it prints consumed CPU time and real time spent in a context.
Example:
with Timer("SelectTimer", logger):
engine.execute('SELECT ...')
| lsst.dax.apdb.timer.Timer.__init__ | ( | self, | |
| str | name, | ||
| *MonAgent | logging.Logger | args, | ||
| _TagsType | None | tags = None, | ||
| int | log_level = logging.INFO ) |
Definition at line 73 of file timer.py.
| Timer lsst.dax.apdb.timer.Timer.__enter__ | ( | self | ) |
| Any lsst.dax.apdb.timer.Timer.__exit__ | ( | self, | |
| type | None | exc_type, | ||
| Any | exc_val, | ||
| Any | exc_tb ) |
| str lsst.dax.apdb.timer.Timer.__str__ | ( | self | ) |
Definition at line 162 of file timer.py.
| tuple[float, float, float] lsst.dax.apdb.timer.Timer.accumulated | ( | self | ) |
Return accumulated real, user, and system times in seconds.
Definition at line 139 of file timer.py.
| None lsst.dax.apdb.timer.Timer.add_values | ( | self, | |
| **int | float | values ) |
Add values to dump together with timing information.
Parameters
----------
**values : int | float
Key/values to add to timer information.
Definition at line 101 of file timer.py.
| dict[str, int | float] lsst.dax.apdb.timer.Timer.as_dict | ( | self, | |
| str | prefix = "" ) |
Return timers and extra values as dictionary.
Definition at line 151 of file timer.py.
| Timer lsst.dax.apdb.timer.Timer.dump | ( | self | ) |
Dump timer statistics
Definition at line 131 of file timer.py.
| Timer lsst.dax.apdb.timer.Timer.start | ( | self | ) |
| Timer lsst.dax.apdb.timer.Timer.stop | ( | self | ) |
Stop timer.
Definition at line 119 of file timer.py.