Langkah-langkah pemecahan masalah untuk data yang tidak muncul di konsol - Managed Service for OpenTelemetry

Jika data tidak muncul di konsol Managed Service for OpenTelemetry setelah Anda melaporkan data dari client open source, ikuti bagian-bagian berikut secara berurutan. Setiap bagian sesuai dengan tahapan dalam pipa data tempat data dapat hilang.

Data mengalir melalui tahapan-tahapan berikut sebelum muncul di konsol:

Client SDK atau agent mengirim telemetri melalui HTTP atau gRPC.
Jaringan mengantarkan permintaan ke titik akhir.
Ingestion endpoint menerima atau menolak permintaan.
Storage backend (Simple Log Service) menyimpan data secara persisten.
Console menampilkan data.

Kegagalan pada tahapan mana pun mencegah data muncul. Mulailah dengan konektivitas jaringan, lalu periksa pengaturan ingestion, penyimpanan, dan error spesifik protokol.

Periksa konektivitas jaringan

Identifikasi apakah kode Anda menggunakan titik akhir pribadi atau titik akhir publik. Titik akhir pribadi harus berada dalam virtual private cloud (VPC) yang sama dengan server yang melaporkan data. Pelaporan lintas wilayah tidak didukung.
Dari lingkungan pelaporan, jalankan curl atau telnet untuk memverifikasi bahwa titik akhir dan port dapat dijangkau. Contoh untuk titik akhir gRPC di wilayah China (Hangzhou): Jika koneksi gagal, periksa pengaturan security group Elastic Compute Service (ECS) Anda. Untuk informasi selengkapnya, lihat Persiapan penggunaan Managed Service for OpenTelemetry dan Ikhtisar security group.
- Success: Terminal menampilkan pesan Connected.
- Failure: Terminal tetap menampilkan Trying [IP] atau mengembalikan Unable to connect to remote host.
```
   telnet <endpoint> <port>
```
```
   telnet tracing-analysis-dc-hz.aliyuncs.com 8090
```

Periksa pengaturan ingestion

Ingestion data dapat dinonaktifkan di tingkat kluster, tingkat aplikasi, atau keduanya. Ingestion juga berhenti ketika volume data yang dilaporkan mencapai kuota yang dikonfigurasi.

Konfigurasi ingestion global

Di panel navigasi sebelah kiri konsol Managed Service for OpenTelemetry, pilih System Configuration > Cluster Configuration. Pada bagian Ingestion Configuration, pastikan bahwa Enable All atau Enable by Default telah dipilih.

Kuota

Pada halaman Cluster Configuration yang sama, gulir ke bagian Quota Configuration. Verifikasi bahwa jumlah data yang dilaporkan belum mencapai kuota yang dikonfigurasi. Jika sudah, tingkatkan kuotanya.

Pengaturan pengambilan data tingkat aplikasi

Di halaman Applications, klik nama aplikasi yang ingin Anda kelola. Di panel navigasi sebelah kiri halaman detail aplikasi, klik Application Settings. Di tab Custom Configuration, periksa apakah opsi Enable atau Don't Set dipilih sebagai Capture Data di bagian Data Capturing Settings.

Application-level data capturing settings

Penting

Jika Enable All atau Disable All dipilih dalam Ingestion Configuration global, pengaturan tingkat aplikasi tidak berlaku. Pengaturan global memiliki prioritas lebih tinggi. Jika Don't Set dipilih untuk suatu aplikasi, aplikasi tersebut mewarisi pengaturan tingkat kluster.

Periksa sumber data Simple Log Service

Managed Service for OpenTelemetry menyimpan data dalam proyek Simple Log Service di akun Anda. Jika jumlah proyek Simple Log Service mencapai batas maksimum, pelaporan data gagal.

Untuk mengatasi masalah ini:

Lepaskan proyek Simple Log Service yang tidak lagi digunakan.
Kirim tiket untuk menambah batas proyek.

Periksa status tugas pemantauan

Jika konsol menunjukkan bahwa tugas pemantauan tidak normal atau tidak diaktifkan, kirim tiket.

Pemecahan masalah kegagalan pelaporan HTTP

Kode status HTTP

Periksa kode status HTTP yang dikembalikan di konsol atau file log, lalu ikuti resolusi yang sesuai.

