add logfire token support

Author: martinabeleda

.env.example

@@ -0,0 +1 @@
+LOGFIRE_TOKEN=your-logfire-write-token

README.md

@@ -9,9 +9,12 @@ A strava clone service for storing running, hiking and ski routes
 Run the service using docker-compose:
 
 ```shell
+cp .env.example .env
 docker compose up --build
 ```
 
+The dev compose setup reads `LOGFIRE_TOKEN` from `.env` and passes it into the `service` container so Logfire can export telemetry.
+
 ## Local development with uv
 
 Install dependencies and development tooling with [uv](https://docs.astral.sh/uv/):

docker-compose.yml

@@ -48,6 +48,8 @@ services:
       - "--reload"
     environment:
       - PROJECT_NAME=strava
+      - ENVIRONMENT=development
+      - LOGFIRE_TOKEN=${LOGFIRE_TOKEN}
       - POSTGRES_SERVER=db:5432
       - POSTGRES_USER=postgres
       - POSTGRES_PASSWORD=password

strava/config.py

@@ -10,6 +10,7 @@ class Settings(BaseSettings):
     PROJECT_NAME: str
     ENVIRONMENT: str = "development"
     LOGFIRE_SEND_TO_LOGFIRE: bool | Literal["if-token-present"] = "if-token-present"
+    LOGFIRE_TOKEN: str | None = None
 
     POSTGRES_SERVER: str
     POSTGRES_USER: str = "postgres"

strava/observability.py

@@ -10,6 +10,7 @@ def configure_observability(app: FastAPI, settings: Settings, engine: Engine) ->
         service_name=settings.PROJECT_NAME,
         environment=settings.ENVIRONMENT,
         send_to_logfire=settings.LOGFIRE_SEND_TO_LOGFIRE,
+        token=settings.LOGFIRE_TOKEN,
     )
     logfire.instrument_fastapi(app)
     logfire.instrument_sqlalchemy(engine)

tests/test_config.py

@@ -27,6 +27,11 @@ def test_environment_default(self):
 
         assert settings.ENVIRONMENT == "development"
 
+    def test_logfire_token_default(self):
+        from strava.config import settings
+
+        assert settings.LOGFIRE_TOKEN is None
+
     def test_settings_from_env(self, monkeypatch):
         monkeypatch.setenv("PROJECT_NAME", "my-project")
         monkeypatch.setenv("POSTGRES_SERVER", "db-host")
@@ -82,3 +87,15 @@ class Info:
             data = {}
 
         assert Settings.assemble_db_connection(None, Info()) is None
+
+    def test_logfire_token_from_env(self, monkeypatch):
+        monkeypatch.setenv("PROJECT_NAME", "test")
+        monkeypatch.setenv("POSTGRES_SERVER", "localhost")
+        monkeypatch.setenv("POSTGRES_PASSWORD", "pass")
+        monkeypatch.setenv("POSTGRES_DB", "db")
+        monkeypatch.setenv("LOGFIRE_TOKEN", "test-token")
+
+        from strava.config import Settings
+
+        s = Settings()
+        assert s.LOGFIRE_TOKEN == "test-token"

tests/test_observability.py

@@ -16,6 +16,7 @@ def test_configure_observability_wires_logfire():
         POSTGRES_PASSWORD="password",
         POSTGRES_DB="test",
         LOGFIRE_SEND_TO_LOGFIRE=False,
+        LOGFIRE_TOKEN="test-token",
     )
 
     with patch("strava.observability.logfire.configure") as configure:
@@ -29,6 +30,7 @@ def test_configure_observability_wires_logfire():
         service_name="strava-test",
         environment="test",
         send_to_logfire=False,
+        token="test-token",
     )
     instrument_fastapi.assert_called_once_with(app)
     instrument_sqlalchemy.assert_called_once_with(engine)