Azure IoT Central uygulamanızda bir telemetri kuralı oluşturma ve bildirim ayarlamaCreate a telemetry rule and set up notifications in your Azure IoT Central application

Bu makale, işleçler, oluşturucular ve yöneticiler için geçerlidir.This article applies to operators, builders, and administrators.

Not

Şu anda, genel olarak kullanılabilen özellikleri kullanan uygulama şablonlarının IoT Central belgelerini görüntüyorsunuz.You're currently viewing the IoT Central documentation for application templates that use generally available features. Önizleme özelliklerini kullanan uygulama şablonlarının belgelerini görüntülemek için Azure IoT Central (Önizleme özellikleri) nedir?sayfasına gidin.To view the documentation for application templates that use preview features, go to What is Azure IoT Central (preview features)?.

Bağlı cihazlarınızı uzaktan izlemek için Azure IoT Central kullanabilirsiniz.You can use Azure IoT Central to remotely monitor your connected devices. Azure IoT Central kuralları, cihazlarınızı neredeyse gerçek zamanlı olarak izlemenizi ve e-posta veya Microsoft Flow tetikleyici Gönder gibi eylemleri otomatik olarak çağırmayı sağlar.Azure IoT Central rules enable you to monitor your devices in near real time and automatically invoke actions, such as send an email or trigger Microsoft Flow. Yalnızca birkaç tıklamayla, cihaz verilerinizi izleyecek koşulu tanımlayabilir ve ilgili eylemi yapılandırabilirsiniz.In just a few clicks, you can define the condition for which to monitor your device data and configure the corresponding action. Bu makalede, cihaz tarafından gönderilen Telemetriyi izlemek için kuralların nasıl oluşturulacağı açıklanmaktadır.This article explains how to create rules to monitor telemetry sent by the device.

Cihazlar, cihazdan sayısal veri göndermek için telemetri ölçümü kullanabilir.Devices can use telemetry measurement to send numerical data from the device. Bir telemetri kuralı, seçilen cihaz telemetrisi belirtilen eşiği aştığında tetikler.A telemetry rule triggers when the selected device telemetry crosses a specified threshold.

Telemetri kuralı oluşturmaCreate a telemetry rule

Bir telemetri kuralı oluşturmak için, cihaz şablonunda en az bir telemetri ölçümü tanımlanmış olmalıdır.To create a telemetry rule, the device template must have at least one telemetry measurement defined. Bu örnek, sıcaklık ve nem telemetrisi gönderen bir soğutma makinesi cihazı kullanır.This example uses a refrigerated vending machine device that sends temperature and humidity telemetry. Kural, cihaz tarafından bildirilen sıcaklığın izler ve 80 derecenin üzerinde kaldığında bir e-posta gönderir.The rule monitors the temperature reported by the device and sends an email when it goes above 80 degrees.

  1. Cihaz şablonları sayfasını kullanarak, kuralını eklemek istediğiniz cihaz şablonuna gidin.Using the Device Templates page, navigate to the device template for which you are adding the rule for.

  2. Henüz bir kural oluşturmadıysanız aşağıdaki ekranı görürsünüz:If you haven’t created any rules yet, you see the following screen:

    Henüz kural yok

  3. Kurallar sekmesinde, oluşturabileceğiniz kural türlerini görmek Için + Yeni kural ' ı seçin.On the Rules tab, select + New Rule to see the types of rules you can create.

  4. Cihaz telemetrisini izlemek için bir kural oluşturmak üzere telemetri ' i seçin.Select Telemetry to create a rule to monitor device telemetry.

    Kural türleri

  5. Bu cihaz şablonunda kuralı tanımlamanızı sağlayan bir ad girin.Enter a name that helps you to identify the rule in this device template.

  6. Bu şablon için oluşturulan tüm cihazların kuralını hemen etkinleştirmek için, Bu şablon için tüm cihazlar kuralını etkinleştirseçeneğini değiştirin.To immediately enable the rule for all the devices created for this template, toggle Enable rule for all devices for this template.

    Kural ayrıntısı

    Kural, cihaz şablonu altındaki tüm cihazlara otomatik olarak uygulanır.The rule automatically applies to all the devices under the device template.

