Gestire i log di controllo

I log di controllo forniscono auditing trail per le API del piano dati in Azure Data Manager per l'energia. Con i log di controllo è possibile indicare:

  • Chi ha eseguito un'azione
  • Che cos'era l'azione
  • Quando è stata eseguita l'azione
  • Stato dell'azione

Ad esempio, quando si aggiunge un nuovo membro al users.datalake.admins gruppo entitlement usando l'API entitlement, è possibile visualizzare queste informazioni nei log di controllo.

Screenshot of audit logs for entitlement

Abilitare i log di controllo

Per abilitare i log di controllo nella registrazione diagnostica, selezionare l'istanza di Azure Data Manager for Energy nel portale di Azure.

Nota

Attualmente, è possibile abilitare i log di controllo per OSDU Core Services, Seismic DMS, Petrel Data Services e Wellbore DMS.

  • Selezionare la schermata Log attività e quindi selezionare Impostazioni di diagnostica.
  • Fare clic su + Aggiungi impostazione di diagnostica.
  • Immettere il nome delle impostazioni di diagnostica.
  • Selezionare Controlla eventi come categoria.

Screenshot of audit events option in diagnostic settings.

  • Selezionare i dettagli di destinazione appropriati per accedere ai log di diagnostica.

Nota

La visualizzazione dei primi log in Log Analytics potrebbe richiedere fino a 15 minuti. Per informazioni su come usare i log di diagnostica, vedere la documentazione del log delle risorse di Azure.

Dettagli del log di controllo

I log di controllo per Azure Data Manager per il servizio Energia restituiscono i campi seguenti.

Nome campo Digita Descrizione
TenantID Stringa Tenant dell'istanza di Azure Data Manager per l'energia.
TimeGenerated Formato UTC Ora del log di controllo.
Categoria Stringa Categoria delle impostazioni di diagnostica a cui appartengono i log.
Titolo stringa Posizione della risorsa di Azure Data Manager per l'energia.
ServiceName Stringa Nome del servizio OSDU in esecuzione in Azure Data Manager per l'energia. Ad esempio: Partition, Search, Indexer, Legal, Entitlements, Workflow, Register, Unit, Crs-catalog, File, Schema e Dataset
OperationName Stringa ID operazione o nome operazione associato alle API del piano dati, che genera log di controllo, ad esempio "Aggiungi membro"
ID partizione dati Stringa ID partizione dati in cui viene eseguita l'operazione.
Azione Stringa L'azione fa riferimento al tipo di operazione, indipendentemente dal fatto che si tratti di creazione, eliminazione, aggiornamento e così via.
ActionID Stringa ID associato all'operazione.
PuID Stringa ObjectId dell'utente in Microsoft Entra ID
ResultType Stringa Definire l'esito positivo o negativo dell'operazione
Descrizione dell'operazione Stringa Fornisce dettagli specifici della risposta. Questi dettagli possono includere informazioni di traccia, ad esempio i sintomi, del risultato usato per ulteriori analisi.
RequestId Stringa RequestId è l'ID univoco associato alla richiesta, che ha attivato l'operazione sul piano dati.
Messaggio Stringa Fornisce un messaggio associato all'esito positivo o negativo dell'operazione.
ResourceID Stringa ID risorsa di Azure Data Manager per l'energia del cliente a cui appartiene il log di controllo.

Query di esempio

Query di base di Application Insights che è possibile usare per esplorare i dati di log.

  1. Eseguire la query seguente per raggruppare le operazioni in base a ServiceName:
OEPAuditLogs
| summarize count() by ServiceName

Screenshot of key vault, key, user assigned identity, and CMK on encryption tab

  1. Eseguire la query seguente per visualizzare i 100 log più recenti:
OEPAuditLogs
| limit 100
  1. Eseguire la query seguente per ottenere tutti i risultati non riusciti:
OEPAuditLogs
| where ResultType contains "Failure"

Passaggi successivi

Informazioni sull'identità gestita: