Update docstring

Author: tammy-baylis-swi

instrumentation/opentelemetry-instrumentation-asgi/src/opentelemetry/instrumentation/asgi/__init__.py

@@ -206,8 +206,12 @@ def client_response_hook(span: Span, scope: Scope, message: dict[str, Any]):
 
 Custom Metrics Attributes using Labeler
 ***************************************
-The ASGI instrumentation reads from a Labeler utility that supports adding custom attributes
-to the HTTP duration metrics recorded by the instrumentation.
+The ASGI instrumentation reads from a labeler utility that supports adding custom
+attributes to HTTP duration metrics at record time. The custom attributes are
+stored only within the context of an instrumented request or operation. The
+instrumentor does not overwrite base attributes that exist at the same keys as
+any custom attributes.
+
 
 .. code-block:: python
 
@@ -220,18 +224,21 @@ def client_response_hook(span: Span, scope: Scope, message: dict[str, Any]):
     app = Quart(__name__)
     app.asgi_app = OpenTelemetryMiddleware(app.asgi_app)
 
-    @app.route("/user/<user_id>")
+    @app.route("/users/<user_id>/")
     async def user_profile(user_id):
         # Get the labeler for the current request
         labeler = get_labeler()
+
         # Add custom attributes to ASGI instrumentation metrics
         labeler.add("user_id", user_id)
         labeler.add("user_type", "registered")
+
         # Or, add multiple attributes at once
         labeler.add_attributes({
             "feature_flag": "new_ui",
             "experiment_group": "control"
         })
+
         return f"User profile for {user_id}"
 
     if __name__ == "__main__":

instrumentation/opentelemetry-instrumentation-django/src/opentelemetry/instrumentation/django/__init__.py

@@ -235,7 +235,12 @@ def response_hook(span, request, response):
 
 Custom Metrics Attributes using Labeler
 ***************************************
-The Django instrumentation reads from a Labeler utility that supports adding custom attributes to the HTTP duration metrics recorded by the instrumentation.
+The Django instrumentation reads from a labeler utility that supports adding custom
+attributes to HTTP duration metrics at record time. The custom attributes are
+stored only within the context of an instrumented request or operation. The
+instrumentor does not overwrite base attributes that exist at the same keys as
+any custom attributes.
+
 
 .. code:: python
 
@@ -245,7 +250,7 @@ def response_hook(span, request, response):
 
     DjangoInstrumentor().instrument()
 
-    # For urlpattern `/user/<user_id>/` mapped elsewhere
+    # Note: urlpattern `/users/<user_id>/` mapped elsewhere
     def my_user_view(request, user_id):
         # Get the labeler for the current request
         labeler = get_labeler()

instrumentation/opentelemetry-instrumentation-falcon/src/opentelemetry/instrumentation/falcon/__init__.py

@@ -182,35 +182,41 @@ def response_hook(span, req, resp):
 
 Custom Metrics Attributes using Labeler
 ***************************************
-The Falcon instrumentation reads from a Labeler utility that supports adding custom attributes
-to the HTTP duration metrics recorded by the instrumentation.
+The Falcon instrumentation reads from a labeler utility that supports adding custom
+attributes to HTTP duration metrics at record time. The custom attributes are
+stored only within the context of an instrumented request or operation. The
+instrumentor does not overwrite base attributes that exist at the same keys as
+any custom attributes.
 
 
 .. code-block:: python
 
     import falcon
+
     from opentelemetry.instrumentation._labeler import get_labeler
     from opentelemetry.instrumentation.falcon import FalconInstrumentor
 
     FalconInstrumentor().instrument()
-
     app = falcon.App()
 
     class UserProfileResource:
         def on_get(self, req, resp, user_id):
             # Get the labeler for the current request
             labeler = get_labeler()
+
             # Add custom attributes to Falcon instrumentation metrics
             labeler.add("user_id", user_id)
             labeler.add("user_type", "registered")
+
             # Or, add multiple attributes at once
             labeler.add_attributes({
                 "feature_flag": "new_ui",
                 "experiment_group": "control"
             })
+
             resp.text = f'User profile for {user_id}'
 
-    app.add_route('/user/{user_id}', UserProfileResource())
+    app.add_route('/users/{user_id}/', UserProfileResource())
 
 API
 ---

instrumentation/opentelemetry-instrumentation-flask/src/opentelemetry/instrumentation/flask/__init__.py

@@ -97,19 +97,24 @@ def hello():
 
 Custom Metrics Attributes using Labeler
 ***************************************
-The Flask instrumentation reads from a Labeler utility that supports adding custom attributes
-to the HTTP request duration metrics recorded by the instrumentation.
+The Flask instrumentation reads from a labeler utility that supports adding custom
+attributes to HTTP duration metrics at record time. The custom attributes are
+stored only within the context of an instrumented request or operation. The
+instrumentor does not overwrite base attributes that exist at the same keys as
+any custom attributes.
+
 
 .. code-block:: python
 
     from flask import Flask
-    from opentelemetry.instrumentation.flask import FlaskInstrumentor
+
     from opentelemetry.instrumentation._labeler import get_labeler
+    from opentelemetry.instrumentation.flask import FlaskInstrumentor
 
     app = Flask(__name__)
     FlaskInstrumentor().instrument_app(app)
 
-    @app.route("/user/<user_id>")
+    @app.route("/users/<user_id>/")
     def user_profile(user_id):
         # Get the labeler for the current request
         labeler = get_labeler()

instrumentation/opentelemetry-instrumentation-wsgi/src/opentelemetry/instrumentation/wsgi/__init__.py

@@ -81,8 +81,11 @@ def GET(self):
 
 Custom Metrics Attributes using Labeler
 ***************************************
-The WSGI instrumentation reads from a labeler utility that supports adding custom attributes
-to HTTP duration metrics at record time.
+The WSGI instrumentation reads from a labeler utility that supports adding custom
+attributes to HTTP duration metrics at record time. The custom attributes are
+stored only within the context of an instrumented request or operation. The
+instrumentor does not overwrite base attributes that exist at the same keys as
+any custom attributes.
 
 .. code-block:: python