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á.

# Monitoramento AWS Elemental MediaTailor com CloudWatch métricas da Amazon
<a name="monitoring-cloudwatch-metrics"></a>

Você pode monitorar AWS Elemental MediaTailor métricas usando CloudWatch o. CloudWatch coleta dados brutos sobre o desempenho do serviço e processa esses dados em métricas legíveis e quase em tempo real. Essas estatísticas são mantidas por 15 meses, de maneira que você possa acessar informações históricas e ter uma perspectiva melhor de como o aplicativo web ou o serviço está se saindo. Você também pode definir alarmes que observam determinados limites e enviam notificações ou realizam ações quando esses limites são atingidos. Para obter mais informações, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

As métricas podem ser úteis quando você investiga manifestos obsoletos. Para obter mais informações, consulte [Usando métricas para diagnosticar manifestos obsoletos](stale-manifest-diagnose.md).

As métricas são agrupadas primeiro pelo namespace do serviço e, em seguida, por várias combinações de dimensão dentro de cada namespace.

**Para visualizar métricas 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, selecione **Métricas**.

1. Em **Todas as métricas**, escolha o **MediaTailor**namespace. 

1. Selecione a dimensão da métrica para exibir as métricas (por exemplo, **originID**).

1. Especifique o período que você deseja visualizar. 

**Para visualizar métricas usando o AWS Command Line Interface (AWS CLI)**
+ Em um prompt de comando, use o seguinte comando:

  ```
  aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
  ```

## AWS Elemental MediaTailor CloudWatch métricas
<a name="metrics"></a>

O AWS Elemental MediaTailor namespace inclui as seguintes métricas. Essas métricas são publicadas por padrão na conta. 

### Métricas de montagem de canais (CA)
<a name="metrics.channel-assembly"></a>

Na tabela a seguir, todas as métricas estão disponíveis por canal ou por saída do canal.


| Métrica | Description | 
| --- | --- | 
|  4xxErrorCount  | O número de `4xx` erros. | 
|  5xxErrorCount  | O número de `5xx` erros. | 
|  RequestCount  | O número total de solicitações . A contagem de transações depende muito da frequência com que os jogadores solicitam manifestos atualizados e do número de jogadores. Cada solicitação de player conta como uma transação. | 
|  TotalTime  | A quantidade de tempo que o servidor do aplicativo levou para processar a solicitação, incluindo o tempo usado para receber bytes e gravar bytes no cliente e na rede.  | 

#### Server-side Ad-insertion Métricas (SSAI)
<a name="metrics.server-side-ad-insertion"></a>

A tabela a seguir lista as métricas de inserção de anúncios do lado do servidor.


