Best-effort OpenTelemetry spans for Chirp internals.
Chirp has no hard dependency onopentelemetry— OTel is configured
through Pounce viaAppConfig.otel_endpoint. These helpers no-op when the
SDK is absent or misbehaving, matchingchirp.logging's guarded pattern.
telemetry
| Name | Type | Default | Description |
|---|---|---|---|
type
|
|
— | |
qualified_name
|
|
— | |
element_type
|
|
— | |
description
|
|
— | |
source_file
|
|
— | |
line_number
|
|
— | |
is_autodoc
|
|
— | |
autodoc_element
|
|
— | |
_autodoc_template
|
|
— | |
_autodoc_url_path
|
|
— | |
_autodoc_page_type
|
|
— | |
title
|
|
— | |
doc_content_hash
|
|
— |
Symbols on this page
Open a best-effort OTel span without mutating raised exceptions.
Enters a_SpanScope when OTel is available, else None.
Recordsduration_mson close and…
Class-based exit avoids contextlib assigning frozen error tracebacks.
Manual span lifetime — use for async generators wherewithends too early.
trace_span
function
def trace_span(name: str, /, **attributes: Any) -> _TraceSpanOpen a best-effort OTel span without mutating raised exceptions.
Enters a_SpanScope when OTel is available, else None.
Recordsduration_mson close and marks ERROR status when the block
raises, preserving the original exception and traceback.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name
|
str
|
— | |
**attributes
|
Any
|
— |
_TraceSpan
class
Class-based exit avoids contextlib assigning frozen error tracebacks.
_SpanScope
class
Manual span lifetime — use for async generators wherewithends too early.
View source · /home/runner/work/chirp/chirp/site/../src/chirp/telemetry.py:1