telemetry-dev 0.2.13__tar.gz → 0.3.0__tar.gz

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telemetry-dev
-Version: 0.2.13
+Version: 0.3.0
 Summary: telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics
 Keywords: telemetry,opentelemetry,llm,genai,tracing,observability
 Author: telemetry.dev
@@ -81,7 +81,7 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 | Variable | Default | Purpose |
 | --- | --- | --- |
 | `TELEMETRY_DEV_API_KEY` | — | Ingest key (`td_live_...`). Absent = SDK is a no-op. |
-| `TELEMETRY_DEV_BASE_URL` | `https://ingest.telemetry.dev` | Base URL for telemetry export and `get_prompt` (trailing slashes stripped). |
+| `TELEMETRY_DEV_BASE_URL` | `https://api.telemetry.dev` | Base URL for telemetry export and `get_prompt` (trailing slashes stripped). |
 | `TELEMETRY_DEV_ENVIRONMENT` | `production` | Deployment environment label. |
 | `OTEL_SERVICE_NAME` | `unknown_service` | Service name on every trace. |
 | `OTEL_TRACES_SAMPLER` | `parentbased_always_on` | OTel trace sampling policy, which includes session roots. |
@@ -89,6 +89,10 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 
 Explicit `init()` arguments take precedence over environment variables.
 
+Earlier versions sent data to `https://ingest.telemetry.dev` by default. That hostname reaches the
+same service and stays supported: if a firewall allows only it, set `TELEMETRY_DEV_BASE_URL` or
+`base_url` to it.
+
 Root spans remain independent by default. `telemetry_dev.init(session_mode="process")` groups
 otherwise uncorrelated spans and logs using a fresh opaque UUID for each enabled SDK
 initialization. Explicit and propagated session IDs take precedence, and valid parent trace
@@ -253,7 +257,7 @@ pinned = telemetry_dev.get_prompt("support/reply", version=13)
   without its prompt.
 - `get_prompt` uses the API key and base URL of an enabled `init()`, or `TELEMETRY_DEV_API_KEY`
   and `TELEMETRY_DEV_BASE_URL`, or its own `api_key` and `base_url`. It reads the same host that
-  telemetry goes to, `https://ingest.telemetry.dev` by default. The key needs the read scope for
+  telemetry goes to, `https://api.telemetry.dev` by default. The key needs the read scope for
   prompts.
 - When a label sends part of the traffic to a second version, each session keeps one version: the
   choice uses the session id of `propagate_attributes` (or of `session_mode="process"`). Without a
@@ -331,7 +335,7 @@ from telemetry_dev import TelemetrySpanProcessor
 | Option | Default | Purpose |
 | --- | --- | --- |
 | `api_key` | `TELEMETRY_DEV_API_KEY` | Ingest key. Absent with no `span_exporter` = inert no-op. |
-| `base_url` | `TELEMETRY_DEV_BASE_URL` or `https://ingest.telemetry.dev` | Ingest base URL; trailing slashes are stripped. |
+| `base_url` | `TELEMETRY_DEV_BASE_URL` or `https://api.telemetry.dev` | Base URL; trailing slashes are stripped. |
 | `export_mode` | `"batched"` | `"batched"` or `"immediate"` span export. |
 | `max_export_batch_size` | `64` | BatchSpanProcessor export batch size. |
 | `schedule_delay_millis` | `1000` | BatchSpanProcessor schedule delay. |
@@ -399,7 +403,7 @@ from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
 
 exporter = OTLPSpanExporter(
-    endpoint="https://ingest.telemetry.dev/v1/traces",
+    endpoint="https://api.telemetry.dev/v1/traces",
     headers={"Authorization": f"Bearer {os.environ['TELEMETRY_DEV_API_KEY']}"},
 )
 provider = TracerProvider()
