イベントデータ

イベントレベルでの製品使用状況のデータ追跡

製品使用状況データ収集の変更に関する詳細は、ブログ記事GitLab Self-ManagedおよびDedicated向けのより詳細な製品使用状況インサイトをご覧ください。

イベントデータ

イベントデータは、GitLabプラットフォーム内のインタラクション（またはアクション）を追跡します。これらのインタラクションまたはアクションは、CI/CDパイプラインの開始、マージリクエストのマージ、Webhookのトリガー、イシューの作成など、ユーザーが開始したものである可能性があります。アクションは、スケジュールされたパイプラインの成功など、バックグラウンドシステムの処理によって生じることもあります。イベントデータ収集の焦点は、ユーザーのアクションとそれらのアクションに関連付けられたメタデータにあります。

ユーザーIDはプライバシーを保護するために仮名化されており、GitLabは、メトリクスを個々のユーザーと再識別または関連付ける処理を行いません。イベントデータには、ソースコードや、GitLab内に保存されているその他のお客様が作成したコンテンツは含まれていません。

詳細については、以下も参照してください:

• イベントとメトリクスのリストについては、メトリクスディクショナリをご覧ください
• お客様の製品使用に関する情報

イベントデータの利点

イベントレベルのデータは、ユーザーを特定せずに、より詳細なインサイトを提供することで、Service Pingのいくつかの利点を強化します。

• プロアクティブサポート: 詳細データにより、当社のカスタマーサクセスマネージャー（CSM）とサポートチームは、より詳細な情報にアクセスでき、より一般的な集約されたメトリクスに依存するのではなく、組織固有のニーズに合わせて調整されたカスタムメトリクスをドリルダウンして作成できます。
• 対象を絞ったガイダンス: イベントレベルのデータは、機能の使用方法についてのより深い理解を提供し、最適化と改善の機会を発見するのに役立ちます。詳細データにより、GitLabの価値を最大化し、ワークフローを強化するための、より正確で実用的な推奨事項を提供できます。
• 匿名化されたベンチマークレポート: 詳細なイベントデータを使用すると、高レベルの集約されたデータだけでなく、詳細な使用パターンに焦点を当てることで、同様の組織とのより正確で関連性の高いパフォーマンス比較が可能になります。

イベントレベルのデータ収集の有効化または無効化

イベントレベルのデータ収集を有効または無効にするには:

1. 管理者アクセス権を持つユーザーとしてサインインします。
2. 左側のサイドバーの下部で、管理者を選択します。
3. 設定 > Metrics and Profiling（メトリクスとプロファイリング）を選択します。
4. イベントのトラッキングを展開します。
5. 設定を有効にするには、イベント追跡を有効にするチェックボックスをオンにします。設定を無効にするには、チェックボックスをオフにします。
6. 変更を保存を選択します。

プログラムによるイベントレベルのデータ収集の有効化または無効化

この設定は、初回インストール時に新しいインスタンスに対してのみ機能します。

Omnibusインストールの場合:

インストール中に使用状況データ収集を無効にするには、gitlab_rails['initial_gitlab_product_usage_data']をfalseに設定します。

Kubernetes Operatorデプロイの場合:

イベントレベルのデータ収集を無効にするには、global.appConfig.initialDefaults.gitlabProductUsageDataをfalseに設定します。

重要な注意点:

• デフォルトの初期設定は、インストール中にのみ適用されます。これらの設定を後で変更しても効果はありません。
• インストール後にイベントデータ収集を有効または無効にするには、前のセクションで説明した管理者設定を使用します。

イベント配信タイミング

イベントは、発生後ほぼすぐにGitLabに送信されます。システムはイベントを小さなバッチで収集し、10個のイベントが収集されるとデータを送信します。このアプローチにより、効率的なネットワーキングの使用を維持しながら、ほぼリアルタイムの配信が実現します。

ペイロードサイズと圧縮

各イベントのサイズは約10 KB（JSON形式）です。10個のイベントのバッチは、約100 KBの非圧縮ペイロードサイズになります。送信前に、ペイロードが圧縮され、データ転送サイズを最小限に抑え、パフォーマンスを最適化します。

イベントデータログ

イベントレベルのトラッキングデータは、product_usage_data.logファイルに記録されます。このログには、ペイロード情報とコンテキストデータを含む、追跡された製品使用状況イベントのJSON形式のエントリが含まれています。各エントリは、個別のトラッキングイベントと、送信されたすべてのデータを表します。

ログファイルは次の場所にあります:

• /var/log/gitlab/gitlab-rails/product_usage_data.log (Linuxパッケージインストール)
• /home/git/gitlab/log/product_usage_data.log (セルフコンパイルインストール)

これらのログはデータ送信に関する詳細な表示レベルを提供しますが、機能の使用状況分析ではなく、セキュリティチームによる検査専用に設計されています。ログシステムの詳細については、ログシステムのドキュメントを参照してください。