Encaminhamento de log: CloudFront (AWS CLI) log-forwarding-cloudfront-cli

Esta página detalha como encaminhar logs de CDN do CloudFront para o bloco S3 do Adobe para a coleção de dados de tráfego agêntico. Você usará a página de configuração da CDN do LLM Optimizer para fazer a integração com o LLM Optimizer. Após a conclusão do processo de integração, siga as etapas fornecidas nesta página para configurar o encaminhamento de log usando a Interface de linha de comando do AWS na Etapa 2.

NOTE
Este guia explica como configurar o encaminhamento de logs usando a Interface de linha de comando do AWS. Se você quiser configurar o encaminhamento de logs usando a Interface de usuário do CloudFront, consulte Encaminhamento de logs: CloudFront.

Etapa 1: integrar no LLM Optimizer step-1

Na página do LLM Optimizer https://llmo.now/:

  1. Acesse o Painel de configuração do cliente.

    Botão Configuração

  2. Clique na guia Configuração da CDN.

    Guia de Configuração da CDN

  3. Clique em Começar.

  4. Ao lado de Ativar insights de tráfego com IA, clique em Configurar.

    Configurar

  5. Insira a ID da sua conta AWS.

  1. Selecione CloudFront (BYOCDN).

    Selecione CloudFront

  2. Clique em Integrar.

Etapa 2: configurar o encaminhamento de log da CDN com o AWS CLI step-2-cli

Configure o encaminhamento de logs da CDN com o AWS CLI da seguinte forma:

Configurar credenciais do AWS CLI

Configurar credencial MAC do AWS CLI. Abra ~/.aws/credentials e insira os valores das variáveis abaixo:

[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

Testar a conexão

Execute o comando abaixo para testar a conexão:

aws sts get-caller-identity --profile LLMO

Exemplo de saída bem-sucedida:

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

Inicializar variáveis

Substitua REPLACEME123@AdobeOrg pela ID da organização no Adobe IMS e execute o comando abaixo. A ID de saída deste comando será chamada de TRANSFORM_IMS_ID.

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

Insira os valores para CUSTOMER, CDN_ID, ACCT1 e TRANSFORM_IMS_ID seguindo as diretrizes abaixo e execute os comandos do 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

Criar a origem da entrega

No mesmo terminal em que a etapa 3 foi executada, execute o comando abaixo:

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
Se você receber o seguinte erro, procure a origem de entrega existente: ocorreu um erro (ConflictException) ao chamar a operação PutDeliverySource: este ResourceId já foi usado em outra Origem de entrega nesta conta.
Para pesquisar a origem de entrega existente, execute este comando:
code language-bash
aws logs describe-delivery-sources --region us-east-1 \
    --query "deliverySources[?contains(resourceArns[0], '<CDN DistributionID>')]"
No próximo comando, use o nome da origem de entrega obtido nos resultados do comando acima.

Criar a configuração de entrega

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'

<!–Alinhe --record-fields e --s3-delivery-configuration com a lista de campos e o sufixo de caminho mostrados na página de configuração da CDN do LLM Optimizer se a documentação ou os valores do produto forem alterados.–>

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