From 691d9f95512856b896334b1e037b5d52031d7ce1 Mon Sep 17 00:00:00 2001 From: Jeff Dupont Date: Wed, 28 Oct 2026 10:59:51 -0700 Subject: [PATCH 1/3] docs(AIC-3692): say which project id attribute the telemetry resource carries The client README and agents.md listed service.name and deployment.environment as the resource attributes init_client() sets, but not launchdarkly.project_id. State that it is the resolved SDK key, and that it replaced highlight.project_id, so anyone matching on the old name knows to switch. Co-Authored-By: Claude Opus 5.5 --- packages/client/README.md | 2 ++ packages/client/agents.md | 1 + 2 files changed, 3 insertions(+) diff --git a/packages/client/README.md b/packages/client/README.md index ecabd1ef..3ba6b32c 100644 --- a/packages/client/README.md +++ b/packages/client/README.md @@ -44,6 +44,8 @@ No code changes are required — `init_client()` detects the packages at runtime | `LD_API_BASE_URI` | No | Evaluations management API host override; intentionally separate from `LD_BASE_URI` | | `LD_UI_BASE_URI` | No | LaunchDarkly application host for evaluation-run links (default: `https://app.launchdarkly.com`). Set it for a non-production project, or its runs still link to the production app | +`init_client()` also sets the `launchdarkly.project_id` resource attribute to the resolved SDK key. It is the SDK key, not the project's ID. Earlier releases sent the same value as `highlight.project_id`, which is no longer sent: if a collector, filter or alert matches on `highlight.project_id`, change it to `launchdarkly.project_id`. + ### Run an evaluation from code (experimental) > **Experimental.** Import Evaluations from Code from `launchdarkly_ai_server.experimental.evaluations`; diff --git a/packages/client/agents.md b/packages/client/agents.md index 3eea9a15..f9dada8f 100644 --- a/packages/client/agents.md +++ b/packages/client/agents.md @@ -853,6 +853,7 @@ pip install "launchdarkly-ai-python[otel]" **Other env vars / options read by `init_client()`:** - `LD_SERVICE_NAME` / `options["serviceName"]` — sets `service.name` resource attribute (default: `'python-sdk'`) - `LD_ENVIRONMENT` / `options["environment"]` — sets `deployment.environment` resource attribute +- Not configurable: the `launchdarkly.project_id` resource attribute is always set to the resolved SDK key, not the project's ID. It replaced `highlight.project_id`, which is no longer sent **Graceful degradation:** if any OTel package is missing, telemetry is silently skipped and a `logger.warning` is emitted. The LD client still initializes and all AI API calls work normally. From 825538e0904dd80178c853021ff65780750d1e95 Mon Sep 17 00:00:00 2001 From: Jeff Dupont Date: Wed, 28 Oct 2026 11:18:45 -0700 Subject: [PATCH 2/3] docs(AIC-3692): drop the highlight.project_id history from the README note The README never named highlight.project_id, so the note only needs the current attribute. The changelog's breaking-change entry from #229 covers the rename. Co-Authored-By: Claude Opus 5.5 --- packages/client/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/client/README.md b/packages/client/README.md index 3ba6b32c..ac0ebf49 100644 --- a/packages/client/README.md +++ b/packages/client/README.md @@ -44,7 +44,7 @@ No code changes are required — `init_client()` detects the packages at runtime | `LD_API_BASE_URI` | No | Evaluations management API host override; intentionally separate from `LD_BASE_URI` | | `LD_UI_BASE_URI` | No | LaunchDarkly application host for evaluation-run links (default: `https://app.launchdarkly.com`). Set it for a non-production project, or its runs still link to the production app | -`init_client()` also sets the `launchdarkly.project_id` resource attribute to the resolved SDK key. It is the SDK key, not the project's ID. Earlier releases sent the same value as `highlight.project_id`, which is no longer sent: if a collector, filter or alert matches on `highlight.project_id`, change it to `launchdarkly.project_id`. +`init_client()` also sets the `launchdarkly.project_id` resource attribute to the resolved SDK key, not the project's ID. ### Run an evaluation from code (experimental) From fa3759b9548c70496517c47afc4c06d80fdb756a Mon Sep 17 00:00:00 2001 From: Jeff Dupont Date: Wed, 28 Oct 2026 11:33:03 -0700 Subject: [PATCH 3/3] docs(AIC-3692): drop the highlight.project_id history from agents.md Co-Authored-By: Claude Opus 5.5 --- packages/client/agents.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/client/agents.md b/packages/client/agents.md index f9dada8f..06645f78 100644 --- a/packages/client/agents.md +++ b/packages/client/agents.md @@ -853,7 +853,7 @@ pip install "launchdarkly-ai-python[otel]" **Other env vars / options read by `init_client()`:** - `LD_SERVICE_NAME` / `options["serviceName"]` — sets `service.name` resource attribute (default: `'python-sdk'`) - `LD_ENVIRONMENT` / `options["environment"]` — sets `deployment.environment` resource attribute -- Not configurable: the `launchdarkly.project_id` resource attribute is always set to the resolved SDK key, not the project's ID. It replaced `highlight.project_id`, which is no longer sent +- Not configurable: the `launchdarkly.project_id` resource attribute is always set to the resolved SDK key, not the project's ID **Graceful degradation:** if any OTel package is missing, telemetry is silently skipped and a `logger.warning` is emitted. The LD client still initializes and all AI API calls work normally.