az iot central diagnostics

Başvuru

Not

Bu başvuru, Azure CLI (sürüm 2.30.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, az iot central diagnostics komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Uygulama ve cihaz düzeyinde tanılama gerçekleştirin.

Komutlar

az iot central diagnostics monitor-events	IoT Central uygulamasına gönderilen cihaz telemetri iletilerini görüntüleyin.
az iot central diagnostics monitor-properties	IoT Central uygulamasına/uygulamasından gönderilen/gönderilen istenen ve bildirilen özellikleri görüntüleyin.
az iot central diagnostics registration-summary	Bir uygulamadaki tüm cihazların kayıt özetini görüntüleyin.
az iot central diagnostics validate-messages	IoT Central uygulaması için IoT Hub gönderilen iletileri doğrulayın.
az iot central diagnostics validate-properties	IoT Central uygulamasına gönderilen bildirilen özellikleri doğrulayın.

az iot central diagnostics monitor-events

IoT Central uygulamasına gönderilen cihaz telemetri iletilerini görüntüleyin.

IoT Central uygulamasına gönderilen telemetri verilerini gösterir. Varsayılan olarak, tüm cihazlar tarafından gönderilen tüm verileri gösterir. Belirli bir cihazı filtrelemek için --device-id parametresini kullanın.

az iot central diagnostics monitor-events --app-id
                                          [--central-api-uri]
                                          [--cg]
                                          [--device-id]
                                          [--enqueued-time]
                                          [--module-id]
                                          [--properties {all, anno, app, sys}]
                                          [--repair {false, true}]
                                          [--timeout]
                                          [--token]
                                          [--yes {false, true}]

Örnekler

Temel kullanım

az iot central diagnostics monitor-events --app-id {app_id}

Hedef cihazda filtreleme yaparken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}

Kimliğinde joker karakter bulunan hedeflenen cihazları filtrelerken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -d Device*d

Modülde filtreleme yaparken temel kullanım.

az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}

Kimliğinde joker karakter bulunan hedeflenen modülleri filtrelerken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -m Module*

Cihazı filtreleyin ve bağlanılacak bir Olay Hub'ı tüketici grubu belirtin.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --cg {consumer_group_name}

İleti ek açıklamalarını alma (ileti üst bilgileri)

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno

İleti ek açıklamaları + sistem özellikleri alın. Asla zaman aşımına uğradım.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0

Tüm cihaz iletilerinden tüm ileti özniteliklerini alma

az iot central diagnostics monitor-events --app-id {app_id} --props all

Tüm iletileri alma ve ileti yükünü JSON olarak ayrıştırma

az iot central diagnostics monitor-events --app-id {app_id} --output json

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliği'ni yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com

--cg --consumer-group -c

Olay hub'ı uç noktasına bağlanırken kullanılacak tüketici grubunu belirtin.

varsayılan değer: $Default

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

--enqueued-time --et -e

Bölümlerden iletileri okumak için başlangıç noktası olarak kullanılması gereken zamanı gösterir. Unix döneminin bu yana birimleri milisaniyedir. Hiçbir zaman belirtilmeyen "şimdi" kullanılır.

--module-id -m

Cihaz türü IoT Edge ise modül kimliğini IoT Edge.

--properties --props -p

Çıkış için anahtar ileti özelliklerini belirtin. sys = sistem özellikleri, uygulama = uygulama özellikleri, anno = ek açıklamalar.

kabul edilen değerler: all, anno, app, sys

--repair -r

Uzantı sürümüyle uyumlu uamqp bağımlılığını yeniden yükleyin. Varsayılan: false.

kabul edilen değerler: false, true

--timeout --to -t

İleti alınmadan bağlantının sürdürülmesi için en fazla saniye sayısı. Sonsuzluk için 0 kullanın.

varsayılan değer: 300

--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtarın türünü belirtmeniz gerekir. adresinden daha fazla https://aka.ms/iotcentraldocsapibilgi edinin.

--yes -y

Kullanıcı istemlerini atlayın. Bağımlılık yüklemesinin kabul edilmesini gösterir (gerekirse). Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot central diagnostics monitor-properties

IoT Central uygulamasına/uygulamasından gönderilen/gönderilen istenen ve bildirilen özellikleri görüntüleyin.

Cihaz ikizini merkezi olarak yoklar ve son cihaz ikizi ile karşılaştırır Cihaz ikizinden özellikleri ayrıştırır ve değişikliklerin yapılıp yapılmadığını algılar Yoklama aralığı içinde değiştirilen özelliklerin alt kümesini yazdırır.

az iot central diagnostics monitor-properties --app-id
                                              --device-id
                                              [--central-api-uri]
                                              [--token]

Örnekler

Temel kullanım

az iot central diagnostics monitor-properties --app-id {app_id} -d {device_id}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliği'ni yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com

--token

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot central diagnostics registration-summary

Bir uygulamadaki tüm cihazların kayıt özetini görüntüleyin.

Not: Uygulamanız çok fazla cihaz içeriyorsa bu komutun döndürülmesi önemli ölçüde zaman alabilir.

az iot central diagnostics registration-summary --app-id
                                                [--api-version {1.0, 1.1-preview, preview}]
                                                [--central-api-uri]
                                                [--token]

Örnekler

Kayıt özeti

az iot central diagnostics registration-summary --app-id {appid}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliği'ni yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--api-version --av

İstenen işlem için API sürümü.

kabul edilen değerler: 1.0, 1.1-preview, preview

varsayılan değer: 1.0

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com

--token

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot central diagnostics validate-messages

IoT Central uygulaması için IoT Hub gönderilen iletileri doğrulayın.

Telemetri iletilerinde doğrulamalar gerçekleştirir ve cihaz şablonunda modellenmemiş verileri veya veri türünün cihaz şablonunda tanımlanan verilerle eşleşmediği verileri raporlar.

az iot central diagnostics validate-messages --app-id
                                             [--central-api-uri]
                                             [--cg]
                                             [--device-id]
                                             [--dr]
                                             [--enqueued-time]
                                             [--max-messages]
                                             [--minimum-severity {error, info, warning}]
                                             [--module-id]
                                             [--properties {all, anno, app, sys}]
                                             [--repair {false, true}]
                                             [--style {csv, json, scroll}]
                                             [--timeout]
                                             [--token]
                                             [--yes {false, true}]

Örnekler

Temel kullanım

az iot central diagnostics validate-messages --app-id {app_id}

Algılanan çıkış hataları

az iot central diagnostics validate-messages --app-id {app_id} --style scroll

Hedef cihazda filtreleme yaparken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}

Kimliğinde joker karakter bulunan hedeflenen cihazları filtrelerken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -d Device*

Modülde filtreleme yaparken temel kullanım.

az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}

Kimliğinde joker karakter bulunan hedeflenen modülleri filtrelerken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -m Module*

Cihazı filtreleyin ve bağlanılacak bir Olay Hub'ı tüketici grubu belirtin.

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliği'ni yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com

--cg --consumer-group -c

Olay hub'ı uç noktasına bağlanırken kullanılacak tüketici grubunu belirtin.

varsayılan değer: $Default

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

--dr --duration

Bağlantıyı sonlandırmadan önce hedef cihazdan ileti alma süresi üst sınırı. Sonsuzluk için 0 kullanın.

varsayılan değer: 300

--enqueued-time --et -e

--max-messages --mm

Bağlantıyı sonlandırmadan önce hedef cihazdan alınacak ileti sayısı üst sınırı. Sonsuzluk için 0 kullanın.

varsayılan değer: 10

--minimum-severity

Raporlama için gereken sorunun en düşük önem derecesi.

kabul edilen değerler: error, info, warning

varsayılan değer: warning

--module-id -m

Cihaz türü IoT Edge ise modül kimliğini IoT Edge.

--properties --props -p

Çıkış için anahtar ileti özelliklerini belirtin. sys = sistem özellikleri, uygulama = uygulama özellikleri, anno = ek açıklamalar.

kabul edilen değerler: all, anno, app, sys

--repair -r

Uzantı sürümüyle uyumlu uamqp bağımlılığını yeniden yükleyin. Varsayılan: false.

kabul edilen değerler: false, true

--style

Çıktı stillerini belirtincroll = teslim hataları geldikçe, json = sonuçları json olarak özetle, csv = sonuçları csv olarak özetle.

kabul edilen değerler: csv, json, scroll

varsayılan değer: scroll

--timeout --to -t

İleti alınmadan bağlantının sürdürülmesi için en fazla saniye sayısı. Sonsuzluk için 0 kullanın.

varsayılan değer: 300

--token

--yes -y

Kullanıcı istemlerini atlayın. Bağımlılık yüklemesinin kabul edilmesini gösterir (gerekirse). Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot central diagnostics validate-properties

IoT Central uygulamasına gönderilen bildirilen özellikleri doğrulayın.

Bildirilen özellik güncelleştirmelerinde doğrulamalar gerçekleştirir:

Uyarı - Cihaz tarafından gönderilen ve merkezi olarak modellenmemiş özellikler.
Uyarı - Birden çok arabirimde bildirilen aynı ada sahip özellikler, özellik güncelleştirmesinin bir parçası olarak arabirim adına sahip olmalıdır.

az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Örnekler

Temel kullanım

az iot central diagnostics validate-properties --app-id {app_id} -d {device_id}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliği'ni yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com

--minimum-severity

Raporlama için gereken sorunun en düşük önem derecesi.

kabul edilen değerler: error, info, warning

varsayılan değer: warning

--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. anahtarın türünü isteğin bir parçası olarak belirtmeniz gerekir. daha fazla bilgi için bkz https://aka.ms/iotcentraldocsapi. .

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.