You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by wu...@apache.org on 2026/09/14 14:35:35 UTC
(skywalking) branch master updated: Rename Envoy AI Gateway to Agent Router in the docs (#14082)
This is an automated email from the ASF dual-hosted git repository.
wu-sheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking.git
The following commit(s) were added to refs/heads/master by this push:
new d13d9e0608 Rename Envoy AI Gateway to Agent Router in the docs (#14082)
d13d9e0608 is described below
commit d13d9e06084fd4889a7027ef0f00a8701c124220
Author: 吴晟 Wu Sheng <wu...@foxmail.com>
AuthorDate: Mon Sep 14 22:35:30 2026 +0800
Rename Envoy AI Gateway to Agent Router in the docs (#14082)
Envoy AI Gateway became Agent Router on 2026-09-10 and moved to the
Agentic AI Foundation. Only the product name changed: Agent Router kept
its API group, CLI, images and emitted telemetry. Update the operator doc,
menu, marketplace entry and OTLP receiver doc to the new name, and keep the
ENVOY_AI_GATEWAY layer, the job_name=envoy-ai-gateway routing tag, the
envoy-ai-gateway rule files, the meter_envoy_ai_gw_ metric names and the
doc URL unchanged so existing deployments, stored data and links keep
working.
---
docs/en/changes/changes.md | 1 +
.../backend/backend-envoy-ai-gateway-monitoring.md | 40 ++++++++++++++--------
docs/en/setup/backend/marketplace.md | 2 +-
docs/en/setup/backend/opentelemetry-receiver.md | 2 +-
docs/menu.yml | 2 +-
.../skywalking/oap/server/core/analysis/Layer.java | 4 +--
6 files changed, 32 insertions(+), 19 deletions(-)
diff --git a/docs/en/changes/changes.md b/docs/en/changes/changes.md
index 19c78382c8..38864e6b71 100644
--- a/docs/en/changes/changes.md
+++ b/docs/en/changes/changes.md
@@ -29,6 +29,7 @@
#### Documentation
* Document the BanyanDB trace tail sampling metrics in the BanyanDB self-observability dashboard catalog, and point the "Operating it" section of the trace tail sampling guide at them — the OAP-collected metrics show what the sampler plugins *proposed* next to what storage *committed*, which the data node's raw metrics endpoint alone does not.
+* Rename Envoy AI Gateway to Agent Router in the monitoring docs, following the project's move to the Agentic AI Foundation. Only the prose changes: the `ENVOY_AI_GATEWAY` layer, the `job_name=envoy-ai-gateway` routing tag, the `envoy-ai-gateway` rule files and the `meter_envoy_ai_gw_` metric names are kept, as Agent Router itself kept its deployed names and the telemetry it emits.
All issues and pull requests are [here](https://github.com/apache/skywalking/issues?q=milestone:11.1.0)
diff --git a/docs/en/setup/backend/backend-envoy-ai-gateway-monitoring.md b/docs/en/setup/backend/backend-envoy-ai-gateway-monitoring.md
index bd614f6f61..ad42eb21a2 100644
--- a/docs/en/setup/backend/backend-envoy-ai-gateway-monitoring.md
+++ b/docs/en/setup/backend/backend-envoy-ai-gateway-monitoring.md
@@ -1,23 +1,35 @@
-# Envoy AI Gateway Monitoring
+# Agent Router (formerly Envoy AI Gateway) Monitoring
-## Envoy AI Gateway observability via OTLP
+## Agent Router observability via OTLP
-[Envoy AI Gateway](https://aigateway.envoyproxy.io/) is a gateway/proxy for AI/LLM API traffic
-(OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, Google Gemini, etc.) built on top of Envoy Proxy.
+[Agent Router](https://theagentrouter.ai/), formerly Envoy AI Gateway, is a gateway/proxy for AI/LLM API traffic
+(OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, Google Gemini, etc.) built on top of Envoy Proxy and Envoy Gateway.
It natively emits GenAI metrics following
[OpenTelemetry GenAI Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/),
and also emits MCP (Model Context Protocol) metrics and access logs via OTLP.
SkyWalking receives OTLP metrics and logs directly on its gRPC port (11800) — no OpenTelemetry
-Collector is needed between the AI Gateway and SkyWalking OAP.
+Collector is needed between Agent Router and SkyWalking OAP.
+
+### Names kept from Envoy AI Gateway
+
+This integration was built while the project was named Envoy AI Gateway. The rename changed only the product name:
+Agent Router kept the names you deploy (the `aigateway.envoyproxy.io` API group, the `aigw` CLI) and emits the same
+telemetry. SkyWalking keeps its names unchanged in the same way, so existing gateway deployments, stored data,
+dashboards and alarm rules keep working:
+
+- the layer `ENVOY_AI_GATEWAY`
+- the routing tag `job_name=envoy-ai-gateway`
+- the rule files `otel-rules/envoy-ai-gateway/*` and `lal/envoy-ai-gateway.yaml`
+- the metric names prefixed with `meter_envoy_ai_gw_`
### Prerequisites
-- [Envoy AI Gateway](https://aigateway.envoyproxy.io/) deployed. See the
- [Envoy AI Gateway getting started](https://aigateway.envoyproxy.io/docs/getting-started/) for installation.
+- [Agent Router](https://theagentrouter.ai/) deployed. See the
+ [Agent Router getting started](https://theagentrouter.ai/docs/getting-started/) for installation.
### Data flow
-1. Envoy AI Gateway processes LLM API requests and MCP requests, recording GenAI metrics and MCP metrics.
-2. The AI Gateway pushes metrics and access logs via OTLP gRPC to SkyWalking OAP.
+1. Agent Router processes LLM API requests and MCP requests, recording GenAI metrics and MCP metrics.
+2. Agent Router pushes metrics and access logs via OTLP gRPC to SkyWalking OAP.
3. SkyWalking OAP parses metrics with [MAL](../../concepts-and-designs/mal.md) rules and access logs
with [LAL](../../concepts-and-designs/lal.md) rules.
@@ -26,7 +38,7 @@ Collector is needed between the AI Gateway and SkyWalking OAP.
The MAL rules (`envoy-ai-gateway/*`) and LAL rules (`envoy-ai-gateway`) are enabled by default
in SkyWalking OAP. No OAP-side configuration is needed.
-Configure the AI Gateway to push OTLP to SkyWalking by setting these environment variables:
+Configure Agent Router to push OTLP to SkyWalking by setting these environment variables:
| Env Var | Value | Purpose |
|-------------------------------|-----------------------------------------------------|------------------------------|
@@ -38,9 +50,9 @@ Configure the AI Gateway to push OTLP to SkyWalking by setting these environment
| `OTEL_RESOURCE_ATTRIBUTES` | See below | Routing + instance + layer |
**Required resource attributes** (in `OTEL_RESOURCE_ATTRIBUTES`):
-- `job_name=envoy-ai-gateway` — Fixed routing tag for MAL/LAL rules. Same for all AI Gateway deployments.
+- `job_name=envoy-ai-gateway` — Fixed routing tag for MAL/LAL rules. Same for all Agent Router deployments.
- `service.instance.id=<instance-id>` — Instance identity. In Kubernetes, use the pod name via Downward API.
-- `service.layer=ENVOY_AI_GATEWAY` — Routes access logs to the AI Gateway LAL rules.
+- `service.layer=ENVOY_AI_GATEWAY` — Routes access logs to the Agent Router LAL rules.
**Example:**
```bash
@@ -54,7 +66,7 @@ OTEL_RESOURCE_ATTRIBUTES=job_name=envoy-ai-gateway,service.instance.id=pod-abc12
### Supported Metrics
-SkyWalking observes the AI Gateway as a `LAYER: ENVOY_AI_GATEWAY` service. Each gateway deployment
+SkyWalking observes Agent Router as a `LAYER: ENVOY_AI_GATEWAY` service. Each gateway deployment
is a service, each pod is an instance. Metrics include per-provider and per-model breakdowns.
#### Service Metrics
@@ -96,7 +108,7 @@ including per-provider and per-model breakdowns.
### MCP Metrics
-When the AI Gateway is configured with MCP (Model Context Protocol) routes, SkyWalking collects
+When Agent Router is configured with MCP (Model Context Protocol) routes, SkyWalking collects
MCP-specific metrics. These appear in the **MCP** tab on the service and instance dashboards.
#### MCP Service Metrics
diff --git a/docs/en/setup/backend/marketplace.md b/docs/en/setup/backend/marketplace.md
index 6665b2cd84..61a8e9222b 100644
--- a/docs/en/setup/backend/marketplace.md
+++ b/docs/en/setup/backend/marketplace.md
@@ -35,7 +35,7 @@ the matching dashboard / visualization lives in Horizon UI.
- **Infrastructure** - Linux and Windows server monitoring
- **Cloud Services** - AWS EKS, S3, DynamoDB, API Gateway, and more
- **Gateways** - Nginx, APISIX, Kong monitoring
-- **GenAI** - [Virtual GenAI](../service-agent/virtual-genai.md) for agent-based LLM call monitoring, [Envoy AI Gateway](backend-envoy-ai-gateway-monitoring.md) for infrastructure-side AI traffic observability
+- **GenAI** - [Virtual GenAI](../service-agent/virtual-genai.md) for agent-based LLM call monitoring, [Agent Router (formerly Envoy AI Gateway)](backend-envoy-ai-gateway-monitoring.md) for infrastructure-side AI traffic observability
- **Databases** - MySQL, PostgreSQL, Redis, Elasticsearch, MongoDB, ClickHouse, and more
- **Message Queues** - Kafka, RabbitMQ, Pulsar, RocketMQ, ActiveMQ
- **Browser** - Real user monitoring for web applications
diff --git a/docs/en/setup/backend/opentelemetry-receiver.md b/docs/en/setup/backend/opentelemetry-receiver.md
index aca1468efa..90c022be85 100644
--- a/docs/en/setup/backend/opentelemetry-receiver.md
+++ b/docs/en/setup/backend/opentelemetry-receiver.md
@@ -41,7 +41,7 @@ in the resource attributes, the fallback is skipped.
| `net.host.name` | `node_identifier_host_name` | Legacy: used by VM/Windows MAL rules |
| `host.name` | `node_identifier_host_name` | Legacy: used by VM/Windows MAL rules |
-When `job_name` is set explicitly in `OTEL_RESOURCE_ATTRIBUTES` (e.g., by Envoy AI Gateway),
+When `job_name` is set explicitly in `OTEL_RESOURCE_ATTRIBUTES` (e.g., `job_name=envoy-ai-gateway` for [Agent Router](backend-envoy-ai-gateway-monitoring.md)),
it takes precedence and the `service.name` fallback is skipped.
**Note:** The `net.host.name` and `host.name` mappings are legacy. New integrations should use
diff --git a/docs/menu.yml b/docs/menu.yml
index d9a069c9db..4a7d289fc3 100644
--- a/docs/menu.yml
+++ b/docs/menu.yml
@@ -168,7 +168,7 @@ catalog:
path: "/en/setup/backend/ai-evaluation"
- name: "AI Agent Conversations"
path: "/en/setup/backend/ai-agent-conversation"
- - name: "Envoy AI Gateway"
+ - name: "Agent Router (Envoy AI Gateway)"
path: "/en/setup/backend/backend-envoy-ai-gateway-monitoring"
- name: "Self Observability"
catalog:
diff --git a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
index 5cec73183a..76d1e18f87 100644
--- a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
+++ b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
@@ -284,8 +284,8 @@ public final class Layer {
public static final Layer VIRTUAL_GENAI = register("VIRTUAL_GENAI", 45, false);
/**
- * Envoy AI Gateway is an AI/LLM traffic gateway built on Envoy Proxy,
- * providing observability for GenAI API traffic.
+ * Agent Router, formerly Envoy AI Gateway, is an AI/LLM traffic gateway built on Envoy Proxy,
+ * providing observability for GenAI API traffic. The layer name predates the rename and is kept.
*/
public static final Layer ENVOY_AI_GATEWAY = register("ENVOY_AI_GATEWAY", 46, true);