From 0a84fcefbdf53fa237798251deb30acffb16d670 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Wed, 15 Apr 2026 14:33:46 -0500 Subject: [PATCH 1/5] Draft new metrics, add back links Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_how-tos/ai-gateway/proxy-a2a-agents.md | 2 + app/_kong_plugins/ai-a2a-proxy/index.md | 2 + app/_landing_pages/ai-gateway/a2a.yaml | 11 ++++- app/observability/explorer.md | 49 +++++++++++++++++++++ 4 files changed, 63 insertions(+), 1 deletion(-) diff --git a/app/_how-tos/ai-gateway/proxy-a2a-agents.md b/app/_how-tos/ai-gateway/proxy-a2a-agents.md index a82762cf3c..3544829fe5 100644 --- a/app/_how-tos/ai-gateway/proxy-a2a-agents.md +++ b/app/_how-tos/ai-gateway/proxy-a2a-agents.md @@ -43,6 +43,8 @@ related_resources: url: https://a2a-protocol.org/latest/ - text: Set up Jaeger with Gen AI OpenTelemetry url: /how-to/set-up-jaeger-with-gen-ai-otel/ + - text: Agentic usage analytics in {{site.konnect_short_name}} + url: /observability/explorer/?tab=agentic-usage#metrics prereqs: entities: diff --git a/app/_kong_plugins/ai-a2a-proxy/index.md b/app/_kong_plugins/ai-a2a-proxy/index.md index daf53220b0..e07322a973 100644 --- a/app/_kong_plugins/ai-a2a-proxy/index.md +++ b/app/_kong_plugins/ai-a2a-proxy/index.md @@ -216,6 +216,8 @@ unlimited capture for request detection. {:.warning} > Payload logging may expose sensitive data. Enable with care in production environments. +You can view AI A2A Proxy analytics in {{site.konnect_short_name}} Explorer and Dashboards using the [agentic usage analytics](/observability/explorer/?tab=agentic-usage#metrics). + ### Log output fields {% include /plugins/ai-a2a-proxy/log-output-fields.md %} diff --git a/app/_landing_pages/ai-gateway/a2a.yaml b/app/_landing_pages/ai-gateway/a2a.yaml index 070fdda5cb..be9a9c9837 100644 --- a/app/_landing_pages/ai-gateway/a2a.yaml +++ b/app/_landing_pages/ai-gateway/a2a.yaml @@ -96,7 +96,7 @@ rows: - Audit logs capture task IDs, JSON-RPC method calls, payloads, latencies, and errors. - OpenTelemetry spans record task state, context IDs, TTFB, SSE event counts, and response sizes. - Log plugins (File Log, HTTP Log, TCP Log, and others) consume the structured `ai.a2a` namespace emitted by the AI A2A Proxy plugin. - - column_count: 2 + - column_count: 3 columns: - blocks: - type: card @@ -134,6 +134,15 @@ rows: cta: url: /ai-gateway/ai-otel-metrics/#a2a-metrics align: end + - blocks: + - type: card + config: + title: Agentic usage analytics in {{site.konnect_short_name}} + description: View A2A-specific metrics and analytics in {{site.konnect_short_name}} + icon: /assets/icons/KogoBlue.svg + cta: + url: /observability/explorer/?tab=agentic-usage#metrics + align: end - header: type: h2 diff --git a/app/observability/explorer.md b/app/observability/explorer.md index 7c5b3668de..6acdb1456b 100644 --- a/app/observability/explorer.md +++ b/app/observability/explorer.md @@ -268,6 +268,55 @@ rows: {% endtable %} {% endnavtab %} +{% navtab "Agentic usage" %} + +Agentic usage tracks analytics data for agent to agent (A2A) traffic that flows through the [AI A2A Proxy plugin](/plugins/ai-a2a-proxy/). +You must [configure the AI A2A Proxy plugin](/how-to/proxy-a2a-agents/) before analytics will display in {{site.konnect_short_name}} Explorer. + +With agentic usage reporting, you can: +* See how many times a tool was called +* View the most called tools +* See which tools are returning errors +* View the latency for tools + +The following table shows which platform usage metrics you can view: + +{% table %} +columns: + - title: "Metric" + key: "metric" + - title: "Category" + key: "category" + - title: "Description" + key: "description" +rows: + - metric: "A2A Context ID" + category: "UUID" + description: | + - metric: "A2A Error" + category: "Latency" + description: | + - metric: "A2A Method" + category: "Count" + description: | + - metric: "A2A Task ID" + category: "UUID" + description: | + - metric: "MCP Error" + category: "Latency" + description: | + - metric: "MCP Method" + category: "Count" + description: | + - metric: "MCP Session ID" + category: "UUID" + description: | + - metric: "MCP Tool Name" + category: "Count" + description: | +{% endtable %} + +{% endnavtab %} {% endnavtabs %} ## Time intervals From b72cebc88823b6a340e80407b4b1b3688f72fd8a Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Wed, 15 Apr 2026 15:41:45 -0500 Subject: [PATCH 2/5] Fix metrics Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/observability/explorer.md | 29 ++++++++--------------------- 1 file changed, 8 insertions(+), 21 deletions(-) diff --git a/app/observability/explorer.md b/app/observability/explorer.md index 6acdb1456b..4c6aeccddf 100644 --- a/app/observability/explorer.md +++ b/app/observability/explorer.md @@ -279,7 +279,9 @@ With agentic usage reporting, you can: * See which tools are returning errors * View the latency for tools -The following table shows which platform usage metrics you can view: +Agentic usage reports the same metrics as [API usage](/observability/explorer/?tab=api-usage#metrics) for your A2A traffic as well as some agentic usage-specific metrics. + +The following table shows which agentic usage-specific metrics you can view: {% table %} columns: @@ -290,29 +292,14 @@ columns: - title: "Description" key: "description" rows: - - metric: "A2A Context ID" - category: "UUID" - description: | - - metric: "A2A Error" + - metric: "A2A latency" category: "Latency" description: | - - metric: "A2A Method" - category: "Count" - description: | - - metric: "A2A Task ID" - category: "UUID" - description: | - - metric: "MCP Error" - category: "Latency" - description: | - - metric: "MCP Method" - category: "Count" - description: | - - metric: "MCP Session ID" - category: "UUID" + - metric: "MCP Response Size" + category: "Size" description: | - - metric: "MCP Tool Name" - category: "Count" + - metric: "A2A Response Size" + category: "Size" description: | {% endtable %} From 970996a3bb044da894af2a4bf7c5c81f3ca7f27f Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Thu, 16 Apr 2026 08:42:32 -0500 Subject: [PATCH 3/5] Add two metric descriptions Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/observability/explorer.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/app/observability/explorer.md b/app/observability/explorer.md index 4c6aeccddf..207a7e9d39 100644 --- a/app/observability/explorer.md +++ b/app/observability/explorer.md @@ -298,9 +298,11 @@ rows: - metric: "MCP Response Size" category: "Size" description: | + The size of the response payload returned to {{site.base_gateway}} from the MCP server, in bytes. Users can select the total sum. - metric: "A2A Response Size" category: "Size" description: | + The size of the response payload returned to {{site.base_gateway}} from an agent, in bytes. Users can select the total sum. {% endtable %} {% endnavtab %} From b200a5212afb02441bde17fb1ae9883b4fe27e96 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Thu, 16 Apr 2026 09:35:13 -0500 Subject: [PATCH 4/5] last metric description Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/observability/explorer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/app/observability/explorer.md b/app/observability/explorer.md index 207a7e9d39..e6af399815 100644 --- a/app/observability/explorer.md +++ b/app/observability/explorer.md @@ -295,6 +295,7 @@ rows: - metric: "A2A latency" category: "Latency" description: | + The amount of time, in milliseconds, that {{site.base_gateway}} was waiting for the first byte of the agents response. Users can select average (avg). - metric: "MCP Response Size" category: "Size" description: | From 73e7d4f6a8b63a13ff2954cd03ad6ac7c824d4e6 Mon Sep 17 00:00:00 2001 From: Diana <75819066+cloudjumpercat@users.noreply.github.com> Date: Thu, 16 Apr 2026 09:59:22 -0500 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: jbaross Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --- app/_kong_plugins/ai-a2a-proxy/index.md | 2 +- app/_landing_pages/ai-gateway/a2a.yaml | 2 +- app/observability/explorer.md | 9 ++++----- 3 files changed, 6 insertions(+), 7 deletions(-) diff --git a/app/_kong_plugins/ai-a2a-proxy/index.md b/app/_kong_plugins/ai-a2a-proxy/index.md index e07322a973..747b3b8e93 100644 --- a/app/_kong_plugins/ai-a2a-proxy/index.md +++ b/app/_kong_plugins/ai-a2a-proxy/index.md @@ -216,7 +216,7 @@ unlimited capture for request detection. {:.warning} > Payload logging may expose sensitive data. Enable with care in production environments. -You can view AI A2A Proxy analytics in {{site.konnect_short_name}} Explorer and Dashboards using the [agentic usage analytics](/observability/explorer/?tab=agentic-usage#metrics). +You can view AI A2A Proxy analytics in {{site.konnect_short_name}} Explorer and Dashboards using the [Agentic usage analytics](/observability/explorer/?tab=agentic-usage#metrics). ### Log output fields diff --git a/app/_landing_pages/ai-gateway/a2a.yaml b/app/_landing_pages/ai-gateway/a2a.yaml index be9a9c9837..3aa949de33 100644 --- a/app/_landing_pages/ai-gateway/a2a.yaml +++ b/app/_landing_pages/ai-gateway/a2a.yaml @@ -138,7 +138,7 @@ rows: - type: card config: title: Agentic usage analytics in {{site.konnect_short_name}} - description: View A2A-specific metrics and analytics in {{site.konnect_short_name}} + description: View A2A-specific metrics and analytics in {{site.konnect_short_name}}. icon: /assets/icons/KogoBlue.svg cta: url: /observability/explorer/?tab=agentic-usage#metrics diff --git a/app/observability/explorer.md b/app/observability/explorer.md index e6af399815..139b0a8ca9 100644 --- a/app/observability/explorer.md +++ b/app/observability/explorer.md @@ -270,8 +270,8 @@ rows: {% endnavtab %} {% navtab "Agentic usage" %} -Agentic usage tracks analytics data for agent to agent (A2A) traffic that flows through the [AI A2A Proxy plugin](/plugins/ai-a2a-proxy/). -You must [configure the AI A2A Proxy plugin](/how-to/proxy-a2a-agents/) before analytics will display in {{site.konnect_short_name}} Explorer. +Agentic usage tracks analytics data for agent-to-agent (A2A) traffic that flows through the [AI A2A Proxy plugin](/plugins/ai-a2a-proxy/). +You must [configure the AI A2A Proxy plugin](/how-to/proxy-a2a-agents/) before analytics display in {{site.konnect_short_name}} Explorer. With agentic usage reporting, you can: * See how many times a tool was called @@ -279,9 +279,8 @@ With agentic usage reporting, you can: * See which tools are returning errors * View the latency for tools -Agentic usage reports the same metrics as [API usage](/observability/explorer/?tab=api-usage#metrics) for your A2A traffic as well as some agentic usage-specific metrics. -The following table shows which agentic usage-specific metrics you can view: +The following table shows the agentic usage-specific metrics you can view: {% table %} columns: @@ -295,7 +294,7 @@ rows: - metric: "A2A latency" category: "Latency" description: | - The amount of time, in milliseconds, that {{site.base_gateway}} was waiting for the first byte of the agents response. Users can select average (avg). + The amount of time, in milliseconds, that {{site.base_gateway}} was waiting for the first byte of the agent's response. Users can select average (avg). - metric: "MCP Response Size" category: "Size" description: |