Esta guía proporciona instrucciones paso a paso para implementar el Panel de Métricas de Copilot en tu entorno.
English | Espanol
Para usar este informe, asegúrate de tener instalado Power BI Desktop o acceso al servicio en línea de Power BI.
Este informe es compatible con los productos Copilot Business y Copilot Enterprise, utilizando las API de Gestión de Usuarios y Métricas de GitHub Copilot. La API de Métricas de Copilot estuvo disponible a partir del 30 de octubre de 2024. Para más información, lee aquí.
Puedes instalar la aplicación desde AppSource. Alternativamente, busca "GitHub Copilot Metrics" y haz clic en Get it now.
El asistente de instalación de la aplicación te guiará a través del proceso de configuración en el servicio Power BI.
El informe requiere los siguientes parámetros:
| Parámetro | Descripción | Tipo | Requerido | Valor Predeterminado |
|---|---|---|---|---|
| Enterprise | Tu slug de GitHub Enterprise | Texto | Sí | - |
| OrganizationList | Lista de organizaciones separadas por comas (preferiblemente < 10). Opcional. Deja vacío si no es necesario o simplemente escribe null. | Texto | No | null |
| GitHubAPI | El prefijo del endpoint para la API de GitHub | Texto | Sí | https://api.github.com |
Para conectarte a tus datos de GitHub, se requiere autenticación y autorización. Para la autenticación, selecciona Básica y proporciona tu nombre de usuario y contraseña.
| Autenticación | Detalles |
|---|---|
| Tipo | Básica |
| Nombre de Usuario | proporciona tu nombre de usuario (handle de GitHub) |
| Contraseña | proporciona tu token PAT (lee la sección An external link was removed to protect your privacy. para más detalles) |
| Nivel de Privacidad | Pública |
[!NOTA] Por favor, usa el nivel de privacidad Pública. Esto no significa que tu panel será accesible públicamente. Si encuentras errores durante la actualización, como "Se necesita información para combinar datos. Por favor, especifica un nivel de privacidad para cada fuente de datos.", intenta cambiar el nivel de privacidad a Organización o Ninguno. Aprende más sobre los niveles de privacidad.
Para leer los datos de Copilot, necesitas ser administrador de la organización. Crea un token de acceso personal (PAT) clásico con los siguientes permisos y alcances:
| Alcance | Permisos |
|---|---|
| admin:org | read:org |
| admin:enterprise | read:enterprise, manage_billing:enterprise |
| copilot | manage_billing:copilot |
Para más información sobre la creación de PATs, consulta la documentación de GitHub.
[!NOTA] La cuenta de usuario desde la cual estás creando el token PAT necesita tener acceso a los endpoints de la API que el panel estará consultando. Esto significa acceso de lectura a la empresa y acceso de lectura a cada una de las organizaciones que tienen asientos de Copilot para los endpoints a continuación.
Aquí hay una lista de los endpoints de la API que el panel utiliza. Debes asegurarte de que el token pueda consultar todos estos endpoints:
| Alcance | Endpoint |
|---|---|
| Enterprise | Obtener métricas de Copilot para una empresa |
| Enterprise | Listar todas las asignaciones de asientos de Copilot para una empresa |
| Enterprise | Listar licencias consumidas por la empresa |
| Enterprise | Obtener committers activos de GitHub Advanced Security para una empresa |
| Organization | Obtener métricas de Copilot para una organización (para cada organización con asientos de Copilot) |
Aquí hay algunos mensajes de error y algunos consejos para solucionarlos:
-
Mensaje de Error: La expresión hizo referencia a una relación entre CopilotEnterpriseStats[enterprise] y ‹oii>EnterpriseLicenses|enterprise], que no contiene datos porque necesita ser recalculada.
-
Consejos para Solucionar: Esto puede deberse a una política de Empresa u Organización. Asegúrate de haber habilitado la política para Acceso a la API de Métricas de Copilot a nivel de Empresa en Configuración de Empresa > Políticas > Copilot > Políticas
- Mensaje de Error: La columna total_seats en la tabla CopilotEnterpriseStats contiene un valor duplicado 23 y esto no está permitido para columnas en el lado uno de una relación muchos-a-uno o para columnas que se utilizan como clave primaria de una tabla.
- Consejos para Solucionar: Es probable que no estés utilizando la última versión de la aplicación. Actualiza la aplicación desde AppSource.
Las filas filtradas hacen referencia a otras consultas o pasos... Por favor, reconstruye esta combinación de datos
- Mensaje de Error: Error de fuente de datos{"error":{"code":"ModelRefresh_ShortMessage_ProcessingError","pbi.error":{"code":"ModelRefresh_ShortMessage_ProcessingError","parameters":{},"details":[{"code":"Message","detail":{"type":1,"value":"[No se puede combinar datos] Section1/PolicyBased_36686F87_B3FA_4760_A613_9C6D47A37170/Filtered Rows hace referencia a otras consultas o pasos, por lo que no puede acceder directamente a una fuente de datos. Por favor, reconstruye esta combinación de datos."}}],"exceptionCulprit":1}}}
- Consejos para Solucionar: Es probable que estés utilizando un nivel de privacidad que impide que los datos de una tabla se combinen con otra. Cambia el Nivel de Privacidad de tus credenciales de autenticación a Pública.
Visita la Comunidad de GitHub (categoría Copilot) y publica tus preguntas para obtener ayuda.