telemetry.mdx 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  1. ---
  2. title: "Cline Telemetry"
  3. sidebarTitle: "Cline Telemetry"
  4. description: "Configure usage analytics and event tracking"
  5. ---
  6. Cline includes telemetry to help understand usage patterns and improve the product. Users can control whether to share this data.
  7. ## What is Cline Telemetry?
  8. Telemetry captures anonymous usage events such as:
  9. - Features used (which tools, commands, workflows)
  10. - Task completion rates
  11. - Error occurrences
  12. - Performance metrics
  13. <Info>
  14. All telemetry data is **anonymous** and does not include code content, file contents, or other sensitive information.
  15. </Info>
  16. ## User Controls
  17. ### Enabling/Disabling Cline Telemetry
  18. Individual users can control telemetry through Cline settings:
  19. 1. Open Cline settings
  20. 2. Find "Cline Telemetry" toggle
  21. 3. Enable or disable as preferred
  22. Changes take effect immediately.
  23. ### What Gets Collected
  24. When telemetry is enabled, Cline captures:
  25. <AccordionGroup>
  26. <Accordion title="Feature Usage" icon="cursor-click">
  27. - Tools executed (e.g., read_file, execute_command)
  28. - Slash commands used
  29. - Workflows triggered
  30. - Settings changed
  31. </Accordion>
  32. <Accordion title="Task Metrics" icon="tasks">
  33. - Task started/completed events
  34. - Mode switches (Plan/Act)
  35. - Checkpoint usage
  36. - Task duration
  37. </Accordion>
  38. <Accordion title="Error Events" icon="triangle-exclamation">
  39. - API failures
  40. - Tool execution errors
  41. - System errors
  42. - Error types and frequencies
  43. </Accordion>
  44. </AccordionGroup>
  45. ### What Doesn't Get Collected
  46. Cline Telemetry **never** includes:
  47. - Your code or file contents
  48. - File paths or names
  49. - Command arguments or parameters
  50. - Conversation content
  51. - Personal information
  52. - API keys or credentials
  53. ## Enterprise Configuration
  54. Administrators can set default telemetry state through remote configuration:
  55. ```json
  56. {
  57. "telemetryEnabled": true
  58. }
  59. ```
  60. <Note>
  61. Even with enterprise configuration, individual users can still disable Cline Telemetry in their local settings.
  62. </Note>
  63. ## Advanced Monitoring
  64. For organizations needing detailed monitoring, Cline supports optional OpenTelemetry integration to export telemetry data to your own observability systems.
  65. See [Enterprise Monitoring](/enterprise-solutions/monitoring/overview) for details on available monitoring options.
  66. ## Privacy
  67. Cline's telemetry is designed with privacy in mind:
  68. <CardGroup cols={2}>
  69. <Card title="Anonymous" icon="user-secret">
  70. No personal information is collected
  71. </Card>
  72. <Card title="Optional" icon="toggle-on">
  73. Users can disable at any time
  74. </Card>
  75. <Card title="Local First" icon="laptop">
  76. Code never leaves your machine
  77. </Card>
  78. <Card title="Transparent" icon="eye">
  79. Open source - see exactly what's collected
  80. </Card>
  81. </CardGroup>
  82. ## Why Telemetry Matters
  83. Anonymous usage data helps:
  84. - **Identify bugs**: Discover issues affecting users
  85. - **Prioritize features**: Focus on most-used capabilities
  86. - **Improve performance**: Find and fix slow operations
  87. - **Enhance reliability**: Track and reduce error rates
  88. ## Related
  89. <CardGroup cols={2}>
  90. <Card title="OpenTelemetry" icon="chart-line" href="/enterprise-solutions/monitoring/opentelemetry">
  91. Enterprise monitoring and observability
  92. </Card>
  93. <Card title="Privacy" icon="shield" href="/more-info/telemetry">
  94. Full telemetry documentation
  95. </Card>
  96. </CardGroup>