Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi AWS X-Ray dengan yang lain Layanan AWS
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Banyak yang Layanan AWS menyediakan berbagai tingkat integrasi X-Ray, termasuk pengambilan sampel dan penambahan header ke permintaan yang masuk, menjalankan daemon X-Ray, dan secara otomatis mengirim data jejak ke X-Ray. Integrasi dengan X-Ray dapat mencakup hal-hal berikut:
+ *Instrumentasi aktif* — Sampel dan instrumen permintaan masuk
+ *Instrumentasi pasif* — Permintaan instrumen yang telah diambil sampelnya oleh layanan lain
+ *Request tracing* - Menambahkan header tracing ke semua permintaan yang masuk dan menyebarkannya ke hilir
+ *Tooling — Menjalankan* daemon X-Ray untuk menerima segmen dari X-Ray SDK
**catatan**
X-Ray SDKs menyertakan plugin untuk integrasi tambahan dengan Layanan AWS. Misalnya, Anda dapat menggunakan plugin X-Ray SDK for Java Elastic Beanstalk untuk menambahkan informasi tentang lingkungan Elastic Beanstalk yang menjalankan aplikasi Anda, termasuk nama lingkungan dan ID.
Berikut adalah beberapa contoh Layanan AWS yang terintegrasi dengan X-Ray:
+ [AWS Distro for OpenTelemetry (ADOT)](xray-services-adot.md) — Dengan ADOT, para insinyur dapat menginstruksikan aplikasi mereka sekali dan mengirim metrik dan jejak yang berkorelasi ke beberapa AWS solusi pemantauan termasuk Amazon, Amazon Service CloudWatch OpenSearch , dan AWS X-Ray Amazon Managed Service untuk Prometheus.
+ [AWS Lambda](xray-services-lambda.md)— Instrumentasi aktif dan pasif dari permintaan masuk pada semua runtime. AWS Lambda menambahkan dua node ke peta jejak Anda, satu untuk AWS Lambda layanan, dan satu untuk fungsi. Saat Anda mengaktifkan instrumentasi, jalankan AWS Lambda juga daemon X-Ray di runtime Java dan Node.js untuk digunakan dengan X-Ray SDK.
+ [Amazon API Gateway](xray-services-apigateway.md) – Instrumentasi aktif dan pasif. API Gateway menggunakan aturan pengambilan sampel untuk menentukan permintaan yang dicatat, dan menambahkan simpul untuk tahap gateway ke peta layanan Anda.
+ [AWS Elastic Beanstalk](xray-services-beanstalk.md) - Alat. Elastic Beanstalk memiliki daemon X-Ray pada platform berikut:
+ *Java SE* – 2.3.0 dan konfigurasi yang lebih baru
+ *Tomcat* – 2.4.0 dan konfigurasi yang lebih baru
+ *Node.js* – 3.2.0 dan konfigurasi yang lebih baru
+ *Windows Server* — Semua konfigurasi selain Windows Server Core yang telah dirilis setelah 9 Desember 2016
Anda dapat menggunakan konsol Elastic Beanstalk untuk memberitahu Elastic Beanstalk agar menjalankan daemon pada platform ini, atau menggunakan opsi `XRayEnabled` di namespace `aws:elasticbeanstalk:xray`.
+ [Elastic Load Balancing](xray-services-elb.md) — Permintaan penelusuran pada Application Load Balancers. Application Load Balancer menambahkan ID jejak ke header permintaan sebelum mengirimnya ke grup target.
+ [Amazon EventBridge](xray-services-eventbridge.md) - Instrumentasi pasif. Jika layanan yang memublikasikan peristiwa ke EventBridge diinstrumentasi dengan X-Ray SDK, target peristiwa akan menerima header penelusuran dan dapat terus menyebarkan ID jejak asli.
+ [Amazon Simple Notification Service](xray-services-sns.md) – Instrumentasi pasif. Jika penerbit Amazon SNS melacak kliennya dengan X-Ray SDK, pelanggan dapat mengambil header pelacakan dan terus menyebarkan pelacakan asli dari penerbit dengan ID pelacakan yang sama.
+ [Amazon Simple Queue Service](xray-services-sqs.md) – Instrumentasi pasif. Jika suatu layanan melacak permintaan menggunakan X-Ray SDK, Amazon SQS dapat mengirim header pelacakan dan terus menyebarkan pelacakan asli dari pengirim ke konsumen dengan ID pelacakan yang konsisten.
+ [Amazon Bedrock AgentCore](xray-services-sqs.md) — AgentCore mendukung penelusuran terdistribusi melalui integrasi X-Ray, memungkinkan Anda melacak permintaan saat mereka mengalir melalui aplikasi agen Anda. Saat Anda mengaktifkan observabilitas untuk AgentCore sumber daya Anda, Anda dapat menyebarkan konteks penelusuran melintasi batas layanan dan mendapatkan visibilitas ke dalam kinerja agen dan alat AI Anda.
Pilih dari topik berikut untuk menjelajahi set lengkap terintegrasi Layanan AWS.
**Topics**
+ [Amazon Bedrock AgentCore dan AWS X-Ray](xray-services-agentcore.md)
+ [Amazon Elastic Compute Cloud dan AWS X-Ray](xray-services-ec2.md)
+ [Amazon SNS dan AWS X-Ray](xray-services-sns.md)
+ [Amazon SQS dan AWS X-Ray](xray-services-sqs.md)
+ [Amazon S3 dan AWS X-Ray](xray-services-s3.md)
+ [AWS Distro untuk OpenTelemetry dan AWS X-Ray](xray-services-adot.md)
+ [Melacak perubahan konfigurasi enkripsi X-Ray AWS Config](xray-api-config.md)
+ [AWS AppSync dan AWS X-Ray](xray-services-appsync.md)
+ [Dukungan penelusuran aktif Amazon API Gateway untuk AWS X-Ray](xray-services-apigateway.md)
+ [Amazon EC2 dan AWS App Mesh](xray-services-appmesh.md)
+ [AWS Pelari Aplikasi dan X-Ray](xray-services-app-runner.md)
+ [Mencatat panggilan X-Ray API dengan AWS CloudTrail](xray-api-cloudtrail.md)
+ [CloudWatch Integrasi dengan X-Ray](xray-services-cloudwatch.md)
+ [AWS Elastic Beanstalk dan AWS X-Ray](xray-services-beanstalk.md)
+ [Elastic Load Balancing dan AWS X-Ray](xray-services-elb.md)
+ [Amazon EventBridge dan AWS X-Ray](xray-services-eventbridge.md)
+ [AWS Lambda dan AWS X-Ray](xray-services-lambda.md)
+ [AWS Step Functions dan AWS X-Ray](xray-services-stepfunctions.md)
# Amazon Bedrock AgentCore dan AWS X-Ray
Amazon Bedrock AgentCore terintegrasi AWS X-Ray untuk menyediakan kemampuan penelusuran terdistribusi untuk agen dan alat AI Anda. Integrasi ini memungkinkan Anda untuk melacak permintaan saat mereka mengalir melalui aplikasi agen Anda, membantu Anda mengidentifikasi kemacetan kinerja dan memecahkan masalah.
AgentCore mendukung penelusuran terdistribusi melalui integrasi X-Ray, memungkinkan Anda memantau kinerja agen dan alat AI Anda. Ketika Anda mengaktifkan observabilitas untuk AgentCore sumber daya Anda, Anda dapat menyebarkan konteks jejak di seluruh batas layanan dan mendapatkan visibilitas tentang bagaimana agen Anda berinteraksi dengan layanan lain. AWS Untuk informasi selengkapnya, lihat [Amazon Bedrock AgentCore](https://docs.aws.amazon.com//bedrock-agentcore/latest/devguide/what-is-genesis.html).
AgentCore mendukung fitur X-Ray berikut:
+ Penyebaran konteks jejak ke layanan hilir
+ Instrumentasi khusus menggunakan AWS Distro for OpenTelemetry (ADOT) SDK
## Menyiapkan X-Ray dengan AgentCore
Untuk menggunakan X-Ray dengan AgentCore, Anda harus mengaktifkan Pencarian CloudWatch Transaksi di AWS akun Anda. Ini adalah pengaturan satu kali yang memungkinkan AgentCore untuk mengirim data jejak ke X-Ray. Untuk informasi selengkapnya, lihat [Mengaktifkan penelusuran transaksi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html).
Untuk informasi selengkapnya tentang menyiapkan observabilitas AgentCore, lihat [Menambahkan observabilitas ke AgentCore agen atau alat Amazon Bedrock](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-configure.html) Anda.
## Menggunakan header jejak dengan AgentCore
AgentCore mendukung format header jejak X-Ray untuk penelusuran terdistribusi. Anda dapat menyertakan `X-Amzn-Trace-Id` header dalam permintaan Anda AgentCore untuk mempertahankan konteks penelusuran di seluruh batas layanan.
# Amazon Elastic Compute Cloud dan AWS X-Ray
Anda dapat menginstal dan menjalankan daemon X-Ray pada EC2 instance Amazon dengan skrip data pengguna. Lihat [Menjalankan daemon X-Ray di Amazon EC2](xray-daemon-ec2.md) untuk instruksi.
Gunakan profil instans untuk memberikan izin daemon untuk mengunggah data penelusuran ke X-Ray. Untuk informasi selengkapnya, lihat [Memberikan izin kepada daemon untuk mengirim data ke X-Ray](xray-daemon.md#xray-daemon-permissions).
# Amazon SNS dan AWS X-Ray
[Anda dapat menggunakan AWS X-Ray Amazon Simple Notification Service (Amazon SNS) untuk melacak dan menganalisis permintaan saat mereka melakukan perjalanan melalui topik SNS Anda ke layanan berlangganan yang didukung SNS Anda.](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) Gunakan penelusuran X-Ray dengan Amazon SNS untuk menganalisis latensi dalam pesan Anda dan layanan back-end mereka, seperti berapa lama permintaan dihabiskan dalam suatu topik, dan berapa lama waktu yang dibutuhkan untuk menyampaikan pesan ke setiap langganan topik. Amazon SNS mendukung penelusuran X-Ray untuk topik standar dan FIFO.
Jika Anda mempublikasikan ke topik Amazon SNS dari layanan yang sudah diinstrumentasi dengan X-Ray, Amazon SNS meneruskan konteks jejak dari penerbit ke pelanggan. Selain itu, Anda dapat mengaktifkan penelusuran aktif untuk mengirim data segmen tentang langganan Amazon SNS Anda ke X-Ray untuk pesan yang diterbitkan dari klien SNS yang diinstrumentasi. [Aktifkan penelusuran aktif](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) untuk topik Amazon SNS dengan menggunakan konsol Amazon SNS, atau dengan menggunakan Amazon SNS API atau CLI. Lihat [Instrumentasi aplikasi Anda](xray-instrumenting-your-app.md) untuk informasi selengkapnya tentang instrumentasi klien SNS Anda.
## Konfigurasikan penelusuran aktif Amazon SNS
Anda dapat menggunakan konsol Amazon SNS atau AWS CLI atau SDK untuk mengonfigurasi penelusuran aktif Amazon SNS.
Saat Anda menggunakan konsol Amazon SNS, Amazon SNS mencoba membuat izin yang diperlukan agar SNS memanggil X-Ray. Upaya dapat ditolak jika Anda tidak memiliki izin yang cukup untuk mengubah kebijakan sumber daya X-Ray. Untuk informasi selengkapnya tentang izin ini, lihat [Identitas dan manajemen akses di Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-authentication-and-access-control.html) SNS [dan Contoh kasus untuk kontrol akses Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon. Untuk informasi selengkapnya tentang mengaktifkan penelusuran aktif menggunakan konsol Amazon SNS, [lihat Mengaktifkan penelusuran aktif pada topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.
Saat menggunakan AWS CLI atau SDK untuk mengaktifkan penelusuran aktif, Anda harus mengonfigurasi izin secara manual menggunakan kebijakan berbasis sumber daya. Gunakan [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html)untuk mengonfigurasi X-Ray dengan kebijakan berbasis sumber daya yang diperlukan untuk memungkinkan Amazon SNS mengirim jejak ke X-Ray.
**Example Contoh kebijakan berbasis sumber daya X-Ray untuk penelusuran aktif Amazon SNS**
Contoh dokumen kebijakan ini menentukan izin yang diperlukan Amazon SNS untuk mengirim data jejak ke X-Ray:
```
{
Version: "2012-10-17",
Statement: [
{
Sid: "SNSAccess",
Effect: Allow,
Principal: {
Service: "sns.amazonaws.com",
},
Action: [
"xray:PutTraceSegments",
"xray:GetSamplingRules",
"xray:GetSamplingTargets"
],
Resource: "*",
Condition: {
StringEquals: {
"aws:SourceAccount": "account-id"
},
StringLike: {
"aws:SourceArn": "arn:partition:sns:region:account-id:topic-name"
}
}
}
]
}
```
Gunakan CLI untuk membuat kebijakan berbasis sumber daya yang memberikan izin Amazon SNS untuk mengirim data jejak ke X-Ray:
```
aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'
```
Untuk menggunakan contoh ini, ganti*`partition`*,*`region`*,*`account-id`*, dan *`topic-name`* dengan AWS partisi tertentu, wilayah, ID akun, dan nama topik Amazon SNS. Untuk memberikan izin kepada semua topik Amazon SNS untuk mengirim data jejak ke X-Ray, ganti nama topik dengan. `*`
## Lihat jejak penerbit dan pelanggan Amazon SNS di konsol X-Ray
Gunakan konsol X-Ray untuk melihat peta jejak dan melacak detail yang menampilkan tampilan penayang dan pelanggan Amazon SNS yang terhubung. Saat penelusuran aktif Amazon SNS diaktifkan untuk suatu topik, peta jejak X-Ray dan peta detail jejak menampilkan node yang terhubung untuk penerbit Amazon SNS, topik Amazon SNS, dan pelanggan hilir:
![\[Lacak peta dengan penerbit dan pelanggan Amazon SNS\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/services-sns-activetracing-map.png)
Setelah memilih jejak yang mencakup penerbit dan pelanggan Amazon SNS, halaman detail jejak X-Ray menampilkan peta detail jejak dan garis waktu segmen.
**Example Contoh timeline dengan penerbit dan pelanggan Amazon SNS**
Contoh ini menunjukkan garis waktu yang menyertakan penerbit Amazon SNS yang mengirim pesan ke topik Amazon SNS, yang diproses oleh pelanggan Amazon SQS.
![\[Garis waktu segmen untuk penerbit dan pelanggan Amazon SNS\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/services-sns-activetracing-timeline.png)
Contoh timeline di atas memberikan detail tentang alur pesan Amazon SNS:
+ Segmen **SNS** mewakili durasi pulang-pergi panggilan `Publish` API dari klien.
+ Segmen **myTopic** mewakili latensi respons Amazon SNS terhadap permintaan publikasi.
+ Subsegmen **SQS** mewakili waktu pulang-pergi yang dibutuhkan Amazon SNS untuk mempublikasikan pesan ke antrian Amazon SQS.
+ Waktu antara segmen **MyTopic** dan subsegmen **SQS** mewakili waktu yang dihabiskan pesan dalam sistem Amazon SNS.
**Example Contoh timeline dengan pesan Amazon SNS batch**
Jika beberapa pesan Amazon SNS dikumpulkan dalam satu jejak, timeline segmen akan menampilkan segmen yang mewakili setiap pesan yang diproses.
![\[Garis waktu segmen untuk pesan batch Amazon SNS\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/services-sns-activetracing-batch-timeline.png)
# Amazon SQS dan AWS X-Ray
AWS X-Ray terintegrasi dengan Amazon Simple Queue Service (Amazon Simple Queue Service) untuk melacak pesan yang diteruskan melalui antrian Amazon SQS. Jika layanan melacak permintaan dengan menggunakan SDK X-Ray, Amazon SQS dapat mengirim header pelacakan dan terus menyebarkan pelacakan asli dari pengirim ke konsumen dengan ID pelacakan konsisten. Kontinuitas pelacakan mengaktifkan pengguna untuk melacak, menganalisis, dan men-debug di seluruh layanan hilir.
AWS X-Ray mendukung penelusuran aplikasi berbasis peristiwa menggunakan Amazon SQS dan. AWS Lambda Gunakan CloudWatch konsol untuk melihat tampilan tersambung dari setiap permintaan saat diantrian dengan Amazon SQS dan diproses oleh fungsi Lambda hilir. Jejak dari produsen pesan hulu secara otomatis ditautkan ke jejak dari node konsumen Lambda hilir, menciptakan end-to-end tampilan aplikasi. Untuk informasi selengkapnya, lihat [melacak aplikasi berbasis peristiwa](xray-tracelinking.md).
![\[Lacak peta dari Lambda melalui antrean Amazon SQS.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/console-batch-servicemap-linkededge.png)
Amazon SQS mendukung instrumentasi header pelacakan berikut:
+ **Header HTTP default** - X-Ray SDK secara otomatis mengisi header jejak sebagai header HTTP saat Anda memanggil Amazon SQS melalui SDK. AWS Header pelacakan default dilakukan oleh `X-Amzn-Trace-Id` dan sesuai dengan semua pesan yang disertakan dalam permintaan [https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html) atau [https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html). Untuk mempelajari selengkapnya tentang Header HTTP default, lihat [Header penelusuran](xray-concepts.md#xray-concepts-tracingheader).
+ **Atribut Sistem `AWSTraceHeader`** – `AWSTraceHeader` adalah [atribut sistem pesan](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_MessageSystemAttributeValue.html) yang disimpan oleh Amazon SQS untuk membawa header pelacakan X-Ray dengan pesan dalam antrean. `AWSTraceHeader` tersedia untuk digunakan meskipun instrumentasi otomatis melalui SDK X-Ray tidak, misalnya saat membuat SDK pelacakan untuk bahasa baru. Ketika kedua instrumentasi header ditetapkan, atribut sistem pesan membatalkan header pelacakan HTTP.
Saat berjalan di Amazon EC2, Amazon SQS mendukung pemrosesan satu pesan pada satu waktu. Ini berlaku saat berjalan di host lokal, dan saat menggunakan layanan kontainer, seperti Amazon ECS AWS Fargate, atau. AWS App Mesh
Header pelacakan dikecualikan dari ukuran pesan Amazon SQS dan kuota atribut pesan. Mengaktifkan pelacakan X-Ray tidak akan melebihi kuota Amazon SQS Anda. Untuk mempelajari AWS kuota selengkapnya, lihat Kuota [Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html).
## Kirim header pelacakan HTTP
Komponen pengirim di Amazon SQS dapat mengirim header pelacakan secara otomatis melalui panggilan [https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html) atau [https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html). Ketika klien AWS SDK diinstrumentasi, mereka dapat dilacak secara otomatis melalui semua bahasa yang didukung melalui X-Ray SDK. Ditelusuri Layanan AWS dan sumber daya yang Anda akses dalam layanan tersebut (misalnya, bucket Amazon S3 atau antrean Amazon SQS), muncul sebagai node hilir pada peta jejak di konsol X-Ray.
Untuk mempelajari cara melacak panggilan AWS SDK dengan bahasa pilihan Anda, lihat topik berikut di bagian yang didukung SDKs:
+ Go – [Menelusuri panggilan AWS SDK dengan X-Ray SDK for Go](xray-sdk-go-awssdkclients.md)
+ Java – [Menelusuri panggilan AWS SDK dengan X-Ray SDK for Java](xray-sdk-java-awssdkclients.md)
+ Node.js – [Menelusuri panggilan AWS SDK dengan X-Ray SDK untuk Node.js](xray-sdk-nodejs-awssdkclients.md)
+ Python – [Menelusuri panggilan AWS SDK dengan X-Ray SDK untuk Python](xray-sdk-python-awssdkclients.md)
+ Ruby – [Menelusuri panggilan AWS SDK dengan X-Ray SDK for Ruby](xray-sdk-ruby-awssdkclients.md)
+ .NET – [Menelusuri panggilan AWS SDK dengan X-Ray SDK untuk.NET](xray-sdk-dotnet-sdkclients.md)
## Mengambil header pelacakan dan memulihkan konteks pelacakan
Jika Anda menggunakan konsumen hilir Lambda, propagasi konteks jejak dilakukan secara otomatis. Untuk melanjutkan propagasi konteks dengan konsumen Amazon SQS lainnya, Anda harus secara manual mengarahkan handoff ke komponen penerima.
Ada tiga langkah utama untuk memulihkan konteks pelacakan:
+ Terima pesan dari antrean untuk atribut `AWSTraceHeader` dengan memanggil API [https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ReceiveMessage.html](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ReceiveMessage.html).
+ Mengambil header pelacakan dari atribut.
+ Memulihkan ID pelacakan dari header. Secara opsional, tambahkan lebih banyak metrik ke segmen.
Berikut ini adalah contoh implementasi yang ditulis dengan SDK for Java X-Ray.
**Example : Mengambil header pelacakan dan memulihkan konteks pelacakan**
```
// Receive the message from the queue, specifying the "AWSTraceHeader"
ReceiveMessageRequest receiveMessageRequest = new ReceiveMessageRequest()
.withQueueUrl(QUEUE_URL)
.withAttributeNames("AWSTraceHeader");
List messages = sqs.receiveMessage(receiveMessageRequest).getMessages();
if (!messages.isEmpty()) {
Message message = messages.get(0);
// Retrieve the trace header from the AWSTraceHeader message system attribute
String traceHeaderStr = message.getAttributes().get("AWSTraceHeader");
if (traceHeaderStr != null) {
TraceHeader traceHeader = TraceHeader.fromString(traceHeaderStr);
// Recover the trace context from the trace header
Segment segment = AWSXRay.getCurrentSegment();
segment.setTraceId(traceHeader.getRootTraceId());
segment.setParentId(traceHeader.getParentId());
segment.setSampled(traceHeader.getSampled().equals(TraceHeader.SampleDecision.SAMPLED));
}
}
```
# Amazon S3 dan AWS X-Ray
AWS X-Ray terintegrasi dengan Amazon S3 untuk melacak permintaan upstream untuk memperbarui bucket S3 aplikasi Anda. Jika layanan melacak permintaan dengan menggunakan X-Ray SDK, Amazon S3 dapat mengirim header penelusuran ke pelanggan acara hilir seperti, AWS Lambda Amazon SQS, dan Amazon SNS. X-Ray mengaktifkan pesan penelusuran untuk notifikasi peristiwa Amazon S3.
Anda dapat menggunakan peta jejak X-Ray untuk melihat koneksi antara Amazon S3 dan layanan lain yang digunakan aplikasi Anda. Anda juga dapat menggunakan konsol tersebut untuk melihat metrik seperti tingkat latensi dan kegagalan rata-rata. Untuk informasi selengkapnya tentang konsol X-Ray, lihat [Gunakan konsol X-Ray](aws-xray-interface-console.md#xray-console).
Amazon S3 mendukung instrumentasi *header http default*. X-Ray SDK secara otomatis mengisi header jejak sebagai header HTTP saat Anda memanggil Amazon S3 melalui SDK. AWS Header penelusuran default dilakukan oleh `X-Amzn-Trace-Id`. Untuk mempelajari selengkapnya tentang penelusuran header, lihat[Header penelusuran](xray-concepts.md#xray-concepts-tracingheader) pada halaman konsep. Propagasi konteks jejak Amazon S3 mendukung pelanggan berikut: Lambda, SQS, dan SNS. Karena SQS dan SNS tidak memancarkan data segmen itu sendiri, mereka tidak akan muncul di peta jejak atau jejak Anda saat dipicu oleh S3, meskipun mereka akan menyebarkan header penelusuran ke layanan hilir.
## Konfigurasikan notifikasi Peristiwa Amazon S3
Dengan fitur notifikasi Amazon S3, Anda menerima notifikasi saat peristiwa tertentu terjadi di bucket Anda. Notifikasi ini kemudian dapat disebarkan ke tujuan berikut dalam aplikasi Anda:
+ Amazon Simple Notification Service (Amazon SNS)
+ Amazon Simple Queue Service (Amazon SQS)
+ AWS Lambda
Untuk daftar peristiwa yang didukung, lihat [Tipe peristiwa yang didukung dalam panduan developer Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#supported-notification-event-types).
### Amazon SNS dan Amazon SQS
Untuk memublikasikan notifikasi ke topik SNS atau antrean SQS, Anda harus memberikan izin Amazon S3. Untuk memberikan izin ini, Anda melampirkan kebijakan AWS Identity and Access Management (IAM) ke topik SNS tujuan atau antrean SQS. Untuk mempelajari selengkapnya tentang kebijakan IAM yang diperlukan, lihat [Memberikan izin untuk memublikasikan pesan ke topik SNS atau antrean SQS](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#grant-sns-sqs-permission-for-s3).
Untuk informasi tentang mengintegrasikan SNS dan SQS dengan X-Ray lihat, [Amazon SNS dan AWS X-Ray](xray-services-sns.md) dan [Amazon SQS dan AWS X-Ray](xray-services-sqs.md).
### AWS Lambda
Ketika Anda menggunakan konsol Amazon S3 untuk mengonfigurasi notifikasi peristiwa pada bucket S3 untuk fungsi Lambda, konsol tersebut menyiapkan izin yang diperlukan pada fungsi Lambda sehingga Amazon S3 memiliki izin untuk memanggil fungsi dari bucket. Untuk informasi selengkapnya, lihat [Bagaimana Cara Saya Mengaktifkan dan Mengonfigurasi Notifikasi Peristiwa untuk Bucket S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/enable-event-notifications.html) dalam Panduan Pengguna Konsol Amazon Simple Storage Service.
Anda juga dapat memberikan izin Amazon S3 dari AWS Lambda untuk menjalankan fungsi Lambda Anda. Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan AWS Lambda dengan Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html) di Panduan Pengembang AWS Lambda.
Untuk informasi selengkapnya tentang mengintegrasikan Lambda dengan X-Ray, [lihat Menginstrumentasi kode](https://docs.aws.amazon.com/lambda/latest/dg/java-tracing.html) Java di Lambda. AWS
# AWS Distro untuk OpenTelemetry dan AWS X-Ray
Gunakan AWS Distro for OpenTelemetry (ADOT) untuk mengumpulkan dan mengirim metrik dan jejak ke AWS X-Ray dan solusi pemantauan lainnya, seperti Amazon, Layanan Amazon, dan OpenSearch Layanan Terkelola CloudWatch Amazon untuk Prometheus.
## AWS Distro untuk OpenTelemetry
AWS Distro for OpenTelemetry (ADOT) adalah AWS distribusi berdasarkan proyek Cloud Native Computing Foundation (CNCF). OpenTelemetry OpenTelemetry menyediakan satu set open source APIs, perpustakaan, dan agen untuk mengumpulkan jejak dan metrik terdistribusi. Toolkit ini adalah distribusi OpenTelemetry komponen hulu termasuk SDKs, agen instrumentasi otomatis, dan kolektor yang diuji, dioptimalkan, diamankan, dan didukung oleh. AWS
Dengan ADOT, para insinyur dapat menginstruksikan aplikasi mereka sekali dan mengirim metrik dan jejak yang berkorelasi ke beberapa solusi AWS pemantauan termasuk Amazon CloudWatch, Amazon Service, dan AWS X-Ray Amazon Managed OpenSearch Service untuk Prometheus.
ADOT terintegrasi dengan semakin banyak Layanan AWS untuk menyederhanakan pengiriman jejak dan metrik ke solusi pemantauan seperti X-Ray. Beberapa contoh layanan yang terintegrasi dengan ADOT meliputi:
+ *AWS Lambda*— Lapisan Lambda yang AWS dikelola untuk ADOT memberikan pengalaman plug-and-play pengguna dengan secara otomatis menginstrumentasi fungsi Lambda, OpenTelemetry mengemas bersama dengan out-of-the-box konfigurasi untuk AWS Lambda dan X-Ray dalam lapisan yang mudah diatur. Pengguna dapat mengaktifkan dan menonaktifkan OpenTelemetry fungsi Lambda mereka tanpa mengubah kode. Untuk informasi lebih lanjut, lihat [AWS Distro untuk OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/lambda) Lambda
+ *Amazon Elastic Container Service (ECS)* — Kumpulkan metrik dan jejak dari aplikasi Amazon ECS menggunakan AWS Distro for OpenTelemetry Collector, untuk dikirim ke X-Ray dan solusi pemantauan lainnya. Untuk informasi selengkapnya, lihat [Mengumpulkan data jejak aplikasi](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/trace-data.html) di panduan pengembang Amazon ECS.
+ *AWS App Runner* — App Runner mendukung pengiriman jejak ke X-Ray menggunakan AWS Distro for OpenTelemetry (ADOT). Gunakan ADOT SDKs untuk mengumpulkan data jejak untuk aplikasi kontainer Anda, dan gunakan X-Ray untuk menganalisis dan mendapatkan wawasan tentang aplikasi instrumentasi Anda. Untuk informasi selengkapnya, lihat [Pelari AWS Aplikasi dan X-Ray](xray-services-app-runner.md).
Untuk informasi selengkapnya tentang AWS Distro for OpenTelemetry, termasuk integrasi dengan tambahan Layanan AWS, lihat [AWS Distro untuk OpenTelemetry ](https://aws-otel.github.io/docs/introduction) Dokumentasi.
Untuk informasi selengkapnya tentang menginstrumentasi aplikasi Anda dengan AWS Distro for dan OpenTelemetry X-Ray, lihat [Menginstrumentasi aplikasi Anda dengan Distro untuk AWS](xray-instrumenting-your-app.md#xray-instrumenting-opentel). OpenTelemetry
# Melacak perubahan konfigurasi enkripsi X-Ray AWS Config
AWS X-Ray terintegrasi dengan AWS Config untuk merekam perubahan konfigurasi yang dibuat pada sumber daya enkripsi X-Ray Anda. Anda dapat menggunakan AWS Config inventaris sumber daya enkripsi X-Ray, mengaudit riwayat konfigurasi X-Ray, dan mengirim pemberitahuan berdasarkan perubahan sumber daya.
AWS Config mendukung pencatatan perubahan sumber daya enkripsi X-Ray berikut sebagai peristiwa:
+ **Perubahan konfigurasi** – Mengubah atau menambahkan kunci enkripsi, atau kembali ke pengaturan enkripsi X-Ray default.
Gunakan petunjuk berikut untuk mempelajari cara membuat koneksi dasar antara X-Ray dan AWS Config.
## Membuat pemicu fungsi Lambda
Anda harus memiliki ARN dari AWS Lambda fungsi kustom sebelum Anda dapat membuat aturan khusus AWS Config . Ikuti petunjuk ini untuk membuat fungsi dasar dengan Node.js yang mengembalikan nilai kepatuhan atau ketidakpatuhan kembali ke AWS Config berdasarkan status sumber daya `XrayEncryptionConfig`.
**Untuk membuat fungsi Lambda dengan pemicu perubahan AWS::Xray EncryptionConfig**
1. Buka [Konsol Lambda](https://console.aws.amazon.com/lambda/home). Pilih **Buat fungsi**.
1. Pilih **Blueprints**, lalu filter pustaka cetak biru untuk cetak biru. **config-rule-change-triggered** Klik tautan di nama cetak biru atau pilih **Konfigurasi** untuk melanjutkan.
1. Tentukan bidang berikut untuk mengonfigurasi cetak biru:
+ Untuk **Name**, ketik nama.
+ Untuk **Peran**, pilih **Buat peran baru dari templat**.
+ Untuk **Nama peran**, ketik nama.
+ Untuk **Templat Kebijakan**, pilih **Izin aturan AWS Config **.
1. Pilih **Buat fungsi** untuk membuat dan menampilkan fungsi Anda di AWS Lambda konsol.
1. Edit kode fungsi Anda untuk mengganti `AWS::EC2::Instance` dengan `AWS::XrayEncryptionConfig`. Anda juga dapat memperbarui bidang deskripsi untuk mencerminkan perubahan ini.
**Kode Default**
```
if (configurationItem.resourceType !== 'AWS::EC2::Instance') {
return 'NOT_APPLICABLE';
} else if (ruleParameters.desiredInstanceType === configurationItem.configuration.instanceType) {
return 'COMPLIANT';
}
return 'NON_COMPLIANT';
```
**Kode yang Diperbarui**
```
if (configurationItem.resourceType !== 'AWS::XRay::EncryptionConfig') {
return 'NOT_APPLICABLE';
} else if (ruleParameters.desiredInstanceType === configurationItem.configuration.instanceType) {
return 'COMPLIANT';
}
return 'NON_COMPLIANT';
```
1. Tambahkan yang berikut ke peran eksekusi Anda di IAM untuk akses ke X-Ray. Izin ini mengizinkan akses hanya-baca ke sumber daya X-Ray Anda. Kegagalan untuk menyediakan akses ke sumber daya yang sesuai akan mengakibatkan pesan di luar cakupan AWS Config sejak mengevaluasi fungsi Lambda yang terkait dengan aturan.
```
{
"Sid": "Stmt1529350291539",
"Action": [
"xray:GetEncryptionConfig"
],
"Effect": "Allow",
"Resource": "*"
}
```
## Membuat AWS Config aturan khusus untuk x-ray
Saat fungsi Lambda dibuat, perhatikan ARN fungsi tersebut, dan buka AWS Config konsol untuk membuat aturan kustom Anda.
**Untuk membuat AWS Config aturan untuk X-Ray**
1. Buka halaman [**Aturan** dari konsol AWS Config tersebut](https://console.aws.amazon.com/config/home#/rules/view).
1. Pilih **Tambahkan aturan**, lalu pilih **Tambahkan aturan kustom**.
1. Di **Fungsi ARN AWS Lambda **, masukkan ARN yang terkait dengan fungsi Lambda yang ingin Anda gunakan.
1. Pilih tipe pemicu untuk mengatur:
+ **Perubahan konfigurasi** — AWS Config memicu evaluasi ketika sumber daya apa pun yang cocok dengan cakupan aturan berubah dalam konfigurasi. Evaluasi berjalan setelah AWS Config mengirimkan pemberitahuan perubahan item konfigurasi.
+ **Berkala** — AWS Config menjalankan evaluasi untuk aturan pada frekuensi yang Anda pilih (misalnya, setiap 24 jam).
1. Untuk **jenis Sumber Daya**, pilih **EncryptionConfig**di bagian X-Ray.
1. Pilih ****Simpan****.
AWS Config Konsol mulai mengevaluasi kepatuhan aturan segera. Evaluasi ini dapat memakan waktu beberapa menit hingga selesai.
Sekarang aturan ini sesuai, AWS Config dapat mulai menyusun riwayat audit. AWS Config mencatat perubahan sumber daya dalam bentuk garis waktu. Untuk setiap perubahan dalam timeline peristiwa, AWS Config buat tabel dalam format dari/ke untuk menunjukkan apa yang berubah dalam representasi JSON dari kunci enkripsi. Dua perubahan bidang yang terkait dengan EncryptionConfig adalah `Configuration.type` dan`Configuration.keyID`.
## Contoh hasil
Berikut ini adalah contoh AWS Config timeline yang menunjukkan perubahan yang dibuat pada tanggal dan waktu tertentu.
![\[AWS Config garis waktu.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/ConfigTimeline.png)
Berikut ini adalah contoh entri AWS Config perubahan. Dari/ke format menggambarkan apa yang berubah. Contoh ini menunjukkan bahwa pengaturan enkripsi X-Ray default diubah ke kunci enkripsi yang ditentukan.
![\[Entri perubahan konfigurasi enkripsi X-Ray.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/ConfigChanges.png)
## Notifikasi Amazon SNS
Untuk diberi tahu tentang perubahan konfigurasi, atur AWS Config untuk mempublikasikan notifikasi Amazon SNS. Untuk informasi selengkapnya, lihat [Memantau Perubahan AWS Config Sumber Daya melalui Email](https://docs.aws.amazon.com/config/latest/developerguide/monitoring-resource-changes-by-email.html).
# AWS AppSync dan AWS X-Ray
Anda dapat mengaktifkan dan melacak permintaan untuk AWS AppSync. Untuk informasi lebih lanjut, lihat [Menelusuri dengan AWS X-Ray](https://docs.aws.amazon.com/appsync/latest/devguide/x-ray-tracing.html) untuk instruksi.
Saat penelusuran X-Ray diaktifkan untuk AWS AppSync API, [peran terkait layanan AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) Identity and Access Management secara otomatis dibuat di akun Anda dengan izin yang sesuai. Ini memungkinkan AWS AppSync untuk mengirim jejak ke X-Ray dengan cara yang aman.
# Dukungan penelusuran aktif Amazon API Gateway untuk AWS X-Ray
Anda dapat menggunakan X-Ray untuk melacak dan menganalisis permintaan pengguna saat mereka melakukan perjalanan melalui Amazon API Gateway Anda APIs ke layanan yang mendasarinya. API Gateway mendukung penelusuran X-Ray untuk semua tipe titik akhir API Gateway: Regional, edge-optimized, dan privat. Anda dapat menggunakan X-Ray dengan Amazon API Gateway di semua Wilayah AWS tempat X-Ray tersedia. Untuk informasi selengkapnya, lihat [Menelusuri Eksekusi API dari API Gateway dengan AWS X-Ray](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-xray.html) di Panduan Developer Amazon API Gateway.
**catatan**
X-Ray hanya mendukung penelusuran REST APIs melalui API Gateway.
Amazon API Gateway menyediakan dukungan [penelusuran aktif](xray-services.md) untuk AWS X-Ray. Aktifkan penelusuran aktif pada tahap API Anda untuk mengambil sampel permintaan masuk dan mengirim penelusuran ke X-Ray.
**Untuk mengaktifkan penelusuran aktif pada tahap API**
1. Buka konsol API Gateway di [https://console.aws.amazon.com/apigateway/](https://console.aws.amazon.com/apigateway/).
1. Pilih API.
1. Memilih tahapan.
1. **Pada tab **Logs/Tracing**, pilih Aktifkan **X-Ray Tracing** dan kemudian pilih Simpan Perubahan.**
1. Pilih **Sumber Daya** pada panel navigasi sebelah kiri.
1. **Untuk menerapkan ulang API dengan pengaturan baru, pilih dropdown **Tindakan**, lalu pilih Deploy API.**
API Gateway menggunakan aturan pengambilan sampel yang Anda tetapkan di konsol X-Ray untuk menentukan permintaan mana yang akan dicatat. Anda dapat membuat aturan yang hanya berlaku untuk APIs, atau yang hanya berlaku untuk permintaan yang berisi header tertentu. API Gateway mencatat header dalam atribut pada segmen, bersama dengan detail tentang tahap dan permintaan. Untuk informasi selengkapnya, lihat [Mengonfigurasi aturan pengambilan sampel](xray-console-sampling.md).
**catatan**
Saat melacak REST APIs dengan [integrasi HTTP](https://docs.aws.amazon.com/apigateway/latest/developerguide/setup-http-integrations.html) API Gateway, nama layanan setiap segmen disetel ke jalur URL permintaan dari API Gateway ke titik akhir integrasi HTTP Anda, menghasilkan node layanan pada peta jejak X-Ray untuk setiap jalur URL unik. Sejumlah besar jalur URL dapat menyebabkan peta jejak melebihi batas 10.000 node, yang mengakibatkan kesalahan.
Untuk meminimalkan jumlah node layanan yang dibuat oleh API Gateway, pertimbangkan untuk meneruskan parameter dalam string kueri URL atau di badan permintaan melalui POST. Pendekatan mana pun akan memastikan parameter bukan bagian dari jalur URL, yang dapat menghasilkan lebih sedikit jalur URL dan node layanan yang berbeda.
Untuk semua permintaan yang masuk, API Gateway menambahkan [header pelacakan](xray-concepts.md#xray-concepts-tracingheader) ke permintaan HTTP masuk yang belum memilikinya.
```
X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793
```
**Format ID jejak X-Ray**
`trace_id`X-Ray terdiri dari tiga angka yang dipisahkan oleh tanda hubung. Contohnya, `1-58406520-a006649127e371903a2de979`. Hal ini mencakup:
+ Nomor versi, yaitu`1`.
+ Waktu permintaan asli dalam waktu epoch Unix menggunakan **8 digit heksadesimal**.
Misalnya, 10:00 AM 1 Desember 2016 PST dalam waktu epoch adalah `1480615200` detik atau `58406520` dalam digit heksadesimal.
+ Pengidentifikasi 96-bit yang unik secara global untuk jejak dalam **24** digit heksadesimal.
Jika penelusuran aktif dinonaktifkan, tahapan masih mencatat segmen jika permintaan berasal dari layanan yang mengambil sampel permintaan dan mulai penelusuran. Misalnya, aplikasi web yang diinstrumentasi dapat memanggil API dari API Gateway dengan klien HTTP. Ketika Anda instrumen klien HTTP dengan SDK X-Ray, hal tersebut akan menambahkan header penelusuran ke permintaan keluar yang berisi keputusan pengambilan sampel. API Gateway membaca header penelusuran dan membuat segmen untuk permintaan sampel.
Jika Anda menggunakan API Gateway untuk [membuat Java SDK untuk API Anda](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-generate-sdk.html), Anda dapat menginstrumentasikan klien SDK dengan menambahkan penangan permintaan dengan pembuat klien, dengan cara yang sama seperti Anda akan secara manual AWS menginstruksikan klien SDK. Lihat [Menelusuri panggilan AWS SDK dengan X-Ray SDK for Java](xray-sdk-java-awssdkclients.md) untuk instruksi.
# Amazon EC2 dan AWS App Mesh
AWS X-Ray terintegrasi dengan [AWS App Mesh](https://docs.aws.amazon.com/app-mesh/latest/userguide/what-is-app-mesh.html)untuk mengelola proxy Utusan untuk layanan mikro. App Mesh menyediakan versi Envoy yang dapat Anda konfigurasikan untuk mengirim data penelusuran ke daemon X-Ray yang berjalan dalam kontainer tugas atau pod yang sama. X-Ray mendukung penelusuran dengan layanan yang kompatibel dengan App Mesh berikut ini:
+ Amazon Elastic Container Service (Amazon ECS)
+ Amazon Elastic Kubernetes Service (Amazon EKS)
+ Amazon Elastic Compute Cloud (Amazon EC2)
Gunakan petunjuk berikut untuk mempelajari cara mengaktifkan penelusuran X-Ray melalui App Mesh.
![\[Peta jejak yang menunjukkan jejak antara klien dan layanan App Mesh.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/appmesh-traceContents.png)
Untuk mengonfigurasi proksi Envoy untuk mengirim data ke X-Ray, atur `ENABLE_ENVOY_XRAY_TRACING` [Variabel Lingkungan](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html#envoy-config) dalam ketentuan kontainer nya.
**catatan**
Versi App Mesh dari Envoy saat ini tidak mengirim jejak berdasarkan aturan [pengambilan sampel](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-sampling.html) yang dikonfigurasi. Sebaliknya, ia menggunakan tingkat pengambilan sampel tetap 5% untuk Utusan versi 1.16.3 atau yang lebih baru, atau tingkat pengambilan sampel 50% untuk versi Envoy sebelum 1.16.3.
**Example Envoy ketentuan kontainer untuk Amazon ECS**
```
{
"name": "envoy",
"image": "public.ecr.aws/appmesh/aws-appmesh-envoy:envoy-version",
"essential": true,
"environment": [
{
"name": "APPMESH_VIRTUAL_NODE_NAME",
"value": "mesh/myMesh/virtualNode/myNode"
},
{
"name": "ENABLE_ENVOY_XRAY_TRACING",
"value": "1"
}
],
"healthCheck": {
"command": [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | cut -d' ' -f3 | grep -q live"
],
"startPeriod": 10,
"interval": 5,
"timeout": 2,
"retries": 3
}
```
**catatan**
Untuk mempelajari selengkapnya tentang alamat wilayah Envoy yang tersedia, lihat [Envoy citra](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html) di Panduan Pengguna AWS App Mesh .
Untuk detail tentang menjalankan daemon X-Ray dalam kontainer, lihat [Menjalankan daemon X-Ray di Amazon ECS](xray-daemon-ecs.md). [Untuk contoh aplikasi yang menyertakan mesh layanan, microservice, proxy Envoy, dan daemon X-Ray, terapkan sampel di repositori Contoh App Mesh. `colorapp` GitHub](https://github.com/aws/aws-app-mesh-examples/tree/master/examples)
**Pelajari Selengkapnya**
+ [Memulai dengan AWS App Mesh](https://docs.aws.amazon.com/app-mesh/latest/userguide/getting_started.html)
+ [Memulai dengan AWS App Mesh dan Amazon ECS](https://docs.aws.amazon.com/app-mesh/latest/userguide/mesh-getting-started-ecs.html)
# AWS Pelari Aplikasi dan X-Ray
AWS App Runner adalah aplikasi Layanan AWS yang menyediakan cara yang cepat, sederhana, dan hemat biaya untuk menyebarkan dari kode sumber atau gambar kontainer langsung ke aplikasi web yang dapat diskalakan dan aman di aplikasi. AWS Cloud Anda tidak perlu mempelajari teknologi baru, memutuskan layanan komputasi mana yang akan digunakan, atau mengetahui cara menyediakan dan mengonfigurasi AWS sumber daya. Lihat [Apa itu Pelari AWS Aplikasi](https://docs.aws.amazon.com/apprunner/latest/dg/what-is-apprunner.html) untuk informasi selengkapnya.
AWS App Runner mengirimkan jejak ke X-Ray dengan mengintegrasikan dengan [AWS Distro for OpenTelemetry](xray-services-adot.md) (ADOT). Gunakan ADOT SDKs untuk mengumpulkan data jejak untuk aplikasi kontainer Anda, dan gunakan X-Ray untuk menganalisis dan mendapatkan wawasan tentang aplikasi instrumentasi Anda. Untuk informasi selengkapnya, lihat [Menelusuri aplikasi App Runner Anda dengan X-Ray](https://docs.aws.amazon.com/apprunner/latest/dg/monitor-xray.html).
# Mencatat panggilan X-Ray API dengan AWS CloudTrail
AWS X-Ray terintegrasi dengan [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html), layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS. CloudTrail menangkap semua panggilan API untuk X-Ray sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari konsol X-Ray dan panggilan kode ke operasi X-Ray API. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat untuk X-Ray, alamat IP dari mana permintaan dibuat, kapan dibuat, dan detail tambahan.
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan berikut hal ini:
+ Baik permintaan tersebut dibuat dengan kredensial pengguna root atau pengguna.
+ Apakah permintaan dibuat atas nama pengguna IAM Identity Center.
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.
+ Apakah permintaan tersebut dibuat oleh Layanan AWS lain.
CloudTrail aktif di Anda Akun AWS ketika Anda membuat akun dan Anda secara otomatis memiliki akses ke **riwayat CloudTrail Acara**. **Riwayat CloudTrail Acara menyediakan catatan** yang dapat dilihat, dapat dicari, dapat diunduh, dan tidak dapat diubah dari 90 hari terakhir dari peristiwa manajemen yang direkam dalam file. Wilayah AWS Untuk informasi selengkapnya, lihat [Bekerja dengan riwayat CloudTrail Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) di *Panduan AWS CloudTrail Pengguna*. Tidak ada CloudTrail biaya untuk melihat **riwayat Acara**.
Untuk catatan acara yang sedang berlangsung dalam 90 hari Akun AWS terakhir Anda, buat jejak atau penyimpanan data acara [CloudTrailDanau](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).
**CloudTrail jalan setapak**
*Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Semua jalur yang dibuat menggunakan Konsol Manajemen AWS Multi-region. Anda dapat membuat jalur Single-region atau Multi-region dengan menggunakan. AWS CLI Membuat jejak Multi-wilayah disarankan karena Anda menangkap aktivitas Wilayah AWS di semua akun Anda. Jika Anda membuat jejak wilayah Tunggal, Anda hanya dapat melihat peristiwa yang dicatat di jejak. Wilayah AWS Untuk informasi selengkapnya tentang jejak, lihat [Membuat jejak untuk Anda Akun AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) dan [Membuat jejak untuk organisasi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) di *Panduan AWS CloudTrail Pengguna*.
Anda dapat mengirimkan satu salinan acara manajemen yang sedang berlangsung ke bucket Amazon S3 Anda tanpa biaya CloudTrail dengan membuat jejak, namun, ada biaya penyimpanan Amazon S3. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/). Untuk informasi tentang harga Amazon S3, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
**CloudTrail Penyimpanan data acara danau**
*CloudTrail Lake* memungkinkan Anda menjalankan kueri berbasis SQL pada acara Anda. CloudTrail [Lake mengubah peristiwa yang ada dalam format JSON berbasis baris ke format Apache ORC.](https://orc.apache.org/) ORC adalah format penyimpanan kolumnar yang dioptimalkan untuk pengambilan data dengan cepat. Peristiwa digabungkan ke dalam *penyimpanan data peristiwa*, yang merupakan kumpulan peristiwa yang tidak dapat diubah berdasarkan kriteria yang Anda pilih dengan menerapkan pemilih acara [tingkat lanjut](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Penyeleksi yang Anda terapkan ke penyimpanan data acara mengontrol peristiwa mana yang bertahan dan tersedia untuk Anda kueri. Untuk informasi lebih lanjut tentang CloudTrail Danau, lihat [Bekerja dengan AWS CloudTrail Danau](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) di *Panduan AWS CloudTrail Pengguna*.
CloudTrail Penyimpanan data acara danau dan kueri menimbulkan biaya. Saat Anda membuat penyimpanan data acara, Anda memilih [opsi harga](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) yang ingin Anda gunakan untuk penyimpanan data acara. Opsi penetapan harga menentukan biaya untuk menelan dan menyimpan peristiwa, dan periode retensi default dan maksimum untuk penyimpanan data acara. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/).
**Topics**
+ [Acara manajemen X-Ray di CloudTrail](#xray-api-cloudtrail-mgmt)
+ [Peristiwa data X-Ray di CloudTrail](#cloudtrail-data-events)
+ [Contoh acara X-Ray](#xray-cloudtrail-examples)
## Acara manajemen X-Ray di CloudTrail
AWS X-Ray terintegrasi dengan AWS CloudTrail untuk merekam tindakan API yang dibuat oleh pengguna, peran, atau Layanan AWS dalam X-Ray. Anda dapat menggunakan CloudTrail untuk memantau permintaan X-Ray API secara real time dan menyimpan log di Amazon S3, Amazon CloudWatch Log, dan Amazon Events. CloudWatch X-Ray mendukung pencatatan tindakan berikut sebagai peristiwa dalam file CloudTrail log:
**Tindakan API yang didukung**
+ [https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_GetEncryptionConfig.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_UpdateGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateGroup.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_DeleteGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_DeleteGroup.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetGroup.html](https://docs.aws.amazon.com/xray/latest/api/API_GetGroup.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetGroups.html](https://docs.aws.amazon.com/xray/latest/api/API_GetGroups.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetInsight.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsight.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightEvents.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightEvents.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightImpactGraph.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightImpactGraph.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetInsightSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetInsightSummaries.html)
+ [https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingStatisticSummaries.html](https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingStatisticSummaries.html)
## Peristiwa data X-Ray di CloudTrail
[Peristiwa data](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya [https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html](https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html), yang mengunggah dokumen segmen ke X-Ray).
Ini juga dikenal sebagai operasi bidang data. Peristiwa data sering kali merupakan aktivitas bervolume tinggi. Secara default, CloudTrail tidak mencatat peristiwa data. **Riwayat CloudTrail peristiwa** tidak merekam peristiwa data.
Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/).
Anda dapat mencatat peristiwa data untuk jenis sumber daya X-Ray menggunakan CloudTrail konsol AWS CLI, atau operasi CloudTrail API. Untuk informasi selengkapnya tentang cara mencatat peristiwa data, lihat [Mencatat peristiwa data dengan Konsol Manajemen AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) dan [Logging peristiwa data dengan AWS Command Line Interface](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI) di *Panduan AWS CloudTrail Pengguna*.
Tabel berikut mencantumkan jenis sumber daya X-Ray yang dapat Anda log peristiwa data. Kolom **tipe peristiwa data (konsol)** menunjukkan nilai yang akan dipilih dari daftar **tipe peristiwa Data** di CloudTrail konsol. Kolom nilai **resources.type menunjukkan `resources.type` nilai**, yang akan Anda tentukan saat mengonfigurasi penyeleksi acara lanjutan menggunakan or. AWS CLI CloudTrail APIs CloudTrailKolom **Data yang APIs dicatat ke** menampilkan panggilan API yang dicatat CloudTrail untuk jenis sumber daya.
| Jenis peristiwa data (konsol) | nilai resources.type | Data APIs masuk ke CloudTrail |
| --- | --- | --- |
| Jejak X-Ray | AWS::XRay::Trace | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/xray-api-cloudtrail.html) |
Anda dapat mengonfigurasi pemilih acara lanjutan untuk memfilter pada `eventName` dan `readOnly` bidang untuk mencatat hanya peristiwa yang penting bagi Anda. Namun, Anda tidak dapat memilih acara dengan menambahkan pemilih `resources.ARN` bidang, karena jejak X-Ray tidak memiliki ARNs. Untuk informasi selengkapnya tentang bidang ini, lihat [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)di *Referensi AWS CloudTrail API*. Berikut ini adalah contoh cara menjalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/put-event-selectors.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudtrail/put-event-selectors.html) AWS CLI perintah untuk mencatat peristiwa data pada CloudTrail jejak. Anda harus menjalankan perintah di atau menentukan Wilayah tempat jejak dibuat; jika tidak, operasi mengembalikan `InvalidHomeRegionException` pengecualian.
```
aws cloudtrail put-event-selectors --trail-name myTrail --advanced-event-selectors \
'{
"AdvancedEventSelectors": [
{
"FieldSelectors": [
{ "Field": "eventCategory", "Equals": ["Data"] },
{ "Field": "resources.type", "Equals": ["AWS::XRay::Trace"] },
{ "Field": "eventName", "Equals": ["PutTraceSegments","GetSamplingTargets"] }
],
"Name": "Log X-Ray PutTraceSegments and GetSamplingTargets data events"
}
]
}'
```
## Contoh acara X-Ray
### Contoh acara manajemen, `GetEncryptionConfig`
Berikut ini adalah contoh entri GetEncryptionConfig log X-Ray di CloudTrail.
**Example**
```
{
"eventVersion"=>"1.05",
"userIdentity"=>{
"type"=>"AssumedRole",
"principalId"=>"AROAJVHBZWD3DN6CI2MHM:MyName",
"arn"=>"arn:aws:sts::123456789012:assumed-role/MyRole/MyName",
"accountId"=>"123456789012",
"accessKeyId"=>"AKIAIOSFODNN7EXAMPLE",
"sessionContext"=>{
"attributes"=>{
"mfaAuthenticated"=>"false",
"creationDate"=>"2023-7-01T00:24:36Z"
},
"sessionIssuer"=>{
"type"=>"Role",
"principalId"=>"AROAJVHBZWD3DN6CI2MHM",
"arn"=>"arn:aws:iam::123456789012:role/MyRole",
"accountId"=>"123456789012",
"userName"=>"MyRole"
}
}
},
"eventTime"=>"2023-7-01T00:24:36Z",
"eventSource"=>"xray.amazonaws.com",
"eventName"=>"GetEncryptionConfig",
"awsRegion"=>"us-east-2",
"sourceIPAddress"=>"33.255.33.255",
"userAgent"=>"aws-sdk-ruby2/2.11.19 ruby/2.3.1 x86_64-linux",
"requestParameters"=>nil,
"responseElements"=>nil,
"requestID"=>"3fda699a-32e7-4c20-37af-edc2be5acbdb",
"eventID"=>"039c3d45-6baa-11e3-2f3e-e5a036343c9f",
"eventType"=>"AwsApiCall",
"recipientAccountId"=>"123456789012"
}
```
### Contoh peristiwa data, `PutTraceSegments`
Berikut ini adalah contoh entri log peristiwa PutTraceSegments data X-Ray di CloudTrail.
**Example**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AROAWYXPW54Y4NEXAMPLE:i-0dzz2ac111c83zz0z",
"arn": "arn:aws:sts::012345678910:assumed-role/my-service-role/i-0dzz2ac111c83zz0z",
"accountId": "012345678910",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROAWYXPW54Y4NEXAMPLE",
"arn": "arn:aws:iam::012345678910:role/service-role/my-service-role",
"accountId": "012345678910",
"userName": "my-service-role"
},
"attributes": {
"creationDate": "2024-01-22T17:34:11Z",
"mfaAuthenticated": "false"
},
"ec2RoleDelivery": "2.0"
}
},
"eventTime": "2024-01-22T18:22:05Z",
"eventSource": "xray.amazonaws.com",
"eventName": "PutTraceSegments",
"awsRegion": "us-west-2",
"sourceIPAddress": "198.51.100.0",
"userAgent": "aws-sdk-ruby3/3.190.0 md/internal ua/2.0 api/xray#1.0.0 os/linux md/x86_64 lang/ruby#2.7.8 md/2.7.8 cfg/retry-mode#legacy",
"requestParameters": {
"traceSegmentDocuments": [
"trace_id:1-00zzz24z-EXAMPLE4f4e41754c77d0000",
"trace_id:1-00zzz24z-EXAMPLE4f4e41754c77d0000",
"trace_id:1-00zzz24z-EXAMPLE4f4e41754c77d0001",
"trace_id:1-00zzz24z-EXAMPLE4f4e41754c77d0002"
]
},
"responseElements": {
"unprocessedTraceSegments": []
},
"requestID": "5zzzzz64-acbd-46ff-z544-451a3ebcb2f8",
"eventID": "4zz51z7z-77f9-44zz-9bd7-6c8327740f2e",
"readOnly": false,
"resources": [
{
"type": "AWS::XRay::Trace"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "012345678910",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ZZZZZ-RSA-AAA128-GCM-SHA256",
"clientProvidedHostHeader": "example.us-west-2.xray.cloudwatch.aws.dev"
}
}
```
# CloudWatch Integrasi dengan X-Ray
AWS X-Ray terintegrasi dengan [CloudWatch Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), CloudWatch RUM, dan CloudWatch Synthetics untuk memudahkan pemantauan kesehatan aplikasi Anda. Aktifkan aplikasi Anda untuk Sinyal Aplikasi untuk memantau dan memecahkan masalah kesehatan operasional layanan, halaman klien, kenari Synthetics, dan dependensi layanan Anda.
Dengan mengkorelasikan CloudWatch metrik, log, dan jejak X-Ray, peta jejak X-Ray memberikan end-to-end tampilan layanan Anda untuk membantu Anda dengan cepat menentukan kemacetan kinerja dan mengidentifikasi pengguna yang terkena dampak.
Dengan CloudWatch RUM, Anda dapat melakukan pemantauan pengguna nyata untuk mengumpulkan dan melihat data sisi klien tentang kinerja aplikasi web Anda dari sesi pengguna yang sebenarnya dalam waktu dekat. Dengan AWS X-Ray dan CloudWatch RUM, Anda dapat menganalisis dan men-debug jalur permintaan mulai dari pengguna akhir aplikasi Anda melalui layanan AWS terkelola hilir. Ini akan membantu Anda untuk mengidentifikasi tren latensi dan kesalahan yang berdampak pada pengguna akhir Anda.
**Topics**
+ [CloudWatch RUM dan AWS X-Ray](xray-services-RUM.md)
+ [Debugging kenari CloudWatch sintetis menggunakan X-Ray](xray-services-cloudwatch-synthetics.md)
# CloudWatch RUM dan AWS X-Ray
Dengan Amazon CloudWatch RUM, Anda dapat melakukan pemantauan pengguna nyata untuk mengumpulkan dan melihat data sisi klien tentang kinerja aplikasi web Anda dari sesi pengguna aktual dalam waktu hampir nyata. Dengan AWS X-Ray dan CloudWatch RUM, Anda dapat menganalisis dan men-debug jalur permintaan mulai dari pengguna akhir aplikasi Anda melalui layanan AWS terkelola hilir. Ini akan membantu Anda untuk mengidentifikasi tren latensi dan kesalahan yang berdampak pada pengguna akhir Anda.
Setelah Anda mengaktifkan penelusuran X-Ray sesi pengguna, CloudWatch RUM menambahkan header jejak X-Ray ke permintaan HTTP yang diizinkan, dan merekam segmen X-Ray untuk permintaan HTTP yang diizinkan. Anda kemudian dapat melihat jejak dan segmen dari sesi pengguna ini di X-Ray dan CloudWatch konsol, termasuk peta jejak X-Ray.
**catatan**
CloudWatch RUM tidak terintegrasi dengan aturan pengambilan sampel X-Ray. Sebaliknya, pilih persentase sampling ketika Anda mengatur aplikasi Anda untuk menggunakan CloudWatch RUM. Jejak yang dikirim dari CloudWatch RUM mungkin dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat [harga AWS X-Ray](https://aws.amazon.com/xray/pricing/).
Secara default, jejak sisi klien yang dikirim dari CloudWatch RUM tidak terhubung ke jejak sisi server. Untuk menghubungkan jejak sisi klien dengan jejak sisi server, konfigurasikan klien web CloudWatch RUM untuk menambahkan header jejak X-Ray ke permintaan HTTP ini.
**Awas**
Mengkonfigurasi klien web CloudWatch RUM untuk menambahkan header jejak X-Ray ke permintaan HTTP dapat menyebabkan berbagi sumber daya lintas asal (CORS) gagal. Untuk menghindari hal ini, tambahkan header `X-Amzn-Trace-Id` HTTP ke daftar header yang diizinkan pada konfigurasi CORS layanan hilir Anda. Jika Anda menggunakan API Gateway sebagai hilir, lihat [Mengaktifkan CORS untuk sumber daya REST](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html) API. Kami sangat menyarankan Anda menguji aplikasi Anda sebelum menambahkan header jejak sinar X sisi klien di lingkungan produksi. Untuk informasi selengkapnya, lihat [dokumentasi klien web CloudWatch RUM](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md#http).
Untuk informasi selengkapnya tentang pemantauan pengguna nyata di CloudWatch, lihat [Menggunakan CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html). Untuk mengatur aplikasi Anda agar menggunakan CloudWatch RUM, termasuk melacak sesi pengguna dengan X-Ray, lihat [Mengatur aplikasi untuk menggunakan CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-get-started.html).
# Debugging kenari CloudWatch sintetis menggunakan X-Ray
CloudWatch Synthetics adalah layanan yang dikelola sepenuhnya yang memungkinkan Anda memantau titik akhir Anda dan APIs menggunakan kenari skrip yang berjalan 24 jam per hari, sekali per menit.
Anda dapat menyesuaikan penulisan canary untuk memeriksa perubahan dalam:
+ Ketersediaan
+ Latensi
+ Transaksi
+ Tautan yang rusak atau mati
+ Step-by-step penyelesaian tugas
+ Kesalahan memuat halaman
+ Latensi Beban untuk aset UI
+ Arus wizard kompleks
+ Aliran checkout dalam aplikasi Anda
Canary mengikuti rute yang sama dan melakukan tindakan dan perilaku yang sama seperti pelanggan Anda, dan terus-menerus memverifikasi pengalaman pelanggan.
Untuk mempelajari selengkapnya tentang cara mengonfigurasi tes Synthetics, lihat [ Menggunakan Synthetics untuk Membuat dan Mengelola Canary](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html).
![\[Contoh simpul canary dalam peta pelacakan x-ray.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-show-canary-active.png)
Contoh berikut menunjukkan kasus penggunaan umum untuk debugging masalah yang meningkatkan Synthetics canary Anda. Setiap contoh menunjukkan strategi kunci untuk debugging menggunakan peta jejak atau konsol X-Ray Analytics.
Untuk informasi selengkapnya tentang cara membaca dan berinteraksi dengan peta jejak, lihat [Melihat Peta Layanan](https://docs.aws.amazon.com/xray/latest/devguide/xray-console.html#xray-console-servicemap).
Untuk informasi selengkapnya tentang cara membaca dan berinteraksi dengan konsol X-Ray Analytics, lihat [Berinteraksi dengan Konsol AWS X-Ray Analytics](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-analytics.html).
**Topics**
+ [Lihat kenari dengan peningkatan pelaporan kesalahan di peta jejak](#xray-services-cloudwatch-synthetics-workflows-which-canary)
+ [Gunakan peta detail jejak untuk setiap jejak untuk melihat setiap permintaan secara detail](#xray-services-cloudwatch-synthetics-workflows-trace-map)
+ [Tentukan akar masalah kegagalan yang sedang berlangsung di layanan hulu dan hilir](#xray-services-cloudwatch-synthetics-workflows-root-cause)
+ [Identifikasi bottleneck dan tren performa](#xray-services-cloudwatch-synthetics-workflows-bottlenecks)
+ [Bandingkan tingkat latensi dan kesalahan atau kesalahan sebelum dan sesudah perubahan](#xray-services-cloudwatch-synthetics-workflows-latency)
+ [Tentukan cakupan kenari yang diperlukan untuk semua APIs dan URLs](#xray-services-cloudwatch-synthetics-workflows-impact)
+ [Gunakan grup untuk fokus pada uji synthetics](#xray-services-cloudwatch-synthetics-groups)
## Lihat kenari dengan peningkatan pelaporan kesalahan di peta jejak
[Untuk melihat kenari mana yang memiliki peningkatan kesalahan, kesalahan, laju pelambatan, atau waktu respons lambat dalam peta jejak X-Ray Anda, Anda dapat menyorot node klien kenari Synthetics menggunakan filter. `Client::Synthetic`](xray-console-filters.md) Mengeklik simpul menampilkan distribusi waktu respons dari seluruh permintaan. Mengeklik edge antara dua simpul menunjukkan detail tentang permintaan yang melintasi koneksi itu. Anda juga dapat melihat node yang disimpulkan “jarak jauh” untuk layanan hilir terkait di peta jejak Anda.
Ketika Anda mengeklik simpul Synthetics, ada **Lihat dalam Synthetics**pada panel samping yang mengalihkan Anda ke konsol Synthetics tempat Anda dapat memeriksa detail canary.
![\[Contoh simpul kenari di peta jejak sinar-x dengan detail layanan.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-servicedetail.png)
## Gunakan peta detail jejak untuk setiap jejak untuk melihat setiap permintaan secara detail
Untuk menentukan layanan mana yang menghasilkan latensi paling banyak atau menyebabkan kesalahan, panggil peta detail jejak dengan memilih jejak di peta jejak. Peta detail jejak individu menampilkan end-to-end jalur permintaan tunggal. Gunakan ini untuk memahami layanan yang dipanggil, dan memvisualisasikan layanan hulu dan hilir.
![\[Contoh simpul kenari di peta detail jejak x-ray.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-tracemap.png)
## Tentukan akar masalah kegagalan yang sedang berlangsung di layanan hulu dan hilir
Setelah Anda menerima CloudWatch alarm untuk kegagalan dalam kenari Synthetics, gunakan pemodelan statistik pada data jejak di X-Ray untuk menentukan kemungkinan akar penyebab masalah dalam konsol X-Ray Analytics. Di konsol Analytics, tabel **Akar Penyebab Waktu Respons** menunjukkan jalur entitas yang dicatat. X-Ray menentukan jalur mana yang ada di pelacakan Anda adalah penyebab paling mungkin untuk waktu respons. Format menunjukkan hierarki entitas yang ditemui, berakhir dengan akar masalah waktu respons.
Contoh berikut menunjukkan bahwa tes Synthetics untuk API “XXX” berjalan pada API Gateway gagal karena pengecualian kapasitas throughput dari tabel Amazon DynamoDB.
![\[Contoh simpul canary dalam peta pelacakan x-ray.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-active-select.png)
![\[Contoh akar masalah simpul canary.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-rootcause.png)
![\[Contoh filter anotasi yang menunjukkan simpul kenari.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-showannot.png)
## Identifikasi bottleneck dan tren performa
Anda dapat melihat tren dalam kinerja titik akhir Anda dari waktu ke waktu menggunakan lalu lintas berkelanjutan dari kenari Synthetics Anda untuk mengisi peta detail jejak selama periode waktu tertentu.
![\[Contoh filter anotasi yang menunjukkan simpul kenari.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-distribution.png)
## Bandingkan tingkat latensi dan kesalahan atau kesalahan sebelum dan sesudah perubahan
Pinpoint waktu perubahan terjadi untuk menghubungkan perubahan itu dengan peningkatan masalah yang ditangkap oleh kenari Anda. Gunakan konsol Analitik X-Ray untuk menentukan rentang waktu sebelum dan sesudah setelah pelacakan yang berbeda ditetapkan, membuat diferensiasi visual dalam distribusi waktu respons.
![\[Contoh filter anotasi yang menunjukkan simpul kenari.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-compare.png)
## Tentukan cakupan kenari yang diperlukan untuk semua APIs dan URLs
Gunakan Analitik X-Ray untuk membandingkan pengalaman canary dengan pengguna. UI di bawah ini menunjukkan garis tren biru untuk canary dan garis hijau untuk pengguna. Anda juga dapat mengidentifikasi bahwa dua dari ketiganya URLs tidak memiliki tes kenari.
![\[Contoh filter anotasi yang menunjukkan simpul kenari.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-vs-customer.png)
## Gunakan grup untuk fokus pada uji synthetics
Anda dapat membuat grup X-Ray menggunakan ekspresi filter untuk fokus pada serangkaian alur kerja tertentu, seperti tes Synthetics untuk aplikasi “www” yang berjalan di AWS Elastic Beanstalk. Gunakan [kata kunci kompleks](xray-console-filters.md#console-filters-complex) `service()` dan `edge()` untuk memfilter melalui layanan dan edge.
**Example Ekspresi filter grup**
```
"edge(id(name: "www", type: "client::Synthetics"), id(name: "www", type: "AWS::ElasticBeanstalk::Environment"))"
```
![\[Contoh simpul untuk Elastic Beanstalk www.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/synthetics-canary-active-www.png)
# AWS Elastic Beanstalk dan AWS X-Ray
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
AWS Elastic Beanstalk Platform termasuk daemon X-Ray. Anda dapat [menjalankan daemon](xray-daemon-beanstalk.md) dengan mengatur opsi di konsol Elastic Beanstalk atau dengan file konfigurasi.
Pada platform Java SE, Anda dapat menggunakan file Buildfile untuk membangun aplikasi Anda dengan Maven atau Gradle pada instans. X-Ray SDK for Java AWS SDK untuk Java dan tersedia dari Maven, sehingga Anda hanya dapat menerapkan kode aplikasi dan membangun on-instance untuk menghindari bundling dan mengunggah semua dependensi Anda.
Anda dapat menggunakan properti lingkungan Elastic Beanstalk untuk mengonfigurasi SDK X-Ray. Metode yang digunakan Elastic Beanstalk untuk melalui properti lingkungan untuk aplikasi Anda bervariasi berdasarkan platform. Gunakan variabel lingkungan atau properti sistem X-Ray SDK tergantung pada platform Anda.
+ **[Platform Node.js](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/create_deploy_nodejs.container.html)** – Gunakan [Variabel lingkungan](xray-sdk-nodejs-configuration.md#xray-sdk-nodejs-configuration-envvars)
+ **[Platform Java SE](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/java-se-platform.html)** – Gunakan [Variabel lingkungan](xray-sdk-java-configuration.md#xray-sdk-java-configuration-envvars)
+ **[Platform Tomcat](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/java-tomcat-platform.html)** – Gunakan [Properti sistem](xray-sdk-java-configuration.md#xray-sdk-java-configuration-sysprops)
Untuk informasi selengkapnya, lihat [Mengonfigurasi AWS X-Ray Debugging](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environment-configuration-debugging.html) di Panduan AWS Elastic Beanstalk Pengembang.
# Elastic Load Balancing dan AWS X-Ray
Elastic Load Balancing aplikasi penyeimbang beban menambahkan ID penelusuran untuk permintaan HTTP masuk di header bernama `X-Amzn-Trace-Id`.
```
X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793
```
**Format ID jejak X-Ray**
`trace_id`X-Ray terdiri dari tiga angka yang dipisahkan oleh tanda hubung. Contohnya, `1-58406520-a006649127e371903a2de979`. Hal ini mencakup:
+ Nomor versi, yaitu`1`.
+ Waktu permintaan asli dalam waktu epoch Unix menggunakan **8 digit heksadesimal**.
Misalnya, 10:00 AM 1 Desember 2016 PST dalam waktu epoch adalah `1480615200` detik atau `58406520` dalam digit heksadesimal.
+ Pengidentifikasi 96-bit yang unik secara global untuk jejak dalam **24** digit heksadesimal.
Penyeimbang beban tidak mengirim data ke X-Ray, dan tidak muncul sebagai simpul pada peta layanan Anda.
Untuk informasi selengkapnya, lihat [Meminta Penelusuran untuk Application Load Balancer Anda](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-request-tracing.html) dalam Panduan Developer Elastic Load Balancing.
# Amazon EventBridge dan AWS X-Ray
AWS X-Ray terintegrasi dengan Amazon EventBridge untuk melacak peristiwa yang dilewati EventBridge. [Jika layanan yang diinstrumentasi dengan X-Ray SDK mengirimkan peristiwa ke EventBridge, konteks penelusuran akan disebarkan ke target peristiwa hilir dalam header penelusuran.](xray-concepts.md#xray-concepts-tracingheader) SDK X-Ray secara otomatis mengambil header penelusuran dan menerapkannya ke instrumentasi berikutnya. Kontinuitas ini memungkinkan pengguna untuk menelusuri, menganalisis, dan men-debug seluruh layanan downstream dan memberikan tampilan yang lebih lengkap dari sistem mereka.
Untuk informasi selengkapnya, lihat [Integrasi EventBridge X-Ray](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-xray-integ.html) di *Panduan EventBridge Pengguna*.
## Melihat sumber dan target pada peta layanan X-Ray
[Peta jejak](xray-console-servicemap.md) X-Ray menampilkan node EventBridge peristiwa yang menghubungkan layanan sumber dan target, seperti pada contoh berikut:
![\[X-Ray menampilkan node EventBridge peristiwa yang menghubungkan sumber dan layanan target\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/service-map-eventbridge.png)
## Sebarkan konteks penelusuran untuk target peristiwa
X-Ray SDK memungkinkan sumber EventBridge peristiwa untuk menyebarkan konteks jejak ke target peristiwa hilir. Contoh khusus bahasa berikut menunjukkan pemanggilan EventBridge dari fungsi Lambda tempat penelusuran [aktif](https://docs.aws.amazon.com//lambda/latest/dg/services-xray.html#services-xray-api) diaktifkan:
------
#### [ Java ]
Tambahkan dependensi yang diperlukan untuk X-Ray:
+ [AWS X-Ray SDK for Java](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-xray/)
+ [AWS X-Ray Perekam SDK for Java](https://mvnrepository.com/artifact/com.amazonaws/aws-xray-recorder-sdk-aws-sdk/)
```
package example;
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import com.amazonaws.services.lambda.runtime.events.SQSEvent;
import com.amazonaws.xray.AWSXRay;
import com.amazonaws.services.eventbridge.AmazonEventBridge;
import com.amazonaws.services.eventbridge.AmazonEventBridgeClientBuilder;
import com.amazonaws.services.eventbridge.model.PutEventsRequest;
import com.amazonaws.services.eventbridge.model.PutEventsRequestEntry;
import com.amazonaws.services.eventbridge.model.PutEventsResult;
import com.amazonaws.services.eventbridge.model.PutEventsResultEntry;
import com.amazonaws.xray.handlers.TracingHandler;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.lang.StringBuilder;
import java.util.Map;
import java.util.List;
import java.util.Date;
import java.util.Collections;
/*
Add the necessary dependencies for XRay:
https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-xray
https://mvnrepository.com/artifact/com.amazonaws/aws-xray-recorder-sdk-aws-sdk
*/
public class Handler implements RequestHandler{
private static final Logger logger = LoggerFactory.getLogger(Handler.class);
/*
build EventBridge client
*/
private static final AmazonEventBridge eventsClient = AmazonEventBridgeClientBuilder
.standard()
// instrument the EventBridge client with the XRay Tracing Handler.
// the AWSXRay globalRecorder will retrieve the tracing-context
// from the lambda function and inject it into the HTTP header.
// be sure to enable 'active tracing' on the lambda function.
.withRequestHandlers(new TracingHandler(AWSXRay.getGlobalRecorder()))
.build();
@Override
public String handleRequest(SQSEvent event, Context context)
{
PutEventsRequestEntry putEventsRequestEntry0 = new PutEventsRequestEntry();
putEventsRequestEntry0.setTime(new Date());
putEventsRequestEntry0.setSource("my-lambda-function");
putEventsRequestEntry0.setDetailType("my-lambda-event");
putEventsRequestEntry0.setDetail("{\"lambda-source\":\"sqs\"}");
PutEventsRequest putEventsRequest = new PutEventsRequest();
putEventsRequest.setEntries(Collections.singletonList(putEventsRequestEntry0));
// send the event(s) to EventBridge
PutEventsResult putEventsResult = eventsClient.putEvents(putEventsRequest);
try {
logger.info("Put Events Result: {}", putEventsResult);
} catch(Exception e) {
e.getStackTrace();
}
return "success";
}
}
```
------
#### [ Python ]
Tambahkan dependensi berikut ke file requirements.txt Anda:
```
aws-xray-sdk==2.4.3
```
```
import boto3
from aws_xray_sdk.core import xray_recorder
from aws_xray_sdk.core import patch_all
# apply the XRay handler to all clients.
patch_all()
client = boto3.client('events')
def lambda_handler(event, context):
response = client.put_events(
Entries=[
{
'Source': 'foo',
'DetailType': 'foo',
'Detail': '{\"foo\": \"foo\"}'
},
]
)
return response
```
------
#### [ Go ]
```
package main
import (
"context"
"github.com/aws/aws-lambda-go/lambda"
"github.com/aws/aws-lambda-go/events"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-xray-sdk-go/xray"
"github.com/aws/aws-sdk-go/service/eventbridge"
"fmt"
)
var client = eventbridge.New(session.New())
func main() {
//Wrap the eventbridge client in the AWS XRay tracer
xray.AWS(client.Client)
lambda.Start(handleRequest)
}
func handleRequest(ctx context.Context, event events.SQSEvent) (string, error) {
_, err := callEventBridge(ctx)
if err != nil {
return "ERROR", err
}
return "success", nil
}
func callEventBridge(ctx context.Context) (string, error) {
entries := make([]*eventbridge.PutEventsRequestEntry, 1)
detail := "{ \"foo\": \"foo\"}"
detailType := "foo"
source := "foo"
entries[0] = &eventbridge.PutEventsRequestEntry{
Detail: &detail,
DetailType: &detailType,
Source: &source,
}
input := &eventbridge.PutEventsInput{
Entries: entries,
}
// Example sending a request using the PutEventsRequest method.
resp, err := client.PutEventsWithContext(ctx, input)
success := "yes"
if err == nil { // resp is now filled
success = "no"
fmt.Println(resp)
}
return success, err
}
```
------
#### [ Node.js ]
```
const AWSXRay = require('aws-xray-sdk')
//Wrap the aws-sdk client in the AWS XRay tracer
const AWS = AWSXRay.captureAWS(require('aws-sdk'))
const eventBridge = new AWS.EventBridge()
exports.handler = async (event) => {
let myDetail = { "name": "Alice" }
const myEvent = {
Entries: [{
Detail: JSON.stringify({ myDetail }),
DetailType: 'myDetailType',
Source: 'myApplication',
Time: new Date
}]
}
// Send to EventBridge
const result = await eventBridge.putEvents(myEvent).promise()
// Log the result
console.log('Result: ', JSON.stringify(result, null, 2))
}
```
------
#### [ C\$1 ]
Tambahkan paket X-Ray berikut untuk dependensi C \$1 Anda:
```
```
```
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Amazon;
using Amazon.Util;
using Amazon.Lambda;
using Amazon.Lambda.Model;
using Amazon.Lambda.Core;
using Amazon.EventBridge;
using Amazon.EventBridge.Model;
using Amazon.Lambda.SQSEvents;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.AwsSdk;
using Newtonsoft.Json;
using Newtonsoft.Json.Serialization;
[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.Json.JsonSerializer))]
namespace blankCsharp
{
public class Function
{
private static AmazonEventBridgeClient eventClient;
static Function() {
initialize();
}
static async void initialize() {
//Wrap the AWS SDK clients in the AWS XRay tracer
AWSSDKHandler.RegisterXRayForAllServices();
eventClient = new AmazonEventBridgeClient();
}
public async Task FunctionHandler(SQSEvent invocationEvent, ILambdaContext context)
{
PutEventsResponse response;
try
{
response = await callEventBridge();
}
catch (AmazonLambdaException ex)
{
throw ex;
}
return response;
}
public static async Task callEventBridge()
{
var request = new PutEventsRequest();
var entry = new PutEventsRequestEntry();
entry.DetailType = "foo";
entry.Source = "foo";
entry.Detail = "{\"instance_id\":\"A\"}";
List entries = new List();
entries.Add(entry);
request.Entries = entries;
var response = await eventClient.PutEventsAsync(request);
return response;
}
}
}
```
------
# AWS Lambda dan AWS X-Ray
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Anda dapat menggunakan AWS X-Ray untuk melacak AWS Lambda fungsi Anda. Lambda menjalankan [daemon X-Ray](xray-daemon.md) dan merekam segmen dengan detail tentang memanggil dan menjalankan fungsi. Untuk instrumentasi selengkapnya, Anda dapat memaketkan SDK X-Ray dengan fungsi Anda untuk mencatat panggilan keluar dan menambahkan anotasi dan metadata.
Jika fungsi Lambda Anda disebut oleh layanan instrumen lain, Lambda menelusuri permintaan yang telah dijadikan sampel tanpa konfigurasi tambahan. Layanan upstream dapat berupa aplikasi web berinstrumen atau fungsi Lambda lain. Layanan Anda dapat menjalankan fungsi secara langsung dengan klien AWS SDK yang diinstrumentasi, atau dengan memanggil API Gateway API dengan klien HTTP yang diinstrumentasi.
AWS X-Ray mendukung penelusuran aplikasi berbasis peristiwa menggunakan dan Amazon AWS Lambda SQS. Gunakan CloudWatch konsol untuk melihat tampilan tersambung dari setiap permintaan saat antri dengan Amazon SQS dan diproses oleh fungsi Lambda hilir. Jejak dari produsen pesan hulu secara otomatis ditautkan ke jejak dari node konsumen Lambda hilir, menciptakan end-to-end tampilan aplikasi. Untuk informasi selengkapnya, lihat [melacak aplikasi berbasis peristiwa](xray-tracelinking.md).
**catatan**
Jika Anda mengaktifkan jejak untuk fungsi Lambda hilir, Anda juga harus mengaktifkan jejak untuk fungsi Lambda root yang memanggil fungsi hilir agar fungsi hilir menghasilkan jejak.
Jika fungsi Lambda Anda berjalan sesuai jadwal, atau dipanggil oleh layanan yang tidak diinstrumentasi, Anda dapat mengonfigurasi Lambda untuk sampel dan mencatat panggilan dengan penelusuran aktif.
**Untuk mengkonfigurasi integrasi X-Ray pada suatu AWS Lambda fungsi**
1. Buka [konsol AWS Lambda](https://console.aws.amazon.com/lambda).
1. Pilih **Fungsi** dari bar navigasi kiri.
1. Pilih fungsi Anda.
1. Pada tab **Konfigurasi**, gulir ke bawah ke kartu **alat pemantauan tambahan**. Anda juga dapat menemukan kartu ini dengan memilih **alat Pemantauan dan operasi** di panel navigasi kiri.
1. Pilih **Edit**.
1. Di bagian **X-Ray AWS **, aktifkan **Penelusuran aktif**.
Saat waktu aktif dengan SDK X-Ray yang sesuai, Lambda juga menjalankan daemon X-Ray.
**X-Ray SDKs pada Lambda**
+ **X-Ray SDK for Go** – Go 1.7 dan waktu aktif yang lebih baru
+ **X-Ray SDK for Java** – Waktu aktif Java 8
+ **X-Ray SDK untuk Node.js** – Node.js 4.3 dan waktu aktif yang lebih baru
+ **X-Ray SDK for Python** – Python 2.7, Python 3.6, dan waktu aktif yang lebih baru
+ **X-Ray SDK for .NET** – .NET Core 2.0 dan waktu aktif yang lebih baru
Untuk menggunakan SDK X-Ray pada Lambda, paketkan dengan kode fungsi Anda setiap kali Anda membuat versi baru. Anda dapat menginstrumen fungsi Lambda Anda dengan metode yang sama yang Anda gunakan untuk aplikasi instrumen yang berjalan pada layanan lain. Perbedaan utamanya adalah Anda tidak menggunakan SDK untuk instrumen permintaan masuk, membuat keputusan pengambilan sampel, dan membuat segmen.
Perbedaan lain antara menginstrumentasi fungsi Lambda dan aplikasi web adalah bahwa segmen yang dibuat dan dikirim Lambda ke X-Ray tidak dapat dimodifikasi oleh kode fungsi Anda. Anda dapat membuat subsegmen dan mencatat anotasi dan metadata di dalamnya, namun Anda tidak dapat menambahkan anotasi dan metadata ke segmen induk.
Untuk informasi selengkapnya, lihat [Menggunakan X-Ray AWS](https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html) di *Panduan Developer AWS Lambda *.
# AWS Step Functions dan AWS X-Ray
AWS X-Ray terintegrasi dengan AWS Step Functions untuk melacak dan menganalisis permintaan untuk Step Functions. Anda dapat memvisualisasikan komponen status mesin , mengidentifikasi hambatan performa, dan memecahkan masalah permintaan yang mengakibatkan kesalahan. Untuk informasi selengkapnya, lihat [AWS X-Ray dan Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-xray-tracing.html) di Panduan AWS Step Functions Pengembang.
**Untuk mengaktifkan penelusuran X-Ray saat membuat mesin status baru**
1. Buka konsol Step Functions di [https://console.aws.amazon.com/states/](https://console.aws.amazon.com/states/).
1. Pilih **Buat mesin status**.
1. Pada halaman **Tentukan mesin status**, pilih salah satu **Penulis dengan potongan kode** atau **Mulai dengan templat**. Jika Anda memilih untuk menjalankan sampel proyek, Anda tidak dapat mengaktifkan Penelusuran X-Ray selama pembuatan . Sebaliknya, mengaktifkan Penelusuran X-Ray setelah Andamembuat mesin keadaan.
1. Pilih **Berikutnya**.
1. Pada halaman **Tentukan Detail**, konfigurasikan mesin status Anda.
1. Pilih **Aktifkan Penelusuran X-Ray**.
**Cara mengaktifkan penelusuran X-Ray di mesin status yang ada**
1. Di konsol Step Functions, pilih mesin status yang Anda ingin mengaktifkan penelusuran.
1. Pilih **Edit**.
1. Pilih **Aktifkan Penelusuran X-Ray**.
1. (Opsional) Buat peran baru secara otomatis untuk mesin status Anda untuk menyertakan izin X-Ray dengan memilih **Buat peran baru** dari jendela Izin.
![\[Permissions section with options to create a new role, choose existing, or enter ARN.\]](http://docs.aws.amazon.com/id_id/xray/latest/devguide/images/stepfunctions-permissions.png)
1. Pilih **Simpan**.
**catatan**
Saat Anda membuat mesin status baru, mesin ini akan dilacak secara otomatis jika permintaan diambil sampelnya dan penelusuran diaktifkan di layanan upstream seperti Amazon API Gateway atau. AWS Lambda Untuk mesin status yang ada yang tidak dikonfigurasi melalui konsol, misalnya melalui CloudFormation templat, periksa apakah Anda memiliki kebijakan IAM yang memberikan izin yang cukup untuk mengaktifkan jejak X-Ray.