Spesifikasi OpenTelemetry mendefinisikan atribut dan sumber daya yang harus dimiliki oleh sebuah span untuk setiap jenis plugin. Namun, guna mengurangi volume data yang dilaporkan, agen Application Real-Time Monitoring Service (ARMS) secara default tidak merekam semua atribut tersebut dalam span. Jika Anda mengaktifkan sakelar Record OTel Spec conventional attributes pada halaman Custom Configuration, agen ARMS akan menambahkan atribut yang sesuai ke dalam span untuk setiap framework.
Atribut umum
Nama atribut | Makna | Contoh | Catatan |
rpc.type | Tipe panggilan dari rentang saat ini. | 0, 40, 60 | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
serviceType | Tipe layanan dari rentang saat ini. | 1000, 1010 | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
ali.trace.flag | Identifikasi produk observabilitas Alibaba Cloud yang mengumpulkan dan melaporkan data jejak.
| arms | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
component.name | Nama komponen yang sesuai dengan span saat ini. | mysql, http | Untuk semua nilai yang mungkin, lihat Metrik Pemantauan Aplikasi. |
hasInternalSpan | Menunjukkan apakah span saat ini memiliki span dengan `spanKind` bernilai `Internal`. | 1 | Atribut ini hanya disertakan dalam LocalRootSpan. |
otel.scope.name | Nama plugin yang menghasilkan span saat ini. | io.opentelemetry.jdbc | - |
otel.scope.version | Nomor versi plugin yang menghasilkan span saat ini. | 1.28.0-SNAPSHOT | - |
root.service.id | ID aplikasi ARMS pertama yang dilewati oleh jejak. | aokcd***@b57c445****** | - |
sample.service.id | ID aplikasi yang menentukan apakah jejak diambil sampelnya dan dilaporkan. | aokcd***@b57c445****** | ARMS mendukung berbagai metode pengambilan sampel. Aplikasi yang menentukan pengambilan sampel belum tentu selalu aplikasi entri. Untuk informasi lebih lanjut, lihat Mode pengambilan sampel jejak (untuk versi agen 3.2.8 dan yang lebih baru). |
sample.reason | Kebijakan pengambilan sampel yang terpicu saat keputusan untuk mengambil sampel jejak dibuat. | s4 | Untuk informasi lebih lanjut, lihat Tag pengambilan sampel. |
ppid | ID aplikasi hulu. | aokcd***@b57c445****** | - |
thread.name | Nama thread. | http-nio-8080-exec-162 | - |
thread.id | ID thread. | 12783 | - |
trace.protocol.type | Protokol propagasi konteks jejak untuk jejak saat ini. | EagleEye, W3C | Atribut ini hanya disertakan dalam LocalRootSpan. |
Sumber daya umum
Nama sumber daya | Makna | Contoh | Catatan |
host.name | Hostname mesin tempat aplikasi dijalankan. | mall-gateway-54c647a51d-db78a | Ditambahkan pada versi 4.5.0. |
agentVersion | Versi agen. | 4.5.0_3d5f5f7 | - |
acs.arms.service.id | ID layanan ARMS. | gauui7wh2@8a8763fbd23c898cd52*** | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
acs.arms.workspace | Nama ruang kerja ARMS. | default-cms-1324351***-cn-hangzhou | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
arms.appId | ID aplikasi ARMS. | gauui7wh2@8a8763fbd23c898cd52*** | Field ini digunakan secara internal oleh ARMS dan dapat berubah sewaktu-waktu. Anda dapat mengabaikan isinya. |
clusterId | ID kluster ACK. | c98cd52967df89a8e9*** | Hanya ada di lingkungan ACK. Nilainya diambil dari variabel lingkungan KUBERNETES_CLUSTER_ID. |
ipv4 | Alamat IP aplikasi. | 127.0.0.1 | - |
namespace | Namespace kluster. | default | Hanya ada di lingkungan Kubernetes. Nilainya diambil dari variabel lingkungan KUBERNETES_POD_NAMESPACE. |
workloadKind | Jenis beban kerja. | Deployment | Hanya ada di lingkungan Kubernetes. Nilainya diambil dari variabel lingkungan ARMS_WORKLOADKIND. |
workloadName | Nama beban kerja. | mall-gateway | Hanya ada di lingkungan Kubernetes. Nilainya diambil dari variabel lingkungan ARMS_WORKLOADNAME. |
Atribut khusus untuk span HTTP
Jenis atribut | Nama atribut | Makna | Contoh |
Atribut umum | http.method | Nama metode HTTP. | GET, POST |
http.status_code | Kode status HTTP. | 200, 404, 500 | |
status | Kode status HTTP yang telah dikonvergen. | 200, 4xx, 5xx | |
Atribut span server HTTP | http.path | Path permintaan HTTP. | /api/v1/user |
http.route | Rute permintaan HTTP. | /api/v1/user `http.route` berbeda dari `http.path`. Sebagai contoh, dalam aplikasi SpringMVC yang khas, jika antarmuka HTTP dideklarasikan dengan parameter jalur seperti `/api/v1/{userId}`, maka `http.route` mencatat `/api/v1/{userId}` sedangkan `http.path` mencatat jalur permintaan aktual. | |
http.params | Parameter permintaan HTTP. Ini adalah konten setelah | userId=123 | |
Atribut span klien HTTP | destId | Nama domain dan nomor port permintaan HTTP. | 127.0.0.1 |
endpoint | Path permintaan HTTP. | /api/v1/user |
Atribut khusus untuk panggilan RPC
Jenis atribut | Nama atribut | Makna | Contoh |
Atribut umum | rpc.system | Framework RPC. | Dubbo, gRPC |
rpc.service | Nama layanan panggilan RPC. | com.test.TestService | |
rpc.method | Nama metode panggilan RPC. | sayHello | |
destId | Alamat peer. | 127.0.0.1:20880 |
Atribut khusus untuk tugas terjadwal
Jenis atribut | Nama atribut | Makna | Contoh |
Atribut umum | job.system | Framework tugas terjadwal. | ShchedulerX, XXLJob |
job.id | ID tugas. | 2847 | |
job.name | Nama tugas. | testJob | |
job.result.status | Status eksekusi tugas. | success |
Atribut khusus untuk panggilan pesan
Jenis atribut | Nama atribut | Makna | Contoh |
Atribut umum | messaging.system | Framework pesan. | RocketMQ, Kafka |
messaging.operation | Tindakan pemrosesan pesan. | publish, receive, process | |
messaging.message.payload_size_bytes | Ukuran pesan. | 137 | |
messaging.destination.name | Topik pesan. | user_order | |
destId | Alamat broker pesan. | rmq-********-vpc.cn-beijing.rmq.aliyuncs.com:8080 | |
endpoint | ${destId} + @ + ${messaging.destination.name} | rmq-********-vpc.cn-beijing.rmq.aliyuncs.com:8080@user_order | |
Atribut khusus RocketMQ | messaging.consume.delay_ms | Latensi konsumsi pesan. Atribut ini hanya didukung oleh RocketMQ. | 128 |
Atribut khusus Kafka | messaging.kafka.destination.partition | Partisi tempat pesan Kafka berada. | 5 |
messaging.kafka.message.offset | Offset pesan Kafka dalam partisi. | 42 | |
messaging.kafka.message.key | Kunci pesan Kafka. | mykey |
Database/NoSQL
Jenis atribut | Nama atribut | Makna | Contoh |
Atribut umum | db.name | Nama basis data. Nilai ini diurai dari string koneksi lengkap. Jika string koneksi tidak berisi informasi ini, field akan kosong. | test |
net.peer.name | Nama domain dan port dari string koneksi database. | *****.mysql.rds.aliyuncs.com:3306 | |
sql | Pernyataan basis data. | SELECT * FROM user WHERE user_id=? | |
db.statement.id | ID terenkripsi 16 karakter dari pernyataan database. | 5a620e8cf06156a5 | |
destId | Nama database. Isinya sama dengan `db.name`. Ini merupakan atribut redundan untuk kompatibilitas dengan berbagai skenario kueri dan akan dihapus pada rilis mendatang. | test | |
endpoint | String koneksi database. Isinya sama dengan `net.peer.name`. Ini merupakan atribut redundan untuk kompatibilitas dengan berbagai skenario kueri dan akan dihapus pada rilis mendatang. | *****.mysql.rds.aliyuncs.com:3306 | |
out.ids | String koneksi database. Isinya sama dengan `net.peer.name`. Ini merupakan atribut redundan untuk kompatibilitas dengan berbagai skenario kueri dan akan dihapus pada rilis mendatang. | *****.mysql.rds.aliyuncs.com:3306 | |
opType | Tipe operasi basis data. | SELECT | |
response.size | Ukuran tanggapan kueri database, dalam byte. | 54 | |
Atribut MongoDB | db.mongodb.collection | Nama koleksi untuk operasi MongoDB. | user |
Atribut Redis | redis.command.key | Kunci yang diakses di Redis. | key |