Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Aktifkan pencarian transaksi
Anda dapat mengaktifkan [Pencarian Transaksi](CloudWatch-Transaction-Search.md) melalui konsol atau dengan menggunakan API. [Pencarian transaksi dikonfigurasi untuk seluruh akun dan mengalihkan semua rentang konsumsi melalui X-Ray ke mode pengumpulan hemat biaya menggunakan Harga Amazon. CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/) Secara default, Anda juga akan mengindeks 1% dari rentang yang dicerna secara gratis sebagai ringkasan jejak untuk analisis, yang biasanya cukup mengingat Anda sudah memiliki visibilitas end-to-end jejak penuh pada semua rentang yang tertelan melalui Pencarian Transaksi.
## Prasyarat
Sebelum Anda dapat mengaktifkan Penelusuran Transaksi, Anda harus membuat peran dengan izin berikut.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "TransactionSearchXRayPermissions",
"Effect": "Allow",
"Action": [
"xray:GetTraceSegmentDestination",
"xray:UpdateTraceSegmentDestination",
"xray:GetIndexingRules",
"xray:UpdateIndexingRule"
],
"Resource": "*"
},
{
"Sid": "TransactionSearchLogGroupPermissions",
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutRetentionPolicy"
],
"Resource": [
"arn:aws:logs:*:*:log-group:/aws/application-signals/data:*",
"arn:aws:logs:*:*:log-group:aws/spans:*"
]
},
{
"Sid": "TransactionSearchLogsPermissions",
"Effect": "Allow",
"Action": [
"logs:PutResourcePolicy",
"logs:DescribeResourcePolicies"
],
"Resource": "*"
},
{
"Sid": "TransactionSearchApplicationSignalsPermissions",
"Effect": "Allow",
"Action": [
"application-signals:StartDiscovery"
],
"Resource": "*"
},
{
"Sid": "CloudWatchApplicationSignalsCreateServiceLinkedRolePermissions",
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals",
"Condition": {
"StringLike": {
"iam:AWSServiceName": "application-signals.cloudwatch.amazonaws.com"
}
}
},
{
"Sid": "CloudWatchApplicationSignalsGetRolePermissions",
"Effect": "Allow",
"Action": "iam:GetRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals"
},
{
"Sid": "CloudWatchApplicationSignalsCloudTrailPermissions",
"Effect": "Allow",
"Action": [
"cloudtrail:CreateServiceLinkedChannel"
],
"Resource": "arn:aws:cloudtrail:*:*:channel/aws-service-channel/application-signals/*"
}
]
}
```
------
**catatan**
Untuk menggunakan Penelusuran Transaksi dan CloudWatch fitur lainnya, tambahkan [CloudWatchReadOnlyAccess kebijakan](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html) ke peran Anda. Untuk informasi tentang cara membuat peran, lihat [Pembuatan peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).
## Mengaktifkan Penelusuran Transaksi di konsol
Prosedur berikut menjelaskan cara mengaktifkan Pencarian Transaksi di konsol.
**Untuk mengaktifkan Penelusuran Transaksi di CloudWatch konsol**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dari panel navigasi, di bawah **Sinyal Aplikasi**, pilih **Pencarian Transaksi**.
1. Pilih **Aktifkan Pencarian Transaksi**.
1. Pilih kotak untuk menelan bentang sebagai log terstruktur, dan masukkan persentase rentang yang akan diindeks. Anda dapat mengindeks rentang 1% secara gratis dan mengubah persentasenya nanti berdasarkan kebutuhan Anda.
## Mengaktifkan Penelusuran Transaksi menggunakan API
Prosedur berikut menjelaskan cara mengaktifkan Transaction Search menggunakan API.
### Langkah 1. Buat kebijakan yang memberikan akses ke rentang konsumsi di Log CloudWatch
Saat menggunakan AWS CLI atau SDK untuk mengaktifkan Penelusuran Transaksi, Anda harus mengonfigurasi izin menggunakan kebijakan berbasis sumber daya dengan. [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html)
**Contoh kebijakan**
Kebijakan contoh berikut memungkinkan X-Ray mengirim jejak ke CloudWatch Log
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "TransactionSearchXRayAccess",
"Effect": "Allow",
"Principal": {
"Service": "xray.amazonaws.com"
},
"Action": "logs:PutLogEvents",
"Resource": [
"arn:aws:logs:{{us-east-1}}:{{123456789012}}:log-group:aws/spans:*",
"arn:aws:logs:{{us-east-1}}:{{123456789012}}:log-group:/aws/application-signals/data:*"
],
"Condition": {
"ArnLike": {
"aws:SourceArn": "arn:aws:xray:{{us-east-1}}:{{123456789012}}:*"
},
"StringEquals": {
"aws:SourceAccount": "{{123456789012}}"
}
}
}
]
}
```
------
**Perintah contoh**
Contoh berikut menunjukkan cara memformat AWS CLI perintah Anda dengan`PutResourcePolicy`.
```
aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:xray:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'
```
### Langkah 2. Konfigurasikan tujuan segmen jejak
Konfigurasikan konsumsi bentang dengan. [https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html)
**Perintah contoh**
Contoh berikut menunjukkan cara memformat AWS CLI perintah Anda dengan`UpdateTraceSegmentDestination`.
```
aws xray update-trace-segment-destination --destination CloudWatchLogs
```
### Langkah 3. Konfigurasikan jumlah bentang yang akan diindeks
Konfigurasikan persentase pengambilan sampel yang Anda inginkan dengan [https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html)
**Perintah contoh**
Contoh berikut menunjukkan cara memformat AWS CLI perintah Anda dengan`UpdateIndexingRule`.
```
aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
```
**catatan**
Setelah Anda mengaktifkan Penelusuran Transaksi, dibutuhkan waktu sepuluh menit agar rentang tersedia untuk pencarian dan analisis.
### Langkah 4. Verifikasi rentang tersedia untuk pencarian dan analisis
Untuk memverifikasi rentang tersedia untuk pencarian dan analisis, gunakan [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html).
**Contoh perintah**
Contoh berikut menunjukkan cara memformat AWS CLI perintah Anda dengan`GetTraceSegmentDestination`.
```
aws xray get-trace-segment-destination
```
**Contoh tanggapan**
Contoh berikut menunjukkan respons yang dapat Anda harapkan saat Transaction Search aktif.
```
{
"Destination": "CloudWatchLogs",
"Status": "ACTIVE"
}
```