Condividi tramite


Abilitare la registrazione di controllo e diagnostica nel servizio DICOM

In questo articolo si apprenderà come abilitare la registrazione diagnostica nel servizio DICOM e come esaminare alcune query di esempio per questi log. L'accesso ai log di diagnostica è essenziale per qualsiasi servizio sanitario che deve rispettare requisiti normativi. La funzionalità del servizio DICOM abilita i log di diagnostica è le impostazioni di diagnostica nel portale di Azure.

Abilitare i log

  1. Per abilitare la registrazione del servizio DICOM, selezionare il servizio DICOM nel portale di Azure.

  2. Selezionare il pannello Log attività e quindi selezionare Impostazioni di diagnostica.

    Screenshot del log attività di Azure.

  3. Fare clic su + Aggiungi impostazione di diagnostica.

    Screenshot di Aggiungi impostazioni di diagnostica.

  4. Immettere il nome delle impostazioni di diagnostica.

    Screenshot di Configura impostazioni di diagnostica.

  5. Selezionare i dettagli categoria e destinazione per l'accesso ai log di diagnostica.

    • Inviare all'area di lavoro Log Analytics in Monitoraggio di Azure. Prima di poter selezionare questa opzione, è necessario creare l'area di lavoro Log Analytics. Per altre informazioni sui log della piattaforma, vedere Panoramica dei log della piattaforma Azure.

    • Archiviare in un account di archiviazione per il controllo o l'ispezione manuale. L'account di archiviazione che si vuole usare deve essere già creato.

    • Trasmettere a un hub eventi per l'inserimento da parte di un servizio di terze parti o di una soluzione analitica personalizzata. Prima di configurare questo passaggio, è necessario creare uno spazio dei nomi dell'hub eventi e un criterio dell'hub eventi.

    • Inviare alla soluzione partner con cui si lavora come organizzazione partner in Azure. Per informazioni sulle potenziali integrazioni dei partner, vedere la documentazione sulle soluzioni per i partner di Azure

      Per informazioni sulle metriche supportate, vedere Metriche supportate con Monitoraggio di Azure.

  6. Selezionare Salva.

    Nota

    La visualizzazione dei primi log in Log Analytics potrebbe richiedere fino a 15 minuti. Inoltre, se il servizio DICOM viene spostato da un gruppo di risorse o una sottoscrizione a un'altra, aggiornare le impostazioni al termine dello spostamento.

    Per informazioni su come usare i log di diagnostica, vedere la documentazione del log delle risorse di Azure

Dettagli del log

Lo schema del log usato è diverso in base alla destinazione. Log Analytics ha uno schema che sarà diverso da altre destinazioni. Ogni tipo di log avrà anche uno schema diverso.

Dettagli del log di controllo

Log non elaborati

Il servizio DICOM restituisce i campi seguenti nel log di controllo, come illustrato durante lo streaming all'esterno di Log Analytics:

Nome campo Type Note
correlationId string ID correlazione
operationName string Descrive il tipo di operazione ,ad esempio Retrieve, Store, Query e così via.
time Datetime Data e ora dell'evento.
resourceId string Percorso di Azure per la risorsa.
identity Dynamic Contenitore di proprietà generico contenente informazioni sull'identità (attualmente non si applica a DICOM).
posizione string Percorso del server che ha elaborato la richiesta.
Uri string URI della richiesta.
resultType string I valori disponibili sono attualmente Started, Succeeded o Failed.
resultSignature Int Codice di stato HTTP (ad esempio, 200)
tipo string Tipo di log (in questo caso è sempre MicrosoftHealthcareApisAuditLog).
livello string Livello di log (informativo, errore).

Log di Log Analytics

Il servizio DICOM restituisce i campi seguenti nel log di controllo in Log Analytics:

Nome campo Type Note
CorrelationId string ID correlazione
OperationName string Descrive il tipo di operazione ,ad esempio Retrieve, Store, Query e così via.
TimeGenerated [UTC] Datetime Data e ora dell'evento.
_ResourceId string Percorso di Azure per la risorsa.
Identità Dynamic Contenitore di proprietà generico contenente informazioni sull'identità (attualmente non si applica a DICOM).
Uri string URI della richiesta.
ResultType string I valori disponibili sono attualmente Started, Succeeded o Failed.
StatusCode Int Codice di stato HTTP (ad esempio, 200)
Type string Tipo di log (in questo caso È sempre AHDSDicomAuditLogs).
Livello string Livello di log (informativo, errore).
TenantId string ID tenant.

Dettagli del log di diagnostica

Log non elaborati

Il servizio DICOM restituisce i campi seguenti nel log di controllo, come illustrato durante lo streaming all'esterno di Log Analytics:

Nome campo Type Note
correlationId string ID correlazione
operationName string Descrive il tipo di operazione ,ad esempio Retrieve, Store, Query e così via.
time Datetime Data e ora dell'evento.
resultDescription string Descrizione della voce di log. Di seguito è riportato un esempio di log di diagnostica con un messaggio di avviso di convalida durante l'archiviazione di un file.
resourceId string Percorso di Azure per la risorsa.
identity Dynamic Contenitore di proprietà generico contenente informazioni sull'identità (attualmente non si applica a DICOM).
posizione string Percorso del server che ha elaborato la richiesta.
properties string Informazioni aggiuntive sull'evento in formato matrice JSON. Gli esempi includono identificatori DICOM presenti nella richiesta.
livello string Livello di log (informativo, errore).

Log di Log Analytics

Il servizio DICOM restituisce i campi seguenti nel log di controllo in Log Analytics:

Nome campo Type Note
CorrelationId string ID correlazione
OperationName string Descrive il tipo di operazione ,ad esempio Retrieve, Store, Query e così via.
TimeGenerated Datetime Data e ora dell'evento.
Message string Descrizione della voce di log. Di seguito è riportato un esempio di log di diagnostica con un messaggio di avviso di convalida durante l'archiviazione di un file.
Posizione string Percorso del server che ha elaborato la richiesta.
Proprietà string Informazioni aggiuntive sull'evento in formato matrice JSON. Gli esempi includono identificatori DICOM presenti nella richiesta.
LogLevel string Livello di log (informativo, errore).

Query di Log Analytics di esempio

Di seguito sono riportate alcune query di base di Application Insights che è possibile usare per esplorare i dati di log.

Eseguire la query seguente per visualizzare i 100 log più recenti :

MicrosoftHealthcareApisAuditLogs
| limit 100

Eseguire la query seguente per raggruppare le operazioni in base al tipo di risorsa DICOM:

MicrosoftHealthcareApisAuditLogs 
| summarize count() by DICOMResourceType

Eseguire la query seguente per ottenere tutti i risultati non riusciti

MicrosoftHealthcareApisAuditLogs 
| where ResultType == "Failed" 

Conclusione

L'accesso ai log di diagnostica è essenziale per il monitoraggio di un servizio e la fornitura di report di conformità. Il servizio DICOM consente di eseguire queste azioni tramite i log di diagnostica.

Passaggi successivi

In questo articolo si è appreso come abilitare i log di controllo per il servizio DICOM. Per informazioni sul log attività di Azure, vedere