Hubungkan sumber telemetri

Hubungkan sumber telemetri untuk membumikan jawaban agen Anda dengan sinyal Anda sendiri, bukan pengetahuan umum. Setelah Anda menyiapkan konektor telemetri, ajukan pertanyaan investigasi dengan bahasa yang sederhana. Agen menjalankan kueri dan menjawab dengan angka nyata.

Tutorial ini membahas konektor dalam kategori Telemetry . Azure Data Explorer menggunakan jalur Azure MCP Kusto. Konektor telemetri pihak ketiga juga muncul di tab Telemetry , bahkan ketika mereka menggunakan MCP di balik layar. Pengaturan menggunakan wizard yang sama seperti setiap konektor yang dikelola, jadi artikel ini berfokus pada detail telemetri: bagaimana sumber mengautentikasi, operasi mana yang diaktifkan, dan cara memvalidasi dengan query.

Important

Konektor terkelola sedang dalam preview. Ketersediaan konektor, field, dan operasi dapat berubah.

Prasyarat

  • Agen SRE yang berjalan dan akses ke sre.azure.com.
  • Izin untuk mengonfigurasi konektor pada agen.
  • Akses baca ke sumber telemetri yang Anda hubungkan. Untuk sumber Azure, identitas yang mengizinkan koneksi setidaknya perlu akses baca ke sumber daya target.

Jika Anda belum pernah mengatur konektor sebelumnya, mulailah dengan Atur konektor terkelola untuk panduan wizard lengkap. Artikel ini hanya menyoroti perbedaan sumber telemetri.

Konektor telemetri

Connector Layanan Authentication Kegunaan umum
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Identitas yang dikelola Jalankan kueri KQL terhadap klaster ADX
Ruang Kerja Log Analytics Log Analytics Identitas yang dikelola Log ruang kerja query dalam mode hanya-baca
Application Insights Application Insights Identitas yang dikelola Query telemetry aplikasi dalam mode hanya-baca
Datadog Datadog Kredensial layanan yang ditampilkan oleh konektor Query metrik, log, dan monitor
Elasticsearch Elasticsearch Kredensial layanan yang ditampilkan oleh konektor Log pencarian dan telemetri terindeks
Dynatrace Dynatrace Kredensial layanan yang ditampilkan oleh konektor Data observabilitas dan jejak query
New Relic New Relic Kredensial layanan yang ditampilkan oleh konektor Kueri telemetri dan insiden
Splunk Splunk Kredensial layanan yang ditampilkan oleh konektor Cari log dan acara Splunk
Hawkeye (NeuBird) Hawkeye oleh NeuBird Kredensial layanan yang ditampilkan oleh konektor Query data observabilitas berbasis AI

Konektor telemetri pihak ketiga menyertakan URL default, autentikasi, dan petunjuk header untuk membantu Anda mengonfigurasi koneksi.

Anda juga dapat menambahkan sumber telemetri lain melalui konektor yang disediakan pengguna. Gunakan opsi ini ketika tim Anda memiliki alat khusus atau sumber yang tidak tercantum di pemilih konektor.

Langkah 1: Tambahkan konektor

  1. Buka sre.azure.com dan pilih agen Anda.

  2. Di sidebar kiri, perluas Builder, lalu pilih Connectors.

  3. Pilih Tambahkan konektor.

  4. Pilih tab Telemetry , lalu pilih sumber telemetry Anda. Untuk Azure Data Explorer, pilih Azure Data Explorer, yang menggunakan jalur Azure MCP Kusto.

Langkah 2: Autentikasi

For Azure telemetry connectors:

  1. Lengkapi kolom yang ditampilkan oleh konektor.

    • Untuk Azure Data Explorer, beri nama konektor, pilih identitas terkelola yang digunakan agen untuk melakukan query ke Kusto, lalu tambahkan satu atau lebih grup cluster dengan URL cluster.
    • Untuk Log Analytics Workspace, pilih workspace dari workspace picker, atau masukkan ID sumber daya workspace ARM secara manual.
    • Untuk Application Insights, pilih sumber daya Application Insights dari resource picker, atau masukkan resource ID ARM secara manual.

  2. Pilih identitas Managed saat konektor memintanya.

  3. Lanjutkan ke langkah tinjauan, klaster, atau pemilihan alat yang ditunjukkan oleh wizard.

Identitas yang dikelola harus memiliki akses baca ke sumber daya target. Jika kueri kemudian gagal dengan kesalahan izin, berikan akses baca ke identitas tersebut dan coba kueri lagi.

Langkah 3: Siapkan alat kueri

Pada langkah Atur alat , aktifkan operasi yang membaca telemetri. Operasi query adalah inti dari konektor telemetri, jadi pilih operasi run-query atau search. Biarkan operasi administratif dinonaktifkan kecuali Anda membutuhkannya.

Atur setiap operasi baca ke Allow agar agen dapat menjawab pertanyaan tanpa jeda. Jika Anda mengaktifkan operasi apa pun yang mengubah data, atur ke Ask.

Untuk Azure Data Explorer melalui Azure MCP, wizard menyertakan langkah grup cluster dan langkah tinjauan dengan pengujian koneksi. Konfigurasikan grup klaster, uji konektivitas, dan simpan konektor. Set alat Kusto ditangani oleh jalur Kusto Azure MCP.

Petunjuk / Saran

Jaga agar set yang diaktifkan tetap kecil. Konektor telemetri biasanya hanya membutuhkan operasi kueri. Lebih sedikit alat berarti agen memilih yang tepat, lebih andal dan tetap dalam anggaran 80 alat.

Langkah 4: Validasi dengan pertanyaan

  1. Buka obrolan dengan agen Anda.

  2. Ajukan pertanyaan yang membutuhkan telemetri Anda. Contohnya:

    How many errors were logged in the last hour, grouped by service?

  3. Perhatikan jawabannya. Kartu alat menunjukkan kepada agen memilih alat query konektor dan menjalankan kueri, diikuti dengan jawaban yang didasarkan pada telemetri Anda.

Ketika Anda melihat hitungan nyata dari sumber Anda sendiri alih-alih penjelasan umum, konektor bekerja dari ujung ke ujung.

Troubleshooting

Problem Cause Perbaiki
Query mengembalikan "Tidak Sah" atau "Dilarang" Identitas koneksi tidak memiliki akses baca Berikan akses baca identitas ke sumber daya target, lalu coba ulang.
Query mengembalikan "tidak ditemukan" Nama workspace, cluster, database, atau tabel yang salah Konfirmasi nama persis di layanan. Nama peka terhadap huruf besar dan kecil.
Konektor pihak ketiga tidak dapat terhubung Nilai URL, token, atau header salah Konfirmasi nilai dengan administrator observabilitas Anda dan perbarui konektornya.
Jawabannya generik dan tidak ada kartu alat yang muncul Pertanyaannya tidak memerlukan telemetri Anda Ubah agar pertanyaan membutuhkan telemetri Anda, seperti "hitung permintaan yang gagal di layanan X untuk hari terakhir."
Konektor disimpan tetapi tidak ada telemetri yang dikembalikan Hasil kosong atau terfilter Perluas rentang waktu dalam pertanyaan Anda, atau pastikan sumbernya memiliki telemetri terbaru.

Konten terkait

  • Last updated on