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 do Adobe Brand Visibility CDN para integrar-se ao Adobe Brand Visibility. 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 Adobe Brand Visibility step-1

Na página do Adobe Brand Visibility https://abv.adobe.com/:

  1. Vá para Gerenciamento de Marcas.

  2. Clique no rótulo CDN.

    Gerenciamento de marcas: encaminhamento de log 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>  ## 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 do Adobe Brand Visibility CDN se a documentação ou os valores do produto forem alterados.—>

recommendation-more-help
brand-visibility-help-main-toc