Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# SDK for Kotlin을 사용한 X-Ray 예제
다음 코드 예제에서는 AWS SDK for Kotlin을 X-Ray와 함께 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `CreateGroup`
다음 코드 예시는 `CreateGroup`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun createNewGroup(groupNameVal: String?) {
val groupRequest =
CreateGroupRequest {
filterExpression = "fault = true AND http.url CONTAINS \"example/game\" AND responsetime >= 5"
groupName = groupNameVal
}
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
val groupResponse = xRayClient.createGroup(groupRequest)
println("The Group ARN is " + (groupResponse.group?.groupArn))
}
}
```
+ API 세부 정보는 *AWS SDK for Kotlin API 참조*의 [CreateGroup](https://sdk.amazonaws.com/kotlin/api/latest/index.html)을 참조하세요.
### `CreateSamplingRule`
다음 코드 예시는 `CreateSamplingRule`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun createRule(ruleNameVal: String?) {
val rule =
SamplingRule {
ruleName = ruleNameVal
priority = 1
httpMethod = "*"
serviceType = "*"
serviceName = "*"
urlPath = "*"
version = 1
host = "*"
resourceArn = "*"
}
val ruleRequest =
CreateSamplingRuleRequest {
samplingRule = rule
}
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
val ruleResponse: CreateSamplingRuleResponse = xRayClient.createSamplingRule(ruleRequest)
println("The ARN of the new rule is ${ruleResponse.samplingRuleRecord?.samplingRule?.ruleArn}")
}
}
```
+ API 세부 정보는 SDK for Kotlin API 참조의 [CreateSamplingRule](https://sdk.amazonaws.com/kotlin/api/latest/index.html)을 참조하세요. *AWS *
### `DeleteGroup`
다음 코드 예시는 `DeleteGroup`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun deleteSpecificGroup(groupNameVal: String) {
val groupRequest =
DeleteGroupRequest {
groupName = groupNameVal
}
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
xRayClient.deleteGroup(groupRequest)
println("$groupNameVal was deleted!")
}
}
```
+ API 세부 정보는 *AWS SDK for Kotlin API 참조*의 [DeleteGroup](https://sdk.amazonaws.com/kotlin/api/latest/index.html)을 참조하세요.
### `DeleteSamplingRule`
다음 코드 예시는 `DeleteSamplingRule`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun deleteRule(ruleNameVal: String?) {
val ruleRequest =
DeleteSamplingRuleRequest {
ruleName = ruleNameVal
}
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
xRayClient.deleteSamplingRule(ruleRequest)
println("$ruleNameVal was deleted")
}
}
```
+ API 세부 정보는 SDK for Kotlin API 참조의 [DeleteSamplingRule](https://sdk.amazonaws.com/kotlin/api/latest/index.html)을 참조하세요. *AWS *
### `GetGroups`
다음 코드 예시는 `GetGroups`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun getAllGroups() {
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
val response = xRayClient.getGroups(GetGroupsRequest {})
response.groups?.forEach { group ->
println("The AWS X-Ray group name is ${group.groupName}")
}
}
}
```
+ API 세부 정보는 *AWS SDK for Kotlin API 참조*의 [GetGroups](https://sdk.amazonaws.com/kotlin/api/latest/index.html)를 참조하세요.
### `GetSamplingRules`
다음 코드 예시는 `GetSamplingRules`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun getRules() {
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
val response = xRayClient.getSamplingRules(GetSamplingRulesRequest {})
response.samplingRuleRecords?.forEach { record ->
println("The rule name is ${record.samplingRule?.ruleName}")
println("The related service is: ${record.samplingRule?.serviceName}")
}
}
}
```
+ API 세부 정보는 SDK for Kotlin API 참조의 [GetSamplingRules](https://sdk.amazonaws.com/kotlin/api/latest/index.html)를 참조하세요. *AWS *
### `GetServiceGraph`
다음 코드 예시는 `GetServiceGraph`의 사용 방법을 보여 줍니다.
**SDK for Kotlin**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/xray#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
suspend fun getGraph(groupNameVal: String?) {
val time = aws.smithy.kotlin.runtime.time.Instant
val getServiceGraphRequest =
GetServiceGraphRequest {
groupName = groupNameVal
this.startTime = time.now()
endTime = time.now()
}
XRayClient.fromEnvironment { region = "us-east-1" }.use { xRayClient ->
val response = xRayClient.getServiceGraph(getServiceGraphRequest)
response.services?.forEach { service ->
println("The name of the service is ${service.name}")
}
}
}
```
+ API 세부 정보는 *AWS SDK for Kotlin API 참조*의 [GetServiceGraph](https://sdk.amazonaws.com/kotlin/api/latest/index.html)를 참조하세요.