View a markdown version of this page

CloudTrail registrare contenuti per eventi Insights per sentieri - AWS CloudTrail

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à.

CloudTrail registrare contenuti per eventi Insights per sentieri

AWS CloudTrail I record degli eventi Insights per i percorsi includono campi diversi dagli altri CloudTrail eventi nella loro struttura JSON, a volte chiamata payload. CloudTrail Gli eventi Insights per i percorsi contengono i seguenti campi:

  • eventVersion— La versione dell'evento.

    Since: 1.07

    Optional: False

  • eventType— Il tipo di evento. Il valore è sempre AwsCloudTrailInsight per gli eventi Insights.

    Since: 1.07

    Optional: False

  • eventID— GUID generato da CloudTrail per identificare in modo univoco ogni evento. Puoi utilizzare questo valore per identificare un singolo evento. Ad esempio, puoi utilizzare l'ID come chiave primaria per recuperare i dati di log da un database ricercabile.

    Since: 1.07

    Optional: False

  • eventTime— L'ora in cui l'evento Insights è iniziato o si è interrotto, in tempo universale coordinato (UTC).

    Since: 1.07

    Optional: False

  • awsRegion— Il Regione AWS luogo in cui si è verificato l'evento Insights, ad esempious-east-2.

    Since: 1.07

    Optional: False

  • recipientAccountId— Rappresenta l'ID dell'account che ha ricevuto questo evento.

    Since: 1.07

    Optional: True

  • sharedEventID— Un GUID generato da CloudTrail Insights per identificare in modo univoco un evento Insights. sharedEventIDè comune tra gli eventi di inizio e fine di Insights e aiuta a collegare entrambi gli eventi per identificare in modo univoco attività insolite. Puoi considerare lo sharedEventID come l'ID evento generale di Insights.

    Since: 1.07

    Optional: False

  • insightDetails— Un record di evento CloudTrail Insights per un percorso include un insightDetails blocco che contiene informazioni sui trigger sottostanti di un evento Insights, come origine dell'evento, identità utente, user agent, ARN delle risorse, medie o baseline storiche, statistiche, nome API e se l'evento è l'inizio o la fine dell'evento Insights.

    Since: 1.07

    Optional: False

    • state— Se l'evento è l'evento iniziale o finale di Insights. Il valore può essere Start o End.

      Since: 1.07

      Optional: False

    • eventSource— Il AWS servizio all'origine dell'attività insolita, ad esempioec2.amazonaws.com.

      Since: 1.07

      Optional: False

    • eventName— Il nome dell'evento Insights, in genere il nome dell'API che è stata l'origine dell'attività insolita.

      Since: 1.07

      Optional: False

    • insightType— Il tipo di evento Insights. Questo valore può essere ApiCallRateInsight o ApiErrorRateInsight.

      Since: 1.07

      Optional: False

    • errorCode— Il codice di errore dell'attività insolita. Consulta anche errorCode in CloudTrail registrare contenuti per eventi di gestione, dati e attività di rete.

      Since: 1.07

      Optional: True

    • insightContext— Informazioni sugli AWS strumenti (denominati user agent), sugli utenti e sui ruoli IAM (denominati identità utente), sui codici di errore e sugli ARN delle risorse associati agli eventi CloudTrail analizzati per generare l'evento Insights. Questo elemento include anche statistiche che mostrano il modo in cui l'attività insolita in un evento Insights viene confrontata con l'attività di riferimento o normale.

      Since: 1.07

      Optional: False

      • statistics— Include i dati sulla baseline, o il tasso medio tipico di chiamate o errori sull'API oggetto da parte di un account misurato durante il periodo di riferimento, il tasso medio di chiamate o errori che hanno attivato l'evento Insights, la durata, in minuti, dell'evento Insights e la durata, in minuti, del periodo di misurazione di base.

        Since: 1.07

        Optional: False

        • baseline— Le chiamate API o gli errori al minuto durante la durata di base sull'API oggetto dell'evento Insights per l'account, calcolati nei sette giorni precedenti l'inizio dell'evento Insights.

          Since: 1.07

          Optional: False

          • average— La media storica delle chiamate o degli errori API al minuto nei sette giorni precedenti l'ora di inizio dell'attività di Insights.

            Since: 1.07

            Optional: False

        • insight— Per un evento Insights iniziale, questo valore è il numero medio di chiamate o errori API al minuto durante l'inizio dell'attività insolita. Per un evento Insights di fine, questo valore è il numero medio di chiamate o erriri API al minuto per la durata dell'attività insolita.

          Since: 1.07

          Optional: False

          • average— Il numero medio di chiamate o errori API registrati al minuto durante il periodo di attività insolito.

            Since: 1.07

            Optional: False

        • insightDuration— La durata, in minuti, di un evento Insights (il periodo di tempo compreso tra l'inizio e la fine di un'attività insolita sull'API in oggetto). insightDurationsi verifica sia all'inizio che alla fine degli eventi Insights.

          Since: 1.07

          Optional: False

        • baselineDuration— La durata, in minuti, del periodo di riferimento (il periodo di tempo in cui viene misurata la normale attività sull'API in oggetto). baselineDurationè almeno i sette giorni (10080 minuti) che precedono un evento Insights. Questo campo è presente sia negli eventi Insights di inizio che di fine. L'ora di fine di baselineDuration è sempre l'inizio di un evento Insights.

          Since: 1.07

          Optional: False

      • attributions— Include informazioni sulle identità degli utenti, sugli user agent, sui codici di errore e sugli ARN delle risorse correlati ad attività insolite e di base. Un massimo di cinque identità utente, cinque user agent, cinque codici di errore e cinque ARN di risorse vengono acquisiti in un attributions blocco di eventi Insights, ordinati in base alla media del conteggio delle attività, in ordine decrescente dal più alto al più basso.

        Since: 1.07

        Optional: True

        • attribute— Contiene il tipo di attributo. Il valore può essere userIdentityArnuserAgent,errorCode, oresourceArn. Se presenti, questi valori verranno visualizzati solo una volta in un singolo attributo. Valori di attributo diversi possono avere resourceArn valori diversi userIdentityArn userAgenterrorCode,, o, ma ogni istanza di attributo conterrà un solo valore per userIdentityArnuserAgent,errorCode, oresourceArn. L'resourceArnattributo è disponibile solo per gli eventi Insights sugli eventi di dati.

          Since: 1.07

          Optional: False

        • insight— Un blocco che mostra i primi cinque valori degli attributi che hanno contribuito alle chiamate API o agli errori commessi durante l'insolito periodo di attività, in ordine decrescente dal maggior numero di chiamate o errori API al più piccolo. Mostra anche il numero medio di chiamate API o errori effettuati dai valori degli attributi durante il periodo di attività insolito.

          Since: 1.07

          Optional: False

          • value— L'attributo che ha contribuito alle chiamate API o agli errori commessi durante il periodo di attività insolito.

            Since: 1.07

            Facoltativo: False False

          • average— Il numero di chiamate o errori API al minuto durante il periodo di attività insolito per l'attributo nel value campo.

            Since: 1.07

            Facoltativo: False False

        • baseline— Un blocco che mostra i primi cinque valori degli attributi che hanno contribuito maggiormente alle chiamate o agli errori API durante il normale periodo di attività, in ordine decrescente dal maggior numero di chiamate o errori API al più piccolo. Mostra inoltre il numero medio di chiamate API o errori effettuati dai valori degli attributi durante il normale periodo di attività.

          Since: 1.07

          Facoltativo: False False

          • value— L'attributo che ha contribuito alle chiamate o agli errori dell'API durante il normale periodo di attività.

            Since: 1.07

            Facoltativo: False False

          • average— La media storica delle chiamate o degli errori API al minuto nei sette giorni precedenti l'ora di inizio dell'attività di Insights per l'attributo nel value campo.

            Since: 1.07

            Optional:FalseFalsa

  • eventCategory— La categoria dell'evento. Il valore è sempre Insight per gli eventi Insights.

    Since: 1.07

    Optional: False

Esempio di blocco InsightDetails

Nell'esempio seguente viene illustrato un blocco insightDetails di evento Insights per un evento Insights che si è verificato quando l'API Application Auto Scaling CompleteLifecycleAction è stata chiamata un numero insolito di volte. Per un esempio di un evento Insights completo, consulta Eventi Insights.

Questo esempio proviene da un evento Insights di inizio, indicato da "state": "Start". Le prime identità utente che hanno chiamato le API associate all'evento Insights, CodeDeployRole1, CodeDeployRole2 e CodeDeployRole3, sono mostrate nel blocco attributions, insieme alla frequenza media delle chiamate API per questo evento Insights e al riferimento per il ruolo CodeDeployRole1. Il attributions blocco mostra anche che lo user agent lo ècodedeploy.amazonaws.com, vale a dire che le principali identità utente hanno utilizzato la AWS CodeDeploy console per eseguire le chiamate API.

Poiché non sono presenti codici di errore associati agli eventi analizzati per generare l'evento Insights (il valore è null), la media insight per il codice di errore è la stessa della media insight generale per l'intero evento Insights, mostrata nel blocco statistics.

"insightDetails": { "state": "Start", "eventSource": "autoscaling.amazonaws.com", "eventName": "CompleteLifecycleAction", "insightType": "ApiCallRateInsight", "insightContext": { "statistics": { "baseline": { "average": 0.0000882145 }, "insight": { "average": 0.6 }, "insightDuration": 5, "baselineDuration": 11336 }, "attributions": [ { "attribute": "userIdentityArn", "insight": [ { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1", "average": 0.2 }, { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole2", "average": 0.2 }, { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole3", "average": 0.2 } ], "baseline": [ { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1", "average": 0.0000882145 } ] }, { "attribute": "userAgent", "insight": [ { "value": "codedeploy.amazonaws.com", "average": 0.6 } ], "baseline": [ { "value": "codedeploy.amazonaws.com", "average": 0.0000882145 } ] }, { "attribute": "errorCode", "insight": [ { "value": "null", "average": 0.6 } ], "baseline": [ { "value": "null", "average": 0.0000882145 } ] }, { "attribute": "resourceArn", "insight": [ { "value": "arn:aws:s3:::example-bucket", "average": 0.6 } ], "baseline": [ { "value": "arn:aws:s3:::example-bucket", "average": 0.0000882145 } ] } ] } }