Node.js v1 instrumentação personalizada (legado)

O New Relic para Node.js instrumenta automaticamente a maioria das solicitações padrão da web, mas às vezes você deseja instrumentação expandida. Com instrumentação personalizada, você pode instrumentar web sockets, trabalhos em segundo plano e bancos de dados não suportados. A instrumentação personalizada também pode direcionar seções específicas do seu código para uma visão mais profunda.

A instrumentação personalizada está disponível nas versões 1.10.0 ou superior do agente Node.js. Para aproveitar as vantagens do recurso de agente Node.js mais recente, atualize seu agente.

Transação instrumentada da web

Para instrumentos de transação da web, como solicitações de websocket, crie uma transação personalizada. A criação de uma transação personalizada oferece o mesmo tipo de visibilidade dessa transação personalizada que você obteria de uma transação que o agente instrumentou automaticamente.

1. Envolva o manipulador que você deseja instrumento com createWebTransaction().
2. Certifique-se de chamar endTransaction() no final da transação.

var nr = require('newrelic');
var app = require('http').createServer();
var io = require('socket.io')(app);

io.on('connection', function (socket) {
  socket.on('ping', nr.createWebTransaction('/websocket/ping', function (data) {
    socket.emit('pong');
    nr.endTransaction();
  }));
  socket.on('new-message', nr.createWebTransaction('/websocket/new-message', function (data) {
    addMessageToChat(data, function () {
      socket.emit('message-received');
      nr.endTransaction();
    });
  }));
});

Histórico de transação instrumentado

Você também pode usar a transação personalizada para instrumentar tarefas em segundo plano, como trabalhos periódicos em seu aplicativo ou trabalhos que continuam após a conclusão de uma solicitação. Para instrumentar tarefas em segundo plano, envolva o manipulador que você deseja instrumentar com createBackgroundTransaction(). Certifique-se de chamar endTransaction() no final da transação.

var nr = require('newrelic');
var redis = require('redis').createClient();

setInterval(nr.createBackgroundTransaction('update:cache', function () {
  var newValue = someDataGenerator();

  redis.set('some:cache:key', newValue, function () {
    nr.endTransaction(); // End the transaction once redis is done
  });
}), 30000); // Every 30s

Expandindo a instrumentação dentro da transação

Você também pode usar instrumentação personalizada para fornecer mais visibilidade nas transações da web que já estão instrumentadas ou para obter insights sobre o banco de dados e outros trabalhos de transação que não são instrumentados automaticamente. Para fazer isso, envolva seu retorno de chamada no rastreador personalizado. O rastreador personalizado cria e coleta métricas específicas para um segmento adicional dentro de uma transação existente, como uma função específica ou uma chamada de banco de dados.

Para retornos de chamada do instrumento, envolva o retorno da chamada com createTracer(). Se você deseja instrumentar uma função que é chamada dentro de uma função assíncrono, você precisa agrupar a função alvo e sua função assíncrono pai com createTracer().

// Wrap the callback in a segment
db.createObject(nr.createTracer('db:createObject', function (err, result) {
  // Some error handler that will end the response for us
  if (util.handleError(err, res)) {
    return;
  }
  res.write(JSON.stringify(result.rows[0].id));
  res.write('\n');
  res.end();
}));

pg.connect(config.db_string, nr.createTracer('pg:connect', function (err, client, done) {
  if (util.handleError(err, '500', res)) {
    return done();
  }
  client.query('SELECT count(*) FROM test_count', nr.createTracer('pg:query', function (err, result) {
    if (util.handleError(err, '500', res)) {
      return done();
    }

    res.write(result.rows[0].count);
    res.write('\n');
  }));
}));