Telemetry Guide
Anonymous usage analytics to help improve DevOps AI Toolkit.
Overview
What it does
Collects anonymous telemetry to understand product usage patterns.
Use when
- You want to help improve DevOps AI Toolkit through anonymous usage data
- You need to configure telemetry settings for your organization
- You want to route telemetry to a self-hosted PostHog instance
Why we collect telemetry
This data helps us:
- Identify which tools are most valuable
- Discover errors users encounter in the wild
- Understand which AI providers to prioritize
- Make data-driven product decisions
Telemetry is enabled by default but can be disabled with a single environment variable.
What We Collect
We collect minimal, anonymous data about tool usage and server lifecycle.
| Event | Properties |
|---|---|
tool_executed | Tool name, success/failure, duration, MCP client name |
tool_error | Tool name, error type (class name only, not message) |
server_started | Kubernetes version, deployment method |
server_stopped | Uptime duration |
client_connected | MCP client name and version, transport type |
All events include: dot-ai version, AI provider, and whether this is a CI/test environment.
What We Do NOT Collect
- User queries or intents
- Cluster names, namespaces, or resource data
- API keys or credentials
- IP addresses or geographic location
- Error messages (only error type/class names)
- Any personally identifiable information (PII)
Instance Identity
Each installation is identified by an anonymous instance ID generated from a SHA-256 hash of the Kubernetes cluster's kube-system namespace UID. This hash cannot be reversed to identify the cluster.
Opting Out
To disable telemetry, set the DOT_AI_TELEMETRY environment variable to false:
# Helm values.yaml
extraEnv:
- name: DOT_AI_TELEMETRY
value: "false"
# Docker
docker run -e DOT_AI_TELEMETRY=false ghcr.io/vfarcic/dot-ai
# Local development
export DOT_AI_TELEMETRY=false
Self-Hosted PostHog
For organizations who want to route telemetry to their own PostHog instance:
# Helm values.yaml
extraEnv:
- name: DOT_AI_POSTHOG_HOST
value: "https://posthog.your-company.com"
Questions?
If you have questions about telemetry or privacy, please open an issue or start a discussion.