This article explains what data Metalama collects and how to modify its settings.
What is being collected?
By default, Metalama collects and sends usage and quality reports to PostSharp Technologies. These telemetry reports are anonymous and are collected under these circumstances:
- When an unexpected failure or performance degradation occurs, an exception report with an anonymized call stack is sent.
- Periodically, for each project you're building, we gather data such as a one-way hash of the project name, the target framework version, the project size, the number of aspects used, the amount of code saved by Metalama, and performance metrics.
All reports include a randomly generated device ID, which you can reset at any time using Metalama command-line tools.
Telemetry data is collected and processed in accordance with our Privacy Policy.
License audit
In addition to telemetry, if you're using premium components of Metalama (as opposed to only open-source ones), the software undergoes a license audit. This audit is anonymous but mandatory for Metalama Community and trial licenses. It's used to gather statistics on the number of users. If you're using a license key, license audit reports include the ID of your license key. If you disagree with license auditing, contact our sales team, and we'll provide you with a new license key that includes a license audit waiver flag.
Disabling telemetry
Telemetry is enabled by default. You can disable it using one of these methods.
Option 1. Defining an environment variable
Disable telemetry by defining the METALAMA_TELEMETRY_OPT_OUT environment variable to any non-empty value.
This environment variable has priority over any other setting. It allows you to disable telemetry for all devices in your domain using remote management tools such as Azure Endpoint Manager.
This approach doesn't affect the license audit mechanism.
Option 2. Using Metalama command-line tools
Install Metalama command-line tools as described in Installing the Metalama command line tool.
Execute this command:
metalama telemetry disable
Option 3. Using Visual Studio Tools for Metalama
- In the top-level menu, choose Options.
- Select the Metalama + PostSharp category, then the Privacy page.
- Set individual settings.
Resetting your device ID
Metalama Telemetry uses a randomly generated GUID to uniquely identify your device. You can reset this ID at any time. Once you reset your ID, PostSharp Technologies can no longer correlate past and future reports.
Install Metalama command-line tools as described in Installing the Metalama command line tool.
Execute this command:
metalama telemetry reset-device-id