Varlık yapılandırmalarını uzaktan yönetme

Önemli

Azure Arc tarafından etkinleştirilen Azure IoT İşlemleri Önizlemesi şu anda ÖNİzLEME aşamasındadır. Bu önizleme yazılımını üretim ortamlarında kullanmamalısınız.

Beta veya önizleme aşamasında olan ya da başka bir şekilde henüz genel kullanıma sunulmamış olan Azure özelliklerinde geçerli olan yasal koşullar için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Azure IoT İşlemleri Önizlemesi'ndeki bir varlık, gerçek bir varlığı temsil etmek için oluşturduğunuz mantıksal bir varlıktır. Azure IoT İşlemleri varlığı, davranışını ve özelliklerini açıklayan özelliklere, etiketlere ve olaylara sahip olabilir.

OPC UA sunucuları , varlıklarla iletişim kuran yazılım uygulamalarıdır. OPC UA sunucuları, veri noktalarını temsil eden OPC UA etiketlerini kullanıma sunar. OPC UA etiketleri varlıkların durumu, performansı, kalitesi veya durumu hakkında gerçek zamanlı veya geçmişe dönük veriler sağlar.

Varlık uç noktası , Kubernetes kümenizdeki OPC UA sunucularını OPC UA bağlayıcı modüllerine bağlayan özel bir kaynaktır. Bu bağlantı, OPC UA bağlayıcının bir varlığın veri noktalarına erişmesini sağlar. Varlık uç noktası olmadan veriler OPC UA sunucusundan Azure IoT OPC UA Aracısı Önizleme örneğine ve Azure IoT MQ Preview örneğine akamaz. Kümenizdeki özel kaynakları yapılandırdıktan sonra aşağı akış OPC UA sunucusuna bir bağlantı kurulur ve sunucu telemetri verilerini OPC UA Aracısı örneğine iletir.

Site, Azure IoT İşlemleri örneklerinin bir koleksiyonudur. Siteler, örneklerinizi düzenlemenize ve erişim denetimini yönetmenize yardımcı olur. BT yöneticiniz siteleri oluşturur, bunlara örnekler atar ve kuruluşunuzdaki OT kullanıcılarına erişim verir.

Azure IoT İşlemleri (önizleme) portalında örnek, Azure IoT İşlemleri kümesini temsil eder. Bir örneğin bir veya daha fazla varlık uç noktası olabilir.

Bu makalede, Azure IoT İşlemleri (önizleme) portalını ve Azure CLI'yi kullanarak şunların nasıl kullanılacağı açıklanmaktadır:

• Varlıkları Azure IoT İşlemleri örneğine bağlayan varlık uç noktalarını tanımlayın.
• OPC UA sunucularından Azure IoT MQ aracısına veri akışını etkinleştirmek için varlık ekleyin ve etiketlerini ve olaylarını tanımlayın.

Bu varlıklar, etiketler ve olaylar, OPC UA sunucularından gelen verileri MQ aracısı ve Azure IoT Veri İşlemcisi Önizleme işlem hatlarında kullanabileceğiniz kolay adlarla eşler.

Önkoşullar

Varlık uç noktasını yapılandırmak için çalışan bir Azure IoT İşlemleri örneğine ihtiyacınız vardır.

Oturum açın

Azure IoT İşlemleri portalı

Azure IoT İşlemleri (önizleme) portalında oturum açmak için tarayıcınızda Azure IoT İşlemleri (önizleme) portalına gidin ve Microsoft Entra Id kimlik bilgilerinizi kullanarak oturum açın.

Sitenizi seçin

Oturum açtığınızda portalda erişiminiz olan sitelerin listesi görüntülenir. Her site, varlıklarınızı yapılandırabileceğiniz bir Azure IoT İşlem örnekleri koleksiyonudur. BT yöneticiniz sitelerdeki örnekleri düzenlemek ve kuruluşunuzdaki OT kullanıcılarına erişim vermekle sorumludur. Bir sitenin parçası olmayan örnekler Atanmamış örnekler düğümünde görünür. Kullanmak istediğiniz siteyi seçin:

İpucu

Site aramak için filtre kutusunu kullanabilirsiniz.

