# Propriedades de dados de métricas para GitHub Copilot

Veja como GitHub calcula propriedades de APIs e relatórios.

## `last_activity_at`

> \[!NOTE] Esses dados estão contidos em prévia pública e sujeitos a alterações.

O carimbo de data/hora da interação mais recente de um usuário com a funcionalidade do Copilot.

### Superfícies

Essa propriedade é consistente entre as seguintes superfícies:

* O relatório CSV baixado da página "gerenciamento de acesso" (consulte [Revisando dados de atividade do usuário para GitHub Copilot em sua organização](/pt/copilot/how-tos/administer-copilot/manage-for-organization/review-activity/review-user-activity-data))
* O [Endpoints da API REST para gerenciamento de usuários do Copilot](/pt/rest/copilot/copilot-user-management)

### Cálculo

As seguintes interações contam como atividade:

* Recebendo uma sugestão de código em um IDE
* Conversando com Bate-papo do Copilot em uma IDE
* Gerando um resumo de uma pull request
* Interagindo com Bate-papo do Copilot no GitHub
* Interagindo com Copilot em um dispositivo móvel
* Interagindo com Bate-papo do Copilot no CLI

Os eventos acompanhados vêm da telemetria do lado do cliente e do servidor, garantindo que o carimbo de data/hora seja durável se as condições de rede afetarem a telemetria do lado do cliente.

O processamento de novos eventos de telemetria e a atualização da data `last_activity_at` de um usuário podem levar até 24 horas. Os usuários devem ter a telemetria habilitada em seu IDE para que seu uso seja refletido em `last_activity_at`.

### Período de retenção

* O período de retenção dos dados `last_activity_at` é de 90 dias. Isso não pode ser modificado.
* Após 90 dias sem nenhuma atividade nova, o valor `last_activity_at` de um usuário é definido como `nil`.

Para saber mais, consulte [Atualizando o período de retenção para valores de `last_activity_at` na API de gerenciamento de usuários do Copilot para 90 dias](https://github.blog/changelog/2025-01-17-updating-retention-period-for-last_activity_at-values-on-the-user-management-api-public-preview-to-90-days/) no the GitHub Blog.

## relatório de atividades do Copilot

O relatório de atividade Copilot mostra os dados de atividade do usuário para uma organização ou empresa.

Os dados no relatório são atualizados automaticamente a cada 30 minutos.

### Campos

| Campo                                                                                                          | Descrição                                                                   |
| -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `report_time`                                                                                                  | Carimbo de data/hora UTC do momento em que o relatório foi gerado           |
| `login`                                                                                                        | GitHub nome de usuário do usuário Copilot                                   |
| `last_authenticated_at`                                                                                        | Carimbo de data/hora UTC da autenticação mais recente do usuário            |
| `last_activity_at`                                                                                             | Carimbo de data/hora UTC da interação mais recente do usuário com o Copilot |
| `last_surface_used`                                                                                            | O recurso Copilot usado mais recentemente:<br><ul><li>                      |
| **IDE**: nome e versão do editor (por exemplo, "VS Code 1.89.1")</li><li>                                      |                                                                             |
| **GitHub.com**: nome do recurso (por exemplo, "Copilot Chat")</li><li>                                         |                                                                             |
| **Não especificado**: quando os detalhes do IDE não estão disponíveis ou não há nenhuma atividade recente</ul> |                                                                             |

### Período de retenção

Os dados de atividade e autenticação são mantidos por um período de 90 dias sem interrupção, consistente com o campo `last_activity_at`.

### Recursos incluídos

O relatório de atividades fornece visibilidade do uso de todos os recursos de GitHub Copilot disponíveis em geral (GA) no IDE, no GitHub, na CLI do GitHub e no GitHub Mobile.

#### Recursos de IDE

* Sugestões embutidas
* Próximas sugestões de edição
* Bate-papo do Copilot
* Modo de agente
* Copilot Edits no VS Code

#### recursos de GitHub

* Bate-papo do Copilot
* agente de nuvem Copilot
* Copilot para Docs
* Copilot resumos da solicitação de pull
* Revisão de código do Copilot

### Limitações

Há uma possibilidade de que GitHub não tenha telemetria consistente de algumas IDEs de terceiros além do VS Code (como JetBrains e Xcode). Os usuários precisam estar executando a versão mais recente do IDE.

O relatório de atividade pode excluir o uso de recursos do GitHub Copilot que ainda não estão disponíveis ao público (GA). Atualmente, os seguintes recursos não têm registros completos:

* Espaços do Copilot
* Copilot Spark