View a markdown version of this page

Monitoramento AWS Elemental MediaTailor com CloudWatch métricas da Amazon - AWS Elemental MediaTailor

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

Você pode monitorar AWS Elemental MediaTailor as métricas usando CloudWatch. 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.

As métricas podem ser úteis quando você investiga manifestos obsoletos. Para obter mais informações, consulte Usando métricas para diagnosticar manifestos obsoletos.

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 emhttps://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, selecione Métricas.

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

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

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

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)

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

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 de aplicativos levou para processar a solicitação, incluindo o tempo usado para receber bytes e gravá-los no cliente e na rede.

Server-side Ad-insertion Métricas (SSAI)

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 período de CloudWatch tempo que você especificou.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

AdDecisionServer.Duration

A duração total, em milissegundos, de todos os anúncios MediaTailor recebidos do ADS dentro do período de CloudWatch tempo que você especificou. Essa duração pode ser maior do Avail.Duration que a especificada.

Dimensões: ConfigurationName

AdDecisionServer.Errors

O número de respostas de código de status não HTTP 200, respostas vazias e respostas expiradas MediaTailor recebidas do ADS dentro do período de CloudWatch tempo que você especificou.

Dimensões: ConfigurationName

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.

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.

Dimensões: ConfigurationName

AdDecisionServer.Latency

O tempo de resposta em milissegundos para solicitações feitas pelo MediaTailor ADS.

Dimensões: ConfigurationName

AdDecisionServer.Timeouts

O número de solicitações expiradas para o ADS no CloudWatch período que você especificou.

Dimensões: ConfigurationName

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.

Um valor alto dessa métrica pode contribuir para um Avail.FillRate geral baixo.

Dimensões: ConfigurationName

AdsBilled

O número de anúncios pelos quais a MediaTailor fatura dos clientes é baseada na inserção.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

Avail.Duration

O número total planejado de milissegundos de anúncios disponibilizados dentro do CloudWatch período. O total planejado é baseado nas durações de disponibilidade do anúncio no manifesto de origem.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

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.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

Avail.FillRate

A média simples planejada das taxas pelas quais os anúncios individuais MediaTailor serão preenchidos dentro do período de CloudWatch tempo.

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.

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.

Dimensões: ConfigurationName

Avail.Impression

O número de anúncios para os quais MediaTailor dispararam sinais de impressão durante a geração de relatórios do lado do servidor. MediaTailor emite uma contagem para cada anúncio que tenha pelo menos um URI de impressão, independentemente de esses beacons terem sido entregues ou não. Use essa métrica como denominador para calcular a taxa de conclusão de vídeo (VCR) (consulteAvail.Complete).

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

Avail.Complete

O número de anúncios para os quais MediaTailor dispararam beacons completos durante a geração de relatórios do lado do servidor. MediaTailor emite uma contagem para cada anúncio que tenha pelo menos um URI de rastreamento completo, independentemente de esses beacons terem sido entregues ou não. Para calcular a taxa de conclusão de vídeo (VCR), divida a soma de Avail.Complete pela soma deAvail.Impression.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

Avail.ObservedDuration

O número total observado de milissegundos de anúncios publicitários que ocorreram dentro do CloudWatch período. Avail.ObservedDurationé emitido no final da disponibilidade do anúncio e é baseado na duração dos segmentos relatados no manifesto durante o lançamento do anúncio.

Dimensões: ConfigurationName

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 de tempo.

Dimensões: ConfigurationName

Avail.ObservedFillRate

A média simples observada das taxas nas quais um anúncio individual MediaTailor preenchido é disponibilizado dentro do período de CloudWatch tempo.

Emitido somente para manifestos HLS, na primeira tag. CUE-IN Se não houver CUE-IN tag, MediaTailor não emite essa métrica.

Dimensões: ConfigurationName

Avail.ObservedSlateDuration

O número total observado de milissegundos de ardósia que foi inserido no CloudWatch período.

Dimensões: ConfigurationName

GetManifest.Age

A idade total do manifesto em milissegundos. Medido desde quando a origem cria o manifesto até quando MediaTailor envia o manifesto personalizado.

Para obter mais informações sobre métricas para medir a idade do manifesto, consulteUsando métricas para diagnosticar manifestos obsoletos.

Dimensões: ConfigurationName

GetManifest.Errors

O número de erros recebidos durante MediaTailor a geração de manifestos no CloudWatch período que você especificou.

Dimensões: ConfigurationName

GetManifest.Latency

O tempo de MediaTailor resposta em milissegundos para a solicitação gerar manifestos.

Para obter mais informações sobre métricas para medir a idade do manifesto, consulteUsando métricas para diagnosticar manifestos obsoletos.

Dimensões: ConfigurationName

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.

