(iggy-website) 09/13: fix(docs): clarify telemetry availability

[hg...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

hubcio pushed a commit to branch docs/align-with-topic-durability
in repository https://gitbox.apache.org/repos/asf/iggy-website.git

commit 93d1cd4427af3a5ecf37617f3f9b8df45d699082
Author: hubcio <h....@gmail.com>
AuthorDate: Fri Sep 11 16:20:42 2026 +0200

    fix(docs): clarify telemetry availability
---
 content/docs/ai/mcp.mdx               | 2 ++
 content/docs/introduction/about.mdx   | 2 +-
 content/docs/server/configuration.mdx | 2 ++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/content/docs/ai/mcp.mdx b/content/docs/ai/mcp.mdx
index 201150e7..22d3f4e6 100644
--- a/content/docs/ai/mcp.mdx
+++ b/content/docs/ai/mcp.mdx
@@ -74,6 +74,8 @@ transport = "grpc" # grpc or http
 endpoint = "http://localhost:4317"
 ```
 
+Set `telemetry.enabled = true` to export to a running collector. For HTTP export, set `transport = "http"` and use complete signal URLs: `http://localhost:4318/v1/logs` for logs and `http://localhost:4318/v1/traces` for traces. The MCP server does not append those paths.
+
 The configuration file must be in the `toml` format. By default, the server looks for `core/ai/mcp/config.toml` relative to its working directory. Set `IGGY_MCP_CONFIG_PATH` to use another path. Embedded defaults are loaded first, then the file if it exists, then environment overrides.
 
 Each setting can also be overridden using `IGGY_MCP_<SECTION>_<KEY>`, for example `IGGY_MCP_IGGY_USERNAME` or `IGGY_MCP_HTTP_ADDRESS`. Nested settings use the same underscore convention, such as `IGGY_MCP_IGGY_TLS_ENABLED`. Set `IGGY_MCP_ENV_PATH` to load a particular dotenv file; otherwise `.env` is searched for in the current directory and its parents. Existing environment variables take precedence over dotenv values.
diff --git a/content/docs/introduction/about.mdx b/content/docs/introduction/about.mdx
index f2d6b620..f06ddfe9 100644
--- a/content/docs/introduction/about.mdx
+++ b/content/docs/introduction/about.mdx
@@ -50,7 +50,7 @@ Historical startup screenshot from server 0.5.0. See [configuration](/docs/serve
 - **[Model Context Protocol](/docs/ai/mcp)** - provide context to LLM with **MCP server** exposing 40+ tools for streaming management
 - Optional server-side as well as client-side **data encryption** using AES-256-GCM
 - Optional metadata support in the form of **message headers**
-- Support for **OpenTelemetry** logs & traces + Prometheus metrics
+- Prometheus metrics and **OpenTelemetry** logs & traces in the [connector runtime](/docs/connectors/observability). Server export has [known limitations](/docs/server/configuration#telemetry).
 - Built-in **[CLI](/docs/cli/start)** to manage the streaming server installable via `cargo install iggy-cli --version 0.14.0-edge.7 --locked`
 - Built-in **[Web UI](/docs/web_ui/start)** dashboard (Svelte) that can be embedded directly in the server binary or run as a standalone container
 - Built-in **benchmarking app** to test the performance
diff --git a/content/docs/server/configuration.mdx b/content/docs/server/configuration.mdx
index fb2340bd..c416061a 100644
--- a/content/docs/server/configuration.mdx
+++ b/content/docs/server/configuration.mdx
@@ -331,6 +331,8 @@ The Rust, Go, Python, Node, async Java, and C# TCP clients ping automatically ev
 
 ### `[telemetry]`
 
+Server OTLP export is unavailable in this revision: `grpc` prevents startup, and `http` does not deliver logs or traces. Leave `enabled = false`.
+
 | Key | Default | Description |
 |-----|---------|-------------|
 | `enabled` | `false` | Enable OpenTelemetry export. |