Kural koşullarını yapılandırmaConfigure the rule conditions

Koşul, kural tarafından izlenen kriterleri tanımlar.Condition defines the criteria that is monitored by the rule.

  1. Koşullar ' ın yanındaki + ' u seçerek yeni bir koşul ekleyin.Select + next to Conditions to add a new condition.

  2. Ölçüm açılan listesinden izlemek istediğiniz Telemetriyi seçin.Select the telemetry you want to monitor from the Measurement dropdown.

  3. Sonra toplama, işleç' i seçin ve bir eşik değeri sağlayın.Next, choose Aggregation, Operator, and provide a Threshold value.

    • Toplama isteğe bağlıdır.Aggregation is optional. Toplama olmadan kural, koşulu karşılayan her telemetri veri noktası için tetikler.Without aggregation, the rule triggers for each telemetry data point that meets the condition. Örneğin, kural sıcaklık 80 üzerinde olduğunda kural tetiklenecek şekilde yapılandırıldıysa, cihaz sıcaklık > 80 ' i raporladığında kural neredeyse anında tetiklenir.For example, if the rule is configured to trigger when temperature is above 80 then the rule triggers almost instantly when the device reports temperature > 80.

    • Ortalama, min, Max, Count gibi bir toplama işlevi seçilirse, kullanıcının koşulun değerlendirilmesi gereken bir toplama zaman penceresi sağlaması gerekir.If an aggregate function like Average, Min, Max, Count is chosen then, the user must provide an Aggregate time window over which the condition needs to be evaluated. Örneğin, dönemi "5 dakika" olarak ayarlarsanız ve kuralınız 80 üzerinde ortalama sıcaklık alıyorsa, kural ortalama sıcaklık en az 5 dakika boyunca 80 ' in üzerinde olduğunda tetiklenir.For example, if you set the period as "5 minutes" and your rule looks for Average temperature above 80, the rule triggers when the average temperature is above 80 for at least 5 minutes. Kural değerlendirme sıklığı toplama zamanı penceresiyleaynıdır, yani bu örnekte kural her 5 dakikada bir değerlendirilir.The rule evaluation frequency is the same as the Aggregate time window, which means, in this example, the rule is evaluated once every 5 minutes.

      Koşul

      Not

      Koşulaltında birden fazla telemetri ölçümü eklenebilir.More than one telemetry measurement can be added under Condition. Birden çok koşul belirtildiğinde kuralın tetiklenmesi için tüm koşulların karşılanması gerekir.When multiple conditions are specified, all the conditions must be met for the rule to trigger. Her bir koşullu ' ve ' yan tümcesiyle dolaylı olarak birleştirilir.Each conditon gets joined by an 'AND' clause implicitly. Toplama kullanılırken, her ölçüm toplanmalıdır.When using aggregate, every measurement must be aggregated.

Eylemleri yapılandırmaConfigure actions

Bu bölümde, kural tetiklendiğinde yapılacak eylemlerin nasıl ayarlanacağı gösterilmektedir.This section shows you how to set up actions to take when the rule is fired. Kuralda belirtilen tüm koşulların doğru olarak değerlendirilmesi durumunda eylemler çağrılır.Actions get invoked when all the conditions specified in the rule evaluate to true.

  1. Eylemler' in yanındaki + seçin.Choose the + next to Actions. Burada, kullanılabilir eylemlerin listesini görürsünüz.Here you see the list of available actions.

    Eylem Ekle

  2. E-posta eylemini seçin, to alanına geçerli bir e-posta adresi girin ve kural tetiklendiğinde e-posta gövdesinde görüntülenecek bir notun sağlayın.Choose the Email action, enter a valid email address in the To field, and provide a note to appear in the body of the email when the rule triggers.

    Not

    E-postalar yalnızca uygulamaya eklenmiş olan ve en az bir kez oturum açan kullanıcılara gönderilir.Emails are only sent to the users that have been added to the application and have logged in at least once. Azure IoT Central 'de Kullanıcı yönetimi hakkında daha fazla bilgi edinin.Learn more about user management in Azure IoT Central.

    Eylemi Yapılandır

  3. Kuralı kaydetmek için Kaydet' i seçin.To save the rule, choose Save. Kural birkaç dakika içinde canlı olarak geçer ve uygulamanıza gönderilen izleme Telemetriyi başlatır.The rule goes live within a few minutes and starts monitoring telemetry being sent to your application. Kuralda belirtilen koşul karşılandığında, kural yapılandırılan e-posta eylemini tetikler.When the condition specified in the rule is met, the rule triggers the configured email action.

