Node.js trace_events.createTracing() Método

El método trace_events.createTracing(options) ( agregado en v10.0.0 ) es una interfaz de programación de aplicaciones incorporada del módulo ‘trace_events’ que crea el objeto de seguimiento y devuelve lo mismo para el conjunto de categorías determinado. El módulo trace_events contiene objetos de seguimiento que se utilizan para habilitar o deshabilitar el seguimiento de conjuntos de categorías. 

Sintaxis:

trace_events.createTracing(options)

Para usar este método ( trace_events.createTracing() ), necesitamos importar el módulo ‘trace_events’.

const trace_events = require('trace_events');  

Parámetros: esta función acepta objetos como parámetros, como se mencionó anteriormente y se describe a continuación:

• opciones < Objeto > : acepta un objeto que contiene algunos valores de string categorizados que son necesarios durante el seguimiento.

• categorías < string[] > Acepta una array de strings que contiene nombres de categorías de seguimiento. Si es posible, los valores se incluyen en la array y se persuaden a una string. Si no se puede persuadir el valor, se devolverá un error.

Valor de retorno < Rastreo > :  Devuelve un objeto que contiene categorías < string [] > y valores < booleanos > habilitados .

Los siguientes programas ilustran el método trace_events.createTracing() en Node.js:

Ejemplo 1: Nombre de archivo: index.js

// Node.js program to demonstrate the 
// trace_events.createTracing() methods 
  
// Using require to access trace_events module 
const tracing_events = require("trace_events");
  
// Different types of tracing categories
const categories = [ 'myapp.category', 
    'v8', 'node', 'node.async_hooks', 
    'node.promises.rejections', 
    'node.vm.script', 'node.perf.usertiming', 
    'node.perf.timerify'
];
  
// Now creating tracing for custom
// trace category.
const newTracing = tracing_events.createTracing(
    { categories });
  
// Printing tracing event
console.log(newTracing);

Producción:

>> Rastreo {
 habilitado: falso,
 categorías: ‘myapp.category, v8, node, node.async_hooks,
node.promises.rejections, node.vm.script, node.perf.usertiming, node.perf.timerify’
}

Ejemplo 2: Nombre de archivo: index.js

// Node.js program to demonstrate the 
// trace_events.createTracing() methods 
  
// Using require to access trace_events module 
const { createTracing } = require('trace_events');
  
// Now create tracing for custom trace category.
const tracing = createTracing({ categories: ['perf_hooks', 
'node.promises.rejections'] });
console.log("Tracing Created...");
  
// Printing tracing event
console.log(tracing);
  
// Enabling Tracing event
tracing.enable();
  
// Do some steff here
const perf_hooks = require("perf_hooks");
perf_hooks.performance.mark("A");
() => {
  perf_hooks.performance.mark("B");
  perf_hooks.performance.measure("A to B", "C", "D");
};
  
// Disabling tracing event
tracing.disable();

Ejecute el archivo index.js con el siguiente comando:

node index.js

Producción:

Rastreo creado…

Rastreo { habilitado: falso, categorías: ‘perf_hooks, node.promises.rejections’ }

Referencia: https://nodejs.org/api/tracing.html#tracing_trace_events_createtracing_options