rasa-pro 3.21.0.dev6__tar.gz → 3.21.0.dev7__tar.gz

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rasa-pro
-Version: 3.21.0.dev6
+Version: 3.21.0.dev7
 Summary: State-of-the-art open-core Conversational AI framework for Enterprises that natively leverages generative AI for effortless assistant development.
 License-File: NOTICE
 Keywords: nlp,machine-learning,machine-learning-library,bot,bots,botkit,rasa conversational-agents,conversational-ai,chatbot,chatbot-framework,bot-framework

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "rasa-pro"
-version = "3.21.0.dev6"
+version = "3.21.0.dev7"
 description = "State-of-the-art open-core Conversational AI framework for Enterprises that natively leverages generative AI for effortless assistant development."
 authors = [ "Rasa Technologies GmbH <hi@rasa.com>",]
 maintainers = [ "Tom Bocklisch <tom@rasa.com>",]

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/cli/tools/skills_data/mantle/mantle-configuring-agent/SKILL.md

@@ -3,7 +3,7 @@ name: mantle-configuring-agent
 description: >
   Configures the Mantle project config files: agent.yml (identity, persona, rules,
   prompt tuning, session settings, tool_timeout), integrations.yml (LLM model groups, channels
-  including voice ASR/TTS, model groups, MCP servers, Langfuse tracing), memory.yml (schema, cross-skill
+  including voice ASR/TTS, model groups, MCP servers, tracing - Langfuse, OTLP or Jaeger - and metrics), memory.yml (schema, cross-skill
   visibility), responses.yml (verbatim templates), and optional turn-path hooks
   (hooks.py / hooks/). Use when setting up or changing any of these files, including
   declaring MCP servers and importing their tools, or authoring observe/modify hooks.
@@ -12,7 +12,7 @@ engine: mantle
 rasa_version: ">=3.18"
 metadata:
   author: rasa
-  version: "0.1.14"
+  version: "0.1.15"
   docs-url: https://rasa-2f7eb63d.mintlify.site
 ---
 
@@ -23,7 +23,7 @@ Project layout:
 ```
 my-agent/
 ├── agent.yml              # Required. Identity, persona, rules, prompt tuning
-├── integrations.yml       # Required. LLM model groups, channels, optional tracing
+├── integrations.yml       # Required. LLM model groups, channels, optional tracing/metrics
 ├── memory.yml             # Optional. Project-wide shared memory
 ├── responses.yml          # Optional. Project-wide responses, overrides built-in wording
 ├── references/            # Optional. Agent-wide knowledge; **/*.md is chunked at train
@@ -121,7 +121,7 @@ Notes:
 ## integrations.yml — models and infrastructure
 
 Holds the model groups, the input channels customers reach the agent through,
-optional MCP servers, and optional Langfuse tracing. Never put a literal key in
+optional MCP servers, and optional tracing and metrics. Never put a literal key in
 this file. Use `api_key: ${ENV_VAR}` on a model entry (the whole value must be
 `${ENV_VAR}`). Omit `api_key` for keyless self-hosted servers.
 
@@ -141,14 +141,24 @@ channels:
   rest: { enabled: true }        # REST input (evaluation / HTTP channel)
   inspector: { enabled: true }   # required for `rasa inspect`
 
-# Langfuse tracing (optional). Install rasa-pro[monitoring], set
-# LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY, then uncomment. Keys use ${VAR}
-# syntax; they resolve when Langfuse configures at startup, not at YAML load.
+# Tracing (optional). One tracer, or a list with at most one langfuse entry
+# and at most one otlp or jaeger entry. For Langfuse, install
+# rasa-pro[monitoring] and set LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY. Its
+# keys use ${VAR} syntax and resolve when Langfuse configures at startup.
 # tracing:
-#   type: langfuse
-#   public_key: ${LANGFUSE_PUBLIC_KEY}
-#   private_key: ${LANGFUSE_SECRET_KEY}
-#   host: https://cloud.langfuse.com
+#   - type: langfuse
+#     public_key: ${LANGFUSE_PUBLIC_KEY}
+#     private_key: ${LANGFUSE_SECRET_KEY}
+#     host: https://cloud.langfuse.com
+#   - type: otlp
+#     endpoint: localhost:4317
+#     insecure: true
+
+# OTLP metrics (optional), independent of tracing.
+# metrics:
+#   type: otlp
+#   endpoint: localhost:4317
+#   insecure: true
 ```
 
 `llm.model_group` selects the group that drives the agent.