Kurala Microsoft Flow ve Web kancaları gibi başka eylemler ekleyebilirsiniz.You can add other actions to the rule such as Microsoft Flow and webhooks. Kural başına en fazla 5 işlem ekleyebilirsiniz.You can add up to 5 actions per rule.

Kuralı ParametreleştirmeParameterize the rule

Kurallar, cihaz özelliklerinden belirli özellikleri parametre olarak türetebilir.Rules can derive certain vales from Device Properties as parameters. Farklı cihazlarda telemetri eşiklerinin değişebileceği senaryolarda, parametreleri kullanmak faydalıdır.Using parameters is helpful in scenarios where telemetry thresholds vary for different devices. Kuralı oluşturduğunuzda, 80 derece gibi mutlak bir değer sağlamak yerine, eşiği belirten, en yüksek Ideal eşikgibi bir cihaz özelliği seçin.When you create the rule, choose a device property that specifies the threshold, such as Maximum Ideal Threshold, instead of providing an absolute value, such as 80 degrees. Kural yürütüldüğünde, Device özelliğinde ayarlanan değer ile cihaz telemetrisiyle eşleşir.When the rule executes, it matches the device telemetry with the value set in the device property.

Parametreleri kullanmak cihaz şablonu başına yönetilecek kural sayısını azaltmak için etkili bir yoldur.Using parameters is an effective way to reduce the number of rules to manage per device template.

Eylemler, bir parametre olarak Device özelliği kullanılarak da yapılandırılabilir.Actions can also be configured using Device Property as a parameter. Bir e-posta adresi özellik olarak depolanıyorsa,, adresini tanımlarken kullanabilirsiniz.If an email address is stored as a property, then it can be used when you define the To address.

Kuralı silmeDelete a rule

Artık bir kurala ihtiyacınız yoksa, kuralı açıp Sil' i seçerek silin.If you no longer need a rule, delete it by opening the rule and choosing Delete. Kural silindiğinde cihaz şablonundan ve ilişkili tüm cihazlardan kaldırılır.Deleting the rule removes it from the device template and all the associated devices.

Cihaz şablonu için bir kuralı etkinleştirme veya devre dışı bırakmaEnable or disable a rule for a device template

Cihaza gidin ve etkinleştirmek veya devre dışı bırakmak istediğiniz kuralı seçin.Navigate to the device and choose the rule you want to enable or disable. Cihaz şablonuyla ilişkili tüm cihazların kuralını etkinleştirmek veya devre dışı bırakmak için kuraldaki Bu şablonun tüm cihazları Için etkinleştir kuralını açın.Toggle the Enable rule for all devices of this template button in the rule to enable or disable the rule for all devices that are associated with the device template.

Cihaz için bir kuralı etkinleştirme veya devre dışı bırakmaEnable or disable a rule for a device

Cihaza gidin ve etkinleştirmek veya devre dışı bırakmak istediğiniz kuralı seçin.Navigate to the device and choose the rule you want to enable or disable. Bu cihazın kuralını etkinleştirmek veya devre dışı bırakmak için Bu cihaz için kuralı etkinleştir düğmesini değiştirin.Toggle the Enable rule for this device button to either enable or disable the rule for that device.

Sonraki adımlarNext steps

Azure IoT Central uygulamanızda kuralların nasıl oluşturulacağını öğrendiğinize göre, bir sonraki adım aşağıda verilmiştir:Now that you have learned how to create rules in your Azure IoT Central application, here are some next step: