コンテンツにスキップ

CLI が送信するデータ

Awnexa CLI が送信するのは、v0.1.0 以降の匿名の利用統計だけです。 利用者自身の認証情報で AWS の API を読み取り専用で呼び出し、結果を手元のマシンに保存します。AWS の構成データは、Awnexa にも第三者にも送信しません。

このページには、利用統計に含まれるすべての項目を載せています。項目を増やすときは、それを送るリリースより前にこのページに載せます。

  • 既定はオンです。最初に 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 単位に丸めます

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 ごとに。リソースの数やリソース型は送りません
  • AWS の構成データ: リソース ID、ARN、名前、タグ(キーも値も)、properties、Evidence、リソース型、リージョン名
  • AWS アカウント ID、認証情報、プロファイル名、ロール名
  • ファイルパス、ホスト名、ユーザー名、環境変数の値
  • オプションの値(--region、--profile、--name、--tag など)
  • エラーメッセージ、スタックトレース

送信用に保存する前に、AWS アカウント ID・ARN・IP アドレスに見える文字列が含まれていないかを CLI が調べ、含まれていればそのイベントを捨てます。

  • 送信元の IP アドレスは記録・保存しません。リクエストの頻度は API 全体で制限し、その前に置いたファイアウォールが、1 つの CLI ではありえないほど多く送るアドレスからのリクエストも断ります(アドレスは件数を数えるためだけに見て、記録しません)。
  • 受け取ったイベントは 13 か月保持して削除します。インストール ID を含まない集計結果は残します。
  • データの削除を希望する場合は、awnexa telemetry status に表示される installId をお知らせください。

予定している有料の追加機能では、利用統計とは別に、ライセンスの確認のためにライセンスキーと Awnexa のバージョンを送ります。送るのはライセンスの期限が近いときだけ(1 日 1 回まで)で、コマンドのたびには送りません。チーム共有は、利用者が自分で有効にしたときだけスキャン結果を送り、送る前に内容を表示します。どちらもまだありません。提供する前に、このページに内容を載せます。