Status code	Arti	Penyebab	Resolusi
400	Format data tidak didukung	Nilai header `Content-Type` harus berupa `application/json`, `application/x-thrift`, atau `Bad Request`. Penyebab umum: nilai tag berupa array JSON alih-alih string, atau rentang dikirim sebagai objek JSON alih-alih array JSON.	Perbaiki badan permintaan agar sesuai dengan format yang diperlukan.
403	Otorisasi ditolak	(1) Titik akhir atau token salah. (2) URL client Zipkin berisi `/v2/spans`.	(1) Temukan titik akhir dan token yang benar di konsol Managed Service for OpenTelemetry di bawah Cluster Configuration. (2) Hapus `/v2/spans` dari URL.
405	Kuota data terlampaui	Volume data yang dilaporkan telah mencapai batas atas yang dikonfigurasi.	Tingkatkan batas di bagian Quota Configuration pada halaman Cluster Configuration.
406	Pengumpulan kluster dinonaktifkan	Pengumpulan data kluster dinonaktifkan.	Aktifkan di bagian Ingestion Configuration pada halaman Cluster Configuration.

Kegagalan pelaporan APISIX

Jika error berikut muncul saat APISIX melaporkan data melalui OpenTelemetry:

The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.

APISIX tidak dapat melaporkan data langsung ke Managed Service for OpenTelemetry melalui OpenTelemetry. Gunakan OpenTelemetry Collector untuk meneruskan data tersebut.

Pemecahan masalah kegagalan pelaporan gRPC

Periksa kode status gRPC yang dikembalikan di konsol atau file log. Untuk daftar lengkap kode status, lihat gRPC status codes.

Timeout

Pesan error:

Failed to export spans. The request could not be executed. Full error message: timeout

Resolusi:

Periksa konektivitas jaringan (lihat Periksa konektivitas jaringan).
Tingkatkan periode timeout untuk pelaporan data dalam konfigurasi SDK atau agent Anda.

Kegagalan autentikasi (kode status gRPC 7)

Pesan error:

Failed to export spans. Server responded with gRPC status code 7. Error message:

Verifikasi bahwa nilai bidang Authentication dalam header permintaan gRPC sesuai dengan token yang ditampilkan di konsol Managed Service for OpenTelemetry.

Error SkyWalking MeterSender

Pesan error:

MeterSender : Send meters to collector fail with a grpc internal exception. org.apache.skywalking.apm.dependencies.io.grpc.StatusRuntimeException: UNIMPLEMENTED: Method not found: skywalking.v3.MeterReportService/collect

Client SkyWalking mengirim metrik ke server Managed Service for OpenTelemetry, yang tidak didukung. Nonaktifkan pelaporan metrik di client SkyWalking.

Pemecahan masalah data jejak yang tidak sesuai harapan

Agent atau SDK SkyWalking

Event framework atau middleware yang hilang

Periksa path plugin agent SkyWalking: ${agent-path}/agent-8.x/plugins. Verifikasi bahwa versi plugin sesuai dengan versi framework yang digunakan dalam aplikasi Anda. Jika plugin yang diperlukan tidak ada di direktori plugins, salin dari folder bootstrap-plugins atau optional-plugins, atau unduh dari komunitas SkyWalking.
Verifikasi bahwa hanya satu agent SkyWalking yang disambungkan ke aplikasi. Beberapa agent dapat menyebabkan konflik instrumentasi.

Jejak terputus

Periksa apakah pelacakan asinkron sedang digunakan. Untuk informasi tentang penyelesaian jejak terputus dalam pelacakan asinkron, lihat Trace Cross Thread.

Jejak lebih pendek dari yang diharapkan

Tingkatkan jumlah maksimum rentang yang dapat dilaporkan oleh agent SkyWalking dengan mengubah nilai collector.agent.service_graph.batch_size dalam file ${agent-path}/agent-8.x/config/agent.config.

Agent atau SDK OpenTelemetry

Jejak terputus

Periksa apakah pelacakan asinkron sedang digunakan. Untuk menyelesaikan jejak terputus dalam pelacakan asinkron:

Perbarui versi OpenTelemetry.
Gunakan API SpanLinks untuk menghubungkan rentang antar jejak.
Tentukan suatu rentang sebagai rentang induk dari rentang lainnya.
Teruskan konteks jejak secara eksplisit melalui propagasi konteks.