As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS Elemental MediaTailor Análise de registros do ADS no Amazon CloudWatch Logs Insights
Você pode visualizar e consultar AWS Elemental MediaTailor os registros do servidor de decisão de anúncios (ADS) usando o Amazon CloudWatch Logs Insights. MediaTailor envia registros de eventos CloudWatch para condições normais de processamento e erro. Os logs seguem um esquema JSON. Por meio do CloudWatch Logs Insights, você pode selecionar registros por período de tempo e, em seguida, executar consultas neles.
Para obter informações gerais, consulte [Analisar dados de registro com o CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
**nota**
Para acessar os registros, você precisa de permissões para acessar a Amazon CloudWatch. Para instruções, consulte [Permissões para Amazon CloudWatch Logs](monitoring-permissions.md).
**Para visualizar e consultar registros do ADS usando o CloudWatch console**
1. Abra o CloudWatch console em[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, em **Logs**, escolha **Insights**.
1. Na barra de pesquisa, digite e**AdDec**, na lista suspensa, selecione. `MediaTailor/AdDecisionServerInteractions`
1. (Opcional) Ajuste o período que você deseja estudar.
1. (Opcional) Altere a consulta na caixa de diálogo. Para orientação geral, consulte [Sintaxe de consulta do CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Para obter exemplos de consultas no ADS do MediaTailor, consulte [Consultando os registros do ADS](querying-the-ads-logs.md).
1. Selecione **Executar consulta**. A consulta pode levar alguns segundos, durante os quais **Cancel (Cancelar)** é exibido no lugar de **Run query (Executar consulta)**.
1. (Opcional) Para exportar os resultados como um arquivo CSV, escolha **Actions (Ações)** e, depois, selecione **Download query results (CSV) (Fazer download de resultados da consulta [CSV])**.
**nota**
O console limita o número de registros que ele retorna nos resultados da consulta e exporta. Portanto, para dados em massa, use a API, o AWS Command Line Interface (AWS CLI) ou um SDK.
**Topics**
+ [Consultando os registros do ADS](querying-the-ads-logs.md)
# Consultando os registros do ADS
CloudWatch O Logs Insights fornece um rico conjunto de opções para consultar seus registros. Para obter informações detalhadas sobre a sintaxe de consulta, consulte Sintaxe de [consulta do CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Esta seção fornece exemplos de consultas comuns para você começar a executar suas consultas de logs do ADS. Todas as consultas são executadas nos logs da configuração de intervalo de tempo atual.
A consulta a seguir recupera todas as informações dos logs do ADS.
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
A consulta a seguir recupera todas as solicitações para o ADS. Essa consulta mostra uma forma de recuperar o conteúdo do cabeçalho da solicitação para MediaTailor os registros.
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
A consulta a seguir recupera os anúncios MediaTailor inseridos em uma determinada sessão.
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
A consulta a seguir recupera URLs o rastreamento MediaTailor chamado em nome do jogador.
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
A consulta a seguir recupera informações de uma sessão de reprodução específica, filtrando os resultados por `sessionId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
A consulta a seguir recupera informações de uma única solicitação, filtrando os resultados por `requestId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
A consulta a seguir recupera uma contagem de entradas de log para cada tipo de evento que foi registrado.
```
fields eventType
| stats count() as @eventCount by eventType
```
A consulta a seguir recupera o ID de disponibilidade e a lista de anúncios ignorados para todas as disponibilidades que ignoraram anúncios.
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```