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á.
# Gravando AWS Elemental MediaTailor registros diretamente no Amazon CloudWatch Logs
MediaTailor produz registros que contêm informações detalhadas sobre a atividade da sessão e as interações do servidor de decisão de anúncios e os grava na Amazon CloudWatch. Os registros fornecem uma descrição sequencial da atividade que ocorre durante a sessão.
MediaTailor também pode usar registros vendidos para flexibilidade na entrega de registros e preços com desconto por volume. Para obter informações sobre registros vendidos, consulte[Usando registros vendidos](vended-logs.md).
**Topics**
+ [Permissões para Amazon CloudWatch Logs](monitoring-permissions.md)
+ [Registro “As Run” para AWS Elemental MediaTailor Channel Assembly](as-run-log.md)
+ [AWS Elemental MediaTailor Análise de registros do ADS no Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Permissões para Amazon CloudWatch Logs
Use AWS Identity and Access Management (IAM) para criar uma função que dê AWS Elemental MediaTailor acesso à Amazon CloudWatch. Você deve executar essas etapas para que CloudWatch os registros sejam publicados em sua conta. CloudWatch publica automaticamente métricas para sua conta.
**Para permitir o MediaTailor acesso a CloudWatch**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação do console do IAM, escolha **Perfis** e, em seguida, **Criar perfil**.
1. Escolha o tipo de função **Outro tipo de AWS conta**.
1. Em **ID da conta**, insira o ID AWS da sua conta.
1. Selecione **Require external ID (Exigir ID externo)** e digite **Midas**. Essa opção adiciona automaticamente uma condição à política de confiança que só permite ao serviço assumir a função caso a solicitação inclua o `sts:ExternalId` correto.
1. Escolha **Próximo: Permissões**.
1. Adicione uma política de permissões que especifique quais ações essa função pode concluir. Selecione uma das seguintes opções e escolha **Next: Review (Avançar: revisar)**:
+ **CloudWatchLogsFullAccess**para fornecer acesso total ao Amazon CloudWatch Logs
+ **CloudWatchFullAccess**para fornecer acesso total à Amazon CloudWatch
1. Em **Role name (Nome da função)**, digite **MediaTailorLogger** e escolha **Create role (Criar função)**.
1. Na página **Roles (Funções)**, escolha a função recém-criada.
1. Para atualizar a entidade principal, edite a relação de confiança:
1. Na página **Summary (Resumo)** da função, escolha a guia **Trust relationship (Relação de confiança)**.
1. Selecione **Editar relação de confiança**.
1. No documento de política, altere o principal para o MediaTailor serviço. A aparência deve ser semelhante a esta:
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
Toda a política deve ser lida da seguinte maneira:
1. Selecione **Atualizar política de confiança**.
# Registro “As Run” para AWS Elemental MediaTailor Channel Assembly
O registro *As Run*, no grupo de CloudWatch `MediaTailor/Channel/AsRunLog` registros, mostra informações sobre programas e intervalos publicitários enquanto eles são reproduzidos.
Quando você cria um canal, o registro As Run é desativado por padrão. Usando o console ou o AWS Command Line Interface (AWS CLI), você pode ativar e desativar o estado de registro As Run para cada canal da sua conta.
Quando você ativa o registro As Run, cria MediaTailor automaticamente uma função vinculada ao serviço que permite MediaTailor gravar e gerenciar o registro As Run na sua conta do CloudWatch Logs. Para obter mais informações sobre funções vinculadas ao serviço, consulte [Usando funções vinculadas a serviços para MediaTailor](using-service-linked-roles.md).
**nota**
Atualmente, o As Run Log suporta apenas o programa padrão. Por enquanto, ele não suporta o AlternateMedia criado pelas regras do programa. Isso significa que atualmente ele não gera o As Run Log para AlternateMedia.
**Topics**
+ [Ativando o registro As Run](enabling-as-run-log.md)
+ [Desativando o registro As Run](disabling-as-run-log.md)
# Ativando o registro As Run
Para ativar o registro As Run, especifique o nome do canal e ative o tipo de log As *Run* para esse canal.
------
#### [ Console ]
**Para ativar o registro As Run ao criar um canal**
1. Faça login no Console de gerenciamento da AWS e abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. No painel de navegação, escolha **Montagem de canais** **> Canais**.
1. Na barra de navegação, escolha **Criar canal**.
1. Nos painéis **Definir detalhes do canal**, **Configurar saídas** e **Controle de acesso**, configure seu canal conforme desejado.
1. No painel **Controle de acesso**, escolha **Avançar**.
1. No painel **Registro**, em **Tipos de registro**, selecione **Ativar como execução** para ativar o registro Como execução.
**Para ativar o registro As Run ao atualizar um canal**
**nota**
Se o canal estiver em execução no momento, você deve primeiro interromper esse canal antes de poder atualizá-lo. Depois de parar o canal, você pode escolher **Ações** > **Editar** para começar a atualizar o canal.
1. Faça login no Console de gerenciamento da AWS e abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. No painel de navegação, escolha **Montagem de canais** **> Canais**.
1. Escolha o canal que você deseja atualizar para ativar o registro As Run para.
1. Selecione **Actions** (Ações) > **Edit** (Editar).
1. Nos painéis **Definir detalhes do canal**, **Configurar saídas** e **Controle de acesso**, atualize a configuração do canal conforme desejado.
1. No painel **Controle de acesso**, escolha **Avançar**.
1. No painel **Registro**, em **Tipos de registro**, selecione **Ativar como execução** para ativar o registro Como execução.
**Para habilitar o registro As Run na guia **Logging****
**nota**
Se o canal estiver em execução no momento, você deverá usar a guia **Registro** em vez de escolher **Ações** > **Editar** para ativar o registro As Run.
1. Faça login no Console de gerenciamento da AWS e abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. No painel de navegação, escolha **Montagem de canais** **> Canais**.
1. Escolha o canal para o qual você deseja habilitar o registro As Run.
1. Na barra de navegação abaixo do nome do canal, escolha **Registro**.
1. Em **Registro** > **Tipos de registro**, selecione **Como execução** para ativar o registro Como execução.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para ativar o registro As Run**
Execute o [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando e especifique os valores apropriados para os parâmetros necessários.
Este exemplo está formatado para Linux, macOS ou Unix e usa o caractere de continuação de linha “barra invertida (\$1)” para melhorar a legibilidade.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Este exemplo foi formatado para Microsoft Windows e usa o caractere de continuação de linha circunflexo (^) para melhorar a legibilidade.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Em que:
+ `MyChannel`é o nome do canal que você possui e para o qual deseja ativar o registro As Run.
Se o comando for executado com sucesso, você receberá um resultado semelhante ao seguinte.
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Desativando o registro As Run
Para desativar o registro As Run para um canal que o tenha ativado, especifique o nome do canal e desative o tipo de log As *Run* para esse canal.
------
#### [ Console ]
**Para desativar o registro As Run ao atualizar um canal**
**nota**
Se o canal estiver em execução no momento, você deve primeiro interromper esse canal antes de poder atualizá-lo. Depois de parar o canal, você pode escolher **Ações** > **Editar** para começar a atualizar o canal.
1. Faça login no Console de gerenciamento da AWS e abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. No painel de navegação, escolha **Montagem de canais** **> Canais**.
1. Escolha o canal que você deseja atualizar para ativar o registro As Run para.
1. Selecione **Actions** (Ações) > **Edit** (Editar).
1. Nos painéis **Definir detalhes do canal**, **Configurar saídas** e **Controle de acesso**, atualize a configuração do canal conforme desejado.
1. No painel **Controle de acesso**, escolha **Avançar**.
1. No painel **Registro**, em **Tipos de registro**, desmarque **Ativar como execução** para desativar o registro Como execução.
**Para desativar o registro As Run na guia **Logging****
**nota**
Se o canal estiver em execução no momento, você deverá usar a guia **Registro** em vez de escolher **Ações** > **Editar** para desativar o registro As Run.
1. Faça login no Console de gerenciamento da AWS e abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. No painel de navegação, escolha **Montagem de canais** **> Canais**.
1. Escolha o canal para o qual você deseja desativar o registro As Run.
1. Na barra de navegação abaixo do nome do canal, escolha **Registro**.
1. Em **Registro** > **Tipos de registro**, **desmarque As run** para desativar o log As Run.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Para desativar o registro As Run**
Execute o [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)comando e especifique os valores apropriados para os parâmetros necessários.
Este exemplo está formatado para Linux, macOS ou Unix e usa o caractere de continuação de linha “barra invertida (\$1)” para melhorar a legibilidade.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Este exemplo foi formatado para Microsoft Windows e usa o caractere de continuação de linha circunflexo (^) para melhorar a legibilidade.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Em que:
+ `MyChannel`é o nome do canal que você possui e do qual deseja desativar o registro As Run.
Se o comando for executado com sucesso, você receberá um resultado semelhante ao seguinte.
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# 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)
```