IoT Hub için Cihaz Güncelleştirmesi tanılamalarına genel bakış

IoT Hub için Cihaz Güncelleştirmesi, cihaz tarafı hatalarını tanılamanıza ve gidermenize yardımcı olan çeşitli özelliklere sahiptir. Kullanılabilir üç tanılama özelliği vardır:

  • Dağıtım hata kodları doğrudan Cihaz Güncelleştirmesi kullanıcı arabiriminde görüntülenebilir.

  • Uzak günlük toplama , hedeflenen cihazlara cihaz içi tanılama günlüklerini bağlı bir Azure Blob depolama hesabına yükleme talimatı veren günlük işlemlerinin oluşturulmasını sağlar.

  • Aracı Denetimi , bağlı IoT Hub'ına kayıtlı ancak Cihaz Güncelleştirmesi'nde görünmeyen cihazları tanılama amacıyla Cihaz Güncelleştirmesi örneğine kayıtlı cihazlarda doğrulama denetimleri çalıştırır.

Kullanıcı arabiriminde dağıtım hata kodları

Bir cihaz, Cihaz Güncelleştirme hizmetine bir dağıtım hatası bildirdiğinde, Cihaz Güncelleştirme kullanıcı arabirimi, cihazın bildirilen resultCode ve extendedResultCode bilgilerini kullanıcı arabiriminde görüntüler. Bu kodları görüntülemek için aşağıdaki adımları kullanın:

  1. Azure portalında IoT hub'ınıza gidin.

  2. Güncelleştirmeler'i seçin ve ardından Gruplar ve Dağıtımlar sekmesine gidin.

  3. Grup ayrıntıları sayfasına ulaşmak için etkin dağıtımı olan bir grubun adını seçin.

  4. Cihaz ayrıntıları panelini açmak için Cihaz listesinden herhangi bir cihaz adını seçin. Burada cihazın bildirdiği sonuç kodunu görebilirsiniz.

  5. Cihaz Güncelleştirmesi başvuru aracısı, sonuç kodu alanı için standart HTTP durum kodu kuralına uyar (örneğin, "200" başarılı olduğunu gösterir). Sonuç kodlarını ayrıştırma hakkında daha fazla bilgi için bkz. Cihaz Güncelleştirmesi istemci hata kodları.

    Uyarı

    Cihaz Güncelleştirme aracınızı özelleştirilmiş sonuç kodlarını bildirecek şekilde değiştirdiyseniz, sayısal kodlar yine de Cihaz Güncelleştirmesi kullanıcı arabirimine geçirilir. Daha sonra bu sayısal kodları ayrıştırmak için oluşturduğunuz tüm belgelere başvurabilirsiniz.

Uzak günlük koleksiyonu

Bir hatayı tanılamak ve gidermek için cihazdan daha fazla bilgi gerektiğinde, hedeflenen cihazlara cihaz içi tanılama günlüklerini bağlı bir Azure Blob depolama hesabına yüklemelerini bildirmek için günlük toplama özelliğini kullanabilirsiniz. Cihazlardan tanılama günlüklerini uzaktan toplama başlığındaki yönergeleri izleyerek bu özelliği kullanmaya başlayabilirsiniz.

Cihaz Güncelleştirmesi'nin (Device Update) uzak günlük toplama özelliği, hizmet odaklı ve işlem esaslı bir işlevdir. Günlük toplamadan yararlanmak için bir cihazın yalnızca Tanılama arabirimini ve yapılandırma dosyasını uygulayabilmesi ve SDK aracılığıyla Azure Blob depolamaya dosya yükleyebilmesi gerekir.

