Merge pull request #14 from makeplane/telemetry

Telemetry

Author: danciaclara

images/disable-telemetry.webp

@@ -1,37 +1,54 @@
 ---
-title: Anonymous data collection
+title: Data collection and usage
 sidebarTitle: Telemetry
 ---
-If you’re self-hosting Plane and you’ve opted in to provide us with anonymous usage data (thank you!), Plane will phone home some data collected via Posthog.
+Plane collects anonymized data to enhance your user experience, ensure product stability, and drive continuous improvements. This article talks about what we collect, what we don't, and how we use collected data.
 
-We collect the instance admin emails to communicate in crucial scenarios like checkpoint releases or large migrations.
+## What Plane collects
 
-### The anonymous data we collect
+With the exception of the instance admin's email address on self-hosted Plane, we don't collect any personally identifiable information (PII). All usage data is anonymized and isn't connected to individual users.
 
-We don’t collect any other usernames, emails or the issue titles, descriptions details of any kind, or any personally identifiable information (PII).
+### Instance admin details
+Plane collects just the instance admin's name and email to communicate essential upgrade news, security alerts, and other critical notifications.
 
-The anonymous data helps us understand how people are actually using Plane, which in turn helps us Prioritize what to work on next.
+### Instance setup
+When an instance is created, Plane collects just the instance ID so we can track upgrades and troubleshoot paid features.
 
-### Examples of the anonymous data we collect and how we use it
+### Usage for billing
+Plane tracks the number of workspaces, members, and roles to bill you correctly and ensure accurate reporting in your workspace's **Billing and plans** screen and the Prime portal.
 
-We track some basic events in an anonymised way to find opportunities for improving the product and evaluating project outcomes.
+### Application data
+Plane tracks anonymized workspace activity, including but not limited to the number of projects, issues, cycles, modules, comments, issue types, custom properties, timesheet downloads, active importers, and integrations. This data helps us understand product usage, adoption, and build new features.
 
-We collect events in the product like:
-- When you create an issue or filter a view.
-- When you add a table block in a page.
-- When you invite a user.
+### User interaction and behavior
+Plane collects anonymized data for how you work with Plane when creating, updating, or deleting Plane entities, including but not restricted to projects, issues, cycles, modules, and others. This data helps us understand user journeys, pain points, and overall behavior.
 
-This anonymous data helps us figure out things like:
-- Which features you’re using.
-- Where people get stuck.
-- How performance for key workflows (like querying or loading) changes over time.
+### Performance
+Plane collects machine configurations, environment details, OS flavors, network throughput, and stack traces to help troubleshoot and prevent performance hiccups.
 
-### Opting out of anonymous usage data collection for self-hosted Plane instances
+## How do we use the data?
 
-If you’re self-hosting Plane, you can opt out of providing us with your anonymous usage data:
-1. Login to the god-mode (/god-mode).
-2. Click General settings.
-3. Toggle off the Telemetry option.
+- **Improving product performance**   
+Analyzing real-world usage helps us identify performance bottlenecks, optimize resource usage, and ensure that Plane runs smoothly across various environments.
 
-If you’re in the process of setting up your Plane, you can also toggle off tracking during the Usage Data Preferences onboarding step. We collect a few anonymous events before that point, but won’t do so anymore if you choose to opt out.
+- **Detecting and fixing bugs**  
+Identifying bugs and errors as they occur enables us to quickly diagnose and fix issues, minimize downtime, and improving product stability.
+
+- **Understanding user behavior**  
+Collecting data on how users interact with Plane helps us prioritize feature development and make informed decisions about future enhancements to better meet user needs.
+
+- **Enhancing security**   
+Monitoring for abnormal patterns helps us identify and mitigate potential security threats or vulnerabilities, ensuring the protection of user data and the integrity of the platform.
+
+- **Informing product development**  
+Aggregated telemetry provides insight into frequently used features, highlighting areas for improvement and aligning the product roadmap with user expectations.
+
+## Disabling telemetry
+As much as we'd love to understand your usage better, we agree that you should be in control of your data. If for any reason you don't want to send us that data, you can turn telemetry collection off in three clicks.
+
+1. Go to your instance's God Mode by appending `/god-mode` to the domain you have hosted Plane on.
+2. In the **General Settings** pane on the right, disable the **Telemetry** toggle button.
+    ![Disable telemetry](/images/disable-telemetry.webp)
+3. Click **Save changes**.
+