CLI が送信するデータ
Awnexa CLI が送信するのは、v0.1.0 以降の匿名の利用統計だけです。 利用者自身の認証情報で AWS の API を読み取り専用で呼び出し、結果を手元のマシンに保存します。AWS の構成データは、Awnexa にも第三者にも送信しません。
このページには、利用統計に含まれるすべての項目を載せています。項目を増やすときは、それを送るリリースより前にこのページに載せます。
利用統計のしくみ
Section titled “利用統計のしくみ”- 既定はオンです。最初に CLI を実行したときに、利用統計を送ることと無効にする方法を表示し、その回は何も送りません。端末で実行したときは、オンのままにするかも尋ねます(Enter でオンのまま、
nでオフ)。送信は次の実行からです。端末がない実行(Claude Code・スクリプト・CI など)では、尋ねずに表示だけします。 - MCP サーバー(
awnexa mcp)は、CLI でこの表示を済ませた後だけ送ります(MCP サーバーの出力は利用者の目に入らないことが多いため)。 - CLI のコマンド 1 回(MCP ではツールの呼び出し 1 回)を 1 件のイベントにします。送信先は Awnexa 自身のバックエンド
https://api.awnexa.net/v1/eventsだけです。 --help・--version、引数の解析で失敗した実行、telemetryコマンド自体は数えません。
無効にする・送る内容を確認する
Section titled “無効にする・送る内容を確認する”| やりたいこと | 方法 |
|---|---|
| 無効にする | awnexa telemetry disable(インストール ID と未送信のイベントも削除します) |
| 環境変数で無効にする | AWNEXA_TELEMETRY=0(off / false も可)、または DO_NOT_TRACK=1 |
| 有効に戻す | awnexa telemetry enable(新しいインストール ID を作ります) |
| 有効かどうかと、その理由を見る | awnexa telemetry status |
| 送る前と送った後のイベントを見る | awnexa telemetry show(未送信のイベントと、直近に送った 10 件) |
| 送らずにイベントを表示する | AWNEXA_TELEMETRY=debug(stderr に表示) |
すべてのイベントに含まれる項目
Section titled “すべてのイベントに含まれる項目”| 項目 | 例 | 備考 |
|---|---|---|
schema |
awnexa.telemetry/v1 |
イベントの形の版 |
installId |
乱数の UUID | 端末ごとの乱数。AWS アカウント・ユーザー名・ホスト名から作りません。無効にすると削除します |
eventId |
乱数の UUID | 再送したイベントを二重に数えないため |
time |
2026-11-02T03:00:00Z |
分単位に丸めます |
awnexaVersion |
0.4.1 |
|
nodeVersion |
22.12 |
メジャー・マイナーまで |
os / arch |
darwin / arm64 |
OS のリリース番号は送りません |
interface |
cli / mcp |
|
ci |
true / false |
環境変数 CI があるか(値は送りません) |
sample |
true / false |
awnexa init --sample のサンプルデータを使ったか(試用と実際の利用を分けるため) |
command |
resources list / awnexa_overview |
Awnexa が定義したコマンド名・MCP ツール名のどれか |
options |
["--compact","--limit"] |
指定したオプションの名前だけ。値は送りません |
optionChoices |
{"--format":"table"} |
値が決まった選択肢から選ぶオプションだけ、選んだ選択肢を送ります |
outcome |
ok / scan_incomplete / usage / user_error / aws_auth / error |
終了の種類 |
errorCategory |
access_denied |
エラーの分類(throttled・access_denied・user_error・internal など)。メッセージやスタックトレースは送りません |
errorCode |
NO_SCAN |
Awnexa が定義したエラーコード、または other |
durationMs |
5300 |
100 ms 単位に丸めます |
scan だけに含まれる項目
Section titled “scan だけに含まれる項目”metrics に入れて送ります。環境を見分ける手がかりになりうる件数は、範囲にして送ります。
| 項目 | 例 | 備考 |
|---|---|---|
regions |
2 |
スキャンしたリージョンの数(名前は送りません) |
plugins |
68 |
実行した Awnexa のプラグインの数 |
accounts |
1 / 2-10 / 11-50 / 51+ |
手元の DB にある AWS アカウントの数を範囲で。アカウント ID は送りません |
dataDirs |
accounts と同じ範囲 |
直近 90 日にスキャンしたデータディレクトリの数を範囲で。パスは送りません。各パスのハッシュだけを、手元の利用統計の設定と同じ場所に保存します(awnexa telemetry disable で削除されます) |
resources |
0 / 1-99 / 100-999 / 1k-9.9k / 10k+ |
リソースの数を範囲で |
relationships |
同じ範囲 | 関係の数を範囲で |
complete |
true / false |
すべて取得できたか |
coverage |
{"complete":120,"access_denied":3} |
取得の単位の数を状態別に |
pluginCoverage |
{"s3":{"complete":4}} |
同じものを Awnexa のプラグイン ID ごとに。リソースの数やリソース型は送りません |
決して送らないもの
Section titled “決して送らないもの”- AWS の構成データ: リソース ID、ARN、名前、タグ(キーも値も)、properties、Evidence、リソース型、リージョン名
- AWS アカウント ID、認証情報、プロファイル名、ロール名
- ファイルパス、ホスト名、ユーザー名、環境変数の値
- オプションの値(
--region、--profile、--name、--tagなど) - エラーメッセージ、スタックトレース
送信用に保存する前に、AWS アカウント ID・ARN・IP アドレスに見える文字列が含まれていないかを CLI が調べ、含まれていればそのイベントを捨てます。
Awnexa のバックエンドでの扱い
Section titled “Awnexa のバックエンドでの扱い”- 送信元の IP アドレスは記録・保存しません。リクエストの頻度は API 全体で制限し、その前に置いたファイアウォールが、1 つの CLI ではありえないほど多く送るアドレスからのリクエストも断ります(アドレスは件数を数えるためだけに見て、記録しません)。
- 受け取ったイベントは 13 か月保持して削除します。インストール ID を含まない集計結果は残します。
- データの削除を希望する場合は、
awnexa telemetry statusに表示されるinstallIdをお知らせください。
予定している有料の追加機能
Section titled “予定している有料の追加機能”予定している有料の追加機能では、利用統計とは別に、ライセンスの確認のためにライセンスキーと Awnexa のバージョンを送ります。送るのはライセンスの期限が近いときだけ(1 日 1 回まで)で、コマンドのたびには送りません。チーム共有は、利用者が自分で有効にしたときだけスキャン結果を送り、送る前に内容を表示します。どちらもまだありません。提供する前に、このページに内容を載せます。