From 818d666ae35341967ea7d8617e2c82daf48f1968 Mon Sep 17 00:00:00 2001 From: Josh Suereth Date: Tue, 17 Sep 2024 08:18:58 -0400 Subject: [PATCH] Add call out about offline usage. --- text/entities/0264-resource-and-entities.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/text/entities/0264-resource-and-entities.md b/text/entities/0264-resource-and-entities.md index 1cfba5f2b..e45f39744 100644 --- a/text/entities/0264-resource-and-entities.md +++ b/text/entities/0264-resource-and-entities.md @@ -349,6 +349,21 @@ resource based on more advanced knowledge of the communication protocol used to The design proposed here attempts to balance non-breaking (backwards and forwards compatible) changes with the need to improve problematic issues in the Specification. Given the inability of most SDKs to implement the current Resource merge specification, breaking this should have little effect on actual users. Instead, the proposed merge specification should allow implementations to match current behavior and expectation, while evolving for users who engage with the new model. +### Why don't we download schema url contents? + +OpenTelemetry needs to work in environments that have no/limited access to the external internet. We entertained, and +dismissed merging solutions that *require* access to the contents of `schema_url` to work. While the core algorithm +*cannot require* this access, we *should* be able to provide improved processing and algorithms that may leverage this data. + +For example: + +- Within an SDK, we can registry entity schema information with `EntityDetector`. +- The OpenTelemetry Collector can allow registered `schema_url` via configuraton + or (optionally) download schema on demand. + +This design does not prevent these solutions, but provides the baseline/fallback +where `schema_url` is not accessible and entities must still be usable. + ## Prior art and alternatives Previously, we have a few unaccepted oteps, e.g. ([OTEP 208](https://github.com/open-telemetry/oteps/pull/208)). Additionally, there are some alternatives that were considered in the Entities WG and rejected.