Usare i log di controllo per tenere traccia dell'attività nell'applicazione IoT Central

Articolo
10/27/2023

Questo articolo descrive come usare i log di controllo per tenere traccia delle modifiche apportate all'ora nelle applicazioni IoT Central. È possibile:

Ordinare il log di controllo.
Filtrare il log di controllo.
Personalizzare il log di controllo.
Gestire l'accesso al log di controllo.
Esportare i record del log di controllo.

Il log di controllo registra informazioni su chi ha apportato una modifica, informazioni sull'entità modificata, l'azione che ha apportato modifiche e quando è stata apportata la modifica. Il log tiene traccia delle modifiche apportate tramite l'interfaccia utente, a livello di codice con l'API REST e tramite l'interfaccia della riga di comando.

Il log registra le modifiche apportate alle entità IoT Central seguenti:

Nota

Il log di controllo non registra quando gli utenti accedono o escono dall'applicazione IoT Central.

Il log registra le modifiche apportate dai tipi di utente seguenti:

Utente di IoT Central: il log mostra il messaggio di posta elettronica dell'utente.
Token API: il log mostra il nome del token.
Utente Microsoft Entra: il log mostra l'indirizzo di posta elettronica o l'ID dell'utente.
Entità servizio: il log mostra il nome dell'entità servizio.

Il log archivia i dati per 30 giorni, dopo i quali non è più disponibile.

Lo screenshot seguente mostra la visualizzazione log di controllo con il percorso dei controlli di ordinamento e filtro evidenziati:

Suggerimento

Se si vuole monitorare l'integrità dei dispositivi connessi, usare Monitoraggio di Azure. Per altre informazioni, vedi Monitorare l'integrità dell'applicazione.

Personalizzare il log

Selezionare Opzioni colonna per personalizzare la visualizzazione log di controllo. È possibile aggiungere e rimuovere colonne, riordinare le colonne e modificare le larghezze delle colonne:

Ordinare il log

È possibile ordinare il log in ordine crescente o decrescente del timestamp. Per ordinare, selezionare Timestamp:

Filtrare il log

Per concentrarsi su un orario specifico, filtrare il log in base all'intervallo di tempo. Selezionare Modifica intervallo di tempo e specificare l'intervallo a cui si è interessati:

Per concentrarsi su voci specifiche, filtrare in base al tipo di entità o all'azione. Selezionare Filtro e usare gli elenchi a discesa a selezione multipla per specificare le condizioni di filtro:

Gestire l'accesso

Il ruolo app Amministrazione istrator predefinito ha accesso ai log di controllo per impostazione predefinita. L'amministratore può concedere l'accesso ad altri ruoli. Un amministratore può assegnare le autorizzazioni Controllo completo o Visualizza log di controllo ad altri ruoli. Per altre informazioni, vedere Gestire utenti e ruoli nell'applicazione IoT Central.

Importante

Qualsiasi utente autorizzato a visualizzare il log di controllo può visualizzare tutte le voci di log anche se non dispone dell'autorizzazione per visualizzare o modificare le entità elencate nel log. Pertanto, qualsiasi utente che può visualizzare il log può visualizzare l'identità di e le modifiche apportate a qualsiasi entità modificata.

Esporta log

È possibile esportare i record del log di controllo in varie destinazioni per l'archiviazione a lungo termine, l'analisi dettagliata o l'integrazione con altri log. Per altre informazioni, vedere Esportare i dati IoT.

Per inviare i log di controllo a Log Analytics in Monitoraggio di Azure, usare l'esportazione dei dati di IoT Central per inviare i log di controllo a Hub eventi e quindi usare una funzione di Azure per aggiungere i dati del log di controllo a Log Analytics.

Passaggi successivi

Ora che si è appreso come gestire utenti e ruoli nell'applicazione IoT Central, il passaggio successivo consigliato consiste nell'apprendere come gestire le organizzazioni IoT Central.