Skip to content

Commit 8871022

Browse files
authored
docs(telemetry): Added first telemetry report for the community (ai-openshell#2190)
* docs(telemetry): add community telemetry reports page Add telemetry/README.md to publish aggregate usage trends every two weeks, and link to it from the Telemetry section of the main README. First report covers the July 8, 2026 window. Signed-off-by: Kirit Thadaka <kthadaka@nvidia.com> * docs(telemetry): note telemetry start date (June 1, 2026) Clarify that all-time figures are cumulative from ai-openshell#1433, so readers know when the all-time counts begin. Signed-off-by: Kirit Thadaka <kthadaka@nvidia.com> --------- Signed-off-by: Kirit Thadaka <kthadaka@nvidia.com>
1 parent 83131d7 commit 8871022

2 files changed

Lines changed: 58 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -258,6 +258,8 @@ Telemetry events are limited to anonymous operational categories and counts, suc
258258

259259
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.
260260

261+
We publish aggregate usage trends from this telemetry every two weeks. See the [community telemetry reports](telemetry/README.md) for the latest summary.
262+
261263
## Notice and Disclaimer
262264

263265
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.

‎telemetry/README.md‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# OpenShell Community Telemetry Reports
2+
3+
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.
4+
5+
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.
6+
7+
Numbers are aggregate counts only — no user data, code, prompts, or command contents are collected. Reports are listed newest first.
8+
9+
---
10+
11+
## Update — July 8, 2026
12+
13+
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.
14+
15+
| Metric | Last 2 weeks | All-time |
16+
|---|---:|---:|
17+
| Sandboxes created | 269,220 | 383,224 |
18+
| Sandboxes deleted | 247,727 | 343,216 |
19+
| Sandbox creation failures | 5,345 | 12,822 |
20+
| Actions denied | 2,323,468 | 3,861,935 |
21+
| Network activity events | 29,935,431 | 43,079,862 |
22+
23+
Creation failure rate held around 2% over the last two weeks (~3% all-time).
24+
25+
**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.
26+
27+
```mermaid
28+
xychart-beta
29+
title "Sandboxes Created by Driver (Last 2 Weeks)"
30+
x-axis ["docker", "podman", "kubernetes", "vm", "unknown", "mxc"]
31+
y-axis "Sandboxes created" 0 --> 220000
32+
bar [208816, 34637, 23480, 1562, 422, 303]
33+
```
34+
35+
**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.
36+
37+
**Providers (last 2 weeks).** `custom` profiles lead (~30k), then `openai` (~21k), with nvidia, claude, anthropic, github, gitlab, opencode, codex, and copilot trailing.
38+
39+
```mermaid
40+
xychart-beta
41+
title "Top Provider Profiles (Last 2 Weeks, approx.)"
42+
x-axis ["custom", "openai", "nvidia", "claude", "other"]
43+
y-axis "Profiles created" 0 --> 32000
44+
bar [30300, 21100, 1200, 1000, 3000]
45+
```
46+
47+
**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.
48+
49+
```mermaid
50+
pie showData
51+
title Policy Decisions — Last 2 Weeks (approx.)
52+
"Approved" : 3700
53+
"Rejected" : 1400
54+
```
55+
56+
<sub>Next update: ~July 22, 2026.</sub>

0 commit comments

Comments
 (0)