123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895 |
- # Copyright 2014-2016 OpenMarket Ltd
- # Copyright 2019 The Matrix.org Foundation C.I.C.
- #
- # Licensed under the Apache License, Version 2.0 (the "License");
- # you may not use this file except in compliance with the License.
- # You may obtain a copy of the License at
- #
- # http://www.apache.org/licenses/LICENSE-2.0
- #
- # Unless required by applicable law or agreed to in writing, software
- # distributed under the License is distributed on an "AS IS" BASIS,
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- # See the License for the specific language governing permissions and
- # limitations under the License.
- """ Thread-local-alike tracking of log contexts within synapse
- This module provides objects and utilities for tracking contexts through
- synapse code, so that log lines can include a request identifier, and so that
- CPU and database activity can be accounted for against the request that caused
- them.
- See doc/log_contexts.rst for details on how this works.
- """
- import inspect
- import logging
- import threading
- import types
- import warnings
- from typing import TYPE_CHECKING, Optional, Tuple, TypeVar, Union
- import attr
- from typing_extensions import Literal
- from twisted.internet import defer, threads
- if TYPE_CHECKING:
- from synapse.logging.scopecontextmanager import _LogContextScope
- logger = logging.getLogger(__name__)
- try:
- import resource
- # Python doesn't ship with a definition of RUSAGE_THREAD but it's defined
- # to be 1 on linux so we hard code it.
- RUSAGE_THREAD = 1
- # If the system doesn't support RUSAGE_THREAD then this should throw an
- # exception.
- resource.getrusage(RUSAGE_THREAD)
- is_thread_resource_usage_supported = True
- def get_thread_resource_usage() -> "Optional[resource._RUsage]":
- return resource.getrusage(RUSAGE_THREAD)
- except Exception:
- # If the system doesn't support resource.getrusage(RUSAGE_THREAD) then we
- # won't track resource usage.
- is_thread_resource_usage_supported = False
- def get_thread_resource_usage() -> "Optional[resource._RUsage]":
- return None
- # a hook which can be set during testing to assert that we aren't abusing logcontexts.
- def logcontext_error(msg: str):
- logger.warning(msg)
- # get an id for the current thread.
- #
- # threading.get_ident doesn't actually return an OS-level tid, and annoyingly,
- # on Linux it actually returns the same value either side of a fork() call. However
- # we only fork in one place, so it's not worth the hoop-jumping to get a real tid.
- #
- get_thread_id = threading.get_ident
- class ContextResourceUsage:
- """Object for tracking the resources used by a log context
- Attributes:
- ru_utime (float): user CPU time (in seconds)
- ru_stime (float): system CPU time (in seconds)
- db_txn_count (int): number of database transactions done
- db_sched_duration_sec (float): amount of time spent waiting for a
- database connection
- db_txn_duration_sec (float): amount of time spent doing database
- transactions (excluding scheduling time)
- evt_db_fetch_count (int): number of events requested from the database
- """
- __slots__ = [
- "ru_stime",
- "ru_utime",
- "db_txn_count",
- "db_txn_duration_sec",
- "db_sched_duration_sec",
- "evt_db_fetch_count",
- ]
- def __init__(self, copy_from: "Optional[ContextResourceUsage]" = None) -> None:
- """Create a new ContextResourceUsage
- Args:
- copy_from (ContextResourceUsage|None): if not None, an object to
- copy stats from
- """
- if copy_from is None:
- self.reset()
- else:
- # FIXME: mypy can't infer the types set via reset() above, so specify explicitly for now
- self.ru_utime = copy_from.ru_utime # type: float
- self.ru_stime = copy_from.ru_stime # type: float
- self.db_txn_count = copy_from.db_txn_count # type: int
- self.db_txn_duration_sec = copy_from.db_txn_duration_sec # type: float
- self.db_sched_duration_sec = copy_from.db_sched_duration_sec # type: float
- self.evt_db_fetch_count = copy_from.evt_db_fetch_count # type: int
- def copy(self) -> "ContextResourceUsage":
- return ContextResourceUsage(copy_from=self)
- def reset(self) -> None:
- self.ru_stime = 0.0
- self.ru_utime = 0.0
- self.db_txn_count = 0
- self.db_txn_duration_sec = 0.0
- self.db_sched_duration_sec = 0.0
- self.evt_db_fetch_count = 0
- def __repr__(self) -> str:
- return (
- "<ContextResourceUsage ru_stime='%r', ru_utime='%r', "
- "db_txn_count='%r', db_txn_duration_sec='%r', "
- "db_sched_duration_sec='%r', evt_db_fetch_count='%r'>"
- ) % (
- self.ru_stime,
- self.ru_utime,
- self.db_txn_count,
- self.db_txn_duration_sec,
- self.db_sched_duration_sec,
- self.evt_db_fetch_count,
- )
- def __iadd__(self, other: "ContextResourceUsage") -> "ContextResourceUsage":
- """Add another ContextResourceUsage's stats to this one's.
- Args:
- other (ContextResourceUsage): the other resource usage object
- """
- self.ru_utime += other.ru_utime
- self.ru_stime += other.ru_stime
- self.db_txn_count += other.db_txn_count
- self.db_txn_duration_sec += other.db_txn_duration_sec
- self.db_sched_duration_sec += other.db_sched_duration_sec
- self.evt_db_fetch_count += other.evt_db_fetch_count
- return self
- def __isub__(self, other: "ContextResourceUsage") -> "ContextResourceUsage":
- self.ru_utime -= other.ru_utime
- self.ru_stime -= other.ru_stime
- self.db_txn_count -= other.db_txn_count
- self.db_txn_duration_sec -= other.db_txn_duration_sec
- self.db_sched_duration_sec -= other.db_sched_duration_sec
- self.evt_db_fetch_count -= other.evt_db_fetch_count
- return self
- def __add__(self, other: "ContextResourceUsage") -> "ContextResourceUsage":
- res = ContextResourceUsage(copy_from=self)
- res += other
- return res
- def __sub__(self, other: "ContextResourceUsage") -> "ContextResourceUsage":
- res = ContextResourceUsage(copy_from=self)
- res -= other
- return res
- @attr.s(slots=True)
- class ContextRequest:
- """
- A bundle of attributes from the SynapseRequest object.
- This exists to:
- * Avoid a cycle between LoggingContext and SynapseRequest.
- * Be a single variable that can be passed from parent LoggingContexts to
- their children.
- """
- request_id = attr.ib(type=str)
- ip_address = attr.ib(type=str)
- site_tag = attr.ib(type=str)
- requester = attr.ib(type=Optional[str])
- authenticated_entity = attr.ib(type=Optional[str])
- method = attr.ib(type=str)
- url = attr.ib(type=str)
- protocol = attr.ib(type=str)
- user_agent = attr.ib(type=str)
- LoggingContextOrSentinel = Union["LoggingContext", "_Sentinel"]
- class _Sentinel:
- """Sentinel to represent the root context"""
- __slots__ = ["previous_context", "finished", "request", "scope", "tag"]
- def __init__(self) -> None:
- # Minimal set for compatibility with LoggingContext
- self.previous_context = None
- self.finished = False
- self.request = None
- self.scope = None
- self.tag = None
- def __str__(self):
- return "sentinel"
- def copy_to(self, record):
- pass
- def start(self, rusage: "Optional[resource._RUsage]"):
- pass
- def stop(self, rusage: "Optional[resource._RUsage]"):
- pass
- def add_database_transaction(self, duration_sec):
- pass
- def add_database_scheduled(self, sched_sec):
- pass
- def record_event_fetch(self, event_count):
- pass
- def __bool__(self):
- return False
- SENTINEL_CONTEXT = _Sentinel()
- class LoggingContext:
- """Additional context for log formatting. Contexts are scoped within a
- "with" block.
- If a parent is given when creating a new context, then:
- - logging fields are copied from the parent to the new context on entry
- - when the new context exits, the cpu usage stats are copied from the
- child to the parent
- Args:
- name (str): Name for the context for debugging.
- parent_context (LoggingContext|None): The parent of the new context
- """
- __slots__ = [
- "previous_context",
- "name",
- "parent_context",
- "_resource_usage",
- "usage_start",
- "main_thread",
- "finished",
- "request",
- "tag",
- "scope",
- ]
- def __init__(
- self,
- name: str,
- parent_context: "Optional[LoggingContext]" = None,
- request: Optional[ContextRequest] = None,
- ) -> None:
- self.previous_context = current_context()
- self.name = name
- # track the resources used by this context so far
- self._resource_usage = ContextResourceUsage()
- # The thread resource usage when the logcontext became active. None
- # if the context is not currently active.
- self.usage_start = None # type: Optional[resource._RUsage]
- self.main_thread = get_thread_id()
- self.request = None
- self.tag = ""
- self.scope = None # type: Optional[_LogContextScope]
- # keep track of whether we have hit the __exit__ block for this context
- # (suggesting that the the thing that created the context thinks it should
- # be finished, and that re-activating it would suggest an error).
- self.finished = False
- self.parent_context = parent_context
- if self.parent_context is not None:
- # we track the current request_id
- self.request = self.parent_context.request
- # we also track the current scope:
- self.scope = self.parent_context.scope
- if request is not None:
- # the request param overrides the request from the parent context
- self.request = request
- def __str__(self) -> str:
- return self.name
- @classmethod
- def current_context(cls) -> LoggingContextOrSentinel:
- """Get the current logging context from thread local storage
- This exists for backwards compatibility. ``current_context()`` should be
- called directly.
- Returns:
- LoggingContext: the current logging context
- """
- warnings.warn(
- "synapse.logging.context.LoggingContext.current_context() is deprecated "
- "in favor of synapse.logging.context.current_context().",
- DeprecationWarning,
- stacklevel=2,
- )
- return current_context()
- @classmethod
- def set_current_context(
- cls, context: LoggingContextOrSentinel
- ) -> LoggingContextOrSentinel:
- """Set the current logging context in thread local storage
- This exists for backwards compatibility. ``set_current_context()`` should be
- called directly.
- Args:
- context(LoggingContext): The context to activate.
- Returns:
- The context that was previously active
- """
- warnings.warn(
- "synapse.logging.context.LoggingContext.set_current_context() is deprecated "
- "in favor of synapse.logging.context.set_current_context().",
- DeprecationWarning,
- stacklevel=2,
- )
- return set_current_context(context)
- def __enter__(self) -> "LoggingContext":
- """Enters this logging context into thread local storage"""
- old_context = set_current_context(self)
- if self.previous_context != old_context:
- logcontext_error(
- "Expected previous context %r, found %r"
- % (
- self.previous_context,
- old_context,
- )
- )
- return self
- def __exit__(self, type, value, traceback) -> None:
- """Restore the logging context in thread local storage to the state it
- was before this context was entered.
- Returns:
- None to avoid suppressing any exceptions that were thrown.
- """
- current = set_current_context(self.previous_context)
- if current is not self:
- if current is SENTINEL_CONTEXT:
- logcontext_error("Expected logging context %s was lost" % (self,))
- else:
- logcontext_error(
- "Expected logging context %s but found %s" % (self, current)
- )
- # the fact that we are here suggests that the caller thinks that everything
- # is done and dusted for this logcontext, and further activity will not get
- # recorded against the correct metrics.
- self.finished = True
- def copy_to(self, record) -> None:
- """Copy logging fields from this context to a log record or
- another LoggingContext
- """
- # we track the current request
- record.request = self.request
- # we also track the current scope:
- record.scope = self.scope
- def start(self, rusage: "Optional[resource._RUsage]") -> None:
- """
- Record that this logcontext is currently running.
- This should not be called directly: use set_current_context
- Args:
- rusage: the resources used by the current thread, at the point of
- switching to this logcontext. May be None if this platform doesn't
- support getrusuage.
- """
- if get_thread_id() != self.main_thread:
- logcontext_error("Started logcontext %s on different thread" % (self,))
- return
- if self.finished:
- logcontext_error("Re-starting finished log context %s" % (self,))
- # If we haven't already started record the thread resource usage so
- # far
- if self.usage_start:
- logcontext_error("Re-starting already-active log context %s" % (self,))
- else:
- self.usage_start = rusage
- def stop(self, rusage: "Optional[resource._RUsage]") -> None:
- """
- Record that this logcontext is no longer running.
- This should not be called directly: use set_current_context
- Args:
- rusage: the resources used by the current thread, at the point of
- switching away from this logcontext. May be None if this platform
- doesn't support getrusuage.
- """
- try:
- if get_thread_id() != self.main_thread:
- logcontext_error("Stopped logcontext %s on different thread" % (self,))
- return
- if not rusage:
- return
- # Record the cpu used since we started
- if not self.usage_start:
- logcontext_error(
- "Called stop on logcontext %s without recording a start rusage"
- % (self,)
- )
- return
- utime_delta, stime_delta = self._get_cputime(rusage)
- self.add_cputime(utime_delta, stime_delta)
- finally:
- self.usage_start = None
- def get_resource_usage(self) -> ContextResourceUsage:
- """Get resources used by this logcontext so far.
- Returns:
- ContextResourceUsage: a *copy* of the object tracking resource
- usage so far
- """
- # we always return a copy, for consistency
- res = self._resource_usage.copy()
- # If we are on the correct thread and we're currently running then we
- # can include resource usage so far.
- is_main_thread = get_thread_id() == self.main_thread
- if self.usage_start and is_main_thread:
- rusage = get_thread_resource_usage()
- assert rusage is not None
- utime_delta, stime_delta = self._get_cputime(rusage)
- res.ru_utime += utime_delta
- res.ru_stime += stime_delta
- return res
- def _get_cputime(self, current: "resource._RUsage") -> Tuple[float, float]:
- """Get the cpu usage time between start() and the given rusage
- Args:
- rusage: the current resource usage
- Returns: Tuple[float, float]: seconds in user mode, seconds in system mode
- """
- assert self.usage_start is not None
- utime_delta = current.ru_utime - self.usage_start.ru_utime
- stime_delta = current.ru_stime - self.usage_start.ru_stime
- # sanity check
- if utime_delta < 0:
- logger.error(
- "utime went backwards! %f < %f",
- current.ru_utime,
- self.usage_start.ru_utime,
- )
- utime_delta = 0
- if stime_delta < 0:
- logger.error(
- "stime went backwards! %f < %f",
- current.ru_stime,
- self.usage_start.ru_stime,
- )
- stime_delta = 0
- return utime_delta, stime_delta
- def add_cputime(self, utime_delta: float, stime_delta: float) -> None:
- """Update the CPU time usage of this context (and any parents, recursively).
- Args:
- utime_delta: additional user time, in seconds, spent in this context.
- stime_delta: additional system time, in seconds, spent in this context.
- """
- self._resource_usage.ru_utime += utime_delta
- self._resource_usage.ru_stime += stime_delta
- if self.parent_context:
- self.parent_context.add_cputime(utime_delta, stime_delta)
- def add_database_transaction(self, duration_sec: float) -> None:
- """Record the use of a database transaction and the length of time it took.
- Args:
- duration_sec: The number of seconds the database transaction took.
- """
- if duration_sec < 0:
- raise ValueError("DB txn time can only be non-negative")
- self._resource_usage.db_txn_count += 1
- self._resource_usage.db_txn_duration_sec += duration_sec
- if self.parent_context:
- self.parent_context.add_database_transaction(duration_sec)
- def add_database_scheduled(self, sched_sec: float) -> None:
- """Record a use of the database pool
- Args:
- sched_sec: number of seconds it took us to get a connection
- """
- if sched_sec < 0:
- raise ValueError("DB scheduling time can only be non-negative")
- self._resource_usage.db_sched_duration_sec += sched_sec
- if self.parent_context:
- self.parent_context.add_database_scheduled(sched_sec)
- def record_event_fetch(self, event_count: int) -> None:
- """Record a number of events being fetched from the db
- Args:
- event_count: number of events being fetched
- """
- self._resource_usage.evt_db_fetch_count += event_count
- if self.parent_context:
- self.parent_context.record_event_fetch(event_count)
- class LoggingContextFilter(logging.Filter):
- """Logging filter that adds values from the current logging context to each
- record.
- """
- def __init__(self, request: str = ""):
- self._default_request = request
- def filter(self, record: logging.LogRecord) -> Literal[True]:
- """Add each fields from the logging contexts to the record.
- Returns:
- True to include the record in the log output.
- """
- context = current_context()
- record.request = self._default_request # type: ignore
- # context should never be None, but if it somehow ends up being, then
- # we end up in a death spiral of infinite loops, so let's check, for
- # robustness' sake.
- if context is not None:
- # Logging is interested in the request ID. Note that for backwards
- # compatibility this is stored as the "request" on the record.
- record.request = str(context) # type: ignore
- # Add some data from the HTTP request.
- request = context.request
- if request is None:
- return True
- record.ip_address = request.ip_address # type: ignore
- record.site_tag = request.site_tag # type: ignore
- record.requester = request.requester # type: ignore
- record.authenticated_entity = request.authenticated_entity # type: ignore
- record.method = request.method # type: ignore
- record.url = request.url # type: ignore
- record.protocol = request.protocol # type: ignore
- record.user_agent = request.user_agent # type: ignore
- return True
- class PreserveLoggingContext:
- """Context manager which replaces the logging context
- The previous logging context is restored on exit."""
- __slots__ = ["_old_context", "_new_context"]
- def __init__(
- self, new_context: LoggingContextOrSentinel = SENTINEL_CONTEXT
- ) -> None:
- self._new_context = new_context
- def __enter__(self) -> None:
- self._old_context = set_current_context(self._new_context)
- def __exit__(self, type, value, traceback) -> None:
- context = set_current_context(self._old_context)
- if context != self._new_context:
- if not context:
- logcontext_error(
- "Expected logging context %s was lost" % (self._new_context,)
- )
- else:
- logcontext_error(
- "Expected logging context %s but found %s"
- % (
- self._new_context,
- context,
- )
- )
- _thread_local = threading.local()
- _thread_local.current_context = SENTINEL_CONTEXT
- def current_context() -> LoggingContextOrSentinel:
- """Get the current logging context from thread local storage"""
- return getattr(_thread_local, "current_context", SENTINEL_CONTEXT)
- def set_current_context(context: LoggingContextOrSentinel) -> LoggingContextOrSentinel:
- """Set the current logging context in thread local storage
- Args:
- context(LoggingContext): The context to activate.
- Returns:
- The context that was previously active
- """
- # everything blows up if we allow current_context to be set to None, so sanity-check
- # that now.
- if context is None:
- raise TypeError("'context' argument may not be None")
- current = current_context()
- if current is not context:
- rusage = get_thread_resource_usage()
- current.stop(rusage)
- _thread_local.current_context = context
- context.start(rusage)
- return current
- def nested_logging_context(suffix: str) -> LoggingContext:
- """Creates a new logging context as a child of another.
- The nested logging context will have a 'name' made up of the parent context's
- name, plus the given suffix.
- CPU/db usage stats will be added to the parent context's on exit.
- Normal usage looks like:
- with nested_logging_context(suffix):
- # ... do stuff
- Args:
- suffix: suffix to add to the parent context's 'name'.
- Returns:
- LoggingContext: new logging context.
- """
- curr_context = current_context()
- if not curr_context:
- logger.warning(
- "Starting nested logging context from sentinel context: metrics will be lost"
- )
- parent_context = None
- else:
- assert isinstance(curr_context, LoggingContext)
- parent_context = curr_context
- prefix = str(curr_context)
- return LoggingContext(
- prefix + "-" + suffix,
- parent_context=parent_context,
- )
- def preserve_fn(f):
- """Function decorator which wraps the function with run_in_background"""
- def g(*args, **kwargs):
- return run_in_background(f, *args, **kwargs)
- return g
- def run_in_background(f, *args, **kwargs) -> defer.Deferred:
- """Calls a function, ensuring that the current context is restored after
- return from the function, and that the sentinel context is set once the
- deferred returned by the function completes.
- Useful for wrapping functions that return a deferred or coroutine, which you don't
- yield or await on (for instance because you want to pass it to
- deferred.gatherResults()).
- If f returns a Coroutine object, it will be wrapped into a Deferred (which will have
- the side effect of executing the coroutine).
- Note that if you completely discard the result, you should make sure that
- `f` doesn't raise any deferred exceptions, otherwise a scary-looking
- CRITICAL error about an unhandled error will be logged without much
- indication about where it came from.
- """
- current = current_context()
- try:
- res = f(*args, **kwargs)
- except Exception:
- # the assumption here is that the caller doesn't want to be disturbed
- # by synchronous exceptions, so let's turn them into Failures.
- return defer.fail()
- if isinstance(res, types.CoroutineType):
- res = defer.ensureDeferred(res)
- # At this point we should have a Deferred, if not then f was a synchronous
- # function, wrap it in a Deferred for consistency.
- if not isinstance(res, defer.Deferred):
- return defer.succeed(res)
- if res.called and not res.paused:
- # The function should have maintained the logcontext, so we can
- # optimise out the messing about
- return res
- # The function may have reset the context before returning, so
- # we need to restore it now.
- ctx = set_current_context(current)
- # The original context will be restored when the deferred
- # completes, but there is nothing waiting for it, so it will
- # get leaked into the reactor or some other function which
- # wasn't expecting it. We therefore need to reset the context
- # here.
- #
- # (If this feels asymmetric, consider it this way: we are
- # effectively forking a new thread of execution. We are
- # probably currently within a ``with LoggingContext()`` block,
- # which is supposed to have a single entry and exit point. But
- # by spawning off another deferred, we are effectively
- # adding a new exit point.)
- res.addBoth(_set_context_cb, ctx)
- return res
- def make_deferred_yieldable(deferred):
- """Given a deferred (or coroutine), make it follow the Synapse logcontext
- rules:
- If the deferred has completed (or is not actually a Deferred), essentially
- does nothing (just returns another completed deferred with the
- result/failure).
- If the deferred has not yet completed, resets the logcontext before
- returning a deferred. Then, when the deferred completes, restores the
- current logcontext before running callbacks/errbacks.
- (This is more-or-less the opposite operation to run_in_background.)
- """
- if inspect.isawaitable(deferred):
- # If we're given a coroutine we convert it to a deferred so that we
- # run it and find out if it immediately finishes, it it does then we
- # don't need to fiddle with log contexts at all and can return
- # immediately.
- deferred = defer.ensureDeferred(deferred)
- if not isinstance(deferred, defer.Deferred):
- return deferred
- if deferred.called and not deferred.paused:
- # it looks like this deferred is ready to run any callbacks we give it
- # immediately. We may as well optimise out the logcontext faffery.
- return deferred
- # ok, we can't be sure that a yield won't block, so let's reset the
- # logcontext, and add a callback to the deferred to restore it.
- prev_context = set_current_context(SENTINEL_CONTEXT)
- deferred.addBoth(_set_context_cb, prev_context)
- return deferred
- ResultT = TypeVar("ResultT")
- def _set_context_cb(result: ResultT, context: LoggingContext) -> ResultT:
- """A callback function which just sets the logging context"""
- set_current_context(context)
- return result
- def defer_to_thread(reactor, f, *args, **kwargs):
- """
- Calls the function `f` using a thread from the reactor's default threadpool and
- returns the result as a Deferred.
- Creates a new logcontext for `f`, which is created as a child of the current
- logcontext (so its CPU usage metrics will get attributed to the current
- logcontext). `f` should preserve the logcontext it is given.
- The result deferred follows the Synapse logcontext rules: you should `yield`
- on it.
- Args:
- reactor (twisted.internet.base.ReactorBase): The reactor in whose main thread
- the Deferred will be invoked, and whose threadpool we should use for the
- function.
- Normally this will be hs.get_reactor().
- f (callable): The function to call.
- args: positional arguments to pass to f.
- kwargs: keyword arguments to pass to f.
- Returns:
- Deferred: A Deferred which fires a callback with the result of `f`, or an
- errback if `f` throws an exception.
- """
- return defer_to_threadpool(reactor, reactor.getThreadPool(), f, *args, **kwargs)
- def defer_to_threadpool(reactor, threadpool, f, *args, **kwargs):
- """
- A wrapper for twisted.internet.threads.deferToThreadpool, which handles
- logcontexts correctly.
- Calls the function `f` using a thread from the given threadpool and returns
- the result as a Deferred.
- Creates a new logcontext for `f`, which is created as a child of the current
- logcontext (so its CPU usage metrics will get attributed to the current
- logcontext). `f` should preserve the logcontext it is given.
- The result deferred follows the Synapse logcontext rules: you should `yield`
- on it.
- Args:
- reactor (twisted.internet.base.ReactorBase): The reactor in whose main thread
- the Deferred will be invoked. Normally this will be hs.get_reactor().
- threadpool (twisted.python.threadpool.ThreadPool): The threadpool to use for
- running `f`. Normally this will be hs.get_reactor().getThreadPool().
- f (callable): The function to call.
- args: positional arguments to pass to f.
- kwargs: keyword arguments to pass to f.
- Returns:
- Deferred: A Deferred which fires a callback with the result of `f`, or an
- errback if `f` throws an exception.
- """
- curr_context = current_context()
- if not curr_context:
- logger.warning(
- "Calling defer_to_threadpool from sentinel context: metrics will be lost"
- )
- parent_context = None
- else:
- assert isinstance(curr_context, LoggingContext)
- parent_context = curr_context
- def g():
- with LoggingContext(str(curr_context), parent_context=parent_context):
- return f(*args, **kwargs)
- return make_deferred_yieldable(threads.deferToThreadPool(reactor, threadpool, g))
|