Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menambahkan atribut khusus

CloudWatch Sinyal Aplikasi digunakan OpenTelemetry untuk instrumen otomatis aplikasi Anda dan mengumpulkan rentang dari pustaka populer dalam berbagai bahasa, sepertiJava,, dan banyak lagi. Python

Instrumentasi otomatis menangkap informasi, seperti kueri basis data, permintaan HTTP, akses cache, dan panggilan layanan eksternal, yang memungkinkan Anda memecahkan masalah kinerja aplikasi.

Anda dapat menambahkan instrumentasi khusus untuk memperkaya rentang dengan data khusus bisnis atau informasi lain yang ingin Anda tangkap. Data ini dapat direkam sebagai atribut khusus atau peristiwa rentang, memberikan wawasan yang disesuaikan dengan kebutuhan pemecahan masalah Anda.

Atribut kustom

Anda dapat menambahkan atribut terkait bisnis atau atribut lainnya ke rentang Anda dalam semua bahasa yang OpenTelemetry mendukung. Berikut ini adalah cuplikan Java kode yang menambahkan id pesanan dan detail pelanggan ke rentang.

import io.opentelemetry.api.trace.Span;

public class OrderProcessor {

    public void processOrder() {
        Span span = Span.current();
        span.setAttribute("order.id", "123456");
        span.setAttribute("customer.name", "John Doe");
        span.setAttribute("customer.id", "4343dfdd");

        // Your order processing logic here
        System.out.println("Order processed with custom attributes");
    }
}

Setelah atribut ini ditambahkan ke rentang, mereka menjadi tersedia untuk mencari dan menganalisis di editor visual Transaction Search.

Acara rentang

Peristiwa rentang biasanya digunakan untuk menunjukkan titik waktu tunggal yang bermakna selama durasi rentang. Pengecualian diambil secara otomatis sebagai peristiwa rentang melalui instrumentasi otomatis, tetapi Anda juga dapat menambahkan acara bisnis khusus, seperti status pembayaran atau pengabaian keranjang. Untuk informasi selengkapnya, lihat Acara rentang di OpenTelemetry situs web.

Anda dapat menyematkan peristiwa rentang ke rentang Anda dalam semua bahasa Sinyal CloudWatch Aplikasi dan OpenTelemetry dukungan. Berikut ini adalah cuplikan Java kode untuk menambahkan acara khusus ke rentang.

import io.opentelemetry.api.trace.Span;

public class OrderProcessor {

    public void bookOrder() {
        Span span = Span.current();

        // Add a booking started event
        span.addEvent("booking started");
        
        // Add a payment succeeded event or failed event 
        span.addEvent("booking failed");
    }
}

Prasyarat untuk agen CloudWatch

Saat menggunakan CloudWatch agen untuk memancarkan peristiwa rentang ke X-Ray, Anda harus menyalakan `transit_spans_in_otlp_format` bendera dalam konfigurasi Anda.

{
  "traces": {
    ...
    "transit_spans_in_otlp_format": true
    ...
  }
}

Setelah Anda menambahkan peristiwa ini, mereka akan tersedia di editor visual Transaction Search.

CloudWatch Kueri log

Anda dapat melakukan kueri peristiwa rentang di CloudWatch Log untuk melihat wawasan lanjutan. Contoh perintah kueri berikut menunjukkan cara menganalisis pengecualian yang dilemparkan oleh aplikasi Anda:

fields jsonparse(@message) as js
| unnest js.events into event 
| filter event.name = "exception"
| display event.attributes.`exception.stacktrace`
   

fields jsonparse(@message) as js
| unnest js.events into event 
| filter event.name = "exception"
| stats count() by event.attributes.`exception.type`