AWS X-Ray 追踪器配置 (proto)
AWS X-Ray 追踪器的配置
X-Ray 追踪器将自动将 custom_tags 作为注释附加到跨度。 (请参阅： 注释.)
AWS X-Ray 跟踪注释也是由跟踪子系统自动创建的，这些注释基于在创建跨度期间提供的元数据。
以下是一个由 envoy 跟踪子系统生成的 X-Ray 跟踪跨度的示例
{
"Id": "1-6698980d-e829ae270ab34b69b488b098",
"Duration": 0.016,
"LimitExceeded": false,
"Segments":
[
{
"Id": "15d65e5ced8dfe76",
"Document":
{
"id": "15d65e5ced8dfe76",
"name": "envoy-example",
"start_time": 1721276429.410355,
"trace_id": "1-6698980d-e829ae270ab34b69b488b098",
"end_time": 1721276429.426068,
"fault": true,
"http":
{
"request":
{
"url": "http://example/path",
"method": "GET",
"user_agent": "curl/8.5.0",
"client_ip": "127.0.0.1",
"x_forwarded_for": false
},
"response":
{
"status": 503,
"content_length": 216
}
},
"aws": {},
"annotations":
{
"response_flags": "UF",
"component": "proxy",
"upstream_cluster": "upstream_cluster",
"annotation_from_custom_tag": "example",
"http.protocol": "HTTP/1.1",
"request_size": "0",
"downstream_cluster": "-",
"direction": "ingress",
"upstream_cluster.name": "upstream_cluster"
}
}
}
]
}
config.trace.v3.XRayConfig
[config.trace.v3.XRayConfig proto]
此扩展的限定名称为 envoy.tracers.xray
注意
此扩展旨在对不可信的下游流量具有鲁棒性。 它假设上游是可信的。
提示
此扩展扩展了以下扩展类别，并且可以与之一起使用
此扩展必须使用以下类型 URL 之一进行配置
{
"daemon_endpoint": {...},
"segment_name": ...,
"sampling_rule_manifest": {...},
"segment_fields": {...}
}
- daemon_endpoint
(config.core.v3.SocketAddress) X-Ray Daemon 的 UDP 端点，跨度将被发送到该端点。 如果未设置此值，将使用默认值 127.0.0.1:2000。
- segment_name
(string, 必需) X-Ray 段的名称。
- sampling_rule_manifest
(config.core.v3.DataSource) 本地自定义采样规则 JSON 文件的位置。 有关采样规则的示例，请参阅： X-Ray SDK 文档
- segment_fields
(config.trace.v3.XRayConfig.SegmentFields) 要添加到每个跟踪段的可选自定义字段。 请参阅： X-Ray 段文档
config.trace.v3.XRayConfig.SegmentFields
[config.trace.v3.XRayConfig.SegmentFields proto]
{
"origin": ...,
"aws": {...}
}
- origin
(string) AWS 资源类型，例如“AWS::AppMesh::Proxy”。