chore(analytics): [ENG-1524] add product analytics with Posthog

[henchaves]

No description provided.

[linear]

ENG-1524 Add product analytics (Posthog)

[gitguardian]

️✅ There are no secrets present in this pull request anymore.

If these secrets were true positive and are still valid, we highly recommend you to revoke them.
While these secrets were previously flagged, we no longer have a reference to the
specific commits where they were detected. Once a secret has been leaked into a git
repository, you should consider it compromised, even if it was deleted immediately.
Find here more information about risks.

---

^{_{🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.}}

[gemini-code-assist]

Code Review

This pull request introduces telemetry tracking using PostHog across the SDK. It adds a new _analytics.py module to handle event capture and provides a disable_telemetry utility. Integration points include client initialization, API error handling, and resource creation for agents, datasets, projects, and scans. Feedback focuses on improving the robustness of the telemetry implementation, specifically handling missing API keys in make_distinct_id to prevent crashes, ensuring thread safety during client initialization, and capturing events before raising exceptions in helper methods to ensure complete telemetry coverage.

[henchaves]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces telemetry tracking using PostHog. It adds a new _analytics.py module to handle event capture and opt-out logic, and integrates telemetry calls across the SDK, including client initialization, resource creation, and error handling. Feedback includes correcting a non-existent method call in the PostHog client, adding version constraints for the new dependency, and optimizing environment variable lookups.

[gemini-code-assist]

It is recommended to specify a version range for new dependencies to ensure compatibility and prevent breaking changes from future updates. For example, posthog>=3.0.0,<4 if version 3 is the current stable major version.

Suggested change

	"posthog",
	"posthog>=3.0.0,<4",

[henchaves]

/gemini review

[gemini-code-assist]

Code Review

This pull request implements anonymous product-usage telemetry using PostHog, including a new _analytics module, documentation for opt-out mechanisms, and integration across the SDK to track client initialization, resource creation, and errors. The review identifies a high-risk security concern where capturing full exception objects could leak sensitive data (PII) to PostHog, recommending sanitized event capture instead. Additionally, feedback suggests evaluating opt-out environment variables dynamically at runtime rather than once at module import to ensure user preferences are correctly respected if modified after the library is loaded.