Consegna, destinatari e gruppi di log Azioni consigliate per i log delle query e dei job

Accesso ad Analysis AWS Clean Rooms

La registrazione delle analisi è una funzionalità di. AWS Clean Rooms Quando crei una collaborazione e attivi la registrazione di Analysis, i membri possono archiviare i log pertinenti delle query o dei lavori in Amazon Logs. CloudWatch

Con i registri di analisi, i membri possono determinare se le query sono conformi alle regole di analisi e all'accordo di collaborazione. Inoltre, i registri di analisi aiutano a supportare gli audit.

Quando i log vengono esportati, AWS Clean Rooms registra un evento nello stesso gruppo di log per ogni esportazione di log. Riceverai l'evento di esportazione del registro se hai eseguito l'analisi o se hai contribuito con una tabella a cui fa riferimento l'analisi. L'evento mostra chi ha richiesto l'esportazione, per quale analisi è stata richiesta l'esportazione, la destinazione in Amazon S3 e se la richiesta è riuscita. Per ulteriori informazioni sull'esportazione dei log, consulta. Esportazione dei log di analisi delle query

Quando la registrazione di Analysis è attivata, AWS Clean Rooms genera i log in due fasi: quando l'analisi viene eseguita e quando l'analisi viene completata.

La tabella seguente descrive i campi inclusi nei registri di analisi.

Campo	Consegnato quando	Description
`eventId`	Consegnato sempre	L'identificatore univoco per l'esecuzione dell'analisi. Per le interrogazioni, è lo stesso di. `protectedQueryID` Per i lavori, è lo stesso di`protectedJobID`.
`eventTimestamp`	Sempre consegnato	L'ora in cui è stata eseguita l'analisi.
`collaborationId`	Sempre consegnato	L'identificatore univoco per la collaborazione.
`logStage`	Consegnato sempre	Indica se il registro proviene dalla convalida dell'invio (SUBMISSION) o dal completamento del terminale (TERMINATION).
`analysisCategory`	Consegnato sempre	Il tipo di analisi: SQL (per le domande) o PYSPARK (per i lavori).
`analysisCategoryVersion`	Consegnato sempre	La versione della categoria di analisi (ad esempio, 1.0).
`schemaName`	Viene eseguita un'analisi	Il nome dell'associazione di tabelle configurata a cui si fa riferimento nell'analisi.
`configuredTableId`	Viene eseguita un'analisi	L'identificatore univoco per la tabella configurata a cui si fa riferimento nell'analisi.
`analysisTemplateArn`	Viene eseguita un'analisi	Il modello di analisi che è stato eseguito (viene visualizzato in base alla regola di analisi).
`parameters`	Viene eseguita un'analisi	I valori dei parametri (visualizzati in base al testo dell'analisi).
`queryText`	Viene eseguita una query	La definizione SQL della query che è stata eseguita. Se sono presenti parametri, vengono etichettati come`:parametervalue`.
`directQueryAnalysisRuleType`	Viene eseguita una query	Il tipo di regola di analisi per la tabella configurata.
`directQueryAnalysisRulePolicy`	Viene eseguita una query	La politica delle regole di analisi include le analisi consentite e i fornitori di analisi consentiti.
`queryValidationErrors`	Viene eseguita una query	Gli errori di interrogazione durante la convalida dell'interrogazione.
`resultReceivers`	Viene eseguita un'interrogazione	I membri designati per ricevere i risultati dell'interrogazione.
`queryRunners`	Viene eseguita una query	I membri designati per eseguire le interrogazioni.
`resultRegions`	Viene eseguita una query	Le AWS regioni in cui è possibile fornire i risultati.
`analysisTemplateArtifactHashList`	Un lavoro viene eseguito	L'elenco hash degli artefatti associati al modello di analisi.
`directJobAnalysisRuleType`	Viene eseguito un processo	Il tipo di regola di analisi per la tabella configurata.
`directJobAnalysisRulePolicy`	Viene eseguito un processo	La politica delle regole di analisi include le analisi consentite e i fornitori di analisi consentiti.
`jobValidationErrors`	Viene eseguito un lavoro	Gli errori del lavoro durante la convalida del lavoro.
`jobRunners`	Un lavoro viene eseguito	I membri designati per eseguire i processi.
`status`	L'analisi termina	Lo stato di esecuzione dell'analisi.
`errorCode`	L'analisi termina	Codice di errore quando un'analisi non è stata eseguita correttamente.
`errorMessage`	Un'analisi termina	Il messaggio di errore quando un'analisi non è stata eseguita correttamente.
`memberSchemaMapping`	Sempre consegnato	Una mappatura degli account dei membri rispetto alle informazioni sullo schema.
`memberDisplayNames`	Consegnato sempre	Una mappatura degli account dei membri con i relativi nomi visualizzati.
`additionalAnalyses`	Vengono creati dati sintetici	L'ARN della risorsa di analisi aggiuntiva consentita per l'analisi dei dati sintetici. Consegnato ai membri la cui tabella configurata è referenziata nella query, non al membro che ha creato il canale di input ML.
`isSynthetic`	Vengono creati dati sintetici	Se l'analisi ha creato dati sintetici ottimizzati per la privacy.
`epsilon`	Vengono creati dati sintetici	Il valore epsilon necessario per creare con successo dati sintetici con protezione avanzata della privacy.
`maxMembershipInferenceAttackScore`	Vengono creati dati sintetici	Il punteggio massimo consentito dagli attacchi di inferenza da parte dei membri è stato consentito per creare con successo dati sintetici ottimizzati in termini di privacy.
`machineLearningInputChannelArn`	Vengono creati dati sintetici	L'ARN del canale di input dell'apprendimento automatico utilizzato per generare i dati sintetici. Consegnato al membro che ha creato il canale di input ML e ai membri le cui tabelle configurate sono referenziate.
`analysisId`	I log vengono esportati	L'identificatore univoco dell'analisi per la quale sono stati esportati i log.
`callerAccountId`	I log vengono esportati	L'ID dell'account del membro che ha richiesto l'esportazione.
`s3OutputPath`	I log vengono esportati	La destinazione Amazon S3 in cui sono stati scritti i log esportati.
`operationName`	I log vengono esportati	L'operazione che ha generato l'evento di esportazione.
`logExportValidationErrors`	I log vengono esportati	Eventuali errori di convalida durante l'esportazione del registro.

