Skip to content

Latest commit

 

History

History
67 lines (49 loc) · 5.99 KB

viewing-license-usage-for-github-enterprise.md

File metadata and controls

67 lines (49 loc) · 5.99 KB
Raw
title intro permissions versions type topics shortTitle
Viewing license usage for GitHub Enterprise
You can view license usage for your enterprise on {% ifversion ghec %}{% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}{% data variables.location.product_location %}{% endif %}.
Enterprise owners can view license usage for {% data variables.product.prodname_enterprise %}.
ghec ghes
*
*
how_to
Enterprise
Licensing
View license usage

About license usage for {% data variables.product.prodname_enterprise %}

You can view license usage for {% data variables.product.product_name %} on {% data variables.location.product_location %}.

If you use both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %} and sync license usage between the products, you can view license usage for both on {% data variables.product.prodname_dotcom_the_website %}. For more information about license sync, see "AUTOTITLE."

{% ifversion ghes %}

For more information about viewing license usage on {% data variables.product.prodname_dotcom_the_website %} and identifying when the last license sync occurred, see "AUTOTITLE" in the {% data variables.product.prodname_ghe_cloud %} documentation.

{% endif %}

You can also use the REST API to return consumed licenses data and the status of the license sync job. For more information, see "AUTOTITLE."

To learn more about the license data associated with your enterprise account and how the number of consumed user {% ifversion ghas-billing-UI-update %}licenses{% else %}seats{% endif %} are calculated, see "AUTOTITLE."

Viewing license usage on {% ifversion ghec %}{% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}{% data variables.location.product_location %}{% endif %}

You can view the license usage for your enterprise and download a file with license details. If you're not seeing expected license counts in this report, it's possible that the subscriber’s assigned {% data variables.product.prodname_vs %} subscription email address and {% data variables.product.prodname_dotcom_the_website %} email address aren't exactly the same. For further information, see "AUTOTITLE."

{% ifversion ghec %}

{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses.
    • To download the consumed license report as a CSV file, to the right of "User licenses," click {% octicon "download" aria-hidden="true" %} CSV report. For more information about reviewing the data in this report, see "AUTOTITLE."
    • If you purchased {% data variables.product.prodname_GH_advanced_security %}, you can review your total {% ifversion ghas-billing-UI-update %}license{% else %}seat{% endif %} usage. For more information, see "AUTOTITLE."
    • To view an overview of the consumed licenses without downloading a report, click View details, then look under "User licenses consumed". For more information, see "AUTOTITLE."

{% elsif ghes %}

{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses.{% ifversion ghes %}
    • To download the consumed license report as a JSON file, in the top right under "Quick links", choose Export license usage. For more information about reviewing the data in this report, see "AUTOTITLE."
    • If you have purchased {% data variables.product.prodname_GH_advanced_security %}, you can review your total {% ifversion ghas-billing-UI-update %}licenses{% else %}seats{% endif %} used as well as a per-organization breakdown of active committers. For more information, see "AUTOTITLE."{% endif %}

{% endif %} {% ifversion ghec %}

Viewing the last license sync date

{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %}

  1. To identify when the last license sync occurred, under "Enterprise Server instances", look for timestamps next to usage uploaded or synced events.
    • "Server usage uploaded" indicates license usage between environments was manually updated when a {% data variables.product.prodname_ghe_server %} license file was uploaded.
    • "{% data variables.product.prodname_github_connect %} server usage synced" indicates license usage between environments was automatically updated.
    • "{% data variables.product.prodname_github_connect %} server usage never synced" indicates that {% data variables.product.prodname_github_connect %} is configured, but license usage between environments has never updated successfully.

{% endif %}