View a markdown version of this page

Registrazione che richiede autorizzazioni aggiuntive [V2] - CloudWatch Registri Amazon
Esempi di configurazione della consegna dei log

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 che richiede autorizzazioni aggiuntive [V2]

Alcuni AWS servizi utilizzano un nuovo metodo per inviare i propri log. Si tratta di un metodo flessibile che consente di configurare la consegna dei log da questi servizi verso una o più delle seguenti destinazioni: CloudWatch Logs, Amazon S3 o X-Ray Firehose e per la consegna tramite traccia.

Una consegna di log funzionante è composta da tre elementi:

  • ADeliverySource, che è un oggetto logico che rappresenta le risorse che effettivamente inviano i log.

  • ADeliveryDestination, che è un oggetto logico che rappresenta la destinazione di consegna effettiva.

  • ADelivery, che collega una fonte di consegna alla destinazione di consegna

Per configurare la consegna dei log tra un AWS servizio supportato e una destinazione, devi fare quanto segue:

  • Crea una fonte di consegna con PutDeliverySource.

  • Crea una destinazione di consegna con PutDeliveryDestination.

  • Se distribuisci log su più account, puoi utilizzare solo destinazioni Amazon S3 e Firehose. È necessario utilizzarlo PutDeliveryDestinationPolicynell'account di destinazione per assegnare una IAM policy alla destinazione. Questa politica autorizza la creazione di una consegna dalla fonte di consegna nell'account A alla destinazione di consegna nell'account B. Per la consegna tra account, devi creare manualmente le politiche di autorizzazione. Per esempi di configurazione, consulta. Cross-account esempio di consegna

  • Crea una consegna associando esattamente una fonte di consegna e una destinazione di consegna, utilizzando CreateDelivery.

Esempi di configurazione della consegna dei log

Gli esempi seguenti creano l'origine e la destinazione di consegna nello stesso AWS account. Sostituisci l'ARN della risorsa di origine e il tipo di log con i valori supportati dal servizio che genera i log. Questi esempi non richiedono una politica sulla destinazione di consegna.

Crea una fonte di consegna per i log di esecuzione delle query di CloudWatch Logs Insights

L'esempio seguente crea una fonte di consegna per i log di esecuzione delle query di CloudWatch Logs Insights. Per i requisiti ARN completi logType e relativi alle risorse, vedere. PutDeliverySource

Nota

Il carattere jolly finale log-group:* è obbligatorio perché i log di esecuzione delle query non sono legati a un gruppo di log. AWS non supporta un gruppo di log ARN specifico per questo tipo di registro.

aws logs put-delivery-source \
    --name insights-query-logs \
    --resource-arn arn:aws:logs:region:account-id:log-group:* \
    --log-type INSIGHTS_QUERY_LOGS

Crea una fonte di consegna

Crea la fonte di consegna, quindi utilizza uno degli esempi di destinazione che seguono.

aws logs put-delivery-source \
    --name my-delivery-source \
    --resource-arn source-resource-arn \
    --log-type log-type

Crea una consegna a CloudWatch Logs

Crea una destinazione di consegna per un gruppo di log esistente.

aws logs put-delivery-destination \
    --name my-cwl-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:logs:region:account-id:log-group:log-group-name"

Crea la consegna.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-cwl-delivery-destination

Creare una consegna su Amazon S3

Crea una destinazione di consegna per un bucket esistente.

aws logs put-delivery-destination \
    --name my-s3-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:s3:::bucket-name"

Crea la consegna.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-s3-delivery-destination

Per configurare un prefisso di destinazione, un percorso di suffisso o un Hive-compatible percorso, vedi. Formato chiave oggetto Amazon S3

Creare una consegna a Firehose

Crea una destinazione di consegna per un flusso di DirectPut consegna esistente.

aws logs put-delivery-destination \
    --name my-firehose-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:firehose:region:account-id:deliverystream/delivery-stream-name"

Crea la consegna.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-firehose-delivery-destination

Crea una consegna a X-Ray

Per la consegna tramite traccia, utilizza un servizio di origine e un tipo di registro che supporti la consegna a X-Ray. Crea la destinazione logica X-Ray di consegna.

aws logs put-delivery-destination \
    --name my-xray-delivery-destination \
    --delivery-destination-type XRAY

Crea la consegna.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-xray-delivery-destination

Per verificare la consegna, usa il seguente comando.

aws logs describe-deliveries \
    --delivery-source-name-prefix my-delivery-source

Le sezioni seguenti forniscono i dettagli delle autorizzazioni necessarie quando si effettua l'accesso per configurare la consegna dei log a ciascun tipo di destinazione utilizzando il processo V2. Queste autorizzazioni possono essere concesse a un ruolo IAM con cui hai effettuato l'accesso.

Importante

È responsabilità dell'utente rimuovere le risorse di consegna dei log dopo aver eliminato la risorsa che genera i log. A tale scopo, segui questi passaggi.

  1. Eliminare il Delivery utilizzando l'DeleteDeliveryoperazione.

  2. Eliminare il DeliverySource utilizzando l'DeleteDeliverySourceoperazione.

  3. Se l'DeliveryDestinationelemento associato a DeliverySource quello che hai appena eliminato viene utilizzato solo per questo specificoDeliverySource, puoi rimuoverlo utilizzando l'DeleteDeliveryDestinationsoperazione.

Indice