Monitoramento AWS CloudFront

Editar online

O sensor do AWS CloudFront é automaticamente implementado e instalado após a instalação do agente do Instana. Este sensor monitora as distribuições d AWS CloudFront e e suas funções associadas.

Para conhecer outros serviços do AWS compatíveis, consulte o tópico AWS.

Pré-requisitos

Editar online

Para habilitar o monitoramento do AWS CloudFront, implante o agente na região us-east-1.
Para monitorar as métricas Cache hit rate e Origin latency , ative as métricas de distribuição adicionais do CloudFront no console do AWS . Para obter instruções sobre como ativar métricas adicionais, consulte a documentação do AWS.

Visualizando detalhes e métricas de uma distribuição do CloudFront

Editar online

Instana reúne detalhes e métricas de uma distribuição do CloudFront.

CloudFront detalhes da distribuição

Editar online

Os seguintes detalhes do CloudFront são coletados pelo sensor AWS CloudFront :


CloudFront Detalhes de distribuição	Descrição
ARN	O Amazon Resource Name (ARN) da distribuição CloudFront .
Nome	O nome de domínio CloudFront da distribuição.
Região	O local (região) da distribuição
ID de distribuição	O identificador exclusivo da distribuição.
Status	O status de implementação da distribuição
Horário da última modificação	A data e a hora em que a distribuição foi modificada pela última vez

Métrica

Editar online

Instana reúne métricas sobre a distribuição ` CloudFront ` e as funções associadas.

Distribuição

Editar online


Nome	Descrição
Solicitações	O número total de solicitações de visualização recebidas pelo CloudFront, para todos os métodos HTTP e para as solicitações tanto do HTTP quanto do HTTPS.
Bytes transferidos por upload	O número total de bytes que os espectadores enviaram para sua origem com o CloudFront,, utilizando solicitações POST e PUT.
Bytes transferidos por download	O número total de bytes transferidos por download pelos visualizadores para solicitações GET, HEAD e OPTIONS..
4xx Taxa de Erro	A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 4xx..
5xx Taxa de Erro	A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 5xx..
Taxa Total de Erro	A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 4xx ou 5xx..
Taxa de acertos do cache	A porcentagem de todas as solicitações que podem ser armazenadas em cache para as quais o CloudFront atendeu o conteúdo de seu cache. HTTP POST e as solicitações PUT, bem como os erros, não são armazenados em cache.
Latência de origem	O tempo total gasto em milissegundos pelo CloudFront para enviar uma resposta para a rede para uma solicitação. Esse valor de latência é apenas para solicitações que são atendidas a partir da origem; ou seja, não do cache do CloudFront .

Funções associadas

Editar online


Nome	Descrição
Chamadas	O número de vezes que a função foi iniciada (chamada) em determinado período de tempo.
Calcular utilização	A quantidade de tempo (0-100, como uma porcentagem do tempo máximo permitido) que a função levou para ser executada.
Reguladores	O número de vezes que a função foi regulada em um determinado período.
Erros de validação	O número de erros de validação produzidos pela função em um determinado período. Erros de validação ocorrem quando a função é executada com sucesso, mas retorna dados inválidos (um objeto de evento inválido).
Erros de execução	O número de erros de execução que ocorreram em um determinado período. Erros de execução ocorrem quando a função falha ao ser concluída com sucesso.

Permissões requeridas

Editar online

As seguintes permissões são necessárias:

cloudfront:GetDistribution
cloudfront:ListDistributions
cloudfront:ListTagsForResource

Configurando o sensor do AWS CloudFront

Editar online

Para alterar a configuração do sensor AWS CloudFront, edite as com.instana.plugin.aws.cloudfront propriedades da configuração do agente no <agent_install_dir>/etc/instana/configuration.yml arquivo.

O sensor AWS CloudFront obtém métricas do CloudFront a cada 5 minutos. Para alterar essa frequência, use a propriedade cloudwatch_period :

com.instana.plugin.aws.cloudfront:
  cloudwatch_period: 60

Observação: A ativação do monitoramento de funções acarreta custos financeiros adicionais devido ao aumento das métricas coletadas pelo CloudWatch.

Para ativar o monitoramento de funções CloudFront , configure a propriedade enable_function_monitoring: true :

com.instana.plugin.aws.cloudfront:
   enable_function_monitoring: true

Para desativar o monitoramento de distribuições CloudFront , configure a propriedade enabled: false :

com.instana.plugin.aws.cloudfront:
  enabled: false

Configurando o sensor do AWS CloudFront para usar um proxy

Editar online

Para fazer com que o sensor AWS CloudFront utilize um proxy, adicione as seguintes propriedades à configuração do agente no <agent_install_dir>/etc/instana/configuration.yml arquivo:

com.instana.plugin.aws.cloudfront:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Monitorando diversas contas da AWS

Editar online

Para configurar o monitoramento de múltiplas contas AWS com um agente AWS na mesma região, consulte o tópico Monitorando múltiplas contas AWS .

Substituir os perfis do AWS usados para monitorar o CloudFront

Editar online

Para definir quais perfis do AWS serão usados para monitorar o CloudFront,, utilize a seguinte configuração:

com.instana.plugin.aws.cloudfront:
  profile_names:
    - 'profile2'
    - 'profile3'

Observação: Se você definir perfis no nível do serviço, a configuração global de perfis do ` AWS ` será substituída.

Substituir as funções do IAM usadas para monitorar o CloudFront

Editar online

Para definir quais funções do IAM serão usadas para monitorar o CloudFront,, utilize a seguinte configuração:

com.instana.plugin.aws.cloudfront:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

Observação: Se você definir funções do IAM no nível do serviço, a configuração global de funções do IAM em AWS será substituída.

Filtragem

Editar online

É possível definir tags que devem ser usadas para incluir serviços na descoberta ou excluir serviços da descoberta. Se você não precisar filtrar serviços, não precisará definir as tags.

É possível definir várias tags, que são separadas por uma vírgula.. Defina cada tag como um par chave-valor. Para facilitar a configuração, é possível definir quais tags você deseja incluir na descoberta ou excluir da descoberta. Se você definir a mesma tag nas duas listas (include e exclude), a lista exclude terá prioridade mais alta. Não é obrigatório definir todos os valores para ativar a filtragem

Observação: as tags estão disponíveis apenas com o Agente do AWS.

É possível especificar a frequência com que os sensores pesquisam os recursos identificados pelo AWS usando a propriedade de configuração tagged-services-poll-rate Por padrão, o valor é 300 segundos.

Para definir com que frequência os sensores pesquisam os recursos identificados, use a configuração a seguir:

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

Para incluir serviços por tags na descoberta, use a configuração a seguir:

com.instana.plugin.aws.cloudfront:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Para excluir serviços por tags da descoberta, use a configuração a seguir:

com.instana.plugin.aws.cloudfront:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Os serviços AWS sem tags são monitorados por padrão, mas podem ser excluídos configurando o campo include_untagged como false:

com.instana.plugin.aws.cloudfront:
  include_untagged: false # True value by default