@@ -156,7 +166,15 @@ channels:
 model, credentials, and provider-specific settings belong under the selected
 group's `models:` list. Inline provider settings under `llm:` fail validation.
 Providers `openai`, `azure`, and `self-hosted` have dedicated clients; any other
-value is passed to LiteLLM. `tracing` is optional and lives here.
+value is passed to LiteLLM.
+
+`tracing` and `metrics` are optional and are read only from `integrations.yml`.
+A `tracing:` or `metrics:` block in `endpoints.yml` is ignored, and startup
+logs a warning naming the block. `rasa train` reports an invalid `tracing:` or
+`metrics:` section (`mantle.validation.config.invalid_tracing` /
+`invalid_metrics`). If you start the agent anyway, an invalid section is
+logged as an error and the agent runs without tracing (both tracers) or
+without metrics.
 
 `channels` declares the channels customers reach the agent through. `rest` and
 `inspector` are the minimum for local work: `rest` is what the evaluation runner
@@ -465,8 +483,9 @@ See `/mantle/runtime-loop` (Start a conversation).
 - Don't put skill behavior in `persona` or global config; behavior belongs in the
   owning skill's `skill.md`.
 - Don't create `domain.yml`, `config.yml`, `credentials.yml`, or an
-  `endpoints.yml` just for Langfuse — those are CALM files. LLM, channel, and
-  Langfuse tracing config live in `integrations.yml`.
+  `endpoints.yml` for tracing or metrics — those are CALM files, and Mantle
+  ignores `tracing:` and `metrics:` in `endpoints.yml`. LLM, channel, tracing,
+  and metrics config live in `integrations.yml`.
 - Do declare every memory key a tool writes — undeclared `context.memory.set()`
   writes fail `rasa train` (`undeclared_memory_write`).
 - If `rasa train` rejects a section, read the reference page for that file below

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/cli/tools/skills_data/mantle/mantle-docs/SKILL.md

@@ -12,7 +12,7 @@ engine: mantle
 rasa_version: ">=3.18"
 metadata:
   author: rasa
-  version: "0.1.4"
+  version: "0.1.5"
   docs-url: https://rasa-2f7eb63d.mintlify.site
 ---
 
@@ -100,7 +100,7 @@ shipped.
 - `/reference/conditions` — Conditions: The memory expression language used by requires:, if:, ordered-block step complete_when:, next:
 - `/reference/skill-md` — skill.md: Frontmatter properties and body format (incl. skill-level complete_when mapping)
 - `/reference/agent-yml` — agent.yml: Identity, persona, rules, prompt tuning, references.chunking
-- `/reference/integrations-yml` — integrations.yml: LLM provider, channels, voice ASR/TTS, Langfuse tracing
+- `/reference/integrations-yml` — integrations.yml: LLM provider, channels, voice ASR/TTS, tracing (Langfuse, OTLP, Jaeger), OTLP metrics
 - `/reference/memory-yml` — memory.yml: Memory schema, types, visibility
 - `/reference/responses-yml` — responses.yml: Response templates and interpolation
 - `/reference/ordered-block-steps` — Ordered block steps: Step kinds, step fields, branching

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/cli/tools/skills_data/mantle/mantle-migrating-from-calm/SKILL.md

@@ -11,7 +11,7 @@ engine: mantle
 rasa_version: ">=3.18"
 metadata:
   author: rasa
-  version: "0.1.10"
+  version: "0.1.11"
   docs-url: https://rasa-2f7eb63d.mintlify.site
 ---
 
