diff --git a/README.md b/README.md index 2b9749652..ff72647a5 100644 --- a/README.md +++ b/README.md @@ -258,6 +258,8 @@ Telemetry events are limited to anonymous operational categories and counts, suc Opting out applies only to telemetry emitted by OpenShell. Third-party services, model providers, inference endpoints, agents, or tools that you configure and use with OpenShell may have their own terms and privacy practices. +We publish aggregate usage trends from this telemetry every two weeks. See the [community telemetry reports](telemetry/README.md) for the latest summary. + ## Notice and Disclaimer This software automatically retrieves, accesses or interacts with external materials. Those retrieved materials are not distributed with this software and are governed solely by separate terms, conditions and licenses. You are solely responsible for finding, reviewing and complying with all applicable terms, conditions, and licenses, and for verifying the security, integrity and suitability of any retrieved materials for your specific use case. This software is provided "AS IS", without warranty of any kind. The author makes no representations or warranties regarding any retrieved materials, and assumes no liability for any losses, damages, liabilities or legal consequences from your use or inability to use this software or any retrieved materials. Use this software and the retrieved materials at your own risk. diff --git a/telemetry/README.md b/telemetry/README.md new file mode 100644 index 000000000..0d0f10560 --- /dev/null +++ b/telemetry/README.md @@ -0,0 +1,56 @@ +# OpenShell Community Telemetry Reports + +OpenShell collects anonymous, aggregate usage telemetry (see the [Telemetry section](../README.md#telemetry) of the main README for what's collected and how to opt out). We publish a summary of the trends here every two weeks so the community can see how the project is being used. + +Telemetry collection landed in [#1433](https://github.com/NVIDIA/OpenShell/pull/1433) on **June 1, 2026**, so all "All-time" figures are cumulative from that date. + +Numbers are aggregate counts only — no user data, code, prompts, or command contents are collected. Reports are listed newest first. + +--- + +## Update — July 8, 2026 + +First public telemetry update. The **Last 2 weeks** column covers the trailing two-week window; **All-time** is cumulative since telemetry landed on June 1, 2026 (~5 weeks). A large share of all-time activity falls within this first two-week window. + +| Metric | Last 2 weeks | All-time | +|---|---:|---:| +| Sandboxes created | 269,220 | 383,224 | +| Sandboxes deleted | 247,727 | 343,216 | +| Sandbox creation failures | 5,345 | 12,822 | +| Actions denied | 2,323,468 | 3,861,935 | +| Network activity events | 29,935,431 | 43,079,862 | + +Creation failure rate held around 2% over the last two weeks (~3% all-time). + +**Sandbox drivers (last 2 weeks).** Docker dominates at 208,816, followed by Podman (34,637) and Kubernetes (23,480). VM (1,562), unknown (422), and MXC (303) make up the long tail. All-time we've also seen a handful of apple-container and macos sandboxes. + +```mermaid +xychart-beta + title "Sandboxes Created by Driver (Last 2 Weeks)" + x-axis ["docker", "podman", "kubernetes", "vm", "unknown", "mxc"] + y-axis "Sandboxes created" 0 --> 220000 + bar [208816, 34637, 23480, 1562, 422, 303] +``` + +**Where sandboxes are created (last 2 weeks).** The United States leads by a wide margin, followed by Israel, Australia, Hong Kong, India, Singapore, South Korea, Germany, Japan, and China. + +**Providers (last 2 weeks).** `custom` profiles lead (~30k), then `openai` (~21k), with nvidia, claude, anthropic, github, gitlab, opencode, codex, and copilot trailing. + +```mermaid +xychart-beta + title "Top Provider Profiles (Last 2 Weeks, approx.)" + x-axis ["custom", "openai", "nvidia", "claude", "other"] + y-axis "Profiles created" 0 --> 32000 + bar [30300, 21100, 1200, 1000, 3000] +``` + +**Policy.** Roughly 73% of policy decisions were approved over the last two weeks. Of denied sandbox connections, ~99% fell under the "Connect Policy" deny group, with "Bypass" denials near zero. + +```mermaid +pie showData + title Policy Decisions — Last 2 Weeks (approx.) + "Approved" : 3700 + "Rejected" : 1400 +``` + +Next update: ~July 22, 2026.