angr.misc.telemetry

class angr.misc.telemetry.Status

Bases: object

Represents the status of a finished Span.

Parameters:

  • status_code (StatusCode) – The canonical status code that describes the result status of the operation.

  • description (Optional[str]) – An optional description of the status.

__init__(status_code=StatusCode.UNSET, description=None)
Parameters:

  • status_code (StatusCode)

  • description (str | None)

property status_code: StatusCode

Represents the canonical status code of a finished Span.

property description: str | None

Status description

property is_ok: bool

Returns false if this represents an error, true otherwise.

property is_unset: bool

Returns true if unset, false otherwise.

class angr.misc.telemetry.StatusCode

Bases: Enum

Represents the canonical set of status codes of a finished Span.

UNSET = 0

The default status.

OK = 1

The operation has been validated by an Application developer or Operator to have completed successfully.

ERROR = 2

The operation contains an error.

angr.misc.telemetry.get_current_span(context=None)

Retrieve the current span.

Parameters:

context (Optional[Context]) – A Context object. If one is not passed, the default current context is used instead.

Return type:

Span

Returns:

The Span set in the context if it exists. INVALID_SPAN otherwise.

angr.misc.telemetry.get_tracer(name)
Return type:

Tracer

Parameters:

name (str)