@@ -80,7 +80,8 @@ layout, so there is no version key to set.
 | `pattern_session_start` | Override `skills/default_session_start/` with a greeting if the channel sends `/session_start` first; leave the bundled silent skill if the user speaks first | Small |
 | Rephraser prompt | `agent.yml` `agent.persona` | Small |
 | `credentials.yml`, `endpoints.yml` model/LLM config | `integrations.yml` (`llm` + `channels`) | Small |
-| `endpoints.yml` Langfuse `tracing:` | `integrations.yml` `tracing:` (`type: langfuse`) | Small |
+| `endpoints.yml` `tracing:` (Langfuse, OTLP, Jaeger, or a list of one Langfuse + one OTLP/Jaeger) | `integrations.yml` `tracing:`, same entry shape. A Jaeger entry with `username`/`password` must also set `insecure` (`false` for TLS). Mantle ignores `endpoints.yml` tracing | Small |
+| `endpoints.yml` `metrics:` (`type: otlp`) | `integrations.yml` `metrics:`. Mantle ignores `endpoints.yml` metrics | Small |
 | `domain.yml` | Dissolves — slots→memory, responses→responses.yml/prose, actions→tools | Structural |
 
 ## No migration path — flag these to the user, do not silently drop

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/core/channels/inspector/package.json

@@ -46,8 +46,8 @@
     "eslint-plugin-react-refresh": "0.4.24",
     "jest": "29.7.0",
     "jest-environment-jsdom": "29.7.0",
-    "prettier": "3.9.8",
-    "ts-jest": "29.4.12",
+    "prettier": "3.9.9",
+    "ts-jest": "29.4.14",
     "ts-node": "10.9.2",
     "typescript": "5.9.3",
     "vite": "4.5.12"
@@ -56,7 +56,7 @@
     "cross-spawn": "7.0.6",
     "dompurify": "3.4.15",
     "braces": "3.0.3",
-    "ws": "8.21.3",
+    "ws": "8.22.0",
     "rollup": "3.30.0",
     "@adobe/css-tools": "4.5.0",
     "lodash-es": "4.18.1",

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/core/channels/inspector/yarn.lock

@@ -4980,10 +4980,10 @@ prelude-ls@^1.2.1:
   resolved "https://registry.yarnpkg.com/prelude-ls/-/prelude-ls-1.2.1.tgz#debc6489d7a6e6b0e7611888cec880337d316396"
   integrity sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==
 
-prettier@3.9.8:
-  version "3.9.8"
-  resolved "https://registry.yarnpkg.com/prettier/-/prettier-3.9.8.tgz#54e81128584538c81d85fce9d5fd77a410c385c5"
-  integrity sha512-WRFq3Wn3WId7LLROfMLdH7xaFr2jR62wU8nLO6rQUOLOxNZUviyJQs1M0iIhLexSFy+L+w0ch66wtoO2jRjG0A==
+prettier@3.9.9:
+  version "3.9.9"
+  resolved "https://registry.yarnpkg.com/prettier/-/prettier-3.9.9.tgz#09b826918c91cd4cbc80e0cbd1d2a922ff04f233"
+  integrity sha512-Z/CJHIkdujO/OtN7nXUii0Rf3VT5SRuhjBA82Xvu2XhBUgX3nhP67T0LHceBdQLex7OOFGTox+Q5Yg8Jk2Qivg==
 
 pretty-format@^27.0.2:
   version "27.5.1"
@@ -5595,10 +5595,10 @@ ts-dedent@^2.2.0:
   resolved "https://registry.yarnpkg.com/ts-dedent/-/ts-dedent-2.2.0.tgz#39e4bd297cd036292ae2394eb3412be63f563bb5"
   integrity sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ==
 
-ts-jest@29.4.12:
-  version "29.4.12"
-  resolved "https://registry.yarnpkg.com/ts-jest/-/ts-jest-29.4.12.tgz#c34cd91f02d364e9286d2c016843315fd0efff76"
-  integrity sha512-Ov6ClY53Fflh6BGAnY2DlTq1hYDrTycz2PVTXBWFW2CU+9zrEqAp9fWdGXl42EXO5RLSFAcAZ2JFKbP+zBTFfw==
+ts-jest@29.4.14:
+  version "29.4.14"
+  resolved "https://registry.yarnpkg.com/ts-jest/-/ts-jest-29.4.14.tgz#cb36c043df0fada861c8b604a5d514f953126180"
+  integrity sha512-+943G6wCX5E3VpzTQhBGBFntCmdT+QAkTvUlp03edTONFBvqskuXPhpyX16xdUotO4P5HQKyppldSWjocoltLQ==
   dependencies:
     bs-logger "^0.2.6"
     fast-json-stable-stringify "^2.1.0"
