> For the complete documentation index, see [llms.txt](https://docs.powermonitor.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powermonitor.com.br/es/power-monitor/mapeamento/git-dos-workspaces.md).
# Git de los workspaces
Siga, dispare, pause y reanude la recolección, cada 6 horas, del estado Git de los workspaces: conexión con el repositorio, elementos sin confirmar, atrasados y en conflicto.
La pantalla **Git de los workspaces** de Mapeo controla la recolección que lee, para cada workspace monitoreado, **si está conectado a un repositorio Git** y **cuántos elementos difieren de la rama**: con cambios aún sin confirmar, atrasados respecto a la rama o en conflicto. La lista y los indicadores están en Gobernanza; esta pantalla muestra el historial de la recolección y permite dispararla, pausarla y reanudarla.
**Cómo acceder:** *Mapeo › Operación › Git de los workspaces*. Solo los **Administradores** acceden a la pantalla y a las acciones. En la pantalla de Git de los workspaces de Gobernanza, los demás perfiles ven únicamente la línea de estado **Recolección**, sin el enlace a esta pantalla.
Git de los workspaces
## Para qué sirve
* Confirmar que el estado Git de los workspaces se está recolectando cada 6 horas y si la última recolección terminó bien.
* Actualizar el estado al momento, después de conectar un workspace a Git, hacer un commit o resolver un conflicto.
* Descubrir cuántos workspaces la recolección no logró leer y por qué.
## Componentes de la pantalla
La pantalla tiene dos tarjetas: **Qué se recolecta** y **Ejecuciones de la recolección** ("Recolección automática cada 6 horas. Dispárala manualmente si no quieres esperar.").
### Qué se recolecta
**Qué es:** tarjeta con la descripción de la recolección y, en el pie, el enlace **Ver los datos recolectados en Git de los workspaces →**, que lleva a la pantalla de Gobernanza.
### Ejecutar ahora / Reanudar
**Qué es:** botón que dispara una recolección manual. Cuando existe una recolección **Pausada**, el mismo botón pasa a llamarse **Reanudar** y continúa desde donde se detuvo.
**Para qué sirve:** reflejar al instante, en [Gobernanza › Operación › Git de los workspaces](/es/power-monitor/governanca/operacao/git-dos-workspaces.md), la situación actual de los workspaces.
**Cómo usar:**
1. Haga clic en **Ejecutar ahora**. No hay modal de confirmación; el botón muestra **Ejecutando…** mientras envía la solicitud.
2. El mensaje **Ejecución en cola. El historial se actualiza cuando inicie.** lo confirma; si ya hay una recolección en curso, aparece **Ya existe una ejecución en curso para esta organización.** Mientras el servicio de recolección no toma la ejecución, el botón muestra **En cola** y la tarjeta avisa *Ejecución en cola, esperando el inicio…*; después, el botón pasa a **En curso** y la barra muestra los elementos procesados (por ejemplo, *12 de 40*) y el tiempo restante estimado (*\~3 min restantes*). La pantalla sigue la ejecución hasta el final, sin recargar.
3. Siga el indicador **Ejecución en curso** y la fila en el historial hasta **Concluida**.
Para reanudar una recolección pausada, haga clic en **Reanudar** (**Reanudando…**). El mensaje **Ejecución reanudada con éxito.** lo confirma.
**Cómo funciona / reglas:**
* Funciona incluso con la ejecución automática desactivada.
* Solo hay una recolección activa (en curso o pausada) por organización.
### Pausar
**Qué es:** botón que aparece solo mientras hay una recolección en curso y pide que se detenga.
**Para qué sirve:** interrumpir temporalmente una recolección larga, por ejemplo en organizaciones con muchos workspaces, sin perder lo que ya se leyó.
**Cómo usar:**
1. Durante la recolección, haga clic en **Pausar** (**Pausando…**). Aparece el indicador **Pausa solicitada: la ejecución se detiene después del próximo elemento procesado**.
2. La ejecución pasa a **Pausada** y el botón principal se convierte en **Reanudar**.
3. Haga clic en **Reanudar** para continuar desde donde se detuvo.
**Cómo funciona / reglas:** la pausa es cooperativa: el workspace en procesamiento termina y la recolección se detiene en el siguiente. Una recolección pausada no expira. Al reanudar, solo se leen los workspaces aún no verificados en la ejecución.
### Indicadores de estado de la recolección
En la parte superior de la tarjeta aparecen los indicadores **Ejecución en curso (n)** (azul, con indicador giratorio), **Ejecución pausada** (amarillo) y **Pausa solicitada…** (gris). Durante una recolección en curso, aparece una barra de progreso animada sobre la tabla. Si la actualización automática de la pantalla se interrumpe después de mucho tiempo, aparece **Actualización automática finalizada. Recargue la página para ver el estado actual.**
### Historial de ejecuciones
**Qué es:** tabla paginada (10 por página; el selector **Elementos por página**, debajo de la tabla, ofrece 10, 25, 50 o 100) con las ejecuciones, de la más reciente a la más antigua.
Historial de ejecuciones
| Columna | Contenido |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Disparo** | **Programado** o **Manual** (en ejecuciones manuales, pase el mouse sobre el icono de persona para ver quién la disparó) |
| **Inicio** / **Fin** / **Duración** | Horarios de la ejecución (sin fin ni duración mientras está activa) |
| **Estado** | **En curso** (azul), **Pausada** (amarillo), **Concluida** (verde), **Falló** (rojo), **Bloqueada** (amarillo) |
| **Elementos procesados** | Cantidad de workspaces leídos |
| **Fallas** | Workspaces con error; enlace **Ver fallas** |
| **Error** | Icono con el mensaje de error general de la ejecución (pase el mouse) |
Mientras hay una recolección activa, la tabla se actualiza automáticamente cada 20 segundos. Sin ejecuciones, aparece **Ninguna ejecución registrada todavía**.
### Ver fallas
**Qué es:** enlace en la columna **Fallas** que abre el modal **Fallas de la ejecución de {date}**, con las columnas **Elemento** (nombre del workspace e identificador), **Motivo** y **Detalle**.
Fallas de la ejecución
**Cómo usar:** haga clic en **Ver fallas** en la ejecución (disponible cuando terminó con fallas), lea el **Motivo** y el **Detalle** de cada workspace y haga clic en **Cerrar**. Si la ejecución no guardó el detalle, aparece **Ningún detalle disponible para esta ejecución.** Cuando hay muchas fallas, el final de la lista muestra **y n más no listadas**.
## Reglas y comportamiento
* **De dónde viene el dato:** API de Fabric (conexión Git y estado Git de cada workspace), con el Service Principal de la organización.
* **Frecuencia automática:** cada **6 horas** (a las 03:55, 09:55, 15:55 y 21:55, hora de Brasilia), para organizaciones activas con Service Principal configurado. Puede desactivarse en *Configuración › Monitoreo › Escaneos y Recolecciones*, grupo **Otros** (**Estado Git de los workspaces**). Como se ejecuta varias veces al día, este escaneo **no tiene la opción de Frecuencia** (**Diario**/**Semanal**/**Mensual**). **Ejecutar ahora** funciona incluso con el interruptor desactivado.
* **Qué workspaces se leen:** los workspaces **monitoreados**, activos y no eliminados.
* **Recuentos de elementos, no de commits:** los números son de **elementos** del workspace. Fabric no informa la cantidad de commits.
* **Resultado por workspace:** cada workspace termina como **Leído**, **Sin Git** (no está conectado a un repositorio), **No disponible** o **Error**. **No disponible** no es una falla: ocurre, por ejemplo, cuando el Service Principal no ve el workspace, el workspace no está en una capacidad o Fabric exige las credenciales Git del propio solicitante, que un Service Principal normalmente no tiene. Solo **Error** cuenta en la columna **Fallas**.
* **Límite de solicitudes:** si Fabric responde que se alcanzó el límite de solicitudes (429), la ejecución termina como **Falló** con el mensaje del punto en que se detuvo, lo que ya se leyó se conserva y la próxima recolección comienza por los workspaces menos recientes.
* **Bloqueada:** una recolección sin progreso durante **10 minutos** se cierra como **Bloqueada**.
* **Concurrencia:** una recolección activa (en curso o pausada) por organización.
### Permisos necesarios
El Service Principal debe estar en el workspace con el rol **Colaborador** o superior para que Fabric devuelva la conexión y el estado Git. Los workspaces en los que no tiene acceso aparecen como **No disponible** en la pantalla de Gobernanza.
## Paso a paso
{% stepper %}
{% step %}
### Abra la pantalla
En *Mapeo › Operación › Git de los workspaces* (o por el enlace **Ver/gestionar la recolección →** en la pantalla de Gobernanza).
{% endstep %}
{% step %}
### Dispare la recolección
Haga clic en **Ejecutar ahora** y siga el indicador **Ejecución en curso** hasta que la fila del historial quede **Concluida**.
{% endstep %}
{% step %}
### Verifique las fallas
Si la columna **Fallas** es mayor que cero, haga clic en **Ver fallas** y lea el **Motivo** y el **Detalle**.
{% endstep %}
{% step %}
### Vea los datos
Haga clic en **Ver los datos recolectados en Git de los workspaces →** para abrir la lista en Gobernanza.
{% endstep %}
{% endstepper %}
## Errores comunes y cómo resolverlos
| Mensaje / síntoma | Cómo resolver |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Estado **Falló** con mensaje de límite de solicitudes (429) | Espere y haga clic en **Ejecutar ahora** de nuevo; la recolección continúa por los workspaces menos recientes. |
| Workspaces **No disponible** en Gobernanza | No es una falla. Agregue el Service Principal al workspace (Colaborador o superior) si desea leer el estado. |
| Estado **Bloqueada** | La ejecución dejó de progresar. Haga clic en **Ejecutar ahora** de nuevo. |
| **Service Principal no configurado** | Complete la configuración del Service Principal en *Configuración*. |
## Preguntas frecuentes
¿Dónde veo el estado Git de cada workspace?
En [Gobernanza › Operación › Git de los workspaces](/es/power-monitor/governanca/operacao/git-dos-workspaces.md), disponible para todos los perfiles (respetando el alcance de workspaces de cada usuario). Esta pantalla muestra solo las ejecuciones de la recolección.
Ninguno de mis workspaces usa Git. ¿Necesito esta recolección?
No. Los workspaces sin Git quedan como **Sin Git**. Si prefiere, desactive la recolección en *Configuración › Monitoreo › Escaneos y Recolecciones*.
¿Por qué el recuento de cambios es de elementos y no de commits?
Porque la API de Fabric no informa commits: lista los elementos cuyo contenido difiere entre el workspace y la rama.
## Páginas relacionadas
* [Gobernanza › Operación › Git de los workspaces](/es/power-monitor/governanca/operacao/git-dos-workspaces.md)
* [Gobernanza › Workspaces](/es/power-monitor/governanca/workspaces.md)
* [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md)
* [Registros de Escaneos](/es/power-monitor/mapeamento/logs-de-scans-e-re-execucoes.md)
* [Mapeo](/es/power-monitor/mapeamento.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.powermonitor.com.br/es/power-monitor/mapeamento/git-dos-workspaces.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
