5 lines
3.7 KiB
JSON
Raw Permalink Normal View History

{
"id": "analytics",
"title": "Usage Metrics Gathering",
"contents": "\n\n\n\n<div class=\"content\">\n <h1 id=\"usage-metrics-gathering\">Usage Metrics Gathering<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#usage-metrics-gathering\"><i class=\"material-icons\">link</i></a></h1>\n<p>You can help the Angular Team to prioritize features and improvements by permitting the Angular\nteam to send command-line command usage statistics to Google. The Angular Team does not collect\nusage statistics unless you explicitly opt in during the Angular CLI installation or upgrade.</p>\n<h2 id=\"what-is-collected\">What is collected?<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#what-is-collected\"><i class=\"material-icons\">link</i></a></h2>\n<p>Usage analytics include the commands and selected flags for each execution. Usage analytics may\ninclude the following information:</p>\n<ul>\n<li>Your operating system (Mac, Linux distribution, Windows) and its version.</li>\n<li>Number of CPUs, amount of RAM.</li>\n<li>Node and Angular CLI version (local version only).</li>\n<li>How long each command took to initialize and execute.</li>\n<li>Command name that was run.</li>\n<li>For Schematics commands (add, generate, new and update), a list of selected flags.</li>\n<li>For build commands (build, serve), the number and size of bundles (initial and lazy),\ncompilation units, the time it took to build and rebuild, and basic Angular-specific\nAPI usage.</li>\n<li>Error code of exceptions and crash data. No stack trace is collected.</li>\n</ul>\n<p>Only Angular owned and developed schematics and builders are reported. Third-party schematics and\nbuilders do not send data to the Angular Team.</p>\n<h2 id=\"opting-in\">Opting in<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#opting-in\"><i class=\"material-icons\">link</i></a></h2>\n<p>When installing the Angular CLI or upgrading an existing version, you are prompted to allow global\ncollection of usage statistics. If you say no or skip the prompt, no data is collected.</p>\n<p>Starting with version 8, we added the <code>analytics</code> command to the CLI. You can change your opt-in\ndecision at any time using this command.</p>\n<h3 id=\"disabling-usage-analytics\">Disabling usage analytics<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#disabling-usage-analytics\"><i class=\"material-icons\">link</i></a></h3>\n<p>To disable analytics gathering, run the following command:</p>\n<code-example language=\"bash\">\n# Disable all usage analytics.\nng analytics off\n</code-example>\n<h3 id=\"enabling-usage-analytics\">Enabling usage analytics<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#enabling-usage-analytics\"><i class=\"material-icons\">link</i></a></h3>\n<p>To enable usage analytics, run the following command:</p>\n<code-example language=\"bash\">\n# Enable all usage analytics.\nng analytics on\n</code-example>\n<h3 id=\"prompting\">Prompting<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"analytics#prompting\"><i class=\"material-icons\">link</i></a></h3>\n<p>To prompt the user again about usage analytics, run the following command:</p>\n<code-example language=\"bash\">\n# Prompt for all usage analytics.\nng analytics prompt\n</code-example>\n\n \n</div>\n\n<!-- links to this doc:\n - cli/usage-analytics-gathering\n-->\n<!-- links from this doc:\n - analytics#disabling-usage-analytics\n - analytics#enabling-usage-analytics\n - analytics#opting-in\n - analytics#prompting\n - analytics#usage-metrics-gathering\n - analytics#what-is-collected\n-->"
}