Qodana 2024.3 Help

Contributor counting

Qodana license costs are comprised of the number of active contributors to your project. An active contributor is a person/bot who has committed to any number of Qodana Cloud projects within the past 90 days under a single Qodana license. For example, on the 30th of June, Qodana will calculate and charge for the unique contributors detected within 30 days of June, 31 days of May, and 29 days of March.

Active contributors are counted using SSH keys. The mechanism of key generation and contributor counting is explained below.

Key generation

During the project setup stage, Qodana Cloud generates an SSH key pair for counting the number of active contributors to your project using this command:

ssh-keygen -t rsa -b 4096 -N "" -f id_rsa -C "qodana.cloud"

Each key pair can be:

  • Generated while creating a new organization

  • Regenerated

  • Encrypted using some secret stored in our database

Contributor counting

Save the generated key in your VCS, see the examples for:

  • GitLab,

  • GitHub - start from step 2, i.e. skip the SSH key generation step,

  • JetBrains Space - start from step 2, i.e. skip the SSH key generation step.

After you save the generated key in your VCS, Qodana will use the following command to clone the project metadata of your repository:

git clone -n --filter=blob:none --shallow-since='90 days ago' <repo>

After cloning, Qodana will extract the contributors from all commits made for the last 90 days:

git log --all --since '90 days ago' --pretty=format:%ae||%an||%H||%ai

To calculate the number of contributors in your repository, you can use Qodana CLI with the contributors option invoked, for example:

qodana contributors -d 90
Last modified: 23 October 2024