Herhangi bir site görmüyorsanız doğru Azure Active Directory kiracısında olmayabilirsiniz. Kiracıyı portalda sağ üst menüden değiştirebilirsiniz. Henüz hiçbir siteye eklenmediğiniz anlamına gelen herhangi bir siteyi hala görmüyorsanız. Erişim istemek için BT yöneticinize ulaşın.

Örneğinizi seçin

Bir siteyi seçtikten sonra portal, sitenin parçası olan Azure IoT İşlemleri örneklerinin listesini görüntüler. Kullanmak istediğiniz örneği seçin:

İpucu

Örnekleri aramak için filtre kutusunu kullanabilirsiniz.

Azure CLI

Komutları kullanmadan az iot ops asset önce Azure IoT İşlemleri dağıtımınızı içeren abonelikte oturum açın:

az login

Varlık uç noktası oluşturma

Varsayılan olarak, Azure IoT İşlemleri dağıtımı yerleşik bir OPC PLC simülatörü içerir. Yerleşik OPC PLC simülatörünü kullanan bir varlık uç noktası oluşturmak için:

Azure IoT İşlemleri portalı

1. Varlık uç noktaları'nın ardından Varlık uç noktası oluştur'u seçin:

   

   İpucu

   Varlık uç noktalarını aramak için filtre kutusunu kullanabilirsiniz.

2. Aşağıdaki uç nokta bilgilerini girin:

   Alan	Değer
   Veri Akışı Adı	opc-ua-connector-0
   OPC UA Aracısı URL'si	opc.tcp://opcplc-000000:50000
   Kullanıcı kimlik doğrulaması	Anonymous
   Aktarım kimlik doğrulaması	Do not use transport authentication certificate

3. Tanımı kaydetmek için Oluştur'u seçin.

Azure CLI

Şu komutu çalıştırın:

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

İpucu

Erişiminiz olan kümeleri listelemek için kullanın az connectedk8s list .

Daha fazla bilgi edinmek için bkz . az iot ops asset endpoint.

Bu yapılandırma, kümeye adlı opc-ua-connector-0 yeni assetendpointprofile bir kaynak dağıtır. Bir varlığı tanımladıktan sonra OPC UA bağlayıcısı podu bu varlığı bulur. Pod, bir OPC UA sunucusuna bağlanmak için varlık tanımında belirttiğiniz varlık uç noktasını kullanır.

OPC PLC simülatörü çalışırken, veriler simülatörden, bağlayıcıya, OPC UA aracısına ve son olarak MQ aracısı'na akar.

Varlık uç noktasını kullanıcı adı ve parola kullanacak şekilde yapılandırma

Önceki örnekte kimlik doğrulama modu kullanılır Anonymous . Bu mod kullanıcı adı veya parola gerektirmez.

Azure IoT İşlemleri portalı

Kimlik doğrulama modunu kullanmak UsernamePassword için aşağıdaki adımları tamamlayın:

1. Azure Key Vault'ta kullanıcı adı ve parola gizli dizileri eklemek ve bunları Kubernetes kümesine yansıtmak için Kullanıcı adı ve parola ile OPC UA kullanıcı kimlik doğrulamasını yapılandırma'daki adımları izleyin.
2. Azure IoT İşlemleri (önizleme) portalında, varlık uç noktasını bu gizli dizileri kullanacak şekilde yapılandırmak için Kullanıcı kimlik doğrulaması alanı için Kullanıcı adı ve parola'yı seçin. Ardından Kullanıcı adı başvurusu ve Parola başvurusu alanları için aşağıdaki değerleri girin:

Alan	Değer
Kullanıcı adı başvurusu	aio-opc-ua-broker-user-authentication/username
Parola başvurusu	aio-opc-ua-broker-user-authentication/password

Azure CLI

Kimlik doğrulama modunu kullanmak UsernamePassword için aşağıdaki adımları tamamlayın:

1. Azure Key Vault'ta kullanıcı adı ve parola gizli dizileri eklemek ve bunları Kubernetes kümesine yansıtmak için Kullanıcı adı ve parola ile OPC UA kullanıcı kimlik doğrulamasını yapılandırma'daki adımları izleyin.

2. Varlık uç noktanızı oluşturmak için aşağıdaki örneğe benzer bir komut kullanın:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Varlık uç noktasını aktarım kimlik doğrulama sertifikası kullanacak şekilde yapılandırma

Varlık uç noktasını aktarım kimlik doğrulama sertifikası kullanacak şekilde yapılandırmak için aşağıdaki adımları tamamlayın:

