IoT Hub için Cihaz Güncelleştirmesi'ni kullanarak cihazlardan tanılama günlüklerini uzaktan toplama

IoT Hub günlük işlemi için Cihaz Güncelleştirmesi başlatmayı ve Toplanan günlükleri Azure blob depolamada görüntülemeyi öğrenin.

Önkoşullar

• IoT Hub için Cihaz Güncelleştirmesi'nin etkinleştirildiği bir IoT Hub'a erişim.
• IoT Hub içinde Cihaz Güncelleştirmesi için sağlanan ve Tanılama Arabirimini uygulayan bir IoT cihazı (veya simülatörü).
• IoT Hub için Cihaz Güncelleştirmesi hesabınızla aynı abonelik altında bir Azure Blob depolama hesabı.

Not

Uzak günlük toplama özelliği şu anda yalnızca Tanılama Arabirimini uygulayan ve Azure Blob depolamaya dosya yükleyebilen cihazlarla uyumludur. Başvuru aracısı uygulaması, cihazın günlük dosyalarını cihazda kullanıcı tarafından belirtilen bir dosya yoluna yazmasını da bekler.

Azure portalı

Desteklenen tarayıcılar:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI ortamı:

• Azure Cloud Shell'de Bash ortamını kullanın.

  

• Veya CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin

  • az login komutunu kullanarak Azure CLI'da oturum açın .
  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
  • İstendiğinde, azure CLI uzantılarını ilk kullanımda yükleyin. Bu makaledeki komutlar azure-iot uzantısını kullanır. Uzantının en son sürümünü kullandığınızdan emin olmak için komutunu çalıştırın az extension update --name azure-iot .

İpucu

Bu makaledeki Azure CLI komutları, komut bağımsız değişkenlerinin daha kolay okunması için satır devamı için ters eğik çizgi \ karakterini kullanır. Bu söz dizimi Bash ortamlarında çalışır. Bu komutları PowerShell'de çalıştırıyorsanız, her ters eğik çizgiyi ''' ters işaretiyle değiştirin veya tamamen kaldırın.

Azure Blob depolama hesabınızı Cihaz Güncelleştirmesi örneğine bağlama

Uzak günlük toplama özelliğini kullanmak için önce Bir Azure Blob depolama hesabını Cihaz Güncelleştirmesi örneğine bağlamanız gerekir. Bu Azure Blob depolama hesabı, cihazlarınızın tanılama günlüklerini karşıya yükleyeceği yerdir.

Azure portalı

1. Azure portalında IoT Hub için Cihaz Güncelleştirmesi hesabınıza gidin.

2. Gezinti bölmesinin Örnek Yönetimi bölümünde Örnekler'i seçin.

3. Listeden Cihaz Güncelleştirmesi örneğinizi ve ardından Tanılamayı Yapılandır'ı seçin.

4. Müşteri Tanılama sekmesini ve ardından Azure Depolama Hesabı'nı seçin.

5. Listeden istediğiniz depolama hesabını seçin ve Kaydet'i seçin .

6. Örnek listesine geri döndükten sonra, örneğin sağlama durumu "Başarılı" olarak gösterene kadar düzenli aralıklarla yenile'yi seçin. Bu işlem genellikle 2-3 dakika sürer.

Azure CLI

Cihaz Güncelleştirmesi örneğinize yönelik tanılamaları yapılandırmak için az iot du instance create komutunu kullanın.

İpucu

Komutunu mevcut Bir Cihaz Güncelleştirmesi örneğinde kullanabilirsiniz az iot du instance create ve bu komut örneği güncelleştirilmiş parametrelerle yapılandıracaktır.

Aşağıdaki yer tutucuları kendi bilgilerinizle değiştirin:

• <>account_name: Cihaz Güncelleştirme hesabınızın adı.
• <>instance_name: Cihaz Güncelleştirme örneğinizin adı.
• <>storage_id: Tanılama günlüklerinin depolanacağı depolama hesabının kaynak kimliği. az storage show komutunu kullanarak ve kimlik değeri için sorgulama yaparak kaynak kimliğini alabilirsiniz: az storage account show -n <storage_name> --query id.

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

Günlük toplamayı yapılandırma

Cihaz güncelleştirme aracısı, başvuru aracısında /etc/adu/du-diagnostics-config.json konumunda bulunan cihazdaki bir yapılandırma dosyasına başvurur.

Günlük toplama dosyası yolları

Bir cihazdaki Cihaz Güncelleştirmesi aracısı, Cihaz Güncelleştirme hizmetinden günlük yükleme başlangıç sinyali aldığında cihazdaki belirli dosya yollarından dosya toplar. Bu dosya yolları tanılama yapılandırma dosyasında tanımlanır.

Yapılandırma dosyasında, toplanacak ve karşıya yüklenecek her günlük dosyası componentName ve logPath özelliklerine sahip bir logComponent nesne olarak temsil edilir. Bu yapılandırma istediğiniz gibi değiştirilebilir.

Günlük dosyası boyutu üst sınırı

Cihaz Güncelleştirme aracısı günlük dosyalarını yalnızca belirli bir dosya boyutu altında toplar. Bu en büyük dosya boyutu tanılama yapılandırma dosyasında tanımlanır.

İlgili "maxKilobytesToUploadPerLogPath" parametresi her logComponent nesnesine uygulanır ve istenildiği gibi değiştirilebilir.

Günlük işlemi oluşturma

