tracing - Splunk Agent Observability

Module

W3C trace-context middleware for Starlette-based applications. TracingMiddleware extracts traceparent and tracestate through the configured OpenTelemetry propagator. Applications explicitly own the local Splunk AO logger and trace lifecycle

app.add_middleware(TracingMiddleware)

@app.post("/process")
async def process_request(data: dict):
    logger = get_request_logger()
    try:
        logger.start_trace(input=str(data), name="request")
        logger.add_workflow_span(input=str(data), name="process")
        result = await process(data)
        logger.conclude(output=str(result), conclude_all=True)
        return {"result": result}
    finally:
        logger.terminate()

TracingMiddleware

Attach incoming W3C trace context for the duration of each request.

dispatch

async def dispatch(self,
                   request: Request,
                   call_next: RequestResponseEndpoint) -> Response

Extract, attach, and reliably detach the request’s trace context.

get_request_logger

def get_request_logger() -> SplunkAOLogger

Create a request-scoped logger under the middleware’s active context. The caller must explicitly call start_trace() before adding spans and should call terminate() in finally. With an extracted W3C parent, the first real local operation becomes its descendant; without one, it starts a new trace.