Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -62,15 +62,29 @@ If you're using a dedicated block device as your backup target, you need to init

>[!WARNING] This command will permanently erase all data on the specified device. Double-check the device name and back up any important data before proceeding.

{% ifversion ghes > 3.17 %}

```shell
ghe-storage-init-backup /dev/YOUR_DEVICE_NAME
```

{% else %}

```shell
/usr/local/share/enterprise/ghe-storage-init-backup /dev/YOUR_DEVICE_NAME
```

{% endif %}

This command:
* Formats the device (erases all data).
* Prepares it for use by the backup service.
* Sets it to mount automatically at `/data/backup` on boot.

{% ifversion ghes = 3.17 %}
From {% data variables.product.prodname_ghe_server %} 3.17.4 onward, the script is installed in PATH so you can run it directly using: `ghe-storage-init-backup /dev/YOUR_DEVICE_NAME`.
{% endif %}

#### Reusing a previously initialized disk

If the device was already initialized using `ghe-storage-init-backup`, you can reuse it without reformatting:
Expand Down
2 changes: 1 addition & 1 deletion content/billing/how-tos/products/view-product-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ If you are an owner or billing manager of an organization or enterprise, you wil
### Personal accounts

{% data reusables.user-settings.access_billing_settings_url %}
1. Scroll to the bottom of the page and use the tabbed view to see a summary of consumed use for each product that you use (in this example, the "{% data variables.product.prodname_AS %}" tab is shown).
1. Use the tabbed view to see a summary of consumed use for each product that you use (in this example, the "{% data variables.product.prodname_AS %}" tab is shown).

![Screenshot of the tabbed view showing "{% data variables.product.prodname_AS %}" with the "View details" links outlined in dark orange.](/assets/images/help/billing/overview-product-summary.png)

Expand Down
30 changes: 8 additions & 22 deletions content/billing/tutorials/estimate-spending.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,14 +30,10 @@ The new billing platform provides a high-level view of your spending trends base
On this page, you can view your usage in the following categories:

* **Current metered usage:** The card on the top left shows the gross metered usage for your personal account.
* **Metered usage:** The graph shows the gross metered usage for your personal account.

To view a different time period, select **Time Frame**, then choose a time period. You can also download an image or CSV of the graph by clicking {% octicon "kebab-horizontal" aria-label="Open column options" %} on the right.

* **By repository:** The card under the graph shows the top five repositories that generate the most usage. You can click {% octicon "kebab-horizontal" aria-label="Open column options" %} in the upper-right corner of each card to view all usage, including a break down by gross usage versus billable usage (minus any discounts that may apply).
* **By products:** You can use the product tabs to view usage and discounts for different products.

![Screenshot of the product tabs section of the overview page.](/assets/images/help/billing/enhanced-billing-platform-products-tabs.png)
* **By repository:** The card at the bottom of the page shows the top five repositories that generate the most usage for your personal account. This helps you identify which repositories are consuming the most resources across {% data variables.product.prodname_copilot_short %}, {% data variables.product.prodname_actions %}, {% data variables.product.prodname_codespaces %}, and other billable features. You can click {% octicon "kebab-horizontal" aria-label="Open column options" %} in the upper-right corner of each card to view all usage, including a breakdown by gross usage versus billable usage (minus any discounts that may apply).

Additionally, you can change your plan by clicking **Upgrade to Pro** or **Downgrade to Free** in the "Current plan" section.

Expand Down Expand Up @@ -65,41 +61,31 @@ The "Overview" page provides a high-level view of your spending and budgets.
On this page, you can view your usage in the following categories:

* **Current metered usage:** The card on the top left shows the gross metered usage for your {% data variables.enterprise.enterprise_or_org %}{% ifversion ghec %} including all cost centers. Click **More details** to view a breakdown of the usage by cost center{% endif %}.
* **Metered usage:** The graph shows the gross metered usage for your {% data variables.enterprise.enterprise_or_org %}{% ifversion ghec %} including cost centers{% endif %}.

