Files
mtusi2026lab6/app/core/telemetry.py

119 lines
3.5 KiB
Python

import logging
import os
import socket
from opentelemetry import metrics, trace
from opentelemetry._logs import set_logger_provider
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.instrumentation.logging import LoggingInstrumentor
from opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor
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 app.core.config import settings
logger = logging.getLogger(__name__)
_initialized = False
def setup_telemetry(app, engine) -> None:
"""Initialize OpenTelemetry instrumentation for the API service."""
global _initialized
if _initialized:
return
service_name = os.getenv("OTEL_SERVICE_NAME", "messenger-api")
endpoint = os.getenv(
"OTEL_EXPORTER_OTLP_ENDPOINT",
"http://otel-collector:4318",
).rstrip("/")
resource = Resource.create(
{
"service.name": service_name,
"service.version": "1.4.0",
"service.instance.id": settings.instance_id or socket.gethostname(),
"deployment.environment.name": settings.app_env,
}
)
# Distributed tracing.
tracer_provider = TracerProvider(resource=resource)
tracer_provider.add_span_processor(
BatchSpanProcessor(
OTLPSpanExporter(
endpoint=f"{endpoint}/v1/traces",
)
)
)
trace.set_tracer_provider(tracer_provider)
# Metrics.
metric_reader = PeriodicExportingMetricReader(
OTLPMetricExporter(
endpoint=f"{endpoint}/v1/metrics",
),
export_interval_millis=10000,
)
meter_provider = MeterProvider(
resource=resource,
metric_readers=[metric_reader],
)
metrics.set_meter_provider(meter_provider)
# Logs.
logger_provider = LoggerProvider(resource=resource)
logger_provider.add_log_record_processor(
BatchLogRecordProcessor(
OTLPLogExporter(
endpoint=f"{endpoint}/v1/logs",
)
)
)
set_logger_provider(logger_provider)
# Add trace_id and span_id to Python log records.
LoggingInstrumentor().instrument(
tracer_provider=tracer_provider,
set_logging_format=False,
)
# Export Python logging records through OTLP.
logging_handler = LoggingHandler(
level=logging.INFO,
logger_provider=logger_provider,
)
logging.getLogger().addHandler(logging_handler)
# FastAPI HTTP server spans. Health endpoints are excluded.
FastAPIInstrumentor.instrument_app(
app,
tracer_provider=tracer_provider,
meter_provider=meter_provider,
excluded_urls=r".*/health/(live|ready)$",
)
# SQLAlchemy database spans.
SQLAlchemyInstrumentor().instrument(
engine=engine,
tracer_provider=tracer_provider,
)
_initialized = True
logger.info("OpenTelemetry initialized for service %s", service_name)