Skip to content

docs: add standalone Arize AX tracing guide - #981

Open
danehans wants to merge 3 commits into
agentgateway:mainfrom
danehans:arize-ax-tracing-docs
Open

docs: add standalone Arize AX tracing guide#981
danehans wants to merge 3 commits into
agentgateway:mainfrom
danehans:arize-ax-tracing-docs

Conversation

@danehans

@danehans danehans commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

Company

Not applicable; this pull request updates documentation.

Contribution summary

  • Add standalone Arize AX tracing guides under LLM observability.
  • Publish matching guides in the stable and development documentation trees.
  • Document OTLP/HTTP and OTLP/gRPC setup, verification, and troubleshooting.

Checklist

Logo file

  • Not applicable to this documentation change.

Listing

  • Added Arize AX to the standalone LLM observability integrations.

Preview

Both transport configurations were validated with agentgateway 1.4.1, and the
full Hugo build completed successfully.

@danehans danehans changed the title docs: add Arize AX tracing guide docs: add standalone Arize AX tracing guide Aug 29, 2026
export ARIZE_SPACE_ID="<your-space-id>"
```

Agentgateway sends the API key and Space ID as request headers.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what are the headers that we send them in?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clarified the protocol-specific names: arize-api-key and arize-space-id for OTLP/HTTP, and api_key and space_id metadata for OTLP/gRPC.

| US | `otlp.arize.com:443` |
| US regional | `otlp.us-central-1a.arize.com:443` |
| EU | `otlp.eu-west-1a.arize.com:443` |
| Canada | `otlp.ca-central-1a.arize.com:443` |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

save it in an environment variable so that you can reference it in the sample config below

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added an ARIZE_HOST environment variable for the selected regional collector.


## Configure trace export

Choose either OTLP/HTTP or OTLP/gRPC. The authentication header names differ by protocol.

@Nadine2016 Nadine2016 Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Choose either OTLP/HTTP or OTLP/gRPC. The authentication header names differ by protocol.
Update the agentgateway configuration file that you created as part of [before you begin](#before-you-begin) to add Arize AX as your tracing backend. Choose either OTLP/HTTP or OTLP/gRPC for your protocol, and add the custom tracing attributes that you require. The authentication header names differ by protocol.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the introduction to direct users to their quickstart configuration and explain the transport and attribute choices.

```text
info request gateway=default/default route=internal/llm:request http.status=200 trace.id=4d50f6d1cb4099a1a22e50b6d339d5f2 span.id=a3f2ae9119406264 protocol=llm gen_ai.provider.name=openai
```
4. In Arize AX, open **Tracing Projects**, select the project from `openinference.project.name`, and search for the trace ID. Trace export is batched, so allow several seconds for the trace to appear.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. In Arize AX, open **Tracing Projects**, select the project from `openinference.project.name`, and search for the trace ID. Trace export is batched, so allow several seconds for the trace to appear.
4. In Arize AX, open **Tracing Projects**, select the project that you defined in the `openinference.project.name` field, and search for the trace ID. Trace export is batched, so allow several seconds for the trace to appear.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clarified that users should select the project defined by openinference.project.name.

@@ -0,0 +1,186 @@
---
title: Arize AX

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you make this a reusable page under assets/agw-docs and then just refer to it from here and main?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the guide body to assets/agw-docs/standalone/llm/arize.md; the latest and main pages now reuse it.

# yaml-language-server: $schema=https://agentgateway.dev/schema/config
frontendPolicies:
tracing:
host: otlp.arize.com:443

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
host: otlp.arize.com:443
host: ${ARIZE_HOST}:443

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the OTLP/HTTP configuration to use ${ARIZE_HOST}:443.

# yaml-language-server: $schema=https://agentgateway.dev/schema/config
frontendPolicies:
tracing:
host: otlp.arize.com:443

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
host: otlp.arize.com:443
host: ${ARIZE_HOST}:443

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the OTLP/gRPC configuration to use ${ARIZE_HOST}:443.

Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
@danehans
danehans force-pushed the arize-ax-tracing-docs branch from e2615d4 to 723d712 Compare September 8, 2026 20:58
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
@danehans
danehans requested a review from Nadine2016 September 8, 2026 21:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants