Managed Service for OpenTelemetry menerima data jejak dari klien OpenTelemetry, Jaeger, Zipkin, dan SkyWalking. Panduan ini memandu Anda melalui aktivasi layanan, pengambilan token otentikasi, serta menghubungkan aplikasi agar dapat mulai mengirimkan jejak.
Prasyarat
Akun Alibaba Cloud. Jika belum memilikinya, buat akun.
Aktifkan Managed Service for OpenTelemetry di halaman produk.
Ambil token otentikasi Anda
Setelah mengaktifkan layanan, ambil token untuk mengotentikasi data jejak yang dikirim oleh aplikasi Anda. Langkah-langkahnya berbeda antara Konsol baru dan lama.
Konsol baru
Masuk ke Konsol Managed Service for OpenTelemetry.
Di panel navigasi sebelah kiri, klik Integration Center.
Pada bagian Open Source Frameworks, klik kartu OpenTelemetry atau kartu klien yang ingin Anda gunakan.
Di panel yang muncul, salin token Anda.
Di panel yang sama, lengkapi konfigurasi berikut: pilih wilayah, misalnya China (Hangzhou). Untuk metode koneksi, pilih titik akhir pribadi jika aplikasi dideploy di lingkungan produksi Alibaba Cloud, atau titik akhir publik untuk aplikasi lainnya. Untuk metode pelaporan, pilih HTTP (direkomendasikan) atau gRPC. Setelah konfigurasi selesai, URL titik akhir akan tersedia di bagian Access point information. Misalnya, jika Anda melaporkan data melalui HTTP, salin titik akhir pribadi tersebut—URL-nya sudah mencakup token.
Konsol lama
Masuk ke Konsol Managed Service for OpenTelemetry.
Di panel navigasi sebelah kiri, klik Cluster Configurations, lalu klik tab Access point information.
Pilih wilayah di bagian atas halaman, lalu aktifkan sakelar Show Token di bagian Cluster Information.
Di bagian Client, pilih OpenTelemetry atau klien yang ingin Anda gunakan.
Salin titik akhir dari kolom Related Information.
Sebagai contoh untuk OpenTelemetry, kolom Related Information menampilkan informasi titik akses berikut:
Laporkan data melalui HTTP: disediakan titik akhir publik dan titik akhir pribadi. URL-nya dalam format berikut:
http://tracing-analysis-dc-{region}.aliyuncs.com/adapt_{token}/api/otlp/traces.Laporkan data melalui gRPC: disediakan titik akhir publik (port 8090), titik akhir pribadi (port 8090), dan token otentikasi.
Tips di bagian bawah: Jika Anda menggunakan Golang untuk melaporkan data, hapus
http://dari titik akhir.
Penggunaan token berdasarkan protokol
Cara aplikasi Anda mengirimkan token bergantung pada protokol:
Protokol berbasis HTTP (OpenTelemetry HTTP, Jaeger HTTP, Zipkin HTTP): Token tertanam dalam URL titik akhir.
Protokol berbasis gRPC (OpenTelemetry gRPC, Jaeger gRPC, SkyWalking gRPC): Atur
Authentication=<token>dalammetadatagRPC.
Hubungkan aplikasi Anda
Pilih titik akhir
Setiap wilayah menyediakan dua jenis titik akhir:
Titik akhir pribadi: Untuk aplikasi yang dideploy di lingkungan produksi Alibaba Cloud.
Titik akhir publik: Untuk aplikasi yang berjalan di luar Alibaba Cloud.
Protokol dan port yang didukung
Semua protokol menggunakan domain titik akhir yang sama. Nomor port dan path URL membedakan setiap protokol.
| Port | Protokol | URL Path |
|---|---|---|
| 8090 | OpenTelemetry gRPC | N/A |
| 80 | OpenTelemetry HTTP | /api/otlp/traces |
| 80 | Jaeger HTTP | /api/traces |
| 80 | Jaeger Remote Sampling | /api/sampling |
| 80 | Zipkin HTTP v1 | /api/v1/spans |
| 80 | Zipkin HTTP v2 | /api/v2/spans |
| 443 | OpenTelemetry HTTPS | /api/otlp/traces |
| 443 | Jaeger HTTPS | /api/traces |
| 443 | Jaeger Remote Sampling (HTTPS) | /api/sampling |
| 443 | Zipkin HTTPS v1 | /api/v1/spans |
| 443 | Zipkin HTTPS v2 | /api/v2/spans |
| 1883 | Jaeger gRPC | N/A |
| 1883 | SkyWalking gRPC | N/A |
| 8000 | SkyWalking v8 gRPC | N/A |
Wilayah dan titik akhir
Untuk aplikasi yang dideploy di lingkungan produksi Alibaba Cloud, gunakan titik akhir pribadi. Jika tidak, gunakan titik akhir publik.
| Wilayah | ID Wilayah | Titik akhir pribadi | Titik akhir publik |
|---|---|---|---|
| China (Hangzhou) | cn-hangzhou | tracing-analysis-dc-hz-internal.aliyuncs.com | tracing-analysis-dc-hz.aliyuncs.com |
| China (Shanghai) | cn-shanghai | tracing-analysis-dc-sh-internal.aliyuncs.com | tracing-analysis-dc-sh.aliyuncs.com |
| China (Qingdao) | cn-qingdao | tracing-analysis-dc-qd-internal.aliyuncs.com | tracing-analysis-dc-qd.aliyuncs.com |
| China (Beijing) | cn-beijing | tracing-analysis-dc-bj-internal.aliyuncs.com | tracing-analysis-dc-bj.aliyuncs.com |
| China (Zhangjiakou) | cn-zhangjiakou | tracing-analysis-dc-zb-internal.aliyuncs.com | tracing-analysis-dc-zb.aliyuncs.com |
| China (Hohhot) | cn-huhehaote | tracing-cn-huhehaote-internal.arms.aliyuncs.com | tracing-cn-huhehaote.arms.aliyuncs.com |
| China (Ulanqab) | cn-wulanchabu | tracing-cn-wulanchabu-internal.arms.aliyuncs.com | tracing-cn-wulanchabu.arms.aliyuncs.com |
| China (Shenzhen) | cn-shenzhen | tracing-analysis-dc-sz-internal.aliyuncs.com | tracing-analysis-dc-sz.aliyuncs.com |
| China (Heyuan) | cn-heyuan | tracing-cn-heyuan-internal.arms.aliyuncs.com | tracing-cn-heyuan.arms.aliyuncs.com |
| China (Guangzhou) | cn-guangzhou | tracing-cn-guangzhou-internal.arms.aliyuncs.com | tracing-cn-guangzhou.arms.aliyuncs.com |
| China (Chengdu) | cn-chengdu | tracing-cn-chengdu-internal.arms.aliyuncs.com | tracing-cn-chengdu.arms.aliyuncs.com |
| China (Hong Kong) | cn-hongkong | tracing-analysis-dc-hk-internal.aliyuncs.com | tracing-analysis-dc-hk.aliyuncs.com |
| Jepang (Tokyo) | ap-northeast-1 | tracing-analysis-dc-jp-internal.aliyuncs.com | tracing-analysis-dc-jp.aliyuncs.com |
| Singapura | ap-southeast-1 | tracing-analysis-dc-sg-internal.aliyuncs.com | tracing-analysis-dc-sg.aliyuncs.com |
| Malaysia (Kuala Lumpur) | ap-southeast-3 | tracing-ap-southeast-3-internal.arms.aliyuncs.com | tracing-ap-southeast-3.arms.aliyuncs.com |
| Indonesia (Jakarta) | ap-southeast-5 | tracing-analysis-dc-indonesia-internal.aliyuncs.com | tracing-analysis-dc-indonesia.aliyuncs.com |
| Jerman (Frankfurt) | eu-central-1 | tracing-analysis-dc-frankfurt-internal.aliyuncs.com | tracing-analysis-dc-frankfurt.aliyuncs.com |
| Inggris (London) | eu-west-1 | tracing-analysis-dc-lundun-internal.aliyuncs.com | tracing-analysis-dc-lundun.aliyuncs.com |
| AS (Silicon Valley) | us-west-1 | tracing-analysis-dc-usw-internal.aliyuncs.com | tracing-analysis-dc-usw.aliyuncs.com |
| AS (Virginia) | us-east-1 | tracing-us-east-1-internal.arms.aliyuncs.com | tracing-us-east-1.arms.aliyuncs.com |
| SAU (Riyadh - Partner Region) | me-central-1 | tracing-me-central-1-internal.arms.aliyuncs.com | tracing-me-central-1.arms.aliyuncs.com |
Persyaratan jaringan untuk aplikasi non-Alibaba Cloud
Jika aplikasi Anda berjalan di luar Alibaba Cloud, pastikan port dan domain berikut dapat diakses dari jaringan Anda sebelum mengirimkan data jejak.
Port yang harus diizinkan:
| Port | Protokol |
|---|---|
| 8090 | OpenTelemetry gRPC |
| 80 | OpenTelemetry HTTP, Jaeger HTTP |
| 443 | OpenTelemetry HTTPS, Jaeger HTTPS, Zipkin HTTPS |
| 1883 | Jaeger gRPC, SkyWalking gRPC |
| 8000 | SkyWalking v8 gRPC |
Domain yang harus diizinkan: Gunakan domain titik akhir publik untuk wilayah Anda dari tabel Wilayah dan Titik Akhir di atas.