| Métrica | Description | 
| --- | --- | 
|  AdDecisionServer.Ads  | A contagem de anúncios incluídos nas respostas do servidor de decisão de anúncios (ADS) dentro do CloudWatch período que você especificou. | 
|  AdDecisionServer.Duration  | A duração total, em milissegundos, de todos os anúncios MediaTailor recebidos do ADS dentro do CloudWatch período que você especificou. Essa duração pode ser maior do `Avail.Duration` que a especificada. | 
|  AdDecisionServer.Errors  | O número de respostas de código de status não HTTP 200, respostas vazias e respostas com tempo limite MediaTailor recebidas do ADS dentro do período de CloudWatch tempo especificado. | 
|  AdDecisionServer.FillRate  | A média simples das taxas em que as respostas do ADS preencheram as disponibilidades de anúncios individuais correspondentes para o período especificado.<br />Para obter a média ponderada, calcule o `AdDecisionServer.Duration` como uma porcentagem do `Avail.Duration`. Para obter mais informações sobre a média ponderada e simples, consulte [Médias simples e ponderadas](#metrics-simple-average). | 
|  AdDecisionServer.Latency  | O tempo de resposta em milissegundos para solicitações feitas pelo MediaTailor ADS. | 
|  AdDecisionServer.Timeouts  | O número de solicitações expiradas para o ADS no CloudWatch período que você especificou. | 
|  AdNotReady  | O número de vezes que o ADS apontou para um anúncio que ainda não foi transcodificado pelo serviço transcodificador interno no período especificado.<br />Um valor alto dessa métrica pode contribuir para um `Avail.FillRate` geral baixo. | 
|  AdsBilled  | O número de anúncios pelos quais os clientes são MediaTailor cobrados com base na inserção. | 
|  Avail.Duration  | O número total planejado de milissegundos do anúncio é disponibilizado dentro do CloudWatch período. O total planejado é baseado nas durações de disponibilidade do anúncio no manifesto de origem. | 
|  Avail.FilledDuration  | O número planejado de milissegundos de tempo de disponibilidade do anúncio que MediaTailor será preenchido com anúncios dentro do CloudWatch período. | 
|  Avail.FillRate  | A média simples planejada das taxas nas quais o anúncio individual MediaTailor será preenchido é disponibilizada dentro do período de CloudWatch tempo.<br />Para obter a média ponderada, calcule o `Avail.FilledDuration` como uma porcentagem do `Avail.Duration`. Para obter mais informações sobre a média ponderada e simples, consulte [Médias simples e ponderadas](#metrics-simple-average).<br />O `Avail.FillRate` máximo que o MediaTailor pode atingir é delimitado pelo `AdDecisionServer.FillRate`. Se o `Avail.FillRate` for baixo, compare-o com o `AdDecisionServer.FillRate`. Se o `AdDecisionServer.FillRate` for baixo, o ADS pode não estar retornando anúncios o suficiente para as durações de disponibilidades.  | 
|  Avail.Impression  | O número de anúncios com eventos de rastreamento de impressões que são exibidos MediaTailor durante o beaconing do lado do servidor (não o número de impressões). | 
|  Avail.ObservedDuration  | O número total observado de milissegundos de disponibilidades de anúncios que ocorreram dentro do CloudWatch período. `Avail.ObservedDuration`é emitido no final da disponibilidade do anúncio e é baseado na duração dos segmentos informados no manifesto durante a disponibilização do anúncio. | 
|  Avail.ObservedFilledDuration  | O número observado de milissegundos de tempo de disponibilidade do anúncio MediaTailor preenchido com anúncios dentro do CloudWatch período. | 
|  Avail.ObservedFillRate  | A média simples observada das taxas nas quais o anúncio individual MediaTailor preenchido é disponibilizado dentro do período de CloudWatch tempo.<br />Emitido somente para manifestos HLS, na primeira tag. `CUE-IN` Se não houver `CUE-IN` tag, MediaTailor não emite essa métrica.  | 
|  Avail.ObservedSlateDuration  | O número total observado de milissegundos de ardósia que foi inserido no CloudWatch período. | 
|  GetManifest.Age  | A idade total do manifesto em milissegundos. Medido desde o momento em que a origem cria o manifesto até o momento em que MediaTailor envia o manifesto personalizado. <br />Para obter mais informações sobre métricas para medir a idade do manifesto, consulte[Usando métricas para diagnosticar manifestos obsoletos](stale-manifest-diagnose.md). | 
|  GetManifest.Errors  | O número de erros recebidos durante MediaTailor a geração de manifestos no CloudWatch período que você especificou. | 
|  GetManifest.Latency  | O tempo de MediaTailor resposta em milissegundos para a solicitação gerar manifestos.<br />Para obter mais informações sobre métricas para medir a idade do manifesto, consulte[Usando métricas para diagnosticar manifestos obsoletos](stale-manifest-diagnose.md). | 
|  GetManifest.MediaTailorAge  | A quantidade de tempo em que o manifesto foi armazenado MediaTailor em milissegundos. Medido desde quando MediaTailor recebe uma resposta de origem até quando MediaTailor envia o manifesto personalizado. <br />Para obter mais informações sobre métricas para medir a idade do manifesto, consulte[Usando métricas para diagnosticar manifestos obsoletos](stale-manifest-diagnose.md). | 
|  Origin.Age  | A quantidade de tempo em que a origem tem o manifesto em milissegundos. Medido desde quando a origem cria o manifesto até quando MediaTailor envia a solicitação de origem. <br />Todas as `origin.*` métricas são emitidas para solicitações atendidas diretamente da origem. Eles não são emitidos para respostas de origem em cache.<br />Para obter mais informações sobre métricas para medir a idade do manifesto, consulte[Usando métricas para diagnosticar manifestos obsoletos](stale-manifest-diagnose.md). | 
|  Origin.Errors  | O número de respostas de código de status não HTTP 200 e respostas com tempo limite MediaTailor recebidas do servidor de origem no CloudWatch período que você especificou.<br />Todas as `origin.*` métricas são emitidas para solicitações atendidas diretamente da origem. Eles não são emitidos para respostas de origem em cache. | 
|  Origin.ManifestFileSizeBytes  | O tamanho do arquivo do manifesto de origem em bytes para HLS e DASH. Normalmente, essa métrica é usada em conjunto com`Origin.ManifestFileSizeTooLarge`.<br />Todas as `origin.*` métricas são emitidas para solicitações atendidas diretamente da origem. Eles não são emitidos para respostas de origem em cache. | 
|  Origin.ManifestFileSizeTooLarge  | O número de respostas da origem que têm um tamanho de manifesto maior do que o valor configurado. Normalmente, essa métrica é usada em conjunto com`Origin.ManifestFileSizeBytes`.<br />Todas as `origin.*` métricas são emitidas para solicitações atendidas diretamente da origem. Eles não são emitidos para respostas de origem em cache. | 
|  Origin.Timeouts  | O número de solicitações expiradas para o servidor de origem no CloudWatch período que você especificou.<br />Todas as `origin.*` métricas são emitidas para solicitações atendidas diretamente da origem. Eles não são emitidos para respostas de origem em cache. | 
|  Requests  | O número de transações simultâneas por segundo em todos os tipos de solicitação. A contagem de transações depende principalmente do número de jogadores e da frequência com que os jogadores solicitam manifestos atualizados. Cada solicitação de player conta como uma transação. | 
|  SkippedReason.DurationExceeded  | O número de anúncios que não foram inseridos em uma disponibilidade porque o ADS retornou uma duração de anúncios maior do que a duração de disponibilidade especificada. Um valor alto para essa métrica pode contribuir para uma discrepância entre a métrica `Avail.Ads` e. `AdDecisionServer.Ads` Para obter mais informações sobre os motivos pelos quais o anúncio foi ignorado, consulte. [Solução de problemas com o ignorar anúncios](troubleshooting-ad-skipping-overview.md) | 
|  SkippedReason.EarlyCueIn  | O número de anúncios ignorados devido a um anúncio antecipado. `CUE-IN` | 
|  SkippedReason.ImportError  | O número de anúncios ignorados devido a um erro no trabalho de importação. | 
|  SkippedReason.ImportInProgress  | O número de anúncios ignorados devido a um trabalho de importação ativo existente. | 
|  SkippedReason.InternalError  | O número de anúncios ignorados devido a um erro MediaTailor interno. | 
|  SkippedReason.NewCreative  | O número de anúncios que não foram inseridos em um avail porque foi a primeira vez que o recurso foi solicitado por um cliente. Um valor alto dessa métrica pode contribuir temporariamente para uma baixa geral`Avail.FillRate`, até que os ativos possam ser transcodificados com sucesso. | 
|  SkippedReason.NoVariantMatch  | O número de anúncios ignorados por não haver correspondência de variantes entre o anúncio e o conteúdo. | 
|  SkippedReason.PersonalizationThresholdExceeded  | A duração dos anúncios que excedem a configuração **Limite de Personalização nessa** configuração. | 
|  SkippedReason.ProfileNotFound  | O número de anúncios ignorados porque o perfil de transcodificação não foi encontrado. | 
|  SkippedReason.TranscodeError  | O número de anúncios ignorados devido a um erro de transcodificação. | 
|  SkippedReason.TranscodeInProgress  | A contagem do número de anúncios que não foram inseridos em um avail porque o anúncio ainda não havia sido transcodificado. Um valor alto dessa métrica pode contribuir temporariamente para uma baixa geral`Avail.FillRate`, até que os ativos possam ser transcodificados com sucesso. | 
|  GetAssets.Requests  | O número de solicitações da Lista de Ativos recebidas para as sessões do HLS Interstitials dentro do período. CloudWatch Use essa métrica para monitorar o volume de decisões de anúncios com vinculação tardia e entender a escala do uso do HLS Interstitials. | 
|  GetAssets.Latency  | O tempo de resposta para solicitações da Lista de ativos em milissegundos para sessões HLS Interstitials. Monitore essa métrica para garantir o desempenho ideal na tomada de decisões sobre anúncios e identificar possíveis gargalos no fluxo de trabalho de vinculação tardia. | 

**nota**  
Nas sessões do HLS Interstitials, algumas métricas se comportam de forma diferente devido à natureza de vinculação tardia da tomada de decisões sobre anúncios:  
`Avail.ObservedFilledDuration`corresponde, `Avail.FilledDuration` pois MediaTailor não consegue observar o comportamento real de reprodução do lado do cliente.
`Avail.ObservedSlateDuration`relata a duração planejada da lista a partir das respostas da Lista de ativos, em vez da reprodução observada.
As métricas prefixadas com “Observado” fornecem valores estimados para as sessões do HLS Interstitials.

### Métricas de funções
<a name="metrics.functions"></a>

As métricas a seguir são publicadas quando você usa o [Functions](monetization-functions.html) com suas configurações de reprodução. Essas métricas são sempre emitidas quando uma função é configurada em um gancho de ciclo de vida. Nenhuma configuração de inscrição ou registro é necessária.

**Hook-level métricas** — um ponto de dados por execução do gancho do ciclo de vida:


| Métrica | Description | 
| --- | --- | 
|  PreSessionInitHook.Invocations  | O número de vezes que o gancho de inicialização pré-sessão foi invocado. | 
|  PreSessionInitHook.Errors  | O número de execuções de ganchos de inicialização pré-sessão que resultaram em um erro. | 
|  PreSessionInitHook.Latency  | O tempo de execução em milissegundos do gancho de inicialização da pré-sessão. | 
|  PreAdsRequestHook.Invocations  | O número de vezes que o gancho de solicitação de pré-anúncios foi invocado. | 
|  PreAdsRequestHook.Errors  | O número de execuções de ganchos de solicitações pré-anúncios que resultaram em um erro. | 
|  PreAdsRequestHook.Latency  | O tempo de execução em milissegundos do gancho de solicitação de pré-anúncios. | 

**Function-level métricas** — um ponto de dados por execução de função individual. Essas métricas incluem dimensões adicionais (`FunctionId`,`FunctionType`,`HookType`) para que você possa identificar qual função específica está lenta ou está falhando:


| Métrica | Description | 
| --- | --- | 
|  Function.Invocations  | O número de vezes que uma função individual foi executada. | 
|  Function.Errors  | O número de execuções de funções individuais que resultaram em um erro. | 
|  Function.Latency  | O tempo de execução em milissegundos para uma função individual. | 

### Médias simples e ponderadas
<a name="metrics-simple-average"></a>

Você pode recuperar a média simples e a média ponderada das respostas do ADS às solicitações de anúncios MediaTailor e de como os MediaTailor preenchimentos são disponibilizados: 
+ As *médias simples * são fornecidas no `AdDecisionServer.FillRate` e no `Avail.FillRate`. Essas são as médias da taxa de preenchimento para invocar porcentagens para disponibilidades individuais para o período. A média simples não leva em conta as diferenças entre as durações das disponibilidades individuais.
+ As *médias ponderadas* são as porcentagens da taxa de preenchimento para a soma de todas as durações de disponibilidades. Elas são calculadas como (`AdDecisionServer.Duration`\* 100)/`Avail.Duration` e (`Avail.FilledDuration`\* 100)/`Avail.Duration`. Essas médias refletem as diferenças na duração de cada disponibilidade de anúncios, dando mais peso para aquelas com maior duração. 

Para um período que contém apenas uma única disponibilidade de anúncios, a média simples fornecida pelo `AdDecisionServer.FillRate` é igual à média ponderada fornecida pelo (`AdDecisionServer.Duration`\* 100)/`Avail.Duration`. A média simples fornecida pelo `Avail.FillRate` é igual à média ponderada fornecida pelo (`Avail.FilledDuration`\* 100)/`Avail.Duration`. 

**Exemplo**

Vamos supor que o período que você especificou tenha as duas disponibilidades de anúncios a seguir:
+ A primeira disponibilidade de anúncios tem 90 segundos de duração:
  + A resposta ADS para a disponibilidade fornece 45 segundos de anúncios (50% preenchido). 
  + MediaTailor preenche 45 segundos do tempo de anúncio disponível (50% preenchido).
+ A segunda disponibilidade de anúncios tem 120 segundos de duração: 
  + A resposta ADS para a disponibilidade fornece 120 segundos de anúncios (100% preenchido). 
  + MediaTailor preenche 90 segundos do tempo de anúncio disponível (75% preenchido).

As métricas são as seguintes: 
+ `Avail.Duration` é 210, a soma das duas durações de disponibilidade de anúncios: 90 \+ 120.
+ `AdDecisionServer.Duration` é 165, a soma das duas durações de resposta: 45 \+ 120.
+ `Avail.FilledDuration` é 135, a soma das duas durações preenchidas: 45 \+ 90. 
+ `AdDecisionServer.FillRate` é 75%, a média das porcentagens preenchidas para cada disponibilidade: (50% \+ 100%)/2. Essa é a média simples.
+ A média ponderada para as taxas de preenchimento ADS é 78,57%, que é `AdDecisionServer.Duration` como uma porcentagem do `Avail.Duration`: (165\*100)/210. Esse cálculo leva em conta as diferenças nas durações. 
+ `Avail.FillRate` é 62,5%, a média das porcentagens preenchidas para cada disponibilidade: (50% \+ 75%)/2. Essa é a média simples.
+ A média ponderada das taxas de preenchimento MediaTailor disponível é de 64,29%, que é a porcentagem de`Avail.Duration`: (`Avail.FilledDuration`135\*100)/210. Esse cálculo leva em conta as diferenças nas durações. 

O máximo `Avail.FillRate` que se MediaTailor pode atingir com a disponibilidade de qualquer anúncio é 100%. O ADS pode retornar mais tempo de anúncios do que está disponível na disponibilidade, mas o MediaTailor só pode preencher o tempo disponível. 

## AWS Elemental MediaTailor CloudWatch dimensões
<a name="dimensions"></a>

Você pode filtrar os AWS Elemental MediaTailor dados usando as seguintes dimensões.


| Dimensão | Description | 
| --- | --- | 
| `ConfigurationName` | Indica a configuração à qual a métrica pertence. Disponível em todas as métricas. | 
| `FunctionId` | O identificador da função. Disponível somente em `Function.*` métricas. | 
| `FunctionType` | O tipo de função:`CUSTOM_OUTPUT`,`HTTP_REQUEST`,`SEQUENTIAL_EXECUTOR`, ou`CONCURRENT_EXECUTOR`. Disponível somente em `Function.*` métricas. | 
| `HookType` | O gancho do ciclo de vida que acionou a função: `PRE_SESSION_INITIALIZATION` ou. `PRE_ADS_REQUEST` Disponível somente em `Function.*` métricas. |