369 lines
16 KiB
HTML

<!DOCTYPE html>
<html lang="en-us">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
<meta name="theme-color" content="#FF8E03">
<meta property="og:title" content="Telemetry (And Why That&#39;s A Good Thing) &middot; Citra" />
<meta property="og:site_name" content="Citra" />
<meta property="og:url" content="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/" />
<meta property="og:description" content="Citra has some issues, and by its nature as an open source project, they are visible to everyone and fixable by anyone. Unfortunately though, most contributions are made by a small minority of developers. These developers have found it difficult to prioritize their efforts, since the majority of issue reports are written scattered across Discord, Reddit, forums, IRC, and too many other places to count.
Because of this, the Citra team has put together a framework to report data about how Citra is used to our server, and use that data to discover what are the most popular games and hardware configurations, where emulated games crash in Citra most often, and more." />
<meta name="description" content="Citra has some issues, and by its nature as an open source project, they are visible to everyone and fixable by anyone. Unfortunately though, most contributions are made by a small minority of developers. These developers have found it difficult to prioritize their efforts, since the majority of issue reports are written scattered across Discord, Reddit, forums, IRC, and too many other places to count.
Because of this, the Citra team has put together a framework to report data about how Citra is used to our server, and use that data to discover what are the most popular games and hardware configurations, where emulated games crash in Citra most often, and more." />
<meta property="og:type" content="article" />
<meta property="og:image" content="https://citra-emu.org/images/banners/index.png" />
<meta property="og:article:published_time" content="2017-08-26T21:04:00-04:00" />
<meta property="og:article:tag" content="feature-update" />
<link rel="icon" href="https://citra-emu.org/favicon.ico" />
<link rel="shortcut icon" href="https://citra-emu.org/favicon.ico" type="image/x-icon" />
<link rel="canonical" href="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/">
<title>Telemetry (And Why That&#39;s A Good Thing) - Citra</title>
<link href="https://fonts.googleapis.com/css?family=Ubuntu|Dosis" rel="stylesheet">
<link rel="stylesheet" href="https://citra-emu.org/scss/style.min.css" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min.js"
integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script>
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-73966905-1', 'auto');
ga('send', 'pageview');
</script>
</head>
<body>
<nav class="navbar navbar-default navbar-wrapper navbar-fixed-top">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar"
aria-expanded="false" aria-controls="navbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="/">&nbsp;</a>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="index-1 first"><a href="/" title="Blog Posts">Blog</a></li>
<li class="index-2"><a href="/download/" title="Download Citra">Download</a></li>
<li class="index-3"><a href="/help/" title="Help">Help</a></li>
<li class="index-4"><a href="/wiki/faq/" title="Frequently Asked Questions">FAQ</a></li>
<li class="index-5"><a href="/game/" title="Game Compatibility">Compatibility</a></li>
<li class="index-6"><a href="/wiki/home/" title="Wiki Homepage">Wiki</a></li>
<li class="index-7 dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown"
role="button" aria-haspopup="true" aria-expanded="false">
Social <span class="caret"></span>
</a>
<ul class="dropdown-menu">
<li class="index-1 first"><a href="/rules/" title="Community Rules">Rules</a></li>
<li class="index-2"><a href="https://community.citra-emu.org/" title="Forums">Community Forums</a></li>
<li class="index-3 last"><a href="/discord/" title="Discord Server">Discord Chat</a></li>
</ul>
</li>
<li class="index-8 dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button"
aria-haspopup="true" aria-expanded="false">
Media <span class="caret"></span>
</a>
<ul class="dropdown-menu">
<li class="index-1 first"><a href="/screenshots/" title="Screenshots">Screenshots</a></li>
<li class="index-2 last"><a href="https://www.youtube.com/channel/UC_dcdgzuapBtAY4ol3x-90Q"
title="YouTube Channel">Videos</a></li>
</ul>
</li>
<li class="index-9 last"><a href="https://www.patreon.com/citraemu" title="Patreon">Patreon</a></li>
</ul>
</div>
</div>
</nav>
<div id="mainContainer" class="container" >
<div class="row">
</div>
<div class="row row-fluid">
<div id="content" class="col-xs-12 col-sm-12 col-md-9 col-lg-9 pull-right">
<a href="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/">
<div class="entry-embed-header">
<div class="entry-embed" style="background: url('https://citra-emu.org/images/banners/telemetry-and-why-thats-a-good-thing.png')">
<header>
<h1>Telemetry (And Why That&#39;s A Good Thing)</h1>
</header>
</div>
<div class="entry-meta" style="position: absolute; top: 5px; right: 20px;">
August 26 2017
</div>
<div class="entry-meta" style="position: absolute; top: 45px; right: 20px;">
feature-update
</div>
</div>
</a>
<div class="entry-content">
<p>Citra has some <a href="https://github.com/citra-emu/citra/issues">issues</a>, and by its
nature as an open source project, they are visible to everyone and fixable by
anyone. Unfortunately though, most contributions are made by
<a href="https://github.com/citra-emu/citra/graphs/contributors">a small minority of developers</a>.
These developers have found it difficult to prioritize their efforts, since the
majority of issue reports are written scattered across Discord, Reddit, forums,
IRC, and too many other places to count.</p>
<p>Because of this, the Citra team has put together a framework to report data about
how Citra is used to our server, and use that data to discover what are the most
popular games and hardware configurations, where emulated games crash in Citra
most often, and more. We had considered including this in last month&rsquo;s progress
report, but we decided that it would be best to publish this on its own, so it
gets the attention it deserves. We&rsquo;re very aware that privacy is important to
many of our users, and so from the earliest planning stage we knew we must be as
transparent and open about this as possible.</p>
<p>The telemetry framework will collect information such as:</p>
<ul>
<li>Information about the version of Citra you are using</li>
<li>Performance data for the games you play</li>
<li>Your Citra configuration settings</li>
<li>Information about your computer hardware (e.g. GPU, CPU, and OS type)</li>
<li>Emulation errors and crash information</li>
</ul>
<p>Not everyone is comfortable sharing information about their system, so we&rsquo;ve made it easy to opt-out:</p>
<figure >
<img src="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/optout1_hu4ada82e93b5bb8336a298e1ee512b5db_42664_911x0_resize_q90_bgffffff_box_3.jpg" alt="Alt, E, C" />
<figcaption>
<h4>
First, head to the Citra &ldquo;Emulation&rdquo;&ldquo;Configure&hellip;&rdquo; menu.
</h4>
</figcaption>
</figure>
<figure >
<img src="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/optout2_hu03982b2fcb53f1be72377675754623cf_50106_911x0_resize_q90_bgffffff_box_3.jpg" alt="Right arrow, Right arrow, Right arrow, Right arrow, Right arrow, Right arrow, Right arrow" />
<figcaption>
<h4>
Then, head into the &ldquo;Web&rdquo; tab.
</h4>
</figcaption>
</figure>
<figure >
<img src="https://citra-emu.org/entry/telemetry-and-why-thats-a-good-thing/optout3_hu95fcd305e79c5c4831f9ff77f98b9f7a_50021_911x0_resize_q90_bgffffff_box_3.jpg" alt="Tab, Tab, Tab, Tab, Tab, Space" />
<figcaption>
<h4>
And finally, untick the box titled &ldquo;Share anonymous usage data with the Citra team&rdquo;.
</h4>
</figcaption>
</figure>
<p>You may have also noticed the field titled &ldquo;Telemetry ID&rdquo; in the screenshots, this
is an identifier generated randomly on install which is used instead of your IP
address. This makes data collection entirely anonymous, unless you choose to log in.
You can also reset your telemetry ID if you&rsquo;d like by clicking &ldquo;Regenerate&rdquo;. The
new ID will also be completely random, and so it would be treated as a wholly new
identity.</p>
<p>Telemetry is an extremely useful developer tool, as they allow the developer to
be more aware of the users&rsquo; needs and priorities accurately, rather than guessing.
But it is only as useful as the data obtained, which is why we urge users to not
opt-out, so the data can be as accurate and correct as possible. Just as innacurate
measurements can damage a device during calibration, innacurate statistical data
will only cause damage to Citra.</p>
</div>
<div class="entry-written-by">
<a href="https://community.citra-emu.org/u/anodium">
<img src="https://community.citra-emu.org/user_avatar/community.citra-emu.org/anodium/120/485_1.png" class="avatar">
</a>
<p>Written by <a href="https://community.citra-emu.org/u/anodium">anodium</a> on Saturday August 26, 2017</p>
</div>
<div class="entry-comments">
<div id="discourse-comments"></div>
<script type="text/javascript">
DiscourseEmbed = { discourseUrl: 'https://community.citra-emu.org/', topicId: "3095" };
(function() {
var d = document.createElement('script'); d.type = 'text/javascript'; d.async = true;
d.src = DiscourseEmbed.discourseUrl + 'javascripts/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(d);
})();
</script>
</div>
</div>
<div id="sidebar" class="col-xs-12 col-sm-12 col-md-3 col-lg-3 pull-left">
<div id="advertisement" class = "ad">
<h3>Advertisement</h3>
<ins class="ad adsbygoogle"
style="display:block"
data-ad-client="ca-pub-4126545610079023"
data-ad-slot="4223809695"></ins>
<script>(adsbygoogle = window.adsbygoogle || []).push({});</script>
</div>
<div class="tagcloud hidden-sm hidden-xs">
<h3>News Tag Cloud</h3>
<ul>
<li><a class="taxonomy-citra-release" href="/tags/citra-release">citra-release</a></li>
<li><a class="taxonomy-feature-update" href="/tags/feature-update">feature-update</a></li>
<li><a class="taxonomy-progress-report" href="/tags/progress-report">progress-report</a></li>
</ul>
</div>
<div id="twitter" class="hidden-sm hidden-xs">
<a class="twitter-timeline" data-tweet-limit="3" href="https://twitter.com/citraemu?ref_src=twsrc%5Etfw">Tweet Feed</a>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
</div>
</div>
</div>
</div>
<div id="footer" class="container">
<div class="row">
<div class="col-md-2">
<h1>Citra</h1>
<a href="/entry">Blog</a>
<a href="/download/">Downloads</a>
<a href="/screenshots/">Screenshots</a>
<a href="https://www.patreon.com/citraemu">Patreon</a>
<a href="/donate/">Donate</a>
</div>
<div class="col-md-2">
<h1>Documentation</h1>
<a href="/help/">Help Documents</a>
<a href="/game/">Compatibility</a>
<a href="/wiki/home/">Wiki</a>
<a href="/wiki/faq/">FAQ</a>
</div>
<div class="col-md-2">
<h1>Blog</h1>
<a href="/entry">News &amp; Articles</a>
<a href="https://citra-emu.org/index.xml">RSS 2.0</a>
</div>
<div class="col-md-2">
<h1>Social</h1>
<a href="https://www.youtube.com/channel/UC_dcdgzuapBtAY4ol3x-90Q">YouTube</a>
<a href="https://www.facebook.com/citra.emu">Facebook</a>
<a href="https://twitter.com/citraemu">Twitter</a>
<a href="https://community.citra-emu.org/">Forums</a>
<a href="/discord">Discord</a>
<a href="/chat">IRC</a>
</ul>
</div>
<div class="col-md-2">
<h1>Get Involved</h1>
<a href="https://github.com/citra-emu/citra">GitHub / Source</a>
<a href="https://github.com/citra-emu/citra/issues">Issues</a>
<a href="https://github.com/citra-emu/citra/pulls">Pull Requests</a>
</div>
</div>
<div id="footer-bottom">
<div id="footer-brand"></div>
<div id="footer-legal">Copyright © 2024 Citra Emulator Project</div>
</div>
</div>
<script src="https://citra-emu.org/js/script.js"></script>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/baguettebox.js/1.10.0/baguetteBox.min.css" type="text/css" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/baguettebox.js/1.10.0/baguetteBox.min.js" type="text/javascript"></script>
<script type="text/javascript">
window.addEventListener("DOMContentLoaded", function() {
baguetteBox.run('.is-img-preview');
});
</script>
</body>
</html>