Consegna, destinatari e gruppi di log

Non è necessario eseguire alcuna azione all'esterno AWS Clean Rooms per configurare i registri delle query e i registri dei lavori. AWS Clean Rooms crea gruppi di log per le collaborazioni dopo che ogni membro della collaborazione ha creato un'iscrizione.

I membri che possono eseguire query, i membri che possono eseguire query e processi, i membri che possono ricevere risultati e i membri le cui tabelle configurate sono referenziate nella query ricevono un registro di analisi.

Il membro che può eseguire una query e il membro che può ricevere risultati ricevono i log delle query per ogni tabella configurata a cui si fa riferimento nella query. Se non è proprietario della tabella configurata, non può visualizzare l'ID della tabella configurata (configuredTableId).

Il membro che può eseguire query e processi e il membro che può ricevere risultati ricevono i log dei lavori per ogni tabella configurata a cui si fa riferimento nel job. Se non è proprietario della tabella configurata, non può visualizzare l'ID della tabella configurata ()configuredTableId.

Se un membro ha più associazioni di tabelle configurate a cui fa riferimento nell'analisi, riceve un registro di analisi per ogni tabella configurata.

I membri con tabelle utilizzate per creare una tabella intermedia non ricevono i registri di analisi quando le analisi vengono eseguite sulla tabella intermedia.

AWS Clean Rooms crea registri per le query che contengono SQL non supportato e supportato. Per ulteriori dettagli, vedere AWS Clean Rooms SQL Reference.

AWS Clean Rooms crea anche registri quando le query o i job fanno riferimento a tabelle configurate che non sono associate alla collaborazione.

I log potrebbero contenere informazioni su un codice SQL errato.

I registri delle query e dei job indicano lo stato di una query ma non indicano se l'output della query è stato consegnato. Confermano che una richiesta o un lavoro è stato inviato dal membro che può effettuare la richiesta. I registri delle query confermano inoltre che la query contiene SQL in supportati AWS Clean Rooms e fa riferimento a tabelle configurate associate alla collaborazione.

Nota

AWS Clean Rooms non produce un registro se la query è stata annullata dopo la AWS Clean Rooms convalida della sua conformità alle regole di analisi e durante l'elaborazione della query.

Se si elimina il gruppo di log, è necessario ricrearlo manualmente con lo stesso nome del gruppo di log (ID di collaborazione della collaborazione). In alternativa, puoi disattivare e riattivare la registrazione nella tua iscrizione.

Per ulteriori informazioni su come attivare la registrazione delle analisi, vedere. Creare una collaborazione

Per ulteriori informazioni su Amazon CloudWatch Logs, consulta la Amazon CloudWatch Logs User Guide.

Azioni consigliate per i log delle query e dei job

Consigliamo ai membri di intraprendere periodicamente le seguenti azioni:

Per verificare che le query e i job corrispondano ai casi d'uso o alle domande concordati per la collaborazione, esamina le query e i job eseguiti nell'ambito della collaborazione.

Per ulteriori informazioni su come visualizzare le interrogazioni recenti, vedere Visualizzazione delle interrogazioni recenti.

Per ulteriori informazioni su come visualizzare i lavori recenti, vedere. Visualizzazione dei lavori recenti
Per verificare che le colonne della tabella configurate corrispondano a quanto concordato per la collaborazione, esamina le colonne della tabella configurate utilizzate nelle regole di analisi dei membri della collaborazione e nelle query.

Per ulteriori informazioni su come visualizzare le colonne configurate, vedere Visualizzazione delle tabelle e delle regole di analisi.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Monitoraggio

Esempi di log di analisi