Sumber kejadian Azure Time Series Insights Gen2
Catatan
Layanan Time Series Insights (TSI) tidak akan lagi didukung setelah Maret 2025. Pertimbangkan untuk memigrasikan lingkungan TSI yang ada ke solusi alternatif sesegera mungkin. Untuk informasi selengkapnya tentang penghentian dan migrasi, kunjungi dokumentasi kami.
Lingkungan Azure Time Series Insights Gen2 Anda dapat memiliki hingga dua sumber kejadian streaming. Dua jenis sumber daya Azure didukung sebagai input:
Kejadian harus dikirim sebagai JSON berenkode UTF-8.
Membuat atau mengedit sumber kejadian
Sumber kejadian adalah tautan antara hub Anda dan lingkungan Azure Time Series Insights Gen2, dan sumber daya terpisah dari jenis Time Series Insights event source dibuat di grup sumber daya Anda. Sumber daya IoT Hub atau Event Hub dapat berada di langganan Azure yang sama dengan lingkungan Azure Time Series Insights Gen2 Anda atau langganan yang berbeda. Namun, praktik terbaik adalah menempatkan lingkungan Azure Time Series Insights Anda dan IoT Hub atau Event Hub dalam wilayah Azure yang sama.
Anda dapat menggunakan portal Microsoft Azure, Azure CLI, templat Azure Resource Manager, dan REST API untuk membuat, mengedit, atau menghapus sumber kejadian lingkungan Anda.
Peringatan
Jangan batasi akses Internet Publik ke hub atau sumber kejadian yang digunakan oleh Time Series Insights atau koneksi yang diperlukan akan terputus.
Opsi memulai
Saat membuat sumber kejadian, Anda dapat menentukan data yang sudah ada sebelumnya yang harus dikumpulkan. Pengaturan ini bersifat opsional. Opsi berikut tersedia:
| Nama | Deskripsi | Contoh templat Azure Resource Manager |
|---|---|---|
| EarliestAvailable | Menyerap semua data yang sudah ada sebelumnya yang disimpan dalam IoT atau Event Hub | "ingressStartAt": {"type": "EarliestAvailable"} |
| EventSourceCreationTime | Mulailah menyerap data yang masuk setelah sumber kejadian dibuat. Data apa pun yang sudah ada sebelumnya yang di-streaming sebelum pembuatan sumber kejadian akan diabaikan. Ini adalah pengaturan default di portal Microsoft Azure | "ingressStartAt": {"type": "EventSourceCreationTime"} |
| CustomEnqueuedTime | Lingkungan Anda akan menyerap data dari waktu antrean kustom (UTC) Anda ke depan. Semua kejadian yang diantrekan ke IoT atau Event Hub Anda pada atau setelah waktu antrean kustom Anda akan diserap dan disimpan. Semua kejadian yang masuk sebelum waktu antrean kustom Anda akan diabaikan. Perhatikan bahwa "waktu antrean" mengacu pada waktu (dalam UTC) saat acara tiba di IoT atau Event Hub Anda. Ini berbeda dari properti tanda waktu kustom yang ada di dalam isi kejadian Anda. | "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"} |
Penting
- Jika Anda memilih EarliestAvailable dan memiliki banyak data yang sudah ada sebelumnya, Anda mungkin mengalami latensi awal yang tinggi karena lingkungan Azure Time Series Insights Gen2 Anda memproses semua data Anda.
- Latensi tinggi ini pada akhirnya akan mereda saat data diindeks. Kirimkan tiket dukungan melalui portal Microsoft Azure jika Anda mengalami latensi tinggi yang berkelanjutan.
- EarliestAvailable
- EventSourceCreationTime
- CustomEnqueuedTime
Praktik terbaik penyerapan streaming
Selalu buat grup konsumen unik untuk lingkungan Azure Time Series Insights Gen2 Anda untuk menggunakan data dari sumber kejadian Anda. Menggunakan kembali grup konsumen dapat menyebabkan pemutusan acak dan dapat mengakibatkan hilangnya data.
Konfigurasikan lingkungan Azure Time Series Insights Gen2 dan IoT Hub dan/atau Event Hub Anda di wilayah Azure yang sama. Meskipun dimungkinkan untuk mengonfigurasi sumber kejadian di wilayah terpisah, skenario ini tidak didukung dan kami tidak dapat menjamin ketersediaan tinggi.
Jangan melampaui batas laju throughput lingkungan Anda atau batas per partisi.
Konfigurasikan pemberitahuan lag agar diberi tahu jika lingkungan Anda mengalami masalah saat memproses data. Lihat Beban kerja produksi di bawah untuk mengetahui kondisi pemberitahuan yang disarankan.
Gunakan penyerapan streaming hanya untuk data mendekati real-time dan terbaru, streaming data historis tidak didukung.
Pahami bagaimana properti akan dilepaskan dan data JSON diratakan dan disimpan.
Ikuti prinsip hak istimewa paling rendah saat memberikan string koneksi sumber kejadian. Untuk Azure Event Hubs, konfigurasikan kebijakan akses bersama dengan klaim kirim saja, dan untuk IoT Hub gunakan izin koneksi layanan saja.
Perhatian
Jika Anda menghapus IoT Hub atau Event Hub dan membuat ulang sumber daya baru dengan nama yang sama, Anda perlu membuat sumber kejadian baru dan melampirkan IoT Hub atau Event Hub baru. Data tidak akan diserap sampai Anda menyelesaikan langkah ini.
Beban kerja produksi
Selain praktik terbaik di atas, sebaiknya Anda menerapkan hal berikut untuk beban kerja penting bisnis.
Tingkatkan waktu retensi data IoT Hub atau Event Hub Anda hingga maksimum tujuh hari.
Buat pemberitahuan lingkungan di portal Microsoft Azure. Pemberitahuan berdasarkan metrik platform memungkinkan Anda memvalidasi perilaku alur pipa end-to-end. Instruksi untuk membuat dan mengelola pemberitahuan ada di sini. Kondisi pemberitahuan yang disarankan:
- IngressReceivedMessagesTimeLag lebih dari 5 menit
- IngressReceivedBytes adalah 0
Jaga keseimbangan beban penyerapan Anda antara IoT Hub atau partisi Event Hub Anda.
Penyerapan Data Historis
Menggunakan alur streaming untuk mengimpor data historis saat ini tidak didukung di Azure Time Series Insights Gen2. Jika Anda perlu mengimpor data sebelumnya ke lingkungan Anda, ikuti panduan di bawah ini:
- Jangan streaming data langsung dan historis secara paralel. Menyerap data yang tidak sesuai pesanan akan mengakibatkan penurunan performa kueri.
- Serap data historis dengan cara yang diatur waktu untuk performa terbaik.
- Tetap dalam batas tingkat throughput penyerapan di bawah.
- Nonaktifkan Warm Store jika data lebih lama dari periode retensi Warm Store Anda.
Tanda waktu sumber kejadian
Saat mengonfigurasi sumber kejadian, Anda akan diminta untuk memberikan properti ID tanda waktu. Properti tanda waktu digunakan untuk melacak kejadian dari waktu ke waktu, ini adalah waktu yang akan digunakan sebagai tanda waktu $ts di API Kueri dan untuk merencanakan rangkaian di Azure Time Series Insights Explorer. Jika tidak ada properti yang disediakan pada waktu pembuatan, atau jika properti tanda waktu hilang dari suatu kejadian, waktu antrean IoT Hub atau Azure Event Hubs akan digunakan sebagai default. Nilai properti tanda waktu disimpan dalam UTC.
Secara umum, pengguna akan memilih untuk menyesuaikan properti tanda waktu dan menggunakan waktu ketika sensor atau tag menghasilkan pembacaan daripada menggunakan waktu antrean hub default. Ini sangat diperlukan ketika perangkat mengalami kehilangan konektivitas terputus-terputus dan kumpulan pesan yang tertunda diteruskan ke Azure Time Series Insights Gen2.
Jika tanda waktu kustom Anda berada dalam objek atau array JSON, Anda harus memberikan nama properti yang benar dengan mengikuti konvensi penamaan perataan dan pelepasan kami. Misalnya, tanda waktu sumber kejadian untuk payload JSON yang ditampilkan di sini harus dimasukkan sebagai "values.time".
Offset Zona Waktu
Tanda waktu harus dikirim dalam format ISO 8601 dan akan disimpan dalam UTC. Jika offset zona waktu disediakan, offset akan diterapkan dan kemudian waktu disimpan dan dikembalikan dalam format UTC. Jika offset tidak diformat dengan benar, offset akan diabaikan. Dalam situasi di mana solusi Anda mungkin tidak memiliki konteks offset asli, Anda dapat mengirim data offset dalam properti peristiwa terpisah tambahan untuk memastikan bahwa solusi tersebut dipertahankan dan aplikasi Anda dapat mereferensikan dalam respons kueri.
Offset zona waktu harus diformat sebagai salah satu dari berikut ini:
±HHMMZ
±HH:MM
±HH:MMZ
Langkah berikutnya
Baca Aturan Perataan dan Pelepasan JSON untuk memahami bagaimana kejadian akan disimpan.
Memahami batasan throughput lingkungan Anda