---
title: telemetry | CodeWeaver Docs
description: API reference for codeweaver.core.telemetry
url: "https://docs.knitli.com/api/core/telemetry"
type: static
generatedAt: "2026-04-17T17:21:08.098Z"
---

# telemetry
       [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/api/core/telemetry.md)       [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F&text=telemetry)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F&text=telemetry)[Share on Bluesky](https://bsky.app/intent/compose?text=telemetry%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F&title=telemetry)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F&t=telemetry)[Share on Email](mailto:?subject=telemetry&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F)[Share on WhatsApp](https://wa.me/?text=telemetry%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Ftelemetry%2F&text=telemetry)
# `codeweaver.core.telemetry`
[Section titled “codeweaver.core.telemetry”](#codeweavercoretelemetry)
Privacy-preserving telemetry system for CodeWeaver.

This module provides telemetry infrastructure for collecting anonymized, aggregated metrics to understand CodeWeaver usage patterns and identify trouble spots while maintaining strict privacy guarantees.

Key Principles:

 - Never collect PII, code, or repository information
 - Aggregated statistics only
 - Easy opt-out mechanism
 - Fail-safe (errors don’t affect application)
 - PostHog v7 context API for session tracking

Events:

 - SessionEvent: Aggregated session statistics (usage patterns, setup success)
 - SearchEvent: Per-search metrics (performance, quality, A/B testing)

Example: >>> from codeweaver.core.telemetry import get_telemetry_client, capture_search_event >>> client = get_telemetry_client() >>> client.start_session({“version”: “0.5.0”}) >>> if client.enabled: … client.capture(“codeweaver_session”, {“searches”: 10})