テレメトリ
Next.jsは、一般的な使用状況に関する**完全に匿名化された**テレメトリデータを収集します。この匿名プログラムへの参加は任意であり、情報を共有したくない場合はオプトアウトできます。
なぜテレメトリが収集されるのか?
Next.jsはリリース以来大幅に成長し、開発者にとって事実上のReactフレームワークとなっています。テレメトリの収集前は、Next.jsを改善する方法に関する意思決定は非常に手動的なプロセスでした。
例えば、Vercelは多くの大きなReactアプリケーション(Next.jsウェブサイトを含む)を自社で利用しています。さらに、私たちは積極的にコミュニティと交流してフィードバックを集めています。
しかし、このアプローチでは、ユーザーのサブセットからのフィードバックしか収集できません。このサブセットは、あなたとは異なるニーズとユースケースを持つ可能性があります。テレメトリにより、すべてのユーザーにわたるNext.jsの機能使用状況、問題点、カスタマイズを正確に測定できます。
このデータにより、Next.jsをより多くの人々に適したものに調整し、その継続的な成長、関連性、そして最高の開発者エクスペリエンスを確保できます。さらに、これにより、フレームワークに加えられた改善がすべてのアプリケーションのベースラインを向上させているかどうかを確認できます。
何が収集されているのか?
Next.jsプラグインやビルドのパフォーマンスなど、一般的な使用状況に関する情報を追跡します。具体的には、次の情報を匿名で追跡します。
- 実行されたコマンド(
next build
、next dev
、またはnext export
) - Next.jsのバージョン
- 一般的なマシン情報(例:CPU数、macOS/Windows/Linux、コマンドがCI内で実行されたかどうか)
- プロジェクトに存在するNext.jsプラグイン
next build
の期間とアプリケーションのサイズ(ページの総数)
注記:このリストは、正確性を確保するために定期的に監査されています。
次の環境変数を設定することで、収集されている内容を正確に確認できます:NEXT_TELEMETRY_DEBUG=1
。
この環境変数が設定されている場合、データは**送信されません**。データは、[telemetry]
をプレフィックスとして付けてstderrストリームに出力されるだけです。
テレメトリイベントの例を以下に示します。
{
"eventName": "NEXT_VERSION",
"payload": {
"version": "9.0.5-canary.2",
"isDevelopment": false
}
}
機密データ(例:シークレット)はどうなるのか?
機密データを含む可能性のある指標は**一切**収集しません。
これには、環境変数、ファイルパス、ファイルの内容、ログ、またはシリアル化されたJavaScriptエラーなどが含まれますが、これらに限定されません。
プライバシーとセキュリティを非常に真剣に受け止めています。Next.jsのテレメトリはセキュリティ開示ポリシーに準拠しています。
このデータは共有されますか?
収集するデータは完全に匿名であり、ソースに追跡できず、集計形式でのみ意味を持ちます。
収集するデータには、個人を特定できる情報は一切含まれていません。
オプトアウトするには?
プロジェクトのルートディレクトリでnext telemetry disable
を実行することで、オプトアウトできます。
npx next telemetry disable
yarn next telemetry disable
pnpm exec next telemetry disable
bun next telemetry disable
プロジェクトのルートディレクトリでnext telemetry status
を実行することで、いつでもテレメトリ収集の状態を確認できます。
npx next telemetry status
yarn next telemetry status
pnpm exec next telemetry status
bun next telemetry status
プログラムに再参加したい場合は、プロジェクトのルートディレクトリで次のコマンドを実行してテレメトリを再度有効にすることができます。
npx next telemetry enable
yarn next telemetry enable
pnpm exec next telemetry enable
bun next telemetry enable
環境変数NEXT_TELEMETRY_DISABLED=1
を設定することでもオプトアウトできます。