@@ -5884,10 +5884,10 @@ write-file-atomic@^4.0.2:
     imurmurhash "^0.1.4"
     signal-exit "^3.0.7"
 
-ws@8.21.3, ws@^8.11.0:
-  version "8.21.3"
-  resolved "https://registry.yarnpkg.com/ws/-/ws-8.21.3.tgz#660b4faddb6a3e575c86e078126919961f4de4fc"
-  integrity sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==
+ws@8.22.0, ws@^8.11.0:
+  version "8.22.0"
+  resolved "https://registry.yarnpkg.com/ws/-/ws-8.22.0.tgz#40f16e1d7588ac0575041be5c49b8eb261c28e73"
+  integrity sha512-Ydggc987+RO0AnWtZ/7Wq9FtNvcrL1b/RO0ud9mWjUPgDrsAAwQSF51sm2hm1XofbU/4jkpGEsLFsZZxU+1DOg==
 
 xml-name-validator@^4.0.0:
   version "4.0.0"

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/engine/storage/local_model_storage.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 import logging
 import os
 import shutil
@@ -10,8 +11,9 @@ import uuid
 from contextlib import contextmanager
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Callable, Generator, List, Optional, Text, Tuple, Union
+from typing import Any, Callable, Generator, List, Optional, Text, Tuple, Union
 
+import structlog
 from tarsafe import TarSafe
 
 import rasa.model
@@ -28,10 +30,15 @@ from rasa.shared.core.domain import Domain
 from rasa.shared.engine_version import DEFAULT_ENGINE_VERSION
 
 logger = logging.getLogger(__name__)
+structlogger = structlog.get_logger()
 
 # Paths within model archive
 MODEL_ARCHIVE_COMPONENTS_DIR = "components"
 MODEL_ARCHIVE_METADATA_FILE = "metadata.json"
+# 16 MiB. metadata.json embeds the domain, so it can be larger than a tiny
+# config, but it is not model weights. Cap the read so a hostile archive
+# cannot force an unbounded json.load during CLI startup.
+_METADATA_JSON_MAX_BYTES = 16 * 1024 * 1024
 
 
 @contextmanager
@@ -146,6 +153,41 @@ class LocalModelStorage(ModelStorage):
 
             return metadata
 
+    @staticmethod
+    def serialized_metadata_from_archive(
+        model_archive_path: Union[Text, Path],
+    ) -> Optional[Any]:
+        """Read ``metadata.json`` from an archive without extracting it to disk.
+
+        Unlike :meth:`metadata_from_archive`, only the metadata member is read,
+        and it is returned as parsed JSON without building a ``ModelMetadata``.
+        Use it where a single field is needed and a full extraction of a large
+        archive would be wasted work.
+
+        Returns:
+            The parsed JSON, or ``None`` when the archive has no top-level
+            ``metadata.json`` or that member exceeds ``_METADATA_JSON_MAX_BYTES``.
+        """
+        with tarfile.open(model_archive_path, mode="r:gz") as tar:
+            for member in tar:
+                if member.name.removeprefix("./") != MODEL_ARCHIVE_METADATA_FILE:
+                    continue
+                if not member.isfile():
+                    return None
+                if member.size > _METADATA_JSON_MAX_BYTES:
+                    _log_metadata_too_large(member.size)
+                    return None
+                metadata_file = tar.extractfile(member)
+                if metadata_file is None:
+                    return None
+                with metadata_file:
+                    raw = metadata_file.read(_METADATA_JSON_MAX_BYTES + 1)
+                if len(raw) > _METADATA_JSON_MAX_BYTES:
+                    _log_metadata_too_large(len(raw))
+                    return None
+                return json.loads(raw)
+        return None
+
     @staticmethod
     def _extract_archive_to_directory(
         model_archive_path: Union[Text, Path], temporary_directory: Path
@@ -304,6 +346,20 @@ class LocalModelStorage(ModelStorage):
         )
 
 
