IoT Hub tanılama için Cihaz Güncelleştirmesi'ne genel bakış

  • Makale

IoT Hub için Cihaz Güncelleştirmesi, cihaz tarafı hatalarını tanılamanıza ve gidermenize yardımcı olan çeşitli özelliklere sahiptir. v0.9.0 aracısının kullanıma sunulmasıyla birlikte üç 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 bağlı bir Azure Blob depolama hesabına cihaz içi tanılama günlüklerini yükleme talimatı veren günlük işlemlerinin oluşturulmasını sağlar

  • Aracı Denetimi, bağlı IoT Hub 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ştirmesi hizmetine bir dağıtım hatası bildirdiğinde, Cihaz Güncelleştirmesi kullanıcı arabirimi cihazın bildirilen resultCode ve extendedResultCode kullanıcı arabiriminde görüntülenir. Bu kodları görüntülemek için aşağıdaki adımları kullanın:

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

  2. Güncelleştirmeler'ı 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ını izler (ö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ı.

    Not

    Cihaz Güncelleştirmesi aracınızı özelleştirilmiş sonuç kodlarını raporlayacak ş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 toplama

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 uzak günlük koleksiyonu, hizmet temelli, işlem tabanlı bir özelliktir. 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 itibaren günlük toplama özelliği aşağıdaki gibi çalışır:

  1. Kullanıcı, 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şturur.

  2. Cihaz Güncelleştirme hizmeti, Tanılama arabirimini kullanarak hedeflenen cihazlara bir günlük koleksiyonu başlangıç iletisi gönderir. Bu başlangıç iletisi, günlük işlemi kimliğini ve ilişkili Azure Depolama hesabına yüklemek 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 önceden tanımlanmış dosya yollarındaki dosyaları toplamaya ve karşıya yüklemeye çalışır. Cihaz Güncelleştirmesi başvuru aracısı varsayılan olarak Cihaz Güncelleştirmesi aracısı tanılama günlüğünü ()aduc.log ve DO Aracısı tanılama günlüğünü ("do-agent.log") karşıya yükleyecek şekilde yapılandırılmıştır.

  4. Cihaz Güncelleştirmesi aracısı daha sonra günlük işlemi kimliği, ResultCode ve ExtendedResultCode dahil olmak üzere işlemin durumunu ( Başarılı veya Başarısız) 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 hizmete yalnızca son durumu bildirir.

  5. Tüm hedeflenen cihazlar terminal durumlarını Cihaz Güncelleştirme hizmetine geri bildirdikten sonra, Cihaz Güncelleştirmesi 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 tamamladığını gösterir. Başarısız günlük işlemi, en az bir hedeflenen cihazın günlük işleminin başarısız olduğunu gösterir.

    Not

    Günlük işlemi hedeflenen cihazlar tarafından paralel olarak gerçekleştirildiğinden, hedeflenen bazı cihazların günlükleri başarıyla karşıya yüklemesi mümkündür, 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.

Aracı Denetimi

Cihazınız IoT Hub kayıtlıyken Cihaz Güncelleştirmesi örneğinizde görünmüyorsa, temel alınan sorunu tanılamanıza yardımcı olmak üzere önceden yapılmış doğrulama denetimleri çalıştırmak için Aracı Denetimi özelliğini kullanabilirsiniz. Aracı Denetimi yönergelerini izleyerek bu özelliği kullanmaya başlayabilirsiniz.

Aracı denetimi özelliği üst düzeyden aşağıdaki gibi çalışır:

  • Kullanıcı bir cihazı IoT Hub kaydeder. Cihaz, IoT Hub için Cihaz Güncelleştirmesi ile uyumlu olanlarla eşleşen bir Model Kimliği bildirirse, kullanıcının bağlı Cihaz Güncelleştirmesi örneği cihazı otomatik olarak Cihaz Güncelleştirmesi'ne kaydeder.

  • Bir cihazın Cihaz Güncelleştirmesi tarafından düzgün bir şekilde yönetilebilmesi için, Aracı Denetimi'nin önceden yapılmış doğrulama denetimleri kullanılarak doğrulanabilir bazı ölçütleri karşılaması gerekir. Bu ölçütler hakkında daha fazla bilgiyi burada bulabilirsiniz.

  • Bir cihaz bu ölçütlerin tümünü karşılamıyorsa Cihaz Güncelleştirmesi tarafından düzgün şekilde yönetilemez ve Cihaz Güncelleştirmesi arabiriminde veya API yanıtlarında gösterilmez. Kullanıcılar bu cihazı bulmak ve Aracı Denetimi'ni kullanarak hangi ölçütlerin karşılanmadığını belirlemeye çalışmak için Aracı Denetimi'ni kullanabilir.

  • Kullanıcı hangi ölçütlerin karşılanmadığını belirledikten sonra, kullanıcı sorunu düzeltebilir 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 Aracı Denetimi özelliklerini kullanmayı öğrenin: