Skip to content

docs(telemetry): Added first telemetry report for the community #2190

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kirit93 wants to merge 2 commits into
base: main
Choose a base branch
from
+58 −0
Open

docs(telemetry): Added first telemetry report for the community #2190

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c4e3a96
docs(telemetry): add community telemetry reports page
kirit93 Jul 9, 2026
d260769
docs(telemetry): note telemetry start date (June 1, 2026)
kirit93 Jul 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
56 changes: 56 additions & 0 deletions telemetry/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
```

<sub>Next update: ~July 22, 2026.</sub>
Loading