Search Results for ""

Enabling Usage Statistics

This chapter is for System Administrators who want to automatically send some aggregate usage statistics to CircleCI. Usage statistics data enhances visibility into CircleCI installations and is used to better support you and ensure a smooth transition from CircleCI 1.0 to 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

Detailed Usage Statistics

The following sections provide information about the usage statistics CircleCI will gather when this setting is enabled.

Weekly Account Usage

Name Type Purpose

account_id

UUID

Uniquely identifies each vcs account

usage_current_macos

minutes

For each account, track weekly builds performed in minutes.

usage_legacy_macos

minutes

usage_current_linux

minutes

usage_legacy_linux

minutes

Weekly Job Activity

Name Type Purpose

utc_week

date

Identifies which week the data below applies to

usage_oss_macos_legacy

minutes

Track builds performed by week

usage_oss_macos_current

minutes

usage_oss_linux_legacy

minutes

usage_oss_linux_current

minutes

usage_private_macos_legacy

minutes

usage_private_macos_current

minutes

usage_private_linux_legacy

minutes

usage_private_linux_current

minutes

new_projects_oss_macos_legacy

sum

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

new_projects_oss_macos_current

sum

new_projects_oss_linux_legacy

sum

new_projects_oss_linux_current

sum

new_projects_private_macos_legacy

sum

new_projects_private_macos_current

sum

new_projects_private_linux_legacy

sum

new_projects_private_linux_current

sum

projects_oss_macos_legacy

sum

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

sum

projects_oss_linux_legacy

sum

projects_oss_linux_current

sum

projects_private_macos_legacy

sum

projects_private_macos_current

sum

projects_private_linux_legacy

sum

projects_private_linux_current

sum

Accessing Usage Data

If you would like programatic access to this data in order to better understand your users you may run this command from the Services VM.

docker exec usage-stats /src/builds/extract

Security and Privacy

Please reference exhibit C within your terms of contract and our standard license agreement for our complete security and privacy disclosures.