Azure IoT İşlemleri portalı

1. Azure Key Vault'a aktarım sertifikası ve özel anahtar eklemek ve bunları Kubernetes kümesine yansıtmak için karşılıklı güveni yapılandırma adımlarını izleyin.
2. Azure IoT İşlemleri (önizleme) portalında Aktarım kimlik doğrulaması alanı için aktarım kimlik doğrulama sertifikasını kullan'ı seçin ve sertifika parmak izini girin.

Azure CLI

1. Azure Key Vault'a aktarım sertifikası ve özel anahtar eklemek ve bunları Kubernetes kümesine yansıtmak için karşılıklı güveni yapılandırma adımlarını izleyin.

2. Varlık uç noktanızı oluşturmak için aşağıdaki örneğe benzer bir komut kullanın:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Daha fazla bilgi edinmek için bkz . az iot ops asset.

Varlık, etiket ve olay ekleme

Azure IoT İşlemleri portalı

Azure IoT İşlemleri (önizleme) portalında varlık eklemek için:

1. Varlıklar sekmesini seçin. Varlık oluşturmadan önce aşağıdaki ekranı görürsünüz:

   

   İpucu

   Varlıkları aramak için filtre kutusunu kullanabilirsiniz.

   Varlık oluştur'u seçin.

2. Varlık ayrıntıları ekranında aşağıdaki varlık bilgilerini girin:

   • Varlık adı
   • Varlık uç noktası. Listeden varlık uç noktanızı seçin.
   • Açıklama

3. Varlıkla ilişkilendirmek istediğiniz özellik kümesini yapılandırın. Varsayılan özellik listesini kabul edebilir veya kendi özelliklerinizi ekleyebilirsiniz. Aşağıdaki özellikler varsayılan olarak kullanılabilir:

   • Üretici
   • Üretici URI'si
   • Model
   • Ürün kodu
   • Donanım sürümü
   • Yazılım sürümü
   • Seri numarası
   • Belge URI'si

   

4. Etiket ekle sayfasına gitmek için İleri'yi seçin.

Bir varlığa tek tek etiketler ekleme

Artık varlıkla ilişkili etiketleri tanımlayabilirsiniz. OPC UA etiketleri eklemek için:

1. Etiket ekle veya CSV > Etiket ekle'yi seçin.

2. Etiket ayrıntılarınızı girin:

   • Düğüm Kimliği. Bu değer, OPC UA sunucusundaki düğüm kimliğidir.
   • Etiket adı (İsteğe bağlı). Bu değer, etiket için kullanmak istediğiniz kolay addır. Etiket adı belirtmezseniz, etiket adı olarak düğüm kimliği kullanılır.
   • Aşağıdaki seçeneklerle gözlemlenebilirlik modu (İsteğe bağlı):
     • Hiçbiri
     • Ölçer
     • Sayaç
     • Histogram
     • Günlük
   • Örnekleme Aralığı (milisaniye). Bu etiket için varsayılan değeri geçersiz kılabilirsiniz.
   • Kuyruk boyutu. Bu etiket için varsayılan değeri geçersiz kılabilirsiniz.

   

   Aşağıdaki tabloda, yerleşik OPC PLC simülatörü ile kullanabileceğiniz bazı örnek etiket değerleri gösterilmektedir:

   Düğüm Kimliği	Etiket adı	Gözlemlenebilirlik modu
   ns=3; s=FastUInt10	sıcaklık	yok
   ns=3; s=FastUInt100	Etiket 10	yok

3. Varlık için varsayılan telemetri ayarlarını yapılandırmak için Varsayılan ayarları yönet'i seçin. Bu ayarlar, varlığa ait olan tüm OPC UA etiketleri için geçerlidir. Eklediğiniz her etiket için bu ayarları geçersiz kılabilirsiniz. Varsayılan telemetri ayarları şunlardır:

   • Örnekleme aralığı (milisaniye): Örnekleme aralığı, OPC UA Sunucusu'nun veri değişiklikleri için temel alınan kaynağını örneklemesi gereken en hızlı hızı gösterir.
   • Yayımlama aralığı (milisaniye): OPC UA Server'ın veri yayımlama hızı.
   • Kuyruk boyutu: Örnekleme verilerini yayımlamadan önce tutmak için kuyruğun derinliği.

