Files
mtusi2026lab6/app/telemetry.py
T

98 lines
4.1 KiB
Python

"""lab6: общая инициализация OTel для API и worker.
Каждый процесс вызывает init(service_name=...) один раз. После этого:
- get_tracer() / get_meter() — SDK-хендлы;
- inject_headers(dict) / extract_context(dict) — W3C trace context через RabbitMQ.
"""
import logging
import os
from opentelemetry import metrics, trace
from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
from opentelemetry.propagate import inject as _inject, extract as _extract
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader
from opentelemetry.sdk.resources import Resource, SERVICE_NAME, SERVICE_VERSION
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
from opentelemetry._logs import set_logger_provider
log = logging.getLogger("telemetry")
_initialized = False
def init(service_name: str) -> None:
"""Идемпотентная инициализация. Если OTEL выключен — no-op.
Ресурс: service.name, service.version, deployment.environment.name, service.instance.id.
"""
global _initialized
if _initialized:
return
# OTEL_SDK_DISABLED=true отключает SDK полностью (для теста «telemetry off»).
if os.environ.get("OTEL_SDK_DISABLED", "false").lower() == "true":
log.info("OTel disabled by OTEL_SDK_DISABLED, using no-op providers")
_initialized = True
return
endpoint = os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "http://otel-collector:4318")
version = os.environ.get("OTEL_SERVICE_VERSION", "1.6.0")
instance_id = os.environ.get("HOSTNAME") or os.environ.get("INSTANCE_ID") or "unknown"
resource = Resource.create({
SERVICE_NAME: service_name,
SERVICE_VERSION: version,
"deployment.environment.name": "lab",
"service.instance.id": instance_id,
})
# Traces
tracer_provider = TracerProvider(resource=resource)
tracer_provider.add_span_processor(
BatchSpanProcessor(OTLPSpanExporter(endpoint=endpoint + "/v1/traces")))
trace.set_tracer_provider(tracer_provider)
# Metrics — периодический экспорт каждые 10 секунд.
reader = PeriodicExportingMetricReader(
OTLPMetricExporter(endpoint=endpoint + "/v1/metrics"),
export_interval_millis=10_000)
meter_provider = MeterProvider(resource=resource, metric_readers=[reader])
metrics.set_meter_provider(meter_provider)
# Logs — OTLP HTTP в Collector → Loki. Формат структурный, JSON.
logger_provider = LoggerProvider(resource=resource)
logger_provider.add_log_record_processor(
BatchLogRecordProcessor(OTLPLogExporter(endpoint=endpoint + "/v1/logs")))
set_logger_provider(logger_provider)
# Прикрепляем OTel handler к root logger, чтобы все наши log.info(...)
# уходили в Collector. Существующий StreamHandler остаётся — логи видны и в docker logs.
root = logging.getLogger()
root.addHandler(LoggingHandler(level=logging.INFO, logger_provider=logger_provider))
_initialized = True
log.info("OTel initialized: service=%s endpoint=%s", service_name, endpoint)
def get_tracer(name: str = None):
return trace.get_tracer(name or "messenger")
def get_meter(name: str = None):
return metrics.get_meter(name or "messenger")
def inject_headers(carrier: dict) -> dict:
"""W3C traceparent/tracestate → headers брокера. Level 4: сквозная связь."""
_inject(carrier)
return carrier
def extract_context(carrier: dict):
"""Из headers брокера → OTel Context. Используется в worker."""
return _extract(carrier or {})