HashiTalks 2025 Learn about unique use cases, homelab setups, and best practices at scale at our 24-hour virtual knowledge sharing event. Register
HashiCorp Cloud Platform
HashiCorp Cloud Platform Home

meter git

The meter git provides information on number of contributers in your data source. Your account teams will use this information for license costs.

Authentication

The meter git command uses the same authentication as scan repo command. It is important to remember that the credentials used must have access to the resources that are to be evaluated.

Additionally if you do not specify which orgs to scan by using the --orgs flag, then the credentials used must have permissions to enumerate orgs.

Usage

users

meter git users is going to provide a usage estimate based on the number of users detected while performing a scan of a Git data source.

Command Options

  • --type, -t: The type of the git data source (required). Supported values: 'github_cloud', 'github_enterprise', 'gitlab_cloud', 'gitlab_onprem','bitbucket_cloud', 'bitbucket_server'.
  • --url, -u: The url endpoint of the git data source to meter (required for non-cloud data sources)
  • --outfile, -o: Specifies the file to store information about found users (required).

The days parameter or both start-time and end-time are required.

  • --days, -d: Specifies the number of days to evaluate for metering.

  • --start-time: Specifies the start date to evaluate metering. Setting --end-time is also required. Accepts YYYY-MM-DD.

  • --end-time: Specifies the end date to evaluate metering. Setting --start-time is also required. Accepts YYYY-MM-DD.

  • --orgs: A comma separated list of orgs used to collect metering info. If not specified, the command will try to meter all orgs the credentials have access to. As a result if this flag is not used, the credentials must have permissions to enumerate orgs.

Meter Github Cloud Orgs

$ vault-radar meter git users -t 'github_cloud' -o <PATH TO OUTPUT>.csv

Meter Github Server Orgs

$ vault-radar meter git users -t 'github_enterprise' -u <INSTANCE URL> -o <PATH TO OUTPUT>.csv

Meter specific Github Orgs

$ vault-radar meter git users -t 'github_cloud' -o <PATH TO OUTPUT>.csv --orgs <ORG 1>,<ORG 2>

Meter Github for the last 10 days

$ vault-radar meter git users -t 'github_cloud' -o <PATH TO OUTPUT>.csv --days 10

Meter Github from a some date until another date

$ vault-radar meter git users -t 'github_cloud' -o <PATH TO OUTPUT>.csv --start-time <YYYY-MM-DD> --end-time <YYYY-MM-DD>