Bir varlığa toplu olarak etiket ekleme

CSV dosyasından aynı anda en fazla 1000 OPC UA etiketini içeri aktarabilirsiniz:

1. Aşağıdaki örneğe benzer bir CSV dosyası oluşturun:

   NodeID	TagName	Örnekleme Aralığı Milisaniye	QueueSize	ObservabilityMode
   ns=3; s=FastUInt1000	Etiket 1000	1000	5	yok
   ns=3; s=FastUInt1001	Etiket 1001	1000	5	yok
   ns=3; s=FastUInt1002	Etiket 1002	Kategori 5000	10	yok

2. Etiket ekle veya CSV > CSV İçeri Aktar (.csv) dosyasını seçin. Oluşturduğunuz CSV dosyasını seçin ve Aç'ı seçin. CSV dosyasında tanımlanan etiketler içeri aktarılır:

   

   Mevcut etiketlerin yinelenenlerini içeren etiketler içeren bir CSV dosyasını içeri aktarırsanız, Azure IoT İşlemleri (önizleme) portalı aşağıdaki iletiyi görüntüler:

   

   Yinelenen etiketleri değiştirebilir ve içeri aktarma dosyasından yeni etiketler ekleyebilir veya içeri aktarma işlemini iptal edebilirsiniz.

3. Bir varlıktan CSV dosyasına tüm etiketleri dışarı aktarmak için Tümünü dışarı aktar'ı seçin ve dosya için bir konum seçin:

   

4. Etiketler sayfasında İleri'yi seçerek Olay ekle sayfasına gidin.

İpucu

Etiket aramak için filtre kutusunu kullanabilirsiniz.

Azure CLI

Azure CLI kullanarak bir "termostat" varlığı eklemek için aşağıdaki komutu kullanın. komutu parametresini kullanarak --data varlığa iki etiket ekler:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

Azure CLI kullanarak varlık oluşturduğunuzda şunları tanımlayabilirsiniz:

• parametresini --data birden çok kez kullanarak birden çok etiket.
• parametresini --event birden çok kez kullanarak birden çok olay.
• Varlık için aşağıdaki gibi isteğe bağlı bilgiler:
  • Üretici
  • Üretici URI'si
  • Model
  • Ürün kodu
  • Donanım sürümü
  • Yazılım sürümü
  • Seri numarası
  • Belge URI'si
• Örnekleme aralığı, yayımlama aralığı ve kuyruk boyutu için varsayılan değerler.
• Örnekleme aralığı, yayımlama aralığı ve kuyruk boyutu için belirli değerleri etiketleyin.
• Örnekleme yayımlama aralığı ve kuyruk boyutu için olaya özgü değerler.
• Her etiket ve olay için gözlemlenebilirlik modu

Bir varlığa tek tek olaylar ekleme

Azure IoT İşlemleri portalı

Artık varlıkla ilişkili olayları tanımlayabilirsiniz. OPC UA olayları eklemek için:

1. Olay ekle'yi veya CSV > Olay ekle'yi seçin.

2. Olay ayrıntılarınızı girin:

   • Olay belirleyicisi. Bu değer, OPC UA sunucusundan olay belirleyicidir.
   • Olay adı (İsteğe bağlı). Bu değer, olay için kullanmak istediğiniz kolay addır. Bir olay adı belirtmezseniz, olay adı olarak olay belirtecisi kullanılır.
   • Aşağıdaki seçeneklerle gözlemlenebilirlik modu (İsteğe bağlı):
     • Hiçbiri
     • Ölçer
     • Sayaç
     • Histogram
     • Günlük
   • Kuyruk boyutu. Bu etiket için varsayılan değeri geçersiz kılabilirsiniz.

   

3. Varlık için varsayılan olay ayarlarını yapılandırmak için Varsayılan ayarları yönet'i seçin. Bu ayarlar, varlığa ait olan tüm OPC UA olayları için geçerlidir. Eklediğiniz her olay için bu ayarları geçersiz kılabilirsiniz. Varsayılan olay ayarları şunlardır:

   • Yayımlama aralığı (milisaniye): OPC UA Server'ın veri yayımlama hızı.
   • Kuyruk boyutu: Örnekleme verilerini yayımlamadan önce tutmak için kuyruğun derinliği.

Bir varlığa toplu olarak olay ekleme