To view a different time period, select **Time Frame**, then choose a time period. You can also download an image or CSV of the graph by clicking {% octicon "kebab-horizontal" aria-label="Open column options" %} on the right.
* **By products:** You can use the product tabs to view usage and discounts for different products.

{% data reusables.billing.actions-usage-delay %}

{% ifversion fpt %}
* **By repository:** The card under the graph shows the top five repositories that generate the most usage. You can click {% octicon "kebab-horizontal" aria-label="Open column options" %} in the upper-right corner of each card to view all usage, including a break down by gross usage verse billable usage (minus any discounts that may apply).
* **By repository:** The card at the bottom of the page shows the top five repositories that generate the most usage. You can click **View details** in the upper-right corner of the card to view all usage, including a breakdown by gross usage versus billable usage (minus any discounts that may apply).
{% elsif ghec %}
* **By organization** and **by repository:** The two cards under the graph show the top five organizations and repositories that generate the most usage. You can click {% octicon "kebab-horizontal" aria-label="Open column options" %} in the upper-right corner of each card to view all usage, including a break down by gross usage verse billable usage (minus any discounts that may apply).
* **By organization** and **by repository:** The two cards at the bottom of the page show the top five organizations and repositories that generate the most usage. You can click **View details** in the upper-right corner of each card to view all usage, including a breakdown by gross usage versus billable usage (minus any discounts that may apply).
{% endif %}
* **By products:** You can use the product tabs to view usage and discounts for different products.

![Screenshot of the product tabs section of the overview page.](/assets/images/help/billing/enhanced-billing-platform-products-tabs.png)

{% data reusables.billing.actions-usage-delay %}

{% ifversion ghec %}

## Viewing prepaid credits

Your prepaid credits are shown above the "Metered usage" graph. To add more prepaid credits, you can contact your account manager in {% data variables.contact.contact_enterprise_sales %}.
Your prepaid credits are shown at the top of the page in the **Current included usage** card. To add more prepaid credits, you can contact your account manager in {% data variables.contact.contact_enterprise_sales %}.

If you don't currently use prepaid credits, but have a volume subscription and would like to use credits, you can contact your account manager in {% data variables.contact.contact_enterprise_sales %}. Prepaid credits are only available to customers who are invoiced (with or without metered add-ons). Prepaid credits can't be used if your account _only_ includes metered add-ons.

## Viewing promotion and discounts

In the "Current promotions and discounts" section in the top right, you can see the total amount of promotions and discounts applied to your account. Click **More details** to view a breakdown of the promotions and discounts.
You can see the total amount of promotions and discounts applied to your account on the Overview page. In the top right-hand corner of the **Current included usage** card, click **More details** to view a breakdown of your promotions and discounts.

{% endif %}

## Tracking budgets

At the bottom of the page, under "Budgets", you can see your current budgets, and how much you have spent against those budgets. If your role provides access, you can edit or delete a budget by clicking {% octicon "kebab-horizontal" aria-label="Open column options" %} to the right of a budget. See [AUTOTITLE](/billing/managing-your-billing/roles-for-the-new-billing-platform).

If you have used all of your budget, a red banner appears at the top of the page. You can click **Update your budget** to increase your budget.

## Creating a budget

As an enterprise owner or billing manager, you can set the budget for your enterprise, an organization within your enterprise, or a cost center. As an organization owner, you are able to set the budgets for the repositories you manage. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#creating-a-budget).
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,10 @@ Your `copilot-setup-steps.yml` file will automatically be run as a normal {% dat

Once you have merged the yml file into your default branch, you can manually run the workflow from the repository's **Actions** tab at any time to check that everything works as expected. For more information, see [AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow).

When {% data variables.product.prodname_copilot_short %} starts work, your setup steps will be run, and updates will show in the session logs. See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions).

If any setup step fails by returning a non-zero exit code, {% data variables.product.prodname_copilot_short %} will skip the remaining setup steps and begin working with the current state of its development environment.

