Transfert de journaux : CloudFront (interface de ligne de commande AWS) log-forwarding-cloudfront-cli

Cette page explique comment transférer les journaux CDN de CloudFront vers le compartiment S3 d’Adobe pour la collecte de données du trafic généré par l’IA agentique. Vous utiliserez la page de configuration du réseau CDN de LLM Optimizer pour l’intégration à LLM Optimizer. Une fois le processus d’intégration terminé, suivez les étapes fournies sur cette page pour configurer le transfert des journaux à l’aide de l’interface de ligne de commande AWS à l’étape 2.

NOTE
Ce guide explique comment configurer le transfert de journaux à l’aide de l’interface de ligne de commande AWS. Si vous souhaitez configurer le transfert de journaux à l’aide de l’interface d’utilisation de CloudFront, consultez Transfert de journaux : CloudFront.

Étape 1 : intégrer dans LLM Optimizer step-1

Sur la page LLM Optimizer https://llmo.now/ :

  1. Accédez au tableau de bord de la configuration cliente.

    Bouton Configuration

  2. Cliquez sur l’onglet Configuration du CDN.

    Onglet Configuration du CDN

  3. Cliquez sur Prise en main.

  4. À côté de Activer les informations sur le trafic généré par l’IA, cliquez sur Configurer.

    Configurer

  5. Saisissez votre identifiant de compte AWS.

  1. Sélectionnez CloudFront (BYOCDN).

    Sélectionner CloudFront

  2. Cliquez sur Intégration.

Étape 2 : configurer le transfert de journaux du CDN avec l’interface de ligne de commande AWS step-2-cli

Configurez le transfert de journaux du CDN avec l’interface de ligne de commande AWS comme suit :

Configurer les informations d’identification de l’interface de ligne de commande AWS

Configurez le MAC de l’interface de ligne de commande AWS. Ouvrez ~/.aws/credentials et saisissez les valeurs des variables ci-dessous :

[LLMO]
aws_access_key_id=<VALUE_OF_ACCESS_KEY_ID>
aws_secret_access_key=<VALUE_OF_SECRET_KEY>
aws_session_token=<ONLY_IF_USING_SECURITY_TOKEN_SERVICE> ## Optional

Tester la connexion

Exécutez la commande ci-dessous pour tester la connexion :

aws sts get-caller-identity --profile LLMO

Exemple de sortie correcte :

aws sts get-caller-identity --profile LLMO
{
    "UserId": "AxxxxxxxxxxxP:user",
    "Account": "012345678912",
    "Arn": "arn:aws:sts::012345678912:assumed-role/klam-master-role-BatlY3dnPVinQLC/user"
}

Initialiser les variables

Remplacez REPLACEME123@AdobeOrg par votre identifiant d’organisation Adobe IMS et exécutez la commande ci-dessous. L’identifiant de sortie de cette commande est appelé TRANSFORM_IMS_ID.

echo "REPLACEME123@AdobeOrg" | sed 's/@AdobeOrg$//' | tr '[:upper:]' '[:lower:]'

Saisissez les valeurs de CUSTOMER, CDN_ID, ACCT1 et TRANSFORM_IMS_ID en suivant les instructions ci-dessous, puis exécutez les commandes à partir de votre terminal.

export PROFILE1=LLMO
export REGION1=us-east-1
export CUSTOMER=<CUSTOMER_NAME> ## No Space, user letters,numbers and dash
export CDN_ID=<YOUR_CLOUDFRONT_DISTRIBUTION_ID>
export ACCT1=<YOUR_AWS_ACCOUNT_NUMBER>
export DELIVERY_DEST_ARN=arn:aws:logs:us-east-1:640168421876:delivery-destination:cdn-logs-<TRANSFORM_IMS_ID>-ams  ## Replace TRANSFORM_IMS_ID with the output of the command above

Créer la source de diffusion

À partir du même terminal que celui utilisé pour l’étape 3, exécutez la commande ci-dessous :

aws logs put-delivery-source --name llmo-cf-${CUSTOMER}-${CDN_ID} \
  --profile $PROFILE1 --region $REGION1 \
  --resource-arn arn:aws:cloudfront::${ACCT1}:distribution/${CDN_ID} \
  --log-type ACCESS_LOGS
IMPORTANT
Si vous obtenez l’erreur suivante, recherchez la source de diffusion existante : Une erreur s’est produite (ConflictException) lors de l’appel de l’opération PutDeliverySource : ce ResourceId a déjà été utilisé dans une autre source de diffusion de ce compte.
Pour rechercher la source de diffusion existante, exécutez la commande suivante :
code language-bash
aws logs describe-delivery-sources --region us-east-1 \
    --query "deliverySources[?contains(resourceArns[0], '<CDN DistributionID>')]"
Dans la commande suivante, utilisez le nom de la source de diffusion à partir des résultats de la commande ci-dessus.

Créer la configuration de diffusion

aws logs create-delivery \
  --profile "$PROFILE1" --region "$REGION1" \
  --delivery-source-name "llmo-cf-${CUSTOMER}-${CDN_ID}" \
  --delivery-destination-arn $DELIVERY_DEST_ARN \
  --s3-delivery-configuration '{"suffixPath":"/{yyyy}/{MM}/{dd}/{HH}"}' \
  --record-fields 'date' 'time' 'x-edge-location' 'cs-method' 'cs(Host)' 'cs-uri-stem' 'sc-status' 'cs(Referer)' 'cs(User-Agent)' 'time-to-first-byte' 'sc-content-type' 'x-host-header'

<!–Alignez --record-fields et --s3-delivery-configuration sur la liste des champs et le suffixe de chemin affichés sur votre page de configuration de CDN LLM Optimizer si la documentation ou les valeurs du produit changent.–>

recommendation-more-help
llm-optimizer-help-main-toc