@@ -407,7 +411,7 @@ provider.add_span_processor(BatchSpanProcessor(exporter))
 trace.set_tracer_provider(provider)
 ```
 
-The Claude API can also send server-side spans to telemetry.dev through a Console destination. Set the endpoint to `https://ingest.telemetry.dev`. Set the `Authorization` header to `Bearer <telemetry.dev API key>`. For more information, refer to [Claude Platform](https://telemetry.dev/docs/integrations/claude-platform).
+The Claude API can also send server-side spans to telemetry.dev through a Console destination. Set the endpoint to `https://api.telemetry.dev`. Set the `Authorization` header to `Bearer <telemetry.dev API key>`. For more information, refer to [Claude Platform](https://telemetry.dev/docs/integrations/claude-platform).
 
 When the SDK and the Claude API send the spans of a request to the same telemetry.dev project, telemetry.dev counts the tokens of the request one time, from the API span. The SDK span stays in the trace with no tokens. telemetry.dev matches the two spans by the request ID or the response ID, so the API span does not have to be a child of the SDK span. If the Console destination uses an API key that is scoped to one environment, its API spans take over only the SDK spans of that environment.
 

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/README.md

@@ -56,7 +56,7 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 | Variable | Default | Purpose |
 | --- | --- | --- |
 | `TELEMETRY_DEV_API_KEY` | — | Ingest key (`td_live_...`). Absent = SDK is a no-op. |
-| `TELEMETRY_DEV_BASE_URL` | `https://ingest.telemetry.dev` | Base URL for telemetry export and `get_prompt` (trailing slashes stripped). |
+| `TELEMETRY_DEV_BASE_URL` | `https://api.telemetry.dev` | Base URL for telemetry export and `get_prompt` (trailing slashes stripped). |
 | `TELEMETRY_DEV_ENVIRONMENT` | `production` | Deployment environment label. |
 | `OTEL_SERVICE_NAME` | `unknown_service` | Service name on every trace. |
 | `OTEL_TRACES_SAMPLER` | `parentbased_always_on` | OTel trace sampling policy, which includes session roots. |
@@ -64,6 +64,10 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 
 Explicit `init()` arguments take precedence over environment variables.
 
+Earlier versions sent data to `https://ingest.telemetry.dev` by default. That hostname reaches the
+same service and stays supported: if a firewall allows only it, set `TELEMETRY_DEV_BASE_URL` or
+`base_url` to it.
+
 Root spans remain independent by default. `telemetry_dev.init(session_mode="process")` groups
 otherwise uncorrelated spans and logs using a fresh opaque UUID for each enabled SDK
 initialization. Explicit and propagated session IDs take precedence, and valid parent trace
@@ -228,7 +232,7 @@ pinned = telemetry_dev.get_prompt("support/reply", version=13)
   without its prompt.
 - `get_prompt` uses the API key and base URL of an enabled `init()`, or `TELEMETRY_DEV_API_KEY`
   and `TELEMETRY_DEV_BASE_URL`, or its own `api_key` and `base_url`. It reads the same host that
-  telemetry goes to, `https://ingest.telemetry.dev` by default. The key needs the read scope for
+  telemetry goes to, `https://api.telemetry.dev` by default. The key needs the read scope for
   prompts.
 - When a label sends part of the traffic to a second version, each session keeps one version: the
   choice uses the session id of `propagate_attributes` (or of `session_mode="process"`). Without a
@@ -306,7 +310,7 @@ from telemetry_dev import TelemetrySpanProcessor
 | Option | Default | Purpose |
 | --- | --- | --- |
 | `api_key` | `TELEMETRY_DEV_API_KEY` | Ingest key. Absent with no `span_exporter` = inert no-op. |
-| `base_url` | `TELEMETRY_DEV_BASE_URL` or `https://ingest.telemetry.dev` | Ingest base URL; trailing slashes are stripped. |
+| `base_url` | `TELEMETRY_DEV_BASE_URL` or `https://api.telemetry.dev` | Base URL; trailing slashes are stripped. |
 | `export_mode` | `"batched"` | `"batched"` or `"immediate"` span export. |
 | `max_export_batch_size` | `64` | BatchSpanProcessor export batch size. |
 | `schedule_delay_millis` | `1000` | BatchSpanProcessor schedule delay. |
@@ -374,7 +378,7 @@ from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
 
 exporter = OTLPSpanExporter(
-    endpoint="https://ingest.telemetry.dev/v1/traces",
+    endpoint="https://api.telemetry.dev/v1/traces",
     headers={"Authorization": f"Bearer {os.environ['TELEMETRY_DEV_API_KEY']}"},
 )
 provider = TracerProvider()
@@ -382,7 +386,7 @@ provider.add_span_processor(BatchSpanProcessor(exporter))
 trace.set_tracer_provider(provider)
 ```
 
-The Claude API can also send server-side spans to telemetry.dev through a Console destination. Set the endpoint to `https://ingest.telemetry.dev`. Set the `Authorization` header to `Bearer <telemetry.dev API key>`. For more information, refer to [Claude Platform](https://telemetry.dev/docs/integrations/claude-platform).
+The Claude API can also send server-side spans to telemetry.dev through a Console destination. Set the endpoint to `https://api.telemetry.dev`. Set the `Authorization` header to `Bearer <telemetry.dev API key>`. For more information, refer to [Claude Platform](https://telemetry.dev/docs/integrations/claude-platform).
 
 When the SDK and the Claude API send the spans of a request to the same telemetry.dev project, telemetry.dev counts the tokens of the request one time, from the API span. The SDK span stays in the trace with no tokens. telemetry.dev matches the two spans by the request ID or the response ID, so the API span does not have to be a child of the SDK span. If the Console destination uses an API key that is scoped to one environment, its API spans take over only the SDK spans of that environment.
 

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.13"
+version = "0.3.0"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.13"
+version = "0.3.0"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/src/telemetry_dev/_config.py

@@ -8,7 +8,7 @@ from collections.abc import Callable
 from dataclasses import dataclass
 from typing import Literal
 
-DEFAULT_BASE_URL = "https://ingest.telemetry.dev"
+DEFAULT_BASE_URL = "https://api.telemetry.dev"
 
 
 def _resolve_version() -> str:

{telemetry_dev-0.2.13 → telemetry_dev-0.3.0}/src/telemetry_dev/_prompts.py

@@ -26,7 +26,7 @@ from opentelemetry import context as otel_context
 from opentelemetry.context import Context
 
 from ._client import Client, get_client
-from ._config import report_error, resolve_config
+from ._config import SDK_VERSION, report_error, resolve_config
 from ._context import propagated_attributes
 from ._semconv import (
     ATTR_PROMPT_LABEL,
@@ -333,7 +333,13 @@ def _get_prompt(
             cache_ttl_seconds,
             lambda: _fetch(
                 f"{url}/v1/prompts?{urllib.parse.urlencode(query)}",
-                {"Authorization": f"Bearer {key}", "X-Telemetry-Dev-SDK": "telemetry-dev"},
+                {
+                    "Authorization": f"Bearer {key}",
+                    "X-Telemetry-Dev-SDK": "telemetry-dev",
+                    # urllib's default User-Agent, Python-urllib/3.x, is refused by bot filters
+                    # such as Cloudflare's Browser Integrity Check.
+                    "User-Agent": f"telemetry-dev-python/{SDK_VERSION}",
+                },
             ),
             on_error,
         )