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à.
Log inviati ad Amazon S3
Per un esempio di AWS CLI, vedi. Creare una consegna su Amazon S3
Autorizzazioni degli utenti
Per abilitare l'invio di log ad Amazon S3, devi aver effettuato l'accesso con le seguenti autorizzazioni.
Politica delle risorse del bucket Amazon S3
Il bucket S3 in cui vengono inviati i log deve disporre di una policy delle risorse che include determinate autorizzazioni. Se il bucket al momento non dispone di una policy delle risorse e l'utente che imposta la registrazione ha le autorizzazioni S3:GetBucketPolicy e S3:PutBucketPolicy per il bucket, AWS
crea automaticamente la seguente policy quando inizi a inviare i log ad Amazon S3.
Nella policy precedente, per aws:SourceAccount, specifica l'elenco degli ID account per i quali i log vengono consegnati a questo bucket. Per aws:SourceArn, specifica l'elenco di ARN della risorsa che genera i log, nel formato arn:aws:logs:. source-region:source-account-id:*
Se il bucket dispone di una policy delle risorse, ma tale criterio non contiene l'istruzione mostrata nella policy precedente e l'utente che imposta la registrazione ha le autorizzazioni S3:GetBucketPolicy e S3:PutBucketPolicy per il bucket, tale istruzione viene aggiunta alla policy delle risorse del bucket.
Nota
In alcuni casi, potresti riscontrare AccessDenied degli errori AWS CloudTrail se l's3:ListBucketautorizzazione non è stata concessa. delivery.logs.amazonaws.com Per evitare questi errori nei CloudTrail log, è necessario concedere l's3:ListBucketautorizzazione delivery.logs.amazonaws.com e includere Condition i parametri mostrati con l's3:GetBucketAclautorizzazione impostata nella precedente policy del bucket. Per renderlo più semplice, invece di creare una nuova Statement, puoi aggiornar direttamenteAWSLogDeliveryAclCheck per essere “Action”:
[“s3:GetBucketAcl”, “s3:ListBucket”]
Crittografia lato server di bucket Amazon S3
Puoi proteggere i dati nel tuo bucket Amazon S3 abilitando la crittografia lato server. Puoi usare Amazon S3-managed keys (SSE-S3) o una AWS KMS chiave memorizzata in AWS Key Management Service (SSE-KMS). Per ulteriori informazioni, consulta Protezione dei dati con la crittografia lato server.
Se lo desideri SSE-S3, non è richiesta alcuna configurazione aggiuntiva. Amazon S3 gestisce la chiave di crittografia.
È richiesta una chiave gestita dal cliente
Se lo desideri SSE-KMS, devi utilizzare una chiave gestita dal cliente. Non puoi usare una chiave AWS gestita. Se configuri la crittografia con una chiave AWS gestita, CloudWatch Logs fornisce i log in un formato illeggibile.
Per SSE-KMS, specifica l'Amazon Resource Name (ARN) della chiave quando abiliti la crittografia dei bucket. Aggiungi quanto segue alla politica chiave (non alla politica del bucket per il tuo bucket S3), in modo che l'account di consegna dei log possa scrivere sul tuo bucket S3.
{ "Sid": "Allow Logs Delivery to use the key", "Effect": "Allow", "Principal": { "Service": [ "delivery.logs.amazonaws.com" ] }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:DescribeKey" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": ["012345678901"] }, "ArnLike": { "aws:SourceArn": ["arn:aws:logs:us-east-1:012345678901:delivery-source:*"] } } }
Peraws:SourceAccount, specifica gli ID degli account i cui log vengono consegnati a questo bucket. Peraws:SourceArn, specifica gli ARN della fonte di consegna nel seguente formato:. arn:aws:logs:source-region:source-account-id:delivery-source:*
Formato chiave oggetto Amazon S3
Per le consegne che utilizzano le autorizzazioni V2, la chiave oggetto Amazon S3 è determinata dal prefisso di destinazione, dal tipo di log, dal percorso del suffisso della consegna e dall'eventuale abilitazione dei percorsi. Hive-compatible Il percorso esatto definito dal servizio e le variabili di suffisso supportate variano in base al tipo di registro.
- Prefisso di destinazione
-
Un percorso opzionale che aggiungi al bucket ARN quando chiami. PutDeliveryDestination Ad esempio,
arn:aws:s3:::. Gli oggetti consegnati iniziano con questo prefisso, seguito dal percorso definito dal servizio del tipo di registro, ad esempio.bucket-name/MyLogPrefixAWSLogs/Per la registrazione CloudFront standard (v2), il prefisso di destinazione sostituisce, anziché precede, il percorso predefinito.source-account-id/service-name/ - Percorso del suffisso
-
Un percorso opzionale che configuri per una singola consegna nel suo S3DeliveryConfiguration. Un suffisso può contenere testo e variabili statici. Per trovare le variabili supportate da un tipo di registro, chiamate DescribeConfigurationTemplatese controllate
allowedSuffixPathFields. Se non specifichi un percorso di suffisso, il percorso del suffisso predefinito del tipo di registro viene utilizzato quando disponibile. - Hive-compatible percorso
-
Quando
enableHiveCompatiblePathè cosìtrue, le variabili supportate in modo esplicitosuffixPathvengono renderizzate come.Per tipi di log come i log di accesso di Application Load Balancer, questa formattazione modifica anche il segmento di account definito dal servizio. Ad esempiokey=valueAWSLogs/diventasource-account-id/AWSLogs/aws-account-id=.source-account-id/Se si omette
suffixPath, la Hive-compatible formattazione viene applicata solo quando il percorso del suffisso predefinito del tipo di registro la supporta. Ad esempio, i log di accesso di Application Load Balancer supportano questa formattazione. Altri tipi di log, inclusi i log di accesso ai server Amazon S3, mantengono il suffisso predefinito originale in formato diverso da Hive, incluse le directory di risorse e date.Per un tipo di registro il cui valore predefinito non supporta la Hive-compatible formattazione, specifica un file valido che contenga variabili supportate.
suffixPathUn suffisso esplicito sostituisce il suffisso predefinito. Includi le variabili di risorsa e data di cui hai bisogno, utilizzando il tipo di registro from.allowedSuffixPathFieldsDescribeConfigurationTemplates
Gli esempi seguenti mostrano l'inizio di una chiave oggetto del log di accesso di Application Load Balancer per l'account in. 111122223333 us-east-1 Se non diversamente specificato, gli esempi non presuppongono alcun prefisso di destinazione.
| Configurazione | Inizio della chiave dell'oggetto |
|---|---|
| Hive-compatible percorso disabilitato, suffisso omesso | AWSLogs/111122223333/elasticloadbalancing/us-east-1/2026/09/10/ |
| Hive-compatible percorso abilitato, suffisso omesso | AWSLogs/aws-account-id=111122223333/elasticloadbalancing/region=us-east-1/year=2026/month=09/day=10/ |
Hive-compatible percorso abilitato, suffisso myFolder/{yyyy}/{MM}/{dd} |
AWSLogs/aws-account-id=111122223333/elasticloadbalancing/myFolder/year=2026/month=09/day=10/ |
Hive-compatible percorso abilitato, suffisso myFolder/ |
AWSLogs/111122223333/elasticloadbalancing/myFolder/ |
prefisso di destinazioneMyLogPrefix, Hive-compatible percorso disabilitato, suffisso omesso |
MyLogPrefix/AWSLogs/111122223333/elasticloadbalancing/us-east-1/2026/09/10/ |
Percorsi dei suffissi statici e autorizzazioni dei bucket
Per tipi di log come i log di accesso di Application Load Balancer, un registro suffixPath che contiene solo testo statico non abilita la Hive-compatible formattazione del prefisso dell'account definito dal servizio. Ad esempio, myFolder/ utilizza il semplice prefisso dell'account mostrato nella tabella. La consegna fallisce se CloudWatch Logs tenta di scrivere con il semplice prefisso dell'account e la policy del bucket consente solo il prefisso. Hive-compatible
Quando si crea una distribuzione di Application Load Balancer con enableHiveCompatiblePath set totrue, la bucket policy creata automaticamente concede s3:PutObject il prefisso. Hive-compatible Includi almeno una variabile supportata dal tipo di registro allowedSuffixPathFields in suffixPath o omettila suffixPath per un tipo di registro il cui percorso del suffisso predefinito supporta la formattazione. Hive-compatible
CloudFront standard logging (v2) formatta il suo prefisso predefinito indipendentemente dalle variabili in. suffixPath
Nota
CloudFront documenta il comportamento del percorso di registrazione standard (v2) e gli esempi in Send logs to Amazon S3.
Nota
L'aggiornamento del percorso o dell' Hive-compatible impostazione del suffisso influisce sulle consegne successive dopo la propagazione della configurazione. Gli oggetti esistenti non vengono spostati. Non è possibile modificare l'ARN di una destinazione, incluso il prefisso, mentre le consegne attive fanno riferimento a tale destinazione.
La policy del bucket deve consentire s3:PutObject il prefisso risultante. Quando gestisci la policy del bucket, mantieni attive le aws:SourceArn condizioni aws:SourceAccount e mostrate Politica delle risorse del bucket Amazon S3 nella policy del bucket di Amazon S3 e concedi l'accesso solo al prefisso richiesto.