Condividi tramite


az dt twin telemetry

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). L'estensione installerà automaticamente la prima volta che si esegue un comando az dt twin telemetry. Learn more about extensions.

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.

Extension 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 --dtn
                          --twin-id
                          [--component]
                          [--dt-id]
                          [--resource-group]
                          [--telemetry]
                          [--telemetry-source-time --tst]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Proprietà Valore
Valore predefinito: False