Integrazione del registro di controllo di Query Service

L'integrazione del registro di controllo di Adobe Experience Platform Query Service fornisce record delle azioni utente correlate alle query. I registri di audit sono uno strumento essenziale per la risoluzione dei problemi e il rispetto delle politiche aziendali di gestione dei dati e dei requisiti normativi. La funzionalità ti consente di restituire un registro delle azioni per molti tipi di eventi, nonché di filtrare ed esportare i record. È possibile accedere ai registri tramite l'interfaccia utente di Platform o l'API di query di controllo e scaricarli in formato CSV o JSON.

Per ulteriori informazioni sull'interfaccia utente dei registri di controllo, consulta il documento di panoramica dei registri di controllo. Per ulteriori informazioni sull'esecuzione di chiamate alle API di Platform, consulta la guida dell'API dei registri di controllo.

Prerequisiti

Per visualizzare il dashboard del registro di controllo nell'interfaccia utente di Platform, è necessario che sia abilitata l'autorizzazione Data Governance Visualizza registro attività utente. L'autorizzazione è abilitata tramite l'Adobe Admin Console. Se non disponi dei privilegi di amministratore per abilitare questa autorizzazione, contatta l’amministratore della tua organizzazione. Consulta la documentazione sul controllo degli accessi per istruzioni complete sull'aggiunta di autorizzazioni tramite Admin Console.

Query Service categorie del registro di controllo audit-log-categories

Le categorie del registro di controllo fornite da Query Service sono le seguenti.

Categoria
Descrizione
Query
Questa categoria consente di controllare le esecuzioni delle query.
Modello query
Questa categoria consente di controllare le varie azioni (creazione, aggiornamento ed eliminazione) eseguite su un modello di query.
Query pianificata
Questa categoria consente di controllare le pianificazioni create, aggiornate o eliminate in Query Service.

Esegui un registro di controllo Query Service perform-an-audit-log

Per eseguire un controllo di audit per le attività Query Service, seleziona Audit dal menu di navigazione a sinistra, seguito dall'icona funnel ( Icona filtro. ) per visualizzare un elenco di controlli filtro per limitare i risultati.

Dashboard del registro di controllo dellinterfaccia utente di Platform con Audits nella navigazione a sinistra e controlli filtro evidenziati.

Dalla scheda Audit della dashboard Registro attività, è possibile filtrare tutte le azioni di Platform registrate in base a una qualsiasi delle categorie Query Service. I risultati del registro possono essere ulteriormente filtrati in base al periodo di tempo in cui sono stati eseguiti, all’azione/funzione intrapresa o all’utente che ha eseguito la query. Consulta la documentazione del registro di controllo per istruzioni complete su come filtrare i registri in base a categoria, azione, utente e stato.

I dati del registro di controllo restituiti contengono le seguenti informazioni su tutte le query che soddisfano i criteri di filtro selezionati.

Nome colonna
Descrizione
Timestamp
Data e ora esatte dell'azione eseguita nel formato month/day/year hour:minute AM/PM.
Nome risorsa
Il valore del campo Nome risorsa dipende dalla categoria scelta come filtro. Quando si utilizza la categoria Query pianificata, si tratta del nome pianificazione. Quando si utilizza la categoria Modello query, questo è il nome modello. Quando si utilizza la categoria Query, questo è l'ID sessione
Categoria
Questo campo corrisponde alla categoria selezionata dall’utente nel menu a discesa del filtro.
Azione
Può essere creata, eliminata, aggiornata o eseguita. Le azioni disponibili dipendono dalla categoria scelta come filtro.
Utente
Questo campo fornisce l’ID utente che ha eseguito la query.

Dashboard dei controlli di audit con il registro attività filtrato evidenziato.

NOTE
Vengono forniti più dettagli sulle query scaricando i risultati del registro in formato CSV o JSON di quanti ne vengano visualizzati per impostazione predefinita nel dashboard del registro di controllo.

Pannello Dettagli

Seleziona una riga di risultati del registro di controllo per aprire un pannello dei dettagli a destra dello schermo.

Controlla la scheda del registro attività della dashboard con il pannello dei dettagli evidenziato.

Il pannello dei dettagli può essere utilizzato per trovare l'ID risorsa e lo stato evento.

Il valore di ID risorsa varia a seconda della categoria utilizzata nel controllo di audit.

  • Quando si utilizza la categoria Query, ID risorsa è l'ID sessione.
  • Quando si utilizza la categoria Modello di query, l'ID risorsa è il ID modello con prefisso templateID:.
  • Quando si utilizza la categoria Query pianificata, l'ID risorsa è l'ID pianificazione con prefisso scheduleID:.

Il valore dello stato Evento cambia a seconda della categoria utilizzata nel controllo di audit.

  • Quando si utilizza la categoria Query, il campo Stato evento fornisce un elenco di tutti i ID query eseguiti dall'utente in quella sessione.
  • Quando si utilizza la categoria Modello query, il campo Stato evento fornisce il nome modello come prefisso per lo stato dell'evento.
  • Quando si utilizza la categoria Pianificazione query, il campo Stato evento fornisce il nome pianificazione come prefisso per lo stato dell'evento.

Filtri disponibili per Query Service categorie di log di controllo available-filters

I filtri disponibili variano a seconda della categoria selezionata nel menu a discesa. La tabella seguente descrive i filtri disponibili per Query Service categorie di log di controllo.

Filtro
Descrizione
Categoria
Consulta la sezione Query Service categorie del registro di controllo per un elenco completo delle categorie disponibili.
Azione
Quando si fa riferimento a Query Service categorie di controllo, l'aggiornamento è una modifica al modulo esistente, l'eliminazione è la rimozione della pianificazione o del modello, la creazione è creazione di una nuova pianificazione o modello ed esecuzione è esecuzione di una query.
Utente
Immetti l’ID utente completo (ad esempio, johndoe@acme.com) da filtrare per utente.
Stato
Le opzioni Consenti, Operazione completata e Errore filtrano i registri in base allo "Stato" o allo "Stato evento", mentre l'opzione Nega filtrerà tutti i registri.
Data
Seleziona una data di inizio e/o una data di fine per definire un intervallo di date in base al quale filtrare i risultati.

Passaggi successivi

La lettura di questo documento consente di comprendere meglio la funzionalità del registro di controllo di Query Service e come può essere utilizzata per filtrare le azioni utente di Query Service.

Se si utilizza la funzionalità del registro di controllo di Query Service per la risoluzione dei problemi, si consiglia di leggere la guida alla risoluzione dei problemi.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb