Azure Time Series Insights 2. Nesil olay kaynakları
Not
Time Series Insights (TSI) hizmeti artık Mart 2025'e kadar desteklenmeyecektir. Mevcut TSI ortamlarını mümkün olan en kısa sürede alternatif çözümlere geçirmeyi göz önünde bulundurun. Kullanımdan kaldırma ve geçiş hakkında daha fazla bilgi için belgelerimizi ziyaret edin.
Azure Time Series Insights 2. Nesil ortamınızda en fazla iki akış olayı kaynağı olabilir. Giriş olarak iki tür Azure kaynağı desteklenir:
Olaylar UTF-8 kodlanmış JSON olarak gönderilmelidir.
Olay kaynaklarını oluşturma veya düzenleme
Olay kaynağı, hub'ınız ile Azure Time Series Insights 2. Nesil ortamınız arasındaki bağlantıdır ve kaynak grubunuzda farklı türde Time Series Insights event source bir kaynak oluşturulur. IoT Hub veya Olay Hub'ı kaynakları, Azure Time Series Insights 2. Nesil ortamınızla aynı Azure aboneliğinde veya farklı bir abonelikte bulunabilir. Ancak, Azure Time Series Insights ortamınızı ve IoT Hub veya Olay Hub'ını aynı Azure bölgesinde depolamak en iyi yöntemdir.
Ortamınızın olay kaynaklarını oluşturmak, düzenlemek veya kaldırmak için Azure portal, Azure CLI, Azure Resource Manager şablonları ve REST API'sini kullanabilirsiniz.
Uyarı
Time Series Insights tarafından kullanılan bir hub'a veya olay kaynağına Genel İnternet erişimini kısıtlamayın, aksi takdirde gerekli bağlantı kesilir.
Başlangıç seçenekleri
Olay kaynağı oluştururken, önceden var olan verilerin toplanması gerektiğini belirtebilirsiniz. Bu ayar isteğe bağlıdır. Aşağıdaki seçenekler kullanılabilir:
| Ad | Açıklama | Azure Resource Manager şablonu örneği |
|---|---|---|
| EarliestAvailable | IoT veya Event Hub'da depolanan önceden var olan tüm verileri alma | "ingressStartAt": {"type": "EarliestAvailable"} |
| EventSourceCreationTime | Olay kaynağı oluşturulduktan sonra gelen verileri almaya başlayın. Olay kaynağı oluşturulmadan önce akışı yapılan önceden var olan veriler yoksayılır. Bu, Azure portal varsayılan ayardır | "ingressStartAt": {"type": "EventSourceCreationTime"} |
| CustomEnqueuedTime | Ortamınız, özel sıraya alınan (UTC) zamanınızın ilerisinden veri alır. Özel sıraya alınan saatinizde veya sonrasında IoT veya Olay Hub'ınıza alınan tüm olaylar alınıp depolanır. Özel sıraya alınan sürenizden önce gelen tüm olaylar yoksayılır. "Sıraya alınan saat", olayın IoT veya Event Hub'ınıza ulaştığı saati (UTC olarak) ifade eder. Bu, olayınızın gövdesinde bulunan özel bir zaman damgası özelliğinden farklıdır. | "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"} |
Önemli
- EarliestAvailable'ı seçerseniz ve önceden var olan çok fazla veriniz varsa, Azure Time Series Insights 2. Nesil ortamınız tüm verilerinizi işlerken yüksek başlangıç gecikmesi yaşayabilirsiniz.
- Veriler dizine alınan bu yüksek gecikme süresi sonunda azalır. Sürekli yüksek gecikme süresiyle karşılaşırsanız Azure portal üzerinden bir destek bileti gönderin.
- EarliestAvailable
- EventSourceCreationTime
- CustomEnqueuedTime
Akış alımı için en iyi yöntemler
Olay kaynağınızdaki verileri kullanmak için her zaman Azure Time Series Insights 2. Nesil ortamınız için benzersiz bir tüketici grubu oluşturun. Tüketici gruplarını yeniden kullanmak rastgele bağlantı kesilmelerine neden olabilir ve veri kaybına neden olabilir.
Azure Time Series Insights 2. Nesil ortamınızı ve IoT Hub ve/veya Event Hubs'ınızı aynı Azure bölgesinde yapılandırın. Ayrı bir bölgede bir olay kaynağı yapılandırmak mümkün olsa da, bu senaryo desteklenmez ve yüksek kullanılabilirliği garanti edemeyiz.
Ortamınızın aktarım hızı sınırının veya bölüm başına sınırın ötesine geçmeyin.
Ortamınızda veri işleme sorunları yaşanıyorsa bildirim almak için bir gecikme uyarısı yapılandırın. Önerilen uyarı koşulları için aşağıdaki Üretim iş yükleri bölümüne bakın.
Yalnızca gerçek zamanlıya yakın ve son veriler için akış alımını kullanın; akış geçmiş verileri desteklenmez.
Özelliklerin nasıl kaçılacağını ve JSON verilerinin düzleştirilmiş ve depolanmış olduğunu anlayın.
Olay kaynağı bağlantı dizelerini sağlarken en az ayrıcalık ilkesini izleyin. Event Hubs için paylaşılan erişim ilkesini yalnızca gönderme talebiyle yapılandırın ve IoT Hub için yalnızca hizmet bağlantı iznini kullanın.
Dikkat
IoT Hub veya Olay Hub'ınızı silip aynı ada sahip yeni bir kaynağı yeniden oluşturursanız, yeni bir olay kaynağı oluşturmanız ve yeni IoT Hub veya Olay Hub'ını eklemeniz gerekir. Bu adım tamamlanana kadar veriler alınmaz.
Üretim iş yükleri
Yukarıdaki en iyi uygulamalara ek olarak, iş açısından kritik iş yükleri için aşağıdakileri uygulamanızı öneririz.
IoT Hub veya Event Hub veri saklama sürenizi en fazla yedi güne artırın.
Azure portal ortam uyarıları oluşturun. Platform ölçümlerini temel alan uyarılar, uçtan uca işlem hattı davranışını doğrulamanıza olanak sağlar. Uyarı oluşturma ve yönetme yönergeleri buradadır. Önerilen uyarı koşulları:
- IngressReceivedMessagesTimeLag 5 dakikadan uzun
- IngressReceivedBytes 0
IoT Hub veya Olay Hub'ı bölümleri arasında alım yükünüzün dengeli kalmasını sağlayın.
Geçmiş Veri Alımı
Geçmiş verileri içeri aktarmak için akış işlem hattının kullanılması şu anda Azure Time Series Insights 2. Nesil'de desteklenmemaktadır. Geçmiş verileri ortamınıza aktarmanız gerekiyorsa aşağıdaki yönergeleri izleyin:
- Canlı ve geçmiş verilerini paralel olarak akışla aktarmayın. Sıra dışı verilerin alımı sorgu performansının düşmesine neden olur.
- En iyi performans için geçmiş verileri zaman sıralı şekilde alın.
- Aşağıdaki alım aktarım hızı sınırları içinde kalın.
- Veriler Isınma Deposu saklama sürenizden eskiyse, Sıcak Depolama'yi devre dışı bırakın.
Olay kaynağı zaman damgası
Bir olay kaynağını yapılandırırken bir zaman damgası kimliği özelliği sağlamanız istenir. Zaman damgası özelliği zaman içindeki olayları izlemek için kullanılır; bu, Sorgu API'lerinde zaman damgası $ts olarak ve Azure Time Series Insights Gezgini'nde seri çizmek için kullanılacak zamandır. Oluşturma zamanında özellik sağlanmamışsa veya bir olayda zaman damgası özelliği eksikse, olayın IoT Hub veya Events Hubs tarafından sıralanan saati varsayılan olarak kullanılır. Zaman damgası özellik değerleri UTC'de depolanır.
Genel olarak, kullanıcılar zaman damgası özelliğini özelleştirmeyi ve varsayılan hub sıraya alınan zamanı kullanmak yerine algılayıcının veya etiketin okumayı oluşturduğu zamanı kullanmayı tercih eder. Bu, özellikle cihazların aralıklı bağlantı kaybı olduğunda ve gecikmeli iletilerin toplu olarak Azure Time Series Insights 2. Nesil'e iletilmesi durumunda gereklidir.
Özel zaman damganız iç içe JSON nesnesi veya dizi içindeyse, düzleştirme ve kaçış adlandırma kurallarımızı izleyerek doğru özellik adını sağlamanız gerekir. Örneğin, burada gösterilen JSON yükünün olay kaynağı zaman damgası olarak "values.time"girilmelidir.
Saat dilimi uzaklıkları
Zaman damgaları ISO 8601 biçiminde gönderilmeli ve UTC'de depolanmalıdır. Saat dilimi uzaklığı sağlanırsa, uzaklık uygulanır ve ardından utc biçiminde depolanıp döndürülür. Uzaklık yanlış biçimlendirildiyse yoksayılır. Çözümünüzün özgün uzaklık bağlamının olmadığı durumlarda, uzaklık verilerinin korunduğunu ve uygulamanızın sorgu yanıtında başvurabileceğinden emin olmak için ek bir ayrı olay özelliğinde gönderebilirsiniz.
Saat dilimi uzaklığı aşağıdakilerden biri olarak biçimlendirilmelidir:
±HHMMZ
±SS:DD
±SS:MMZ
Sonraki adımlar
Olayların nasıl depolandığını anlamak için JSON Düzleştirme ve Kaçış Kuralları'nı okuyun.
Ortamınızın aktarım hızı sınırlamalarını anlama