Günlük işlemleri, IoT cihazlarınıza Cihaz Güncelleştirme hizmeti aracılığıyla gerçekleştirmeleri için talimat veleyebileceğiniz hizmet temelli bir eylemdir. Günlük işlemlerinin nasıl çalıştığının daha ayrıntılı bir açıklaması için bkz . Cihaz güncelleştirme tanılaması.

Azure portalı

1. IoT Hub'ınıza gidin ve gezinti bölmesinin Cihaz Yönetimi bölümünün altındaki Güncelleştirmeler sekmesini seçin.

2. Kullanıcı arabiriminde Tanılama sekmesini seçin. Tanılama sekmesi görmüyorsanız IoT Hub için Cihaz Güncelleştirmesi kullanıcı arabiriminin en yeni sürümünü kullandığınızdan emin olun. "Bu Cihaz Güncelleştirmesi örneği için tanılama etkinleştirilmelidir" ifadesini görüyorsanız, Cihaz Güncelleştirmesi örneğiniz ile bir Azure Blob depolama hesabı bağladığınızdan emin olun.

3. Günlük işlemi oluşturma sayfasına gitmek için Günlük karşıya yükleme işlemi ekle'yi seçin.

4. Yeni günlük işleminiz için bir ad (kimlik) ve açıklama girin, ardından Tanılama günlüklerini hangi IoT cihazlarından toplamak istediğinizi seçmek için Cihaz ekle'yi seçin.

5. Ekle'yi seçin.

6. Tanılama sekmesine döndüğünüzde, İşlem Tablosunda günlük işleminizin listelendiğini görene kadar Yenile'yi seçin.

7. İşlem durumu Başarılı veya Başarısız olduğunda, ayrıntılarını görüntülemek için işlem adını seçin. Yalnızca hedeflenen tüm cihazlar günlüğü karşıya yüklemeyi başarıyla tamamlarsa bir işlem "Başarılı" olarak işaretlenir. Hedeflenen bazı cihazlar başarılı ve bazıları başarısız olursa günlük işlemi "Başarısız" olarak işaretlenir. Hangi cihazların başarılı ve hangilerinin başarısız olduğunu görmek için günlük işlemi ayrıntıları sayfasını kullanabilirsiniz.

8. Günlük işlemi ayrıntılarında cihaza özgü durumu görüntüleyebilir ve günlük konumu yolunu görebilirsiniz. Bu yol, tanılama günlüklerinin karşıya yüklendiği Azure Blob depolama hesabınızdaki sanal dizin yoluna karşılık gelir.

Azure CLI

Tanılama günlüğü toplama işlemini yapılandırmak için az iot du device log collect komutunu kullanın.

komutu device log collect aşağıdaki bağımsız değişkenleri alır:

• --account: Cihaz Güncelleştirme hesabı adı.
• --instance: Cihaz Güncelleştirmesi örneği adı.
• --log-collection-id: Günlük toplama işlemi için bir ad.
• --agent-id: Bu günlük toplama işlemi için hedef Cihaz Güncelleştirme aracısını tanımlayan Anahtar=değer çiftleri. Aracının cihaz kimliği varsa kullanın deviceId=<device name> . Aracının modül kimliği varsa kullanın deviceId=<device name> moduleId=<module name> . Birden çok cihazı hedeflemek için parametresini birden çok kez kullanabilirsiniz --agent-id .

Örneğin:

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

Belirli bir tanılama günlüğü toplama işleminin ayrıntılarını görüntülemek için az iot du device log show komutunu kullanın.

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>

Toplanan tanılama günlüklerini görüntüleme ve dışarı aktarma

1. Günlük işleminiz başarılı olduktan sonra Azure Blob depolama hesabınıza gidin.

2. Gezinti bölmesinin Veri depolama bölümünde Kapsayıcılar'ı seçin.

3. Cihaz Güncelleştirme örneğiniz ile aynı ada sahip kapsayıcıyı seçin.

4. Günlükleri içeren doğru dizine gitmek için günlük işlemi ayrıntılarındaki günlük konumu yolunu kullanın. Varsayılan olarak, uzak günlük toplama özelliği hedeflenen cihazlara şu dizin yolu modelini kullanarak tanılama günlüklerini karşıya yükleme talimatı verir: Blob depolama kapsayıcısı/Hedef cihaz kimliği/Günlük işlemi kimliği/Cihaz içi günlük yolu

5. Cihaz Güncelleştirme aracısının tanılama bileşenini değiştirmediyseniz, cihaz iki düz metin günlük dosyasını karşıya yüklemeyi deneyerek herhangi bir günlük işlemine yanıt verir: Cihaz Güncelleştirme aracısı tanılama günlüğü ("aduc.log") ve DO aracısı tanılama günlüğü ("do-agent.log"). Cihaz Güncelleştirmesi tanılama kavramı sayfasını okuyarak Cihaz Güncelleştirmesi başvuru aracısının hangi günlük dosyalarını topladığı hakkında daha fazla bilgi edinebilirsiniz.

6. Günlük dosyasının içeriğini görüntülemek için dosya adını ve ardından menü öğesini (üç nokta) seçip Görüntüle/düzenle'ye tıklayabilirsiniz. Ayrıca, sırasıyla etiketlenmiş seçenekleri seçerek günlük dosyasını indirebilir veya silebilirsiniz.

   

Sonraki adımlar

Cihaz Güncelleştirmesi'nin tanılama özellikleri hakkında daha fazla bilgi edinmek için bkz . Cihaz güncelleştirmesi tanılama özelliğine genel bakış