A API métrica da New Relic pode ser usada para enviar dados métricos para a New Relic a partir de diversas fontes. Esta API é a forma como métricas de alguns de nossos integradores e exportadores entram na New Relic.
Quer experimentar nossa API métrica? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.
O que é a API métrica?
A API métrica é uma forma de inserir dados métricos no New Relic. A API funciona enviando uma solicitação POST para nosso endpoint HTTP com uma carga JSON contendo os dados métricos.
A API métrica é como as métricas são ingeridas de algumas de nossas integrações, incluindo nossos exportadores de código aberto (como DropWizard e Prometheus). A API métrica também é usada por nossos SDKs de telemetria, que são ferramentas específicas de linguagem que facilitam o uso de nossas APIs de ingestão de dados.
A API métrica pode ser usada para:
- Relate dados métricos para a New Relic sem um agente da New Relic.
- Integre dados métricos de uma ferramenta, biblioteca ou framework de código aberto ou desenvolvida internamente.
- Controle totalmente os dados métricos que você está enviando, incluindo a resolução e dimensões associadas.
- Aproveite o poder do NRQL, a linguagem de consulta da New Relic, para consultar seus dados métricos.
- Configure alerta para seus dados métricos.
Requisitos
Certifique-se de que a conectividade de saída na porta TCP 443 seja permitida para o intervalo CIDR que corresponde à sua região. O método de configuração preferencial é usar o nome DNS metric-api.newrelic.com ou metric-api.eu.newrelic.com.
Você precisará de um New Relic para a conta New Relic para a qual deseja enviar dados. Para informações sobre limites e atributo restrito, consulte requisitos e limites da API métrica.
Iniciar
Se não tivermos uma integração ou início rápido que atenda às suas necessidades de relatórios métricos, você terá duas opções:
- Use nossos SDKs de telemetria, que são ferramentas específicas de linguagem que ajudam você a nos enviar métricas e outros dados.
- Use a API métrica diretamente.
Encontre e use seus dados
Você pode encontrar dados enviados via API métrica (inclusive de integração que utilizam esta API) nestes locais:
Em one.newrelic.com, selecione Explorer e procure seu serviço.
Consultando o tipo de dados
Metric. Por exemplo, você pode usar NRQL para executar:SELECT * FROM MetricPara saber mais sobre consulta, veja exemplos de consulta métrica. Para informações sobre consultas em geral, veja consulta de dados.
Alerta sobre dados métricos
Para alertar sobre métrica criada com a API métrica, use NRQL condição do alerta: selecione a categoria NRQL ao definir sua condição e use a sintaxe de consulta FROM Metric ... NRQL para expressá-la. Ao criar essas condições de alerta, usa automaticamente os dados de granularidade mais finos disponíveis (os pontos de dados de métrica bruta) para avaliar alertas.
Retenção de dados
Todos os pontos de dados métricos brutos serão retidos por 30 dias. Todos os dados agregados adicionais derivados dos pontos de dados métricos brutos (por exemplo, rollups de um minuto) serão retidos por 13 meses. Qualquer alteração no período de retenção além desses períodos poderá resultar em cobrança para você.
Resolução de problemas
Consulte Solução de problemas de um evento NrIntegrationError .