+def _log_metadata_too_large(size: int) -> None:
+    """Log and skip packaged metadata that would be unsafe to parse."""
+    structlogger.error(
+        "model_storage.metadata_json_too_large",
+        metadata_bytes=size,
+        max_bytes=_METADATA_JSON_MAX_BYTES,
+        event_info=(
+            f"'{MODEL_ARCHIVE_METADATA_FILE}' is {size} bytes, which exceeds "
+            f"the {_METADATA_JSON_MAX_BYTES} byte limit. Skipping packaged "
+            "metadata so project layout can be used instead."
+        ),
+    )
+
+
 def yield_safe_members(
     members: List[tarfile.TarInfo],
 ) -> Generator[tarfile.TarInfo, None, None]:

{rasa_pro-3.21.0.dev6 → rasa_pro-3.21.0.dev7}/rasa/hooks.py

@@ -52,23 +52,28 @@ def refine_cli(
 def configure_commandline(cmdline_arguments: argparse.Namespace) -> Optional[Text]:
     """Resolve endpoints and configure backend tracing, metrics, and Langfuse.
 
-    Langfuse is loaded from ``integrations.yml`` when present (Mantle),
-    with fallback to ``endpoints.yml``. Runs even when no ``--endpoints`` path is
-    given so integrations-only projects still get tracing.
+    Mantle projects load tracing (Langfuse and OTLP/Jaeger) and OTLP metrics
+    only from ``integrations.yml``; ``tracing:`` or ``metrics:`` blocks in
+    ``endpoints.yml`` are ignored with a warning. Runs even when no
+    ``--endpoints`` path is given so integrations-only projects still get
+    observability.
 
     Mantle projects do not use ``endpoints.yml`` by default (providers live in
     ``integrations.yml``), yet ``--endpoints`` still defaults to that path.
     When the default file is absent under a Mantle layout, endpoint-backed
-    tracing/metrics/secrets/telemetry reads are skipped so CLI commands do not
-    log missing-file errors. An on-disk ``endpoints.yml`` is still honored if
-    present. CALM v1 keeps the existing missing-file errors. Explicit
-    ``--endpoints`` paths that are missing still surface as before.
+    secrets/telemetry reads are skipped so CLI commands do not log missing-file
+    errors. An on-disk ``endpoints.yml`` is still honored if present. CALM v1
+    keeps the existing missing-file errors. Explicit ``--endpoints`` paths that
+    are missing still surface as before.
     """
     from rasa.cli import x as rasa_x
     from rasa.cli.project_env import resolve_project_dir
-    from rasa.tracing.backend_tracing_config import configure_backend_tracing
+    from rasa.shared.engine_version import is_mantle_cli_context
+    from rasa.tracing.backend_tracing_config import (
+        configure_backend_tracing_for_project,
+    )
     from rasa.tracing.langfuse_config import configure_langfuse_for_project
-    from rasa.tracing.metrics_config import configure_metrics
+    from rasa.tracing.metrics_config import configure_metrics_for_project
 
     endpoints_file = None
 
@@ -80,29 +85,46 @@ def configure_commandline(cmdline_arguments: argparse.Namespace) -> Optional[Tex
         endpoints_file = cmdline_arguments.endpoints
 
     project_root = resolve_project_dir(getattr(cmdline_arguments, "project_path", None))
-    if _mantle_project_without_default_endpoints(endpoints_file, project_root):
+    # Resolved once: a model path is read only to warn when it disagrees.
+    is_mantle = is_mantle_cli_context(
+        project_root=project_root,
+        model_path=getattr(cmdline_arguments, "model", None),
+    )
+    if _mantle_project_without_default_endpoints(
+        endpoints_file, project_root, is_mantle=is_mantle
+    ):
         structlogger.debug(
             "hooks.configure_commandline.mantle_endpoints_absent",
             event_info=(
                 f"No endpoints file at '{endpoints_file}' and the project uses the "
-                f"Mantle layout. Skipping endpoint-backed tracing, metrics, "
-                f"secrets, and telemetry configuration."
+                f"Mantle engine. Skipping endpoint-backed secrets and telemetry "
+                f"configuration. Tracing and metrics may still come from "
+                f"integrations.yml."
             ),
         )
         endpoints_file = None
 
-    if endpoints_file is not None:
-        configure_backend_tracing(endpoints_file)
-        configure_metrics(endpoints_file)
+    if is_mantle:
+        _warn_if_endpoints_observability_ignored(endpoints_file)
+
+    configure_backend_tracing_for_project(
+        project_root=project_root,
+        endpoints_file=endpoints_file,
+        is_mantle=is_mantle,
+    )
+    configure_metrics_for_project(
+        project_root=project_root,
+        endpoints_file=endpoints_file,
+        is_mantle=is_mantle,
+    )
 
-    # Langfuse: integrations.yml for Mantle / v2 layout, else endpoints.yml.
-    # Runs even when no endpoints file is present (integrations-only projects).
     langfuse_environment_name: Optional[Text] = getattr(
         cmdline_arguments, "langfuse_environment_name", None
     )
     configure_langfuse_for_project(
         endpoints_file,
         project_root=project_root,
+        is_mantle=is_mantle,
         langfuse_environment_name=langfuse_environment_name,
     )
 
@@ -143,7 +165,9 @@ def create_tracker_store(
 
 
 def _mantle_project_without_default_endpoints(
-    endpoints_file: Optional[Text], project_root: Path
+    endpoints_file: Optional[Text],
+    project_root: Path,
+    is_mantle: Optional[bool] = None,
 ) -> bool:
     """Test whether a Mantle project is using the absent default endpoints path.
 
@@ -152,6 +176,9 @@ def _mantle_project_without_default_endpoints(
     log an error for the missing default file, so callers treat that default as
     unset instead. An explicit ``--endpoints`` path, or an on-disk default file,
     is left unchanged. CALM v1 keeps the error for a missing default path.
+
+    *is_mantle* is the engine the caller already resolved; ``None`` falls back
+    to the on-disk project layout.
     """
     from rasa.shared.constants import DEFAULT_ENDPOINTS_PATH
     from rasa.shared.project_structure import has_mantle_project_layout
@@ -164,4 +191,34 @@ def _mantle_project_without_default_endpoints(
     if Path(endpoints_file).is_file():
         return False
 
-    return has_mantle_project_layout(project_root)
+    if is_mantle is None:
+        return has_mantle_project_layout(project_root)
+    return is_mantle
+
+
+def _warn_if_endpoints_observability_ignored(endpoints_file: Optional[Text]) -> None:
+    """Warn that a Mantle project's ``endpoints.yml`` tracing/metrics is unused.
+
+    Mantle reads tracing and metrics only from ``integrations.yml``. Without
+    this warning a project that kept those blocks in ``endpoints.yml`` would
+    lose traces or metrics with no visible signal.
+    """
+    from rasa.shared.project_structure import V2_INTEGRATIONS_FILE
+    from rasa.shared.utils.yaml import read_config_file
+    from rasa.tracing.constants import ENDPOINTS_METRICS_KEY, ENDPOINTS_TRACING_KEY
+
+    if endpoints_file is None or not Path(endpoints_file).is_file():
+        return
+    # Only key presence matters; skip expansion so unset ${VAR}s cannot raise.
+    content = read_config_file(endpoints_file, expand_env_vars=False)
+    for key in (ENDPOINTS_TRACING_KEY, ENDPOINTS_METRICS_KEY):
+        if content.get(key) is None:
+            continue
+        structlogger.warning(
+            "hooks.configure_commandline.endpoints_observability_ignored",
+            section=key,
+            event_info=(
+                f"The '{key}:' block in '{endpoints_file}' is ignored for this "
+                f"engine. Move it to '{V2_INTEGRATIONS_FILE}'."
+            ),
+        )