Lines Matching +full:- +full:- +full:disable +full:- +full:docs
4 <meta charset="utf-8">
5 <meta name="viewport" content="width=device-width">
6 <meta name="nodejs.org:node-version" content="v14.21.2">
13 <body class="alt apidoc" id="api-section-tracing">
22 <li><a href="documentation.html" class="nav-documentation">About this documentation</a></li>
23 <li><a href="synopsis.html" class="nav-synopsis">Usage and example</a></li>
27 <li><a href="assert.html" class="nav-assert">Assertion testing</a></li>
28 <li><a href="async_hooks.html" class="nav-async_hooks">Async hooks</a></li>
29 <li><a href="buffer.html" class="nav-buffer">Buffer</a></li>
30 <li><a href="addons.html" class="nav-addons">C++ addons</a></li>
31 <li><a href="n-api.html" class="nav-n-api">C/C++ addons with Node-API</a></li>
32 <li><a href="embedding.html" class="nav-embedding">C++ embedder API</a></li>
33 <li><a href="child_process.html" class="nav-child_process">Child processes</a></li>
34 <li><a href="cluster.html" class="nav-cluster">Cluster</a></li>
35 <li><a href="cli.html" class="nav-cli">Command-line options</a></li>
36 <li><a href="console.html" class="nav-console">Console</a></li>
37 <li><a href="corepack.html" class="nav-corepack">Corepack</a></li>
38 <li><a href="crypto.html" class="nav-crypto">Crypto</a></li>
39 <li><a href="debugger.html" class="nav-debugger">Debugger</a></li>
40 <li><a href="deprecations.html" class="nav-deprecations">Deprecated APIs</a></li>
41 <li><a href="diagnostics_channel.html" class="nav-diagnostics_channel">Diagnostics Channel</a></li>
42 <li><a href="dns.html" class="nav-dns">DNS</a></li>
43 <li><a href="domain.html" class="nav-domain">Domain</a></li>
44 <li><a href="errors.html" class="nav-errors">Errors</a></li>
45 <li><a href="events.html" class="nav-events">Events</a></li>
46 <li><a href="fs.html" class="nav-fs">File system</a></li>
47 <li><a href="globals.html" class="nav-globals">Globals</a></li>
48 <li><a href="http.html" class="nav-http">HTTP</a></li>
49 <li><a href="http2.html" class="nav-http2">HTTP/2</a></li>
50 <li><a href="https.html" class="nav-https">HTTPS</a></li>
51 <li><a href="inspector.html" class="nav-inspector">Inspector</a></li>
52 <li><a href="intl.html" class="nav-intl">Internationalization</a></li>
53 <li><a href="modules.html" class="nav-modules">Modules: CommonJS modules</a></li>
54 <li><a href="esm.html" class="nav-esm">Modules: ECMAScript modules</a></li>
55 <li><a href="module.html" class="nav-module">Modules: <code>module</code> API</a></li>
56 <li><a href="packages.html" class="nav-packages">Modules: Packages</a></li>
57 <li><a href="net.html" class="nav-net">Net</a></li>
58 <li><a href="os.html" class="nav-os">OS</a></li>
59 <li><a href="path.html" class="nav-path">Path</a></li>
60 <li><a href="perf_hooks.html" class="nav-perf_hooks">Performance hooks</a></li>
61 <li><a href="policy.html" class="nav-policy">Policies</a></li>
62 <li><a href="process.html" class="nav-process">Process</a></li>
63 <li><a href="punycode.html" class="nav-punycode">Punycode</a></li>
64 <li><a href="querystring.html" class="nav-querystring">Query strings</a></li>
65 <li><a href="readline.html" class="nav-readline">Readline</a></li>
66 <li><a href="repl.html" class="nav-repl">REPL</a></li>
67 <li><a href="report.html" class="nav-report">Report</a></li>
68 <li><a href="stream.html" class="nav-stream">Stream</a></li>
69 <li><a href="string_decoder.html" class="nav-string_decoder">String decoder</a></li>
70 <li><a href="timers.html" class="nav-timers">Timers</a></li>
71 <li><a href="tls.html" class="nav-tls">TLS/SSL</a></li>
72 <li><a href="tracing.html" class="nav-tracing active">Trace events</a></li>
73 <li><a href="tty.html" class="nav-tty">TTY</a></li>
74 <li><a href="dgram.html" class="nav-dgram">UDP/datagram</a></li>
75 <li><a href="url.html" class="nav-url">URL</a></li>
76 <li><a href="util.html" class="nav-util">Utilities</a></li>
77 <li><a href="v8.html" class="nav-v8">V8</a></li>
78 <li><a href="vm.html" class="nav-vm">VM</a></li>
79 <li><a href="wasi.html" class="nav-wasi">WASI</a></li>
80 <li><a href="worker_threads.html" class="nav-worker_threads">Worker threads</a></li>
81 <li><a href="zlib.html" class="nav-zlib">Zlib</a></li>
85 <li><a href="https://github.com/nodejs/node" class="nav-https-github-com-nodejs-node">Code reposito…
89 <div id="column1" data-id="tracing" class="interior">
91 <div class="header-container">
93 …<button class="theme-toggle-btn" id="theme-toggle-btn" title="Toggle dark mode/light mode" aria-la…
94 <svg xmlns="http://www.w3.org/2000/svg" class="icon dark-icon" height="24" width="24">
96 …-2.33-4.51-.5-8.48.53-10.07C6.27 2.2 1.98 6.59 1.98 12c0 .14.02.28.02.42.62-.27 1.29-.42 2-.42 1.6…
97 …<path d="M7 16h-.18C6.4 14.84 5.3 14 4 14c-1.66 0-3 1.34-3 3s1.34 3 3 3h3c1.1 0 2-.9 2-2s-.9-2-2-2…
99 <svg xmlns="http://www.w3.org/2000/svg" class="icon light-icon" height="24" width="24">
101 …-1.8-1.79-1.41 1.41 1.79 1.79 1.42-1.41zM4 10.5H1v2h3v-2zm9-9.95h-2V3.5h2V.55zm7.45 3.91l-1.41-1.4…
117 <li class="version-picker">
119 …<ol class="version-picker"><li><a href="https://nodejs.org/docs/latest-v19.x/api/tracing.html">19.…
120 <li><a href="https://nodejs.org/docs/latest-v18.x/api/tracing.html">18.x <b>LTS</b></a></li>
121 <li><a href="https://nodejs.org/docs/latest-v17.x/api/tracing.html">17.x</a></li>
122 <li><a href="https://nodejs.org/docs/latest-v16.x/api/tracing.html">16.x <b>LTS</b></a></li>
123 <li><a href="https://nodejs.org/docs/latest-v15.x/api/tracing.html">15.x</a></li>
124 <li><a href="https://nodejs.org/docs/latest-v14.x/api/tracing.html">14.x <b>LTS</b></a></li>
125 <li><a href="https://nodejs.org/docs/latest-v13.x/api/tracing.html">13.x</a></li>
126 <li><a href="https://nodejs.org/docs/latest-v12.x/api/tracing.html">12.x</a></li>
127 <li><a href="https://nodejs.org/docs/latest-v11.x/api/tracing.html">11.x</a></li>
128 <li><a href="https://nodejs.org/docs/latest-v10.x/api/tracing.html">10.x</a></li>
129 <li><a href="https://nodejs.org/docs/latest-v9.x/api/tracing.html">9.x</a></li>
130 <li><a href="https://nodejs.org/docs/latest-v8.x/api/tracing.html">8.x</a></li>
131 <li><a href="https://nodejs.org/docs/latest-v7.x/api/tracing.html">7.x</a></li></ol>
148 <li><a href="#tracing_tracing_disable"><code>tracing.disable()</code></a></li>
164 …<a href="documentation.html#documentation_stability_index">Stability: 1</a> - Experimental</div><p…
168 <p>Tracing can be enabled with the <code>--trace-event-categories</code> command-line flag
169 or by using the <code>trace_events</code> module. The <code>--trace-event-categories</code> flag
170 accepts a list of comma-separated category names.</p>
192 of unhandled Promise rejections and handled-after-rejections.</li>
198 <pre><code class="language-bash">node --trace-event-categories v8,node,node.async_hooks server.js</…
199 <p>Prior versions of Node.js required the use of the <code>--trace-events-enabled</code>
201 <code>--trace-events-enabled</code> flag <em>may</em> still be used and will enable the
203 <pre><code class="language-bash">node --trace-events-enabled
205 <span class="hljs-comment"># is equivalent to</span>
207 node --trace-event-categories v8,node,node.async_hooks</code></pre>
209 … class="language-js"><span class="hljs-keyword">const</span> trace_events = <span class="hljs-buil…
210 …-keyword">const</span> tracing = trace_events.<span class="hljs-title function_">createTracing</sp…
211 tracing.<span class="hljs-title function_">enable</span>(); <span class="hljs-comment">// Enable t…
213 <span class="hljs-comment">// do work</span>
215 tracing.<span class="hljs-title function_">disable</span>(); <span class="hljs-comment">// Disable…
217 in the <a href="https://www.chromium.org/developers/how-tos/trace-event-profiling-tool"><code>chrom…
220 <code>${rotation}</code> is an incrementing log-rotation id. The filepath pattern can
221 be specified with <code>--trace-event-file-pattern</code> that accepts a template
223 <pre><code class="language-bash">node --trace-event-categories v8 --trace-event-file-pattern <span …
226 However the trace-event timestamps are expressed in microseconds,
237 <p>The <code>Tracing</code> object is used to enable or disable tracing for sets of
242 categories. Calling <code>tracing.disable()</code> will remove the categories from the
249 <li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" c…
251 <p>A comma-separated list of the trace event categories covered by this
253 <h5><code>tracing.disable()</code><span><a class="mark" href="#tracing_tracing_disable" id="tracing…
259 and <em>not</em> specified by the <code>--trace-event-categories</code> flag will be disabled.</p>
260 … class="language-js"><span class="hljs-keyword">const</span> trace_events = <span class="hljs-buil…
261 …-keyword">const</span> t1 = trace_events.<span class="hljs-title function_">createTracing</span>({…
262 …-keyword">const</span> t2 = trace_events.<span class="hljs-title function_">createTracing</span>({…
263 t1.<span class="hljs-title function_">enable</span>();
264 t2.<span class="hljs-title function_">enable</span>();
266 <span class="hljs-comment">// Prints 'node,node.perf,v8'</span>
267 <span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(…
269 t2.<span class="hljs-title function_">disable</span>(); <span class="hljs-comment">// Will only dis…
271 <span class="hljs-comment">// Prints 'node,v8'</span>
272 <span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(…
284 <li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" …
291 <li><code>options</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference…
293 <li><code>categories</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_s…
301 … class="language-js"><span class="hljs-keyword">const</span> trace_events = <span class="hljs-buil…
302 <span class="hljs-keyword">const</span> categories = [<span class="hljs-string">'node.perf'</span>,…
303 <span class="hljs-keyword">const</span> tracing = trace_events.<span class="hljs-title function_">c…
304 tracing.<span class="hljs-title function_">enable</span>();
305 <span class="hljs-comment">// do stuff</span>
306 tracing.<span class="hljs-title function_">disable</span>();</code></pre>
312 <li>Returns: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Strin…
314 <p>Returns a comma-separated list of all currently-enabled trace event
316 by the <em>union</em> of all currently-enabled <code>Tracing</code> objects and any categories
317 enabled using the <code>--trace-event-categories</code> flag.</p>
319 <code>node --trace-event-categories node.perf test.js</code> will print
321 … class="language-js"><span class="hljs-keyword">const</span> trace_events = <span class="hljs-buil…
322 …-keyword">const</span> t1 = trace_events.<span class="hljs-title function_">createTracing</span>({…
323 …-keyword">const</span> t2 = trace_events.<span class="hljs-title function_">createTracing</span>({…
324 …-keyword">const</span> t3 = trace_events.<span class="hljs-title function_">createTracing</span>({…
326 t1.<span class="hljs-title function_">enable</span>();
327 t2.<span class="hljs-title function_">enable</span>();
329 <span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(…
330 <!-- API END -->
339 const themeToggleButton = document.getElementById('theme-toggle-btn');
341 const mq = window.matchMedia('(prefers-color-scheme: dark)');
344 document.body.classList.toggle('dark-mode', e.matches);
354 document.body.classList.add('dark-mode');
357 document.body.classList.add('dark-mode');
364 document.body.classList.toggle('dark-mode')