Yüksek düzeyden günlük toplama özelliği aşağıdaki gibi çalışır:

  1. Cihaz Güncelleştirmesi kullanıcı arabirimini veya API'lerini kullanarak Tanılama arabirimini uygulayan en fazla 100 cihazı hedefleyen yeni bir günlük işlemi oluşturursunuz.

  2. Cihaz Güncelleştirme hizmeti, Tanılama arabirimini kullanarak hedeflenen cihazlara günlük toplama başlangıç mesajı gönderir. Bu başlangıç iletisi, günlük işleme kimliği ve ilişkili Azure Depolama hesabına yükleme için bir SAS belirteci içerir.

  3. Başlangıç iletisini aldıktan sonra, hedeflenen cihazın Cihaz Güncelleştirme aracısı, cihaz içi aracı yapılandırma dosyasında belirtilen bir veya daha fazla önceden tanımlanmış dosya yolu içinde dosyaları toplamaya ve karşıya yüklemeye çalışır. Cihaz Güncelleştirmesi referans aracısı, varsayılan olarak Cihaz Güncelleştirme aracısı tanılama günlüğünü (aduc.log) ve DO Aracısı tanılama günlüğü ("do-agent.log") yükleyecek şekilde yapılandırılır.

  4. Cihaz Güncelleştirme aracısı daha sonra işlemin durumunu ( Başarılı veya Başarısız) işlem günlüğü kimliği, ResultCode ve ExtendedResultCode dahil olmak üzere hizmete geri bildirir. Cihaz Güncelleştirme aracısı günlük işlemini başarısız olursa, otomatik olarak üç kez yeniden denemeyi dener ve yalnızca son durumu hizmete geri bildirir.

  5. Tüm hedeflenen cihazlar terminal durumunu Cihaz Güncelleştirme hizmetine geri bildirdikten sonra, Cihaz Güncelleştirme hizmeti günlük işlemini Başarılı veya Başarısız olarak işaretler. Başarılı bir günlük işlemi, hedeflenen tüm cihazların günlük işlemini başarıyla tamamlandığını gösterir. Başarısız bir kayıt işlemi, en az bir hedef cihazın kayıt işleminin başarısız olduğunu gösterir.

    Uyarı

    Günlük işlemi hedeflenen cihazlar tarafından paralel olarak gerçekleştirildiğinden, hedeflenen bazı cihazlar günlükleri başarıyla karşıya yüklemiş olabilir, ancak genel günlük işlemi başarısız olarak işaretlenir. Kullanıcı arabirimi veya API'ler aracılığıyla günlük işlemi ayrıntılarını görüntüleyerek hangi cihazların başarılı ve hangilerinin başarısız olduğunu görebilirsiniz.

Ajan Kontrolü

Cihazınız IoT Hub'a kaydedildiğinde ancak Cihaz Güncelleştirmesi örneğinizde görünmediğinde, temel sorunu tanılamanıza yardımcı olmak üzere önceden yapılmış doğrulama denetimleri çalıştırmak için Aracı Denetimi özelliğini kullanabilirsiniz. Bu aracı denetimi yönergelerini izleyerek bu özelliği kullanmaya başlayabilirsiniz.

Genel olarak, aracı denetim özelliği aşağıdaki şekilde çalışır:

  1. Bir cihazı IoT Hub'a kaydedersiniz. Cihaz, IoT Hub için Cihaz Güncelleştirmesi ile uyumlu olanlarla eşleşen bir Model Kimliği bildirirse, bağlı Cihaz Güncelleştirmesi örneğiniz cihazı Cihaz Güncelleştirmesi'ne otomatik olarak kaydeder.
  2. Bir cihazın Cihaz Güncelleştirmesi tarafından düzgün yönetilebilmesi için, Aracı Denetimi'nin önceden yapılmış doğrulama denetimleri kullanılarak doğrulanabilir belirli ölçütleri karşılaması gerekir. Bu ölçütler hakkında daha fazla bilgiyi burada bulabilirsiniz.
  3. Bir cihaz bu ölçütlerin tümünü karşılamıyorsa Cihaz Güncelleştirmesi tarafından düzgün yönetilemiyor ve Cihaz Güncelleştirmesi arabiriminde veya API yanıtlarında görünmüyor. Aracı Denetimi'ni kullanarak bu cihazı bulabilir ve Aracı Denetimi'ni kullanarak hangi ölçütlerin karşılanmadığı belirlemeye çalışabilirsiniz.
  4. Hangi ölçütlerin karşılanmadığını belirledikten sonra sorunu düzeltebilirsiniz ve cihazın Cihaz Güncelleştirmesi arabiriminde düzgün görünmesi gerekir.

Sonraki Adımlar

Cihaz Güncelleştirmesi'nin uzak günlük toplama ve Agent Check özelliklerini kullanmayı öğrenin:

  • Last updated on