本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用适用于 Java 的 X-Ray 开发工具包生成自定义
子区段扩展跟踪段详细介绍了为了满足请求而完成的工作。当您使用所分析客户端进行调用时，X-Ray 开发工具包会记录子分段中生成的信息。您可以创建其他子区段来对其他子区段进行分组、衡量代码部分的性能或记录注释和元数据。
要管理子分段，请使用 beginSubsegment 和 endSubsegment 方法。
例 GameModel.java - 自定义子分段
import com.amazonaws.xray.AWSXRay;
...
public void saveGame(Game game) throws SessionNotFoundException {
// wrap in subsegment
Subsegment subsegment = AWSXRay.beginSubsegment("Save Game");
try {
// check session
String sessionId = game.getSession();
if (sessionModel.loadSession(sessionId) == null ) {
throw new SessionNotFoundException(sessionId);
}
mapper.save(game);
} catch (Exception e) {
subsegment.addException(e);
throw e;
} finally {
AWSXRay.endSubsegment();
}
}在此示例中，子分段中的代码使用会话模型上的方法从 DynamoDB 加载游戏会话，并使用Amazon SDK for Java的 DynamoDB 映射器来保存游戏。在子分段中包装此代码会调用 DynamoDB 子项。Save Game控制台跟踪视图中的子分段。
如果子分段中的代码引发了检查异常，将其包装在try阻止并打电话AWSXRay.endSubsegment()在finally代码块以确保始终结束子分段。如果子分段未结束，则父分段无法完成，不发送到 X-Ray。
对于不引发检查异常的代码，可以将该代码传递到AWSXRay.CreateSubsegment作为 Lambda 函数。
例 子分段 Lambda 函数
import com.amazonaws.xray.AWSXRay;
AWSXRay.createSubsegment("getMovies", (subsegment) -> {
// function code
});当您在分段或者其他子分段中创建子分段时，SDK for Java 的 X-Ray 开发工具包会为其生成 ID 并记录开始时间和结束时间。
例 包含元数据的子分段
"subsegments": [{
"id": "6f1605cd8a07cb70",
"start_time": 1.480305974194E9,
"end_time": 1.4803059742E9,
"name": "Custom subsegment for UserModel.saveUser function",
"metadata": {
"debug": {
"test": "Metadata string from UserModel.saveUser"
}
},对于异步和多线程编程，必须手动将子段传递给endSubsegment()方法来确保它正确关闭，因为在异步执行期间可能会修改 X-Ray 上下文。如果异步子段在其父区段关闭后关闭，则此方法将自动将整个分段流式传输到 X-Ray 守护程序。
例 异步子分段
@GetMapping("/api")
public ResponseEntity<?> api() {
CompletableFuture.runAsync(() -> {
Subsegment subsegment = AWSXRay.beginSubsegment("Async Work");
try {
Thread.sleep(3000);
} catch (InterruptedException e) {
subsegment.addException(e);
throw e;
} finally {
AWSXRay.endSubsegment(subsegment);
}
});
return ResponseEntity.ok().build();
}