Enabling Usage Statistics

This chapter is for System Administrators who want to automatically send some aggregate usage statistics to CircleCI. 使用状況統計データを活用すれば、CircleCI Server の可視性が向上するだけでなく、サポートが強化され、CircleCI 1.0 から CircleCI 2.0 への移行がスムーズに行えます。

To opt-in to this feature, navigate to your Management Console settings (e.g. circleci-hostname.com:8800/settings) and scroll down to Usage Statistics. Enable the radio button labeled Automatically send some usage statistics to CircleCI, as shown below.

Send Usage Statistics
Figure 1. Usage Statistics Settings

使用状況統計の詳細

以下のセクションでは、この設定を有効にした場合に CircleCI が収集する使用状況統計に関する情報を提供します。

週単位のアカウント使用状況

名前 タイプ 目的

account_id

UUID

各 vcs アカウントを一意に識別します。

usage_current_macos

各アカウントについて、1 週間で実行されたビルドを分単位で記録します。

usage_legacy_macos

usage_current_linux

usage_legacy_linux

週単位のジョブ アクティビティ

名前 タイプ 目的

utc_week

日付

以下のデータが適用される週を識別します。

usage_oss_macos_legacy

1 週間で実行されたビルドを記録します。

usage_oss_macos_current

usage_oss_linux_legacy

usage_oss_linux_current

usage_private_macos_legacy

usage_private_macos_current

usage_private_linux_legacy

usage_private_linux_current

new_projects_oss_macos_legacy

合計

Captures new Builds performed on 1.0. Observe if users are starting new projects on 1.0.

new_projects_oss_macos_current

合計

new_projects_oss_linux_legacy

合計

new_projects_oss_linux_current

合計

new_projects_private_macos_legacy

合計

new_projects_private_macos_current

合計

new_projects_private_linux_legacy

合計

new_projects_private_linux_current

合計

projects_oss_macos_legacy

合計

Captures Builds performed on 1.0 and 2.0. Observe if users are moving towards 2.0 or staying with 1.0.

projects_oss_macos_current

合計

projects_oss_linux_legacy

合計

projects_oss_linux_current

合計

projects_private_macos_legacy

合計

projects_private_macos_current

合計

projects_private_linux_legacy

合計

projects_private_linux_current

合計

使用状況データへのアクセス

このデータにプログラムでアクセスして、組織内の使用状況をさらに詳しく把握したいときには、Services VM からこのコマンドを実行します。

docker exec usage-stats /src/builds/extract

セキュリティとプライバシー

セキュリティとプライバシーに関する CircleCI の開示情報は、契約条件の別紙 C および CircleCI のhttps://circleci.com/legal/enterprise-license-agreement/[標準ライセンス契約]にてご覧いただけます。



Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.