## Setting environment variables in {% data variables.product.prodname_copilot_short %}'s environment

You may want to set environment variables in {% data variables.product.prodname_copilot_short %}'s environment to configure or authenticate tools or dependencies that it has access to.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,8 @@ If {% data variables.product.prodname_copilot_short %} starts a new agent sessio
> [!TIP]
> If you don't want {% data variables.product.prodname_copilot_short %} to respond to comments on a pull request, you can unassign {% data variables.product.prodname_copilot_short %} from the pull request. If you later reassign {% data variables.product.prodname_copilot_short %} to the same pull request it will respond to new comments and push more changes. It will not respond to comments that were added while it was not assigned.

As {% data variables.product.prodname_copilot_short %} makes changes to the pull request, it will keep the title and body up to date so they reflect the current changes.

For more information, see the section "Use comments to iterate on a pull request" in [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices#using-comments-to-iterate-on-a-pull-request).

## Managing {% data variables.product.prodname_actions %} workflow runs
Expand Down
36 changes: 24 additions & 12 deletions content/copilot/reference/metrics-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,12 @@ This property is consistent across the following surfaces:
The following interactions count as activity:

* Receiving a code suggestion in an IDE
* Chatting with Copilot Chat in an IDE
* Chatting with {% data variables.copilot.copilot_chat_short %} in an IDE
* Creating or updating a knowledge base
* Creating a pull request summary
* Interacting with Copilot Chat in GitHub
* Generating a pull request summary
* Interacting with {% data variables.copilot.copilot_chat_short %} in GitHub
* Interacting with Copilot on a mobile device
* Interacting with Copilot Chat for CLI
* Interacting with {% data variables.copilot.copilot_chat_short %} for CLI

The tracked events come from both client- and server-side telemetry, ensuring the timestamp is durable if network conditions affect client-side telemetry.

Expand Down Expand Up @@ -62,24 +62,36 @@ Data in the report refreshes automatically every 30 minutes.
| `last_activity_at` | UTC timestamp of the user's most recent Copilot interaction |
| `last_surface_used` | The Copilot feature used most recently:<br><ul><li>**IDE**: Editor name and version (e.g. "VS Code 1.89.1")</li><li>**GitHub.com**: Feature name (e.g., "Copilot Chat")</li><li>**Unspecified**: When IDE details are unavailable or no recent activity exists</ul> |

### Retention period

Activity and authentication data are retained for a rolling 90-day period, consistent with the `last_activity_at` field.

### Included features

The activity report provides visibility into usage of all generally available (GA) GitHub Copilot features in the IDE, on GitHub, in GitHub CLI, and on GitHub Mobile.

#### IDE features

* Code completions and Next edit suggestions
* Copilot Chat
* Copilot agents
* Code completions
* {% data variables.copilot.next_edit_suggestions_caps %}
* {% data variables.copilot.copilot_chat_short %}
* Agent mode
* {% data variables.copilot.copilot_edits_short %} in VS Code

#### GitHub features

* Copilot Chat
* {% data variables.copilot.copilot_chat_short %}
* {% data variables.copilot.copilot_coding_agent %}
* Copilot for Docs
* Knowledge base management
* Copilot pull requests
* Copilot code reviews
* {% data variables.copilot.copilot_for_prs %}
* {% data variables.copilot.copilot_code-review_short %}

### Retention period
### Limitations

Activity and authentication data are retained for a rolling 90-day period, consistent with the `last_activity_at` field.
There is a possibility that {% data variables.product.github %} lacks consistent telemetry from some third party IDEs outside of VS Code (such as JetBrains and Xcode). Users should ensure they're running the latest version of their IDE.

The activity report may exclude usage of {% data variables.product.prodname_copilot %} features that are not yet generally available (GA). Currently, the following features are not fully recorded:

* {% data variables.copilot.copilot_spaces %}
* Copilot Spark
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,8 @@ Working with {% data variables.product.prodname_copilot_short %} on a pull reque
> [!NOTE]
> {% data reusables.copilot.coding-agent.write-access-required %}

As {% data variables.product.prodname_copilot_short %} makes changes to the pull request, it will keep the title and body up to date so they reflect the current changes.

## Adding custom instructions to your repository

By adding custom instructions to your repository, you can guide {% data variables.product.prodname_copilot_short %} on how to understand your project and how to build, test and validate its changes.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,10 @@ If the source of your migration is {% data variables.product.prodname_ghe_server

{% data reusables.enterprise-migration-tool.identifying-githubs-ip-ranges %}

### Virtual network firewall rules for Azure Blob Storage for {% data variables.product.prodname_dotcom_the_website %}

{% data reusables.enterprise-migration-tool.identify-gei-vnet-firewall-rules %}

### IP ranges for {% data variables.enterprise.data_residency_site %}

{% data reusables.enterprise-migration-tool.ip-ranges-ghecom %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,10 @@ To grant the migrator role using the CLI, you must have installed the {% data va

{% data reusables.enterprise-migration-tool.identifying-githubs-ip-ranges %}

### Virtual network firewall rules for Azure Blob Storage for {% data variables.product.prodname_dotcom_the_website %}

{% data reusables.enterprise-migration-tool.identify-gei-vnet-firewall-rules %}

### IP ranges for {% data variables.enterprise.data_residency_site %}

{% data reusables.enterprise-migration-tool.ip-ranges-ghecom %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,10 @@ For more information, see [AUTOTITLE](/enterprise-cloud@latest/organizations/kee

{% data reusables.enterprise-migration-tool.identifying-githubs-ip-ranges %}

### Virtual network firewall rules for Azure Blob Storage for {% data variables.product.prodname_dotcom_the_website %}

{% data reusables.enterprise-migration-tool.identify-gei-vnet-firewall-rules %}

### IP ranges for {% data variables.enterprise.data_residency_site %}

{% data reusables.enterprise-migration-tool.ip-ranges-ghecom %}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
Customers with Azure Blob Storage configured for storing repository data for migrations must add virtual network firewall rules to their storage accounts to allow GEI to access the repository data. This requires the use of the Azure CLI or PowerShell, as adding these virtual network firewall rules on the Azure Portal is currently unsupported. The following virtual network subnet IDs must be added to the virtual network firewall rules for your storage account:

* `/subscriptions/495e10ff-6097-4190-a1de-b031fcb96f66/resourceGroups/ghr-network-service-4c5846fa-dc07-4153-8d08-a16a9b437a5a-3-eastus2/providers/Microsoft.Network/virtualNetworks/4c5846fa-dc07-4153-8d08-a16a9b437a5a-3/subnets/4c5846fa-dc07-4153-8d08-a16a9b437a5a-3`
* `/subscriptions/d3bde7c9-46be-429b-81a8-258387be6dde/resourceGroups/ghr-network-service-4c5846fa-dc07-4153-8d08-a16a9b437a5a-3-westus3/providers/Microsoft.Network/virtualNetworks/4c5846fa-dc07-4153-8d08-a16a9b437a5a-3/subnets/4c5846fa-dc07-4153-8d08-a16a9b437a5a-3`

To add the virtual network firewall rules to your Azure Storage account, you can follow step 5 in the documentation for [creating a virtual network rule for Azure Storage](https://learn.microsoft.com/azure/storage/common/storage-network-security-virtual-networks?tabs=azure-cli) using the network subnet IDs provided above. Be sure to provide the `--subscription` argument with the subscription ID tied to the storage account.
24 changes: 16 additions & 8 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -371,7 +371,7 @@
"chalk": "^5.0.1",
"change-case": "^5.4.4",
"commander": "^14.0.0",
"cross-env": "^7.0.3",
"cross-env": "^10.0.0",
"csp-parse": "0.0.2",
"csv-parse": "6.1.0",
"eslint": "^8.57.1",
Expand Down
Loading
Loading