Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Registrazione delle chiamate Amazon Kendra API con AWS CloudTrail log

Amazon Kendra è integrato con AWS CloudTrail, un servizio che fornisce una registrazione delle azioni intraprese da un utente, un ruolo o un AWS servizio in Amazon Kendra. CloudTrail acquisisce tutte le API chiamate da Amazon Kendra come eventi, incluse le chiamate dalla console Amazon Kendra e le chiamate in codice verso Amazon Kendra. APIs Se crei un trail, puoi attivare la distribuzione continua di CloudTrail eventi in un bucket Amazon S3, inclusi gli eventi per Amazon Kendra. Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console in Cronologia eventi. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta che è stata effettuata ad Amazon Kendra, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e ulteriori dettagli.

Per saperne di più CloudTrail, incluso come configurarlo e attivarlo, consulta il AWS CloudTrail Guida per l'utente.

Informazioni su Amazon Kendra in CloudTrail

CloudTrail è attivato sul tuo AWS account al momento della creazione dell'account. Quando si verifica un'attività in Amazon Kendra, tale attività viene registrata in CloudTrail un evento insieme ad altri AWS eventi di servizio nella cronologia degli CloudTrail eventi. È possibile visualizzare, cercare e scaricare gli eventi recenti nella AWS conto. Per ulteriori informazioni, consulta Visualizzazione degli eventi con la cronologia degli CloudTrail eventi.

Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi per Amazon Kendra, crea un percorso. Un trail è una configurazione che consente di CloudTrail fornire eventi come file di registro a un bucket S3 specificato. Per impostazione predefinita, quando crei un trail nella console, il trail si applica a tutti AWS Regioni. Il percorso registra gli eventi di tutte le regioni del AWS partiziona e consegna i file di registro nel bucket S3 specificato. Inoltre, puoi configurarne altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei CloudTrail log. Per ulteriori informazioni, consultare:

CloudTrail registra tutte le azioni di Amazon Kendra, documentate nel Reference. API Ad esempio, le chiamate alle Query operazioni CreateIndexCreateDataSource, e generano voci nei file di registro. CloudTrail

Ogni evento o voce di log contiene informazioni sull'utente che ha generato la richiesta. Per ulteriori informazioni, vedete l'CloudTrail userIdentity elemento.

Esempio: voci dei file di registro di Amazon Kendra

Un trail è una configurazione che consente la consegna di eventi come file di registro a un bucket S3 specificato. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia stack ordinata delle API chiamate pubbliche, quindi non vengono visualizzati in un ordine specifico.

Le chiamate all'Queryoperazione creano la seguente voce.

        {
            "eventVersion": "1.05",
            "userIdentity": {
                "type": "AssumedRole | FederatedUser | IAMUser | Root | SAMLUser | WebIdentityUser",
                "principalId": "principal ID",
                "arn": "ARN",
                "accountId": "account ID",
                "accessKeyId": "access key ID",
                "sessionContext": {
                    "sessionIssuer": {
                        "type": "Role",
                        "principalId": "principal Id",
                        "arn": "ARN",
                        "accountId": "account ID",
                        "userName": "user name"
                    },
                    "webIdFederationData": {
                        
                    },
                    "attributes": {
                        "mfaAuthenticated": false,
                        "creationDate": "timestamp"
                    }
                }
            },
            "eventTime": "timestamp",
            "eventSource": "kendra.amazonaws.com",
            "eventName": "Query",
            "awsRegion": "region",
            "sourceIPAddress": "source IP address",
            "userAgent": "user agent",
            "requestParameters": {
                "indexId": "index ID"
            },
            "responseElements": null,
            "requestID": "request ID",
            "eventID": "event ID",
            "eventType": "AwsApiCall",
            "recipientAccountId": "account ID"
        },