Azure Time Series Insights 2. Nesil olay kaynakları
Not
Time Series Insights hizmeti 7 Temmuz 2024'te kullanımdan kaldırılacaktır. Mevcut ortamları 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 ayrı türde bir kaynak Time Series Insights event source oluşturulur. IoT Hub veya Event 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 Event Hub'ı 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ını, Azure CLI'yı, Azure Resource Manager şablonlarını ve REST API'yi 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 bulunur:
| Veri Akışı Adı | Açıklama | Azure Resource Manager şablon örneği |
|---|---|---|
| EarliestAvailable | IoT veya Event Hub içinde depolanan önceden var olan tüm verileri alın | "ingressStartAt": {"type": "EarliestAvailable"} |
| EventSourceCreationTime | Olay kaynağı oluşturulduktan sonra gelen verileri almaya başlayın. Olay kaynağının oluşturulmasından önce akışa alınan önceden var olan veriler yok sayılacaktır. Bu, Azure portalındaki varsayılan ayardır | "ingressStartAt": {"type": "EventSourceCreationTime"} |
| CustomEnqueuedTime | Ortamınız, verileri özel sıraya alınmış zamanınızdan (UTC) ileriye doğru alacaktır. Özel sıraya alma zamanında veya sonrasında IoT veya Event Hub’ınıza sıraya alınan tüm olaylar alınacak ve depolanacaktır. Özel sıraya alma zamanından önce gelen tüm olaylar göz ardı edilecektir. "Sıralanan 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 çok fazla önceden var olan 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. Devam eden yüksek gecikme süresiyle karşılaşırsanız Azure portalı üzerinden bir destek bileti gönderin.
- EarliestAvailable
- EventSourceCreationTime
- CustomEnqueuedTime
Akış alımı en iyi yöntemleri
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ı kesilmesine neden olabilir ve veri kaybına neden olabilir.
Azure Time Series Insights 2. Nesil ortamınızı ve ioT Hub'ınızı ve/veya Event Hubs'ınızı aynı Azure bölgesinde yapılandırın. Olay kaynağını ayrı bir bölgede yapılandırmak mümkün olsa da bu senaryo desteklenmez ve yüksek kullanılabilirlik garantisi veremeyiz.
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; geçmiş verileri akışı desteklenmez.
Özelliklerin nasıl kaçılacağını ve JSON verilerinin düzleştirme ve depolanma şeklini anlayın.
Olay kaynağı bağlantı dizesi 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ğlanma iznini kullanın.
Dikkat
IoT Hub'ınızı 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ı tamamlayana kadar veriler alınmaz.
Üretim iş yükleri
Yukarıdaki en iyi yöntemlere 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ün olacak şekilde artırın.
Azure portalında 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ş verileri 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ı bir şekilde alın.
- Aşağıdaki alım aktarım hızı sınırları içinde kalın.
- Veriler, Sıcak Depolama saklama sürenizden daha 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 Event 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 algılayıcının veya etiketin varsayılan hub sıralı zamanını kullanmak yerine okumayı oluşturduğu zamanı kullanmayı tercih eder. Bu, özellikle cihazlar aralıklı bağlantı kaybı olduğunda ve bir dizi gecikmeli ileti Azure Time Series Insights 2. Nesil'e iletildiğinde 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önderilmelidir ve UTC'de depolanacaktır. Bir saat dilimi uzaklığı sağlanırsa, uzaklık uygulanır ve ardından saat UTC biçiminde depolanır ve 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 korunmasını 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
± SSS:MMZ