> 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/operacoes-de-deploy.md).
# Operaciones de despliegue
Siga, dispare, pause y reanude la recolección diaria de las operaciones de despliegue de los pipelines de implementación, conservadas durante 180 días.
La pantalla **Operaciones de despliegue** de Mapeo controla la recolección que lee, todos los días, las **operaciones de despliegue más recientes de cada pipeline de implementación** de Fabric y las acumula durante **180 días**. Esa recolección alimenta el Historial de despliegues de Gobernanza. Esta pantalla muestra el historial de la recolección y permite dispararla, pausarla y reanudarla.
**Cómo acceder:** *Mapeo › Operación › Operaciones de despliegue*. Solo los **Administradores** acceden a la pantalla y a las acciones. En la pantalla de Historial de despliegues de Gobernanza, los demás perfiles ven únicamente la línea de estado **Recolección**, sin el enlace a esta pantalla.
Operaciones de despliegue
## Para qué sirve
* Confirmar que las operaciones de despliegue de los pipelines se están recolectando y que la última recolección terminó bien.
* Registrar al momento un despliegue recién hecho, sin esperar la recolección diaria.
* Descubrir por qué algún pipeline no aparece en el Historial de despliegues.
## Componentes de la pantalla
La pantalla tiene dos tarjetas: **Qué se recolecta** y **Ejecuciones de la recolección** ("Recolección diaria automática. 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 Historial de despliegues →**, 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:** ver al instante, en [Gobernanza › Operación › Historial de despliegues](/es/power-monitor/governanca/operacao/historico-de-deploys.md), los despliegues hechos desde la última recolección.
**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 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 pipeline en procesamiento termina y la recolección se detiene en el siguiente. Una recolección pausada no expira.
### 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.
### 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 pipelines leídos |
| **Fallas** | Pipelines 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**, **Motivo** y **Detalle**.
**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 elemento 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:** primero la Admin API de Power BI, para listar los pipelines de implementación del tenant; después la API de pipelines de Power BI, para leer las operaciones de despliegue de cada pipeline. Power Monitor no guarda los pipelines en sí, solo las operaciones.
* **Frecuencia automática:** una vez al día, a las **06:45** (hora de Brasilia), para organizaciones activas con Service Principal configurado. En *Configuración › Monitoreo › Escaneos y Recolecciones*, grupo **Otros**, el escaneo aparece como **Operaciones de despliegue de los pipelines**: allí puede desactivarlo y elegir la **Frecuencia** (**Diario**, **Semanal** o **Mensual**), con la **Próxima ejecución prevista** y la **Última ejecución**. **Ejecutar ahora** funciona incluso con el interruptor desactivado y no cambia la frecuencia configurada. Vea [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md).
* **Ventana de 20 operaciones:** la API devuelve, como máximo, las **20 operaciones más recientes de cada pipeline**. Un pipeline con más de 20 despliegues entre dos recolecciones pierde los más antiguos: el historial es una acumulación de mejor esfuerzo, no un registro completo. Por eso, en pipelines muy activos, la recolección más frecuente (**Diario**) es la más indicada.
* **Retención:** las operaciones se conservan durante **180 días**; las más antiguas se eliminan.
* **Pipelines sin acceso:** Power Monitor solo puede leer las operaciones de los pipelines a los que el Service Principal tiene acceso. Los pipelines sin acceso se ignoran y **no cuentan como falla**.
* **Límite de solicitudes:** si la API responde que se alcanzó el límite (429), la ejecución termina como **Falló** con el mensaje del punto en que se detuvo; lo que ya se guardó se conserva.
* **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.
### Permiso necesario
Para listar los pipelines se requiere la configuración de tenant **Las entidades de servicio pueden acceder a las API de administración de solo lectura**, habilitada para un grupo de seguridad que contenga el Service Principal. Si Fabric rechaza el listado (403), la ejecución termina como **Falló** con orientación para habilitar esa configuración. Para leer las operaciones, el Service Principal necesita acceso al propio pipeline. Power Monitor nunca modifica estas configuraciones automáticamente.
## Paso a paso
{% stepper %}
{% step %}
### Abra la pantalla
En *Mapeo › Operación › Operaciones de despliegue* (o por el enlace **Ver/gestionar la recolección →** en Historial de despliegues).
{% 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 despliegues
Haga clic en **Ver los datos recolectados en Historial de despliegues →**.
{% endstep %}
{% endstepper %}
## Errores comunes y cómo resolverlos
| Mensaje / síntoma | Cómo resolver |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Estado **Falló** que orienta a habilitar la configuración de administrador para Service Principals | Habilite **Las entidades de servicio pueden acceder a las API de administración de solo lectura** para el grupo del Service Principal, espere la propagación y ejecute de nuevo. |
| Estado **Falló** por límite de solicitudes (429) | Espere y haga clic en **Ejecutar ahora** de nuevo. |
| Un pipeline no aparece en el Historial de despliegues | Puede que el Service Principal no tenga acceso a él, o que el pipeline no haya tenido despliegues recientes. |
| Estado **Bloqueada** | La ejecución dejó de progresar. Haga clic en **Ejecutar ahora** de nuevo. |
## Preguntas frecuentes
¿Dónde veo las operaciones de despliegue recolectadas?
En [Gobernanza › Operación › Historial de despliegues](/es/power-monitor/governanca/operacao/historico-de-deploys.md), disponible para todos los perfiles (respetando el alcance de workspaces de cada usuario). Esta pantalla muestra solo las ejecuciones de la recolección.
Hice un despliegue hace más de 180 días y desapareció. ¿Es un error?
No. La retención es de 180 días.
¿Por qué faltan despliegues de un pipeline muy usado?
La API de Power BI devuelve solo las 20 operaciones más recientes de cada pipeline. Si hubo más de 20 despliegues entre dos recolecciones, las más antiguas no se pueden recuperar. Mantenga la **Frecuencia** en **Diario**.
## Páginas relacionadas
* [Gobernanza › Operación › Historial de despliegues](/es/power-monitor/governanca/operacao/historico-de-deploys.md)
* [Gobernanza › Operación › Canalizaciones de Implementación](/es/power-monitor/governanca/operacao/pipelines-de-implantacao.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/operacoes-de-deploy.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.
