GitHub Copilot
O conector github-copilot lê duas coisas do GitHub:
- Billing: cobranças diárias das licenças do Copilot por SKU, e AI Credits por modelo, em USD (billed).
- Relatórios de métricas de uso do Copilot: atividade diária por usuário (interações, geração de código, aceites), sem custo.
Funciona no github.com e no GHE.com (GitHub Enterprise Cloud com residência de dados), em um de dois modos:
| Modo | Use quando | Cobre |
|---|---|---|
| Enterprise (informe o slug do enterprise) | Você tem um enterprise no GitHub, e sempre no GHE.com | Todas as organizações do enterprise, incluindo cobranças do Copilot que o GitHub faz no nível do enterprise |
| Organização (informe só a organização) | Uma organização avulsa no github.com, sem enterprise | Essa organização |
Se você tem um enterprise, prefira o modo enterprise, mesmo que só importe uma organização. O GitHub costuma cobrar o Copilot no nível do enterprise, sem organização associada, e o modo organização não enxerga essas cobranças.
Antes de começar
| Você precisa | Por quê |
|---|---|
| Copilot Business ou Enterprise na organização | Os relatórios de métricas só existem nesses planos |
| Modo enterprise: ser owner ou billing manager do enterprise | Necessário para ler as métricas e o billing do Copilot do enterprise |
| Modo organização: ser owner da organização | Necessário para ler as métricas e o billing do Copilot da organização |
| A política Copilot usage metrics habilitada | Sem ela, o GitHub não gera os relatórios de métricas |
Descubra o endereço do GitHub, a organização e o enterprise
- Slug do enterprise (modo enterprise): o nome na URL do enterprise, por exemplo
acme-enterpriseem…/enterprises/acme-enterprise. No GHE.com, é sempre obrigatório. - Organização (só no modo organização): o nome na URL da organização, por exemplo
acmeemhttps://github.com/acme. - Subdomínio do GHE.com: só no GHE.com, a parte antes de
.ghe.com. Parahttps://acme-corp.ghe.com, éacme-corp. No github.com, deixe em branco.
Habilite a política Copilot usage metrics
Um owner do enterprise (ou, sem enterprise, um owner da organização) abre as políticas do Copilot nas configurações do enterprise ou da organização e define Copilot usage metrics como Enabled everywhere. Os relatórios começam a partir do dia em que a política é habilitada.
Crie um personal access token classic
O Lore recomenda um token classic, porque o GitHub não documenta permissões de fine-grained token para os endpoints de billing usage.
- Entre no GitHub (ou no seu endereço GHE.com) com o owner descrito acima.
- Abra a sua foto de perfil → Settings → Developer settings → Personal access tokens → Tokens (classic).
- Clique em Generate new token → Generate new token (classic).
- Note:
lore-usage. Expiration: conforme a sua política permitir. Quando o token expirar, o Lore mostra um erro de sincronização. - Marque estes escopos:
- Modo enterprise:
read:enterprise(métricas do Copilot do enterprise) emanage_billing:enterprise(billing do enterprise); - Modo organização:
read:org(métricas do Copilot) emanage_billing:copilot(billing da organização).
- Modo enterprise:
- Clique em Generate token e copie o token. Ele só é exibido uma vez.
- No github.com, se a organização usa SAML single sign-on, clique em Configure SSO ao lado do token e autorize o token para a organização.
Se Tokens (classic) não aparecer ou a criação for bloqueada, o seu enterprise pode estar restringindo personal access tokens. Isso é comum com Enterprise Managed Users no GHE.com. Um owner do enterprise pode liberar nas políticas de Personal access tokens do enterprise.
Conecte no Lore
No painel do Lore, abra Usage Connectors → GitHub Copilot e preencha:
| Campo | Valor |
|---|---|
| Credential | O token do passo anterior |
| Enterprise slug | Modo enterprise (obrigatório no GHE.com) |
| GitHub organization | Só no modo organização, quando não há enterprise |
| GHE.com subdomain | Só no GHE.com (ex.: acme-corp) |
Clique em Connect. O Lore valida o token com o GitHub antes de salvar, testando as métricas do Copilot e o billing, e diz exatamente o que está faltando.
Se a validação falhar
| Mensagem | O que fazer |
|---|---|
| GitHub rejected this token (401) | O token não foi copiado inteiro ou expirou. Crie um novo. |
| The token cannot read the enterprise’s Copilot usage metrics (403) | Adicione read:enterprise e confira se o token pertence a um owner ou billing manager do enterprise. |
| The token cannot read Copilot usage metrics (403) | Modo organização: adicione read:org. Confira se o token pertence a um owner da organização e, com SAML SSO, se foi autorizado para a organização. |
| Copilot usage metrics are not available (404) | Confira o nome do enterprise ou da organização, o plano do Copilot e a política Copilot usage metrics. No GHE.com, confira o subdomínio. |
| The token can read Copilot metrics but not billing usage | Modo enterprise: adicione manage_billing:enterprise. Modo organização: adicione manage_billing:copilot. O dono do token precisa ser owner ou billing manager ali. |
Fine-grained tokens
Um fine-grained token com a organização como resource owner e a permissão View Organization Copilot Metrics consegue ler os relatórios de métricas. Se a organização exige aprovação, um owner precisa aprovar o token antes. Hoje o GitHub não documenta qual permissão fine-grained libera o billing usage, então a validação do billing pode falhar com um fine-grained token. Nesse caso, use um token classic.
O que esperar
- Os AI Credits são atribuídos por usuário: para cada pessoa com atividade no Copilot no dia, o Lore lê os AI Credits dela por modelo. O GitHub aplica o desconto do uso incluído ao enterprise como um todo, então o custo líquido de cada modelo é rateado entre as pessoas na proporção do consumo bruto de cada uma, que é a forma usual de FinOps repartir um desconto compartilhado. Os créditos que o GitHub não atribui a um usuário ativo ficam não atribuídos (unattributed). Nos dois casos, cada dia soma exatamente o valor da fatura. As licenças (Business, Enterprise) não são atribuídas por usuário e aparecem como “Not per person” na visão por pessoa.
- As licenças são amortizadas a partir do total mensal do GitHub. Os valores diários de licença do GitHub não somam o mês, então o Lore usa o total de cada mês por SKU e o distribui igualmente pelos dias do mês (no mês corrente, pelos dias já decorridos, recalculado a cada sincronização). A soma dos dias é exatamente o valor mensal do GitHub.
- O custo vem do resumo de billing do GitHub (licenças, por SKU) e do uso de AI Credits (por modelo), líquido do uso incluído. São os valores que a página Billing and licensing do GitHub mostra. O valor bruto e a quantidade de AI Credits ficam registrados junto.
- No modo enterprise, o custo cobre o enterprise inteiro. O resumo de billing do GitHub não traz quebra por organização.
- As linhas usam o login do GitHub, que não é associado ao e-mail dos membros do Lore.
- O Lore sincroniza no máximo a cada 6 horas e relê os últimos 3 dias. Depois de uma sincronização com falha, tenta de novo na passada seguinte, uma hora depois. Os relatórios de métricas de uso guardam até um ano de histórico.
- Os AI Credits por usuário custam uma chamada a mais por pessoa ativa por dia. Por isso, o primeiro backfill de 90 dias de um enterprise grande pode levar mais de uma passada, e continua de onde parou. O GitHub permite cerca de 5.000 chamadas de API por hora para o dono do token. Quando essa cota acaba, o conector mostra Paused: vendor rate limit (não é um erro), mantém o progresso e continua na primeira sincronização depois que a cota do GitHub renova. Outras ferramentas que usam o token da mesma pessoa dividem essa cota.
Revogar
Apague o token em Developer settings → Personal access tokens e depois desconecte no Lore.