arize-link

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Arize Link

Arize 链接

Generate deep links to the Arize UI for traces, spans, sessions, datasets, labeling queues, evaluators, and annotation configs.

生成指向Arize UI的深度链接，可用于跳转trace、span、会话、数据集、标注队列、评估器和标注配置页面。

When to Use

适用场景

User wants a link to a trace, span, session, dataset, labeling queue, evaluator, or annotation config
You have IDs from exported data or logs and need to link back to the UI
User asks to "open" or "view" any of the above in Arize

用户需要获取指向trace、span、会话、数据集、标注队列、评估器或标注配置的链接
你持有导出数据或日志中的ID，需要跳转回UI页面
用户要求在Arize中「打开」或「查看」上述任意资源

Required Inputs

必填输入项

Collect from the user or context (exported trace data, parsed URLs):

Always required	Resource-specific
`org_id` (base64)	`project_id` + `trace_id` [+ `span_id` ] — trace/span
`space_id` (base64)	`project_id` + `session_id` — session
	`dataset_id` — dataset
	`queue_id` — specific queue (omit for list)
	`evaluator_id` [+ `version` ] — evaluator

All path IDs must be base64-encoded (characters:

A-Za-z0-9+/=

). A raw numeric ID produces a valid-looking URL that 404s. If the user provides a number, ask them to copy the ID directly from their Arize browser URL (

https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…

). If you have a raw internal ID (e.g.

Organization:1:abC1

), base64-encode it before inserting into the URL.

从用户或上下文（导出的trace数据、解析的URL）中收集：

通用必填项	资源专属项
`org_id` (base64)	`project_id` + `trace_id` [+ `span_id` ] — trace/span
`space_id` (base64)	`project_id` + `session_id` — 会话
	`dataset_id` — 数据集
	`queue_id` — 指定队列（查询列表可省略）
	`evaluator_id` [+ `version` ] — 评估器

所有路径ID必须为base64编码（支持字符：

A-Za-z0-9+/=

）。原始数字ID生成的URL看起来格式合法但会返回404。如果用户提供的是数字，请让他们直接从Arize浏览器URL中复制ID（

https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…

）。如果你持有原始内部ID（例如

Organization:1:abC1

），请先进行base64编码再插入到URL中。

URL Templates

URL模板

Base URL:

https://app.arize.com

(override for on-prem)

Trace (add

&selectedSpanId={span_id}

to highlight a specific span):

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId={trace_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

Session:

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedSessionId={session_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

Dataset (

selectedTab

examples

experiments

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTab=examples

Queue list / specific queue:

{base_url}/organizations/{org_id}/spaces/{space_id}/queues
{base_url}/organizations/{org_id}/spaces/{space_id}/queues/{queue_id}

Evaluator (omit

?version=…

for latest):

{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}?version={version_url_encoded}

The

version

value must be URL-encoded (e.g., trailing

→

%3D

Annotation configs:

{base_url}/organizations/{org_id}/spaces/{space_id}/annotation-configs

基础URL：

https://app.arize.com

（私有化部署可替换）

Trace（添加

&selectedSpanId={span_id}

可高亮指定span）：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId={trace_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

会话：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedSessionId={session_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

数据集（

selectedTab

可选值：

examples

或

experiments

）：

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTab=examples

队列列表 / 指定队列：

{base_url}/organizations/{org_id}/spaces/{space_id}/queues
{base_url}/organizations/{org_id}/spaces/{space_id}/queues/{queue_id}

评估器（查询最新版本可省略

?version=…

）：

{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}?version={version_url_encoded}

version

值必须进行URL编码（例如末尾的

需转为

%3D

）。

标注配置：

{base_url}/organizations/{org_id}/spaces/{space_id}/annotation-configs

Time Range

时间范围

CRITICAL:

startA

and

endA

(epoch milliseconds) are required for trace/span/session links — omitting them defaults to the last 7 days and will show "no recent data" if the trace falls outside that window.

Priority order:

User-provided URL — extract and reuse
```
startA
```
/
```
endA
```
directly.
Span
start_time
— pad ±1 day (or ±1 hour for a tighter window).
Fallback — last 90 days (
```
now - 90d
```
to
```
now
```
).

Prefer tight windows; 90-day windows load slowly.

重要提示：

startA

和

endA

（Unix时间戳，单位毫秒）是trace/span/会话链接的必填项——如果省略会默认取最近7天，若trace不在该时间范围内会显示「无最近数据」。

优先级顺序：

用户提供的URL——直接提取复用
```
startA
```
/
```
endA
```
。
Span的
start_time
——前后各扩展1天（或扩展1小时获得更精准的窗口）。
兜底方案——最近90天（
```
当前时间 - 90天
```
到
```
当前时间
```
）。

建议优先使用窄时间窗口，90天的窗口加载速度较慢。

Instructions

使用说明

Gather IDs from user, exported data, or URL context.
Verify all path IDs are base64-encoded.
Determine
```
startA
```
/
```
endA
```
using the priority order above.
Substitute into the appropriate template and present as a clickable markdown link.

从用户、导出数据或URL上下文中收集所需ID。
验证所有路径ID都已进行base64编码。
按照上述优先级确定
```
startA
```
/
```
endA
```
。
代入对应模板，以可点击的markdown链接形式呈现。

Troubleshooting

问题排查

Problem	Solution
"No data" / empty view	Trace outside time window — widen `startA` / `endA` (±1h → ±1d → 90d).
404	ID wrong or not base64. Re-check `org_id` , `space_id` , `project_id` from the browser URL.
Span not highlighted	`span_id` may belong to a different trace. Verify against exported span data.
`org_id` unknown	`ax` CLI doesn't expose it. Ask user to copy from `https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…` .

问题	解决方案
「无数据」/ 空视图	trace不在时间窗口内——扩大 `startA` / `endA` 范围（±1小时 → ±1天 → 90天）。
404错误	ID错误或未进行base64编码。从浏览器URL重新核对 `org_id` 、 `space_id` 、 `project_id` 。
Span未高亮	`span_id` 可能属于其他trace。对照导出的span数据进行验证。
`org_id` 未知	`ax` CLI不暴露该参数，请让用户从 `https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…` 复制。

Related Skills

Examples

示例

See references/EXAMPLES.md for a complete set of concrete URLs for every link type.

查看references/EXAMPLES.md获取所有链接类型的完整具体URL示例。