BIR CSV dosyasından aynı anda en fazla 1000 OPC UA olayını içeri aktarabilirsiniz.

Bir varlıktan CSV dosyasına tüm olayları dışarı aktarmak için Tümünü dışarı aktar'ı seçin ve dosya için bir konum seçin.

Olaylar sayfasında İleri'yi seçerek Gözden Geçir sayfasına gidin.

İpucu

Olayları aramak için filtre kutusunu kullanabilirsiniz.

Değişikliklerinizi inceleme

Varlığınızı ve OPC UA etiketinizi ve olay ayrıntılarınızı gözden geçirin ve ihtiyacınız olan ayarlamaları yapın:

Azure CLI

Azure CLI kullanarak bir varlık oluşturduğunuzda, parametresini --event birden çok kez kullanarak birden çok olay tanımlayabilirsiniz. parametresinin --event söz dizimi parametresine --data benzer:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

Tanımladığınız her olay için şunları belirtebilirsiniz:

• Olay belirleyicisi. Bu değer, OPC UA sunucusundan olay belirleyicidir.
• Olay adı. Bu değer, olay için kullanmak istediğiniz kolay addır. Bir olay adı belirtmezseniz, olay adı olarak olay belirtecisi kullanılır.
• Gözlemlenebilirlik modu.
• Kuyruk boyutu.

Varlığı güncelleştirme

Azure IoT İşlemleri portalı

Daha önce oluşturduğunuz varlığı bulun ve seçin. Değişiklik yapmak için Varlık ayrıntıları, Etiketler ve Olaylar sekmelerini kullanın:

Etiketler sekmesinde etiket ekleyebilir, mevcut etiketleri güncelleştirebilir veya etiketleri kaldırabilirsiniz.

Bir etiketi güncelleştirmek için var olan bir etiketi seçin ve etiket bilgilerini güncelleştirin. Ardından Güncelleştir'i seçin:

Etiketleri kaldırmak için bir veya daha fazla etiket seçin ve ardından Etiketleri kaldır'ı seçin:

Ayrıca olayları ve özellikleri aynı şekilde ekleyebilir, güncelleştirebilir ve silebilirsiniz.

Değişiklik yapmayı bitirdiğinizde, değişikliklerinizi kaydetmek için Kaydet'i seçin.

Azure CLI

Varlıklarınızı listelemek için aşağıdaki komutu kullanın:

az iot ops asset query -g {your resource group name}

İpucu

Belirli ölçütlerle eşleşen varlıkları aramak için sorgu komutunu geliştirebilirsiniz. Örneğin, varlıkları üreticiye göre arayabilirsiniz.

Termostat varlığının ayrıntılarını görüntülemek için aşağıdaki komutu kullanın:

az iot ops asset show --name thermostat -g {your resource group}

Bir varlığı güncelleştirmek için komutunu kullanın az iot ops asset update . Örneğin, varlığın açıklamasını güncelleştirmek için aşağıdaki örneğe benzer bir komut kullanın:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

Termostat varlığının etiketlerini listelemek için aşağıdaki komutu kullanın:

az iot ops asset data-point list --asset thermostat -g {your resource group}

Termostat varlığının olaylarını listelemek için aşağıdaki komutu kullanın:

az iot ops asset event list --asset thermostat -g {your resource group}

Termostat varlığına yeni bir etiket eklemek için aşağıdaki örneğe benzer bir komut kullanın:

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

Etiketi silmek için komutunu kullanın az iot ops asset data-point remove .

Komutları kullanarak bir varlığın olaylarını az iot ops asset event yönetebilirsiniz.

Varlığı silme

Azure IoT İşlemleri portalı

Bir varlığı silmek için silmek istediğiniz varlığı seçin. Varlık ayrıntıları sayfasında Sil'i seçin. Varlığı silmek için yaptığınız değişiklikleri onaylayın:

Azure CLI

Bir varlığı silmek için aşağıdaki örneğe benzer bir komut kullanın:

az iot ops asset delete --name thermostat -g {your resource group name}

Notifications

Azure IoT İşlemleri (önizleme) portalında varlıkta her değişiklik yaptığınızda işlemin durumunu bildiren bir bildirim görürsünüz:

İlgili içerik

• Azure OPC UA Aracısı'ne genel bakış
• Azure IoT Akri'ye Genel Bakış
• az iot ops asset
• az iot ops asset endpoint