Introdução à criação de dados métricos a partir de dados não métricos
Você pode gerar dados do tipo métrica a partir de outros tipos de dados no New Relic, incluindo evento, log e spans. métricas são agregados de seus dados e são ideais para analisar e monitorar tendências em longos períodos de tempo.
Por que criar métricas a partir de outros tipos de dados?
O uso da métrica permite um armazenamento de dados mais eficiente. Isso, por sua vez, permite consultar seus dados e construir gráficos com mais facilidade. A diferença entre métricas e outros tipos de dados no New Relic é baseada no tempo. Para obter mais informações, consulte Compreender os tipos de dados.
Events, logs, spans: Esses tipos de dados representam um único registro em um momento específico. Por exemplo, você pode ter um evento para cada solicitação ao sistema. Esses dados são ideais para resolução de problemas e análises aprofundadas.
Metrics: Eles fornecem uma visão agregada do seu evento, log ou períodos. métricas são melhores para mostrar tendências em intervalos de tempo mais longos. Por exemplo, você pode agregar o número total de solicitações por serviço a uma métrica e depois examinar essas informações mês após mês.
Por que usar métrica?
Comentários
Flexibilidade
Métricas são dimensionais. Você pode escolher quais metadados (como nome do host ou nome do aplicativo) serão anexados a eles.
Medidas métricas comuns, como média, soma, mínimo e máximo, já foram calculadas.
Agregação e retenção de dados
Os dados já foram pré-agregados em períodos de tempo mais longos.
Ao criar uma métrica, isso não exclui seu evento ou outros tipos de dados. No entanto, as métricas são melhores para consultas e gráficos de longo alcance.
Aqui está um vídeo mostrando como gerar dados métricos a partir de dados de eventos (7:47 minutos):
Para começar a converter seus dados em métricas, crie uma regra.
Operações disponíveis
Para mostrar, criar e excluir regras para geração de métricas de evento, log ou spans, use NerdGraph, nossa API no formato GraphQL. Antes de realizar qualquer operação, recomendamos a leitura da Introdução ao NerdGraph e explorar seus dados com a ferramenta GraphiQL API.
Aqui você define os dados retornados por sucesso ou falha. Parâmetro disponível para estes blocos:
id (ou ruleId para submitted)
name
description
nrql
enabled
accountId
Example response for the request:
{
"data":{
"eventsToMetricsDeleteRule":{
"failures":[],
"successes":[
{
"id":"12",
"name":"Test Rule",
"nrql":"select summary(duration) as 'server.responseTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
}
]
}
}
}
Importante
Esta operação modifica as configurações de produção, por isso recomendamos revisar minuciosamente suas alterações antes de executar a operação.
Para ativar ou desativar uma regra existente para evento para métrica, log para métrica ou spans para métrica, use a mesma operação eventsToMetricsUpdateRule . A única diferença é se enabled está definido como true ou false.
Example request to enable an existing metrics rule:
Defina o escopo dos dados apenas para regras evento-to-métrica, log-to-métrica ou spans-to-métrica.
allRules
Retorna todas as regras dessa conta.
rules
No bloco rules , você pode definir quais dados deseja retornar. Os campos disponíveis incluem:
id
name
description
nrql
accountId
enabled
Example response:
{
"data":{
"actor":{
"account":{
"eventsToMetrics":{
"allRules":{
"rules":[
{
"description":"Metric for total time",
"enabled":true,
"id":"1",
"name":"Total Time Tx",
"nrql":"select summary(totalTime) as 'server.totalTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
},
{
"description":"Metric for duration",
"enabled":true,
"id":"2",
"name":"Duration Rule",
"nrql":"select summary(duration) as 'server.responseTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
}
]
}
}
}
}
}
}
Se você souber o ID exato de uma regra, poderá consultar uma regra específica. Por exemplo, você pode ter acabado de criar uma regra e agora deseja listar seu conteúdo para poder revisá-la.
Example listing rule 36 for New Relic account 123456:
query{
actor{
account(id:123456){
eventsToMetrics{
rulesById(ruleIds:"36"){
rules{
id
name
enabled
nrql
description
accountId
}
}
}
}
}
}
Para obter mais detalhes sobre os elementos desta consulta, consulte Listar todas as regras.
Example response:
{
"data":{
"actor":{
"account":{
"eventsToMetrics":{
"rulesById":{
"rules":[
{
"accountId":123456,
"description":"Metric for total time",
"enabled":true,
"id":"36",
"name":"Total Time Tx",
"nrql":"select summary(totalTime) as 'server.totalTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
}
]
}
}
}
}
}
}
Use a ferramenta exploradora da API NerdGraph
Você pode usar o NerdGraph API Explorer, nossa ferramenta GraphiQL, para explorar a estrutura de dados. Você também pode usá-lo para construir e executar operações para converter evento, log e spans em métricas. Para usar esta ferramenta:
Crie a solicitação da operação métrica com o parâmetro requerido.
Vá para one.newrelic.com > All capabilities > Apps > NerdGraph API explorer e cole sua consulta na caixa.
Para executar a operação, clique no botão vermelho Execute query . Ou, para obter o formato curl, selecione Tools > Copy as CURL.