mirror of
https://github.com/meta-llama/llama-stack.git
synced 2025-10-03 19:57:35 +00:00
90 lines
3.6 KiB
Python
90 lines
3.6 KiB
Python
# Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
# All rights reserved.
|
|
#
|
|
# This source code is licensed under the terms described in the LICENSE file in
|
|
# the root directory of this source tree.
|
|
|
|
from typing import Any
|
|
|
|
from aiohttp import hdrs
|
|
|
|
from llama_stack.apis.datatypes import Api
|
|
from llama_stack.core.external import ExternalApiSpec
|
|
from llama_stack.core.server.routes import find_matching_route, initialize_route_impls
|
|
from llama_stack.log import get_logger
|
|
from llama_stack.providers.utils.telemetry.tracing import end_trace, start_trace
|
|
|
|
logger = get_logger(name=__name__, category="telemetry::meta_reference")
|
|
|
|
|
|
class TracingMiddleware:
|
|
def __init__(
|
|
self,
|
|
app,
|
|
impls: dict[Api, Any],
|
|
external_apis: dict[str, ExternalApiSpec],
|
|
):
|
|
self.app = app
|
|
self.impls = impls
|
|
self.external_apis = external_apis
|
|
# FastAPI built-in paths that should bypass custom routing
|
|
self.fastapi_paths = ("/docs", "/redoc", "/openapi.json", "/favicon.ico", "/static")
|
|
|
|
async def __call__(self, scope, receive, send):
|
|
if scope.get("type") == "lifespan":
|
|
return await self.app(scope, receive, send)
|
|
|
|
path = scope.get("path", "")
|
|
|
|
# Check if the path is a FastAPI built-in path
|
|
if path.startswith(self.fastapi_paths):
|
|
# Pass through to FastAPI's built-in handlers
|
|
logger.debug(f"Bypassing custom routing for FastAPI built-in path: {path}")
|
|
return await self.app(scope, receive, send)
|
|
|
|
if not hasattr(self, "route_impls"):
|
|
external_api_map = {Api(api_name): spec for api_name, spec in self.external_apis.items()}
|
|
self.route_impls = initialize_route_impls(self.impls, external_api_map)
|
|
|
|
try:
|
|
_, _, route_path, webmethod = find_matching_route(
|
|
scope.get("method", hdrs.METH_GET), path, self.route_impls
|
|
)
|
|
except ValueError:
|
|
# If no matching endpoint is found, pass through to FastAPI
|
|
logger.debug(f"No matching route found for path: {path}, falling back to FastAPI")
|
|
return await self.app(scope, receive, send)
|
|
|
|
# Log deprecation warning if route is deprecated
|
|
if getattr(webmethod, "deprecated", False):
|
|
logger.warning(
|
|
f"DEPRECATED ROUTE USED: {scope.get('method', 'GET')} {path} - "
|
|
f"This route is deprecated and may be removed in a future version. "
|
|
f"Please check the docs for the supported version."
|
|
)
|
|
|
|
trace_attributes = {"__location__": "server", "raw_path": path}
|
|
|
|
# Extract W3C trace context headers and store as trace attributes
|
|
headers = dict(scope.get("headers", []))
|
|
traceparent = headers.get(b"traceparent", b"").decode()
|
|
if traceparent:
|
|
trace_attributes["traceparent"] = traceparent
|
|
tracestate = headers.get(b"tracestate", b"").decode()
|
|
if tracestate:
|
|
trace_attributes["tracestate"] = tracestate
|
|
|
|
trace_path = webmethod.descriptive_name or route_path
|
|
trace_context = await start_trace(trace_path, trace_attributes)
|
|
|
|
async def send_with_trace_id(message):
|
|
if message["type"] == "http.response.start":
|
|
headers = message.get("headers", [])
|
|
headers.append([b"x-trace-id", str(trace_context.trace_id).encode()])
|
|
message["headers"] = headers
|
|
await send(message)
|
|
|
|
try:
|
|
return await self.app(scope, receive, send_with_trace_id)
|
|
finally:
|
|
await end_trace()
|