feat: OpenTelemetry tracing (#73)

Author: hrodmn

infrastructure/aws/lambda/Dockerfile

@@ -5,11 +5,12 @@ COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 
 WORKDIR /tmp
 
+RUN dnf install -y gcc-c++  
+
 COPY uv.lock .python-version pyproject.toml LICENSE README.md ./
 COPY titiler/ ./titiler/
 
-RUN dnf install -y gcc-c++  
-RUN uv export --locked --no-editable --no-dev --extra lambda --format requirements.txt -o requirements.txt && \
+RUN uv export --locked --no-editable --no-dev --extra lambda --extra telemetry --format requirements.txt -o requirements.txt && \
   uv pip install --compile-bytecode --no-binary pydantic --target /asset -r requirements.txt 
 
 # copy libexpat.so.1 into /asset which is included in LD_LIBRARY_PATH
@@ -21,6 +22,8 @@ RUN cd /asset && find . -type d -a -name '__pycache__' -print0 | xargs -0 rm -rf
 RUN cd /asset && find . -type f -a -name '*.py' -print0 | xargs -0 rm -f
 RUN find /asset -type d -a -name 'tests' -print0 | xargs -0 rm -rf
 RUN rm -rdf /asset/numpy/doc/ /asset/bin /asset/geos_license /asset/Misc
+RUN rm -rdf /asset/boto3*
+RUN rm -rdf /asset/botocore*
 
 # Strip debug symbols from compiled C/C++ code (except for numpy.libs!)
 RUN cd /asset && \

infrastructure/aws/lambda/handler.py

@@ -6,6 +6,11 @@
 
 import earthaccess
 from mangum import Mangum
+from opentelemetry import trace
+from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
+from opentelemetry.instrumentation.logging import LoggingInstrumentor
+from opentelemetry.sdk.resources import SERVICE_NAME, SERVICE_VERSION, Resource
+from opentelemetry.sdk.trace import TracerProvider
 
 from titiler.cmr.main import app
 from titiler.cmr.settings import AuthSettings
@@ -16,6 +21,25 @@
 logging.getLogger("mangum.http").setLevel(logging.ERROR)
 
 
+LoggingInstrumentor().instrument(set_logging_format=True)
+FastAPIInstrumentor.instrument_app(app)
+
+resource = Resource.create(
+    {
+        SERVICE_NAME: "titiler-cmr",
+        SERVICE_VERSION: "0.1.0",
+    }
+)
+
+provider = TracerProvider(resource=resource)
+
+# uses the OTEL_EXPORTER_OTLP_ENDPOINT env var
+# processor = BatchSpanProcessor(OTLPSpanExporter())
+# provider.add_span_processor(processor)
+
+trace.set_tracer_provider(provider)
+
+
 @app.on_event("startup")
 async def startup_event() -> None:
     """startup."""

pyproject.toml

@@ -24,24 +24,24 @@ dependencies = [
     "titiler.core>=0.23.1,<0.24",
     "titiler.mosaic>=0.23.1,<0.24",
     "titiler.xarray>=0.23.1,<0.24",
-    "aiobotocore>=2.20",
-    "boto3>=1.34.145",
+    "aiobotocore>=2.24.0",
+    "boto3>=1.39.0",
     "cftime~=1.6.4",
     "earthaccess~=0.11.0",
+    "geojson-pydantic>=2.0.0,<3.0",
     "h5netcdf~=1.1.0",
+    "httpx>=0.27.2",
+    "isodate>=0.7.2",
     "orjson~=3.10.7",
+    "pillow>=11.0.0",
+    "psutil>=6.0.0",
     "pydantic-settings~=2.0",
     "pydantic>=2.4,<3.0",
+    "python-dateutil>=2.9.0.post0",
     "rio_tiler[s3]>=7.2.0,<8.0",
     "rioxarray~=0.13.4",
     "s3fs~=2025.9.0",
     "xarray~=2024.9.0",
-    "geojson-pydantic>=2.0.0,<3.0",
-    "python-dateutil>=2.9.0.post0",
-    "httpx>=0.27.2",
-    "pillow>=11.0.0",
-    "isodate>=0.7.2",
-    "psutil>=6.0.0",
 ]
 dynamic = ["version"]
 
@@ -50,8 +50,13 @@ uvicorn = [
     "uvicorn",
 ]
 
-lambda = ["mangum==0.19.0"]
-
+lambda = [
+    "mangum==0.19.0",
+    "aiobotocore>=2.24.0,<2.24.2"
+]
+telemetry = [
+    "titiler.core[telemetry]>=0.23.1,<0.24",
+]
 [dependency-groups]
 dev = [
     "folium>=0.17.0",

titiler/cmr/reader.py

@@ -3,14 +3,14 @@
 Originaly from titiler-xarray
 """
 
+import os
 import pickle
 from typing import Any, Dict, Optional, Type
 from urllib.parse import urlparse
 
 import attr
 import earthaccess
 import fsspec
-import os
 import s3fs
 import xarray
 from cachetools import TTLCache