Para obter mais informações sobre métricas para medir a idade do manifesto, consulteUsando métricas para diagnosticar manifestos obsoletos.

Dimensões: ConfigurationName

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.

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.

Para obter mais informações sobre métricas para medir a idade do manifesto, consulteUsando métricas para diagnosticar manifestos obsoletos.

Dimensões: ConfigurationName

Origin.Errors

O número de respostas de código de status não HTTP 200 e respostas expiradas MediaTailor recebidas do servidor de origem no período de CloudWatch tempo que você especificou.

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.

Dimensões: ConfigurationName

Origin.ManifestFileSizeBytes

O tamanho do arquivo do manifesto de origem em bytes para HLS e DASH. Normalmente, essa métrica é usada em conjunto comOrigin.ManifestFileSizeTooLarge.

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.

Dimensões: ConfigurationName

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 comOrigin.ManifestFileSizeBytes.

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.

Dimensões: ConfigurationName

Origin.Timeouts

O número de solicitações expiradas para o servidor de origem no CloudWatch período que você especificou.

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.

Dimensões: ConfigurationName

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.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

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 as métricas AdsBilled e. AdDecisionServer.Ads Para obter mais informações sobre os motivos do anúncio ser ignorado, consulte. Solução de problemas para pular anúncios

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.EarlyCueIn

O número de anúncios ignorados devido a uma antecipação. CUE-IN

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.ImportError

O número de anúncios ignorados devido a um erro no trabalho de importação.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.ImportInProgress

O número de anúncios ignorados devido a um trabalho de importação ativo existente.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.InternalError

O número de anúncios ignorados devido a um erro MediaTailor interno.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.NewCreative

O número de anúncios que não foram inseridos em um anúncio porque foi a primeira vez que o ativo foi solicitado por um cliente. Um valor alto para essa métrica pode contribuir temporariamente para uma baixa geralAvail.FillRate, até que os ativos possam ser transcodificados com sucesso.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.NoVariantMatch

O número de anúncios ignorados por não haver correspondência variante entre o anúncio e o conteúdo.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.PersonalizationThresholdExceeded

A duração dos anúncios que excedem a configuração do Limite de Personalização nessa configuração.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.ProfileNotFound

O número de anúncios ignorados porque o perfil de transcodificação não foi encontrado.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.TranscodeError

O número de anúncios ignorados devido a um erro de transcodificação.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

SkippedReason.TranscodeInProgress

A contagem do número de anúncios que não foram inseridos em uma promoção porque o anúncio ainda não havia sido transcodificado. Um valor alto para essa métrica pode contribuir temporariamente para uma baixa geralAvail.FillRate, até que os ativos possam ser transcodificados com sucesso.

Dimensões:

  • ConfigurationName

  • Account-level (sem dimensões)

nota

Nas sessões do HLS Interstitials, algumas métricas se comportam de forma diferente devido à natureza vinculativa tardia da decisão de anúncios:

  • Avail.ObservedFilledDurationcorresponde, Avail.FilledDuration pois MediaTailor não é possível observar o comportamento real de reprodução do lado do cliente.

  • Avail.ObservedSlateDurationrelata a duração planejada da lista de ativos 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

As métricas a seguir são publicadas quando você usa o Functions 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 opcional ou de registro é necessária.

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

Métrica Description
PreSessionInitHook.Invocations

O número de vezes que o gancho de inicialização pré-sessão foi invocado.

Dimensões: ConfigurationName

PreSessionInitHook.Errors

O número de execuções de ganchos de inicialização antes da sessão que resultaram em um erro.

Dimensões: ConfigurationName

PreSessionInitHook.Latency

O tempo de execução em milissegundos do gancho de inicialização pré-sessão.

Dimensões: ConfigurationName

PreAdsRequestHook.Invocations

O número de vezes que o gancho de solicitação de pré-anúncios foi invocado.

Dimensões: ConfigurationName

PreAdsRequestHook.Errors

O número de execuções de ganchos de solicitações pré-anúncios que resultaram em um erro.

Dimensões: ConfigurationName

PreAdsRequestHook.Latency

O tempo de execução em milissegundos do gancho de solicitação de pré-anúncios.

Dimensões: ConfigurationName

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 falhando:

Métrica Description
Function.Invocations

O número de vezes que uma função individual foi executada.

Dimensões:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Errors

O número de execuções de funções individuais que resultaram em um erro.

Dimensões:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Latency

O tempo de execução em milissegundos para uma função individual.

Dimensões:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Médias simples e ponderadas

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 MediaTailor preenche e disponibiliza:

  • 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íveis é de 64,29%, que é a porcentagem deAvail.Duration: (Avail.FilledDuration135*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 qualquer anúncio disponível é 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

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_OUTPUTHTTP_REQUEST,SEQUENTIAL_EXECUTOR, ouCONCURRENT_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.