Importante
Habilite a integração do AWS CloudWatch Metric Streams para monitor todas as métricas do CloudWatch de seus serviços da AWS, incluindo namespace personalizado. A integração individual não é mais nossa opção recomendada.
A integração New Relic Infrastructure inclui uma integração para relatar seus dados do Amazon API Gateway para New Relic. Este documento explica como ativar esta integração e descreve os dados que podem ser reportados.
Dica
As métricas API Gateway v1 estão disponíveis exclusivamente por meio da integração de pesquisa API para Amazon API Gateway. As métricasAPI Gateway v2 são transmitidas por meio CloudWatch Metric Streams.
Recurso
O API Gateway da Amazon é um serviço totalmente gerenciado que permite criar, publicar, manter, monitor e proteger API em qualquer escala. Com a integração do New Relic API Gateway, você obtém mais dados sobre como sua camada de API está funcionando nos bastidores. Você receberá dados métricos sobre o número de chamadas de API, as solicitações atendidas, o número de erros, contagens de latência e muito mais.
Você pode monitor e alertar sobre os dados do seu API Gateway diretamente do New Relic, consultar dados e criar um painel.
Requisitos
API Gateway não enviará métricas de "Contagem de chamadas por recurso", "Erro 4xx por recurso" e "Erros 5xx por recurso", a menos que você tenha habilitado explicitamente as métricas detalhadas do CloudWatch.
Dica
A ativação dessas métricas pode adicionar cobranças adicionais à definição de preço da sua conta do Amazon CloudWatch.
Para habilitar métricas do CloudWatch, use uma destas opções:
Acesse o AWS Management Console, selecione a opção
Settings
para CloudWatch e, em seguida, selecione a opção para ativar detalhes detalhados do CloudWatch.
Chame a ação
stage:updateda API REST do Amazon API Gateway para atualizar a propriedademetricsEnabledparatrue.
Ativar integração
Para habilitar essa integração, siga os procedimentos padrão para conectar os serviços da AWS ao New Relic.
Configuração e polling
Você pode alterar a frequência de pesquisa e filtrar dados usando opções de configuração.
Informações de pesquisa padrão para a integração do gateway API da Amazon:
- Intervalo de sondagem New Relic : 5 minutos
- Intervalo de dados do Amazon CloudWatch: 1 minuto
Encontre e use dados
Para encontrar seus dados de integração na interface de infraestrutura, acesse one.newrelic.com > All capabilities > Infrastructure > AWS e selecione um dos links de integração API Gateway.
Você pode consultar e explorar seus dados usando o tipo de evento ApiGatewaySample .
Para saber mais sobre como usar seus dados, consulte Compreender e usar dados de integração.
Dados métricos
Esta integração New Relic Infrastructure coleta os seguintes dados do Amazon API Gateway:
Métrica | Descrição |
|---|---|
| O número de erros do lado do cliente capturados |
| O número de erros do lado do servidor capturados. |
| O número de solicitações atendidas pelo cache da API. |
| O número de solicitações atendidas no backend quando o cache API está ativado. |
| O número de chamadas para métodos de API. |
| O tempo em milissegundos entre o momento em que API Gateway retransmite uma solicitação ao backend e o momento em que recebe uma resposta do backend. |
| O tempo em milissegundos entre o momento em que o API Gateway recebe uma solicitação de um cliente e o momento em que retorna uma resposta ao cliente. A latência inclui a latência de integração e outras sobrecargas do API Gateway. |
Dimensões
Você pode usar as dimensões na tabela a seguir para filtrar métricas API Gateway.
Dimensões | Descrição |
|---|---|
| Filtra a métrica API Gateway para uma API com o nome API especificado. |
| Filtra a métrica API Gateway para um método de API da API, estágio, recurso e método especificados. |
| Filtra a métrica API Gateway para um estágio API da API e do estágio especificados. |