arcade-mcp/libs/arcade-serve/arcade_serve/fastapi/telemetry.py
2025-11-25 14:38:16 -08:00

140 lines
5.8 KiB
Python

import logging
import os
import urllib.parse
from typing import Optional
from fastapi import FastAPI
from opentelemetry import _logs, trace
from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
from opentelemetry.metrics import Meter, get_meter_provider, set_meter_provider
from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.semconv._incubating.attributes import deployment_attributes
from opentelemetry.semconv.attributes import service_attributes
EXCLUDED_URLS = "/worker/health"
EXCLUDED_SPANS = ["send", "receive"]
class ShutdownError(Exception):
pass
class OTELHandler:
def __init__(self, enable: bool = True, log_level: int = logging.INFO):
self.enable = enable
self.log_level = log_level
self._tracer_provider: Optional[TracerProvider] = None
self._tracer_span_exporter: Optional[OTLPSpanExporter] = None
self._meter_provider: Optional[MeterProvider] = None
self._meter_reader: Optional[PeriodicExportingMetricReader] = None
self._otlp_metric_exporter: Optional[OTLPMetricExporter] = None
self._logger_provider: Optional[LoggerProvider] = None
self._log_processor: Optional[BatchLogRecordProcessor] = None
self.environment = os.environ.get("ARCADE_ENVIRONMENT", "local")
def instrument_app(self, app: FastAPI) -> None:
if self.enable:
logging.info(
"🔎 Initializing OpenTelemetry. Use environment variables to configure the connection"
)
self.resource = Resource(
attributes={
service_attributes.SERVICE_NAME: "worker",
deployment_attributes.DEPLOYMENT_ENVIRONMENT_NAME: self.environment,
}
)
self._init_tracer()
self._init_metrics()
self._init_logging(self.log_level)
FastAPIInstrumentor().instrument_app(
app, excluded_urls=EXCLUDED_URLS, exclude_spans=EXCLUDED_SPANS
)
def _init_tracer(self) -> None:
self._tracer_provider = TracerProvider(resource=self.resource)
trace.set_tracer_provider(self._tracer_provider)
# Create an OTLP exporter
self._tracer_span_exporter = OTLPSpanExporter()
try:
self._tracer_span_exporter.export([trace.get_tracer(__name__).start_span("ping")])
except Exception as e:
raise ConnectionError(
f"Could not connect to OpenTelemetry Tracer endpoint. Check OpenTelemetry configuration or disable: {e}"
)
# Create a batch span processor and add the exporter
span_processor = BatchSpanProcessor(self._tracer_span_exporter)
self._tracer_provider.add_span_processor(span_processor)
def _init_metrics(self) -> None:
self._otlp_metric_exporter = OTLPMetricExporter()
self._meter_reader = PeriodicExportingMetricReader(self._otlp_metric_exporter)
self._meter_provider = MeterProvider(
metric_readers=[self._meter_reader], resource=self.resource
)
set_meter_provider(self._meter_provider)
def get_meter(self) -> Meter:
return get_meter_provider().get_meter(__name__)
def _init_logging(self, log_level: int) -> None:
otlp_log_exporter = OTLPLogExporter()
self._logger_provider = LoggerProvider(resource=self.resource)
_logs.set_logger_provider(self._logger_provider)
# Create a batch span processor and add the exporter
self._log_processor = BatchLogRecordProcessor(otlp_log_exporter)
self._logger_provider.add_log_record_processor(self._log_processor)
handler = LoggingHandler(level=log_level, logger_provider=self._logger_provider)
logging.getLogger().addHandler(handler)
# Create a filter for urllib3 connection logs related to OpenTelemetry
class OTELConnectionFilter(logging.Filter):
def filter(self, record: logging.LogRecord) -> bool:
# Filter out connection logs to OpenTelemetry endpoints
parsed_url = urllib.parse.urlparse(
os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "")
)
domain = parsed_url.netloc.split(":")[0]
return not (domain and domain in str(getattr(record, "args", ())))
# Apply the filter to the urllib3 logger
urllib3_logger = logging.getLogger("urllib3.connectionpool")
urllib3_logger.addFilter(OTELConnectionFilter())
def _shutdown_tracer(self) -> None:
if self._tracer_span_exporter is None:
raise ShutdownError("Tracer provider not initialized. Failed to shutdown")
self._tracer_span_exporter.shutdown()
def _shutdown_metrics(self) -> None:
if self._otlp_metric_exporter is None:
raise ShutdownError("Meter provider not initialized. Failed to shutdown")
self._otlp_metric_exporter.shutdown()
def _shutdown_logging(self) -> None:
if self._logger_provider is None:
raise ShutdownError("Log provider not initialized. Failed to shutdown")
self._logger_provider.shutdown()
def shutdown(self) -> None:
self._shutdown_tracer()
self._shutdown_metrics()
self._shutdown_logging()