Claude Platform Docs

测试遥测目标

$ ant beta:organization:telemetry-destinations test
POST/v1/organizations/telemetry_destinations/{destination_id}/test

使用目标已注册的标头向其发送一个名为 anthropic.test 的测试 span，仅发送一次且不重试，并报告目标的响应。无论目标是否以 2xx 状态响应，响应均为 200：其 result 的类型为 success，或类型为 failure 并在 error 中给出原因。目标的配置、state 和 delivery_health 不会改变。已禁用的目标也可以测试。对同一目标的两次测试之间请等待 10 秒；过早发出的请求可能会收到 429 状态。

Parameters
--destination-id: string⁠Path parameter

ID of the destination to test (starts with tdst_).

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send telemetry-destinations-2026-08-11 in this header.

Returns
beta_telemetry_destination_test_response: object{ type: "telemetry_destination_test", result }

The result of one test span sent to a destination.

type: "telemetry_destination_test"
result: BetaTelemetryDestinationTestSuccess or BetaTelemetryDestinationTestFailure

How the test went: success when the destination answered with a 2xx status, else failure with the reason.

One of the following:
beta_telemetry_destination_test_success: object{ type: "success" }

The destination answered the test span with a 2xx status.

type: "success"
beta_telemetry_destination_test_failure: object{ type: "failure", error }

The test span was not delivered.

type: "failure"
error: string

A message that describes why the test span was not delivered, including the HTTP status code when the destination returned one. Examples: HTTP error (status 403), timeout, TLS failure. It has the same form as the destination's delivery_health.last_error and never contains the destination's response body, any header value, a network address, or TLS details.

测试遥测目标
ant beta:organization:telemetry-destinations test \
  --api-key my-anthropic-api-key \
  --destination-id destination_id
Returns Examples
Response 200
{
  "result": {
    "type": "success"
  },
  "type": "telemetry_destination_test"
}