Condividi tramite


az dt twin telemetry

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az dt twin telemetry. Altre informazioni sulle estensioni.

Testare e convalidare le route di eventi e gli endpoint di un'istanza di Gemelli digitali.

Comandi

Nome Descrizione Tipo Status
az dt twin telemetry send

Invia i dati di telemetria per conto di un gemello digitale. Se viene fornito il percorso del componente, i dati di telemetria generati sono per conto del componente.

Estensione GA

az dt twin telemetry send

Invia i dati di telemetria per conto di un gemello digitale. Se viene fornito il percorso del componente, i dati di telemetria generati sono per conto del componente.

az dt twin telemetry send --dt-name
                          --twin-id
                          [--component]
                          [--dt-id]
                          [--resource-group]
                          [--telemetry]
                          [--telemetry-source-time]

Esempio

Inviare dati di telemetria dei dispositivi gemelli

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id}

Inviare dati di telemetria del dispositivo gemello con un timestamp di origine e un identificatore di messaggio di telemetria personalizzati

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id} --tst {telemetry_source_timestamp} --dt-id {dt_id}

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

--component

Percorso del componente DTDL. Se impostato, i dati di telemetria verranno generati per conto del componente.

--dt-id

Identificatore univoco del messaggio (nell'ambito dell'ID del gemello digitale) comunemente usato per la deduplicazione dei messaggi. Se non viene fornito alcun valore, viene generato automaticamente un GUID.

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}.

--telemetry

JSON di telemetria inline o percorso del file per i dati di telemetria JSON. Il payload predefinito è un oggetto vuoto: {}.

--telemetry-source-time --tst

Timestamp RFC 3339 che identifica l'ora in cui sono stati misurati i dati di telemetria.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.