> 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/sessoes-spark.md).
# Sesiones de Spark
Siga, active y pause la recolección de las sesiones de Spark (Livy) de Lakehouses, Notebooks y Spark Job Definitions, que se ejecuta cada 6 horas.
La recolección de **Sesiones de Spark** lee en Microsoft Fabric las **sesiones de Spark (Livy)** de **Lakehouses**, **Notebooks** y **Spark Job Definitions** de los workspaces monitoreados y guarda el historial durante 90 días. Los indicadores, los gráficos y la lista de sesiones están en Monitoreo; esta pantalla muestra el historial de la recolección y permite activarla o pausarla.
**Cómo acceder:** *Mapeo › Operación › Sesiones de Spark*. Solo los **Administradores** acceden a la pantalla y a las acciones. En la pantalla de datos, todos los perfiles ven la línea **Recolección** con la fecha de la última ejecución; el enlace **Ver/gestionar la recolección →**, que lleva hasta aquí, aparece solo para los administradores.
Sesiones de Spark
## Para qué sirve
* Mantener actualizado el historial de sesiones de Spark usado en [Monitoreo › Sesiones de Spark](/es/power-monitor/monitoramento/sessoes-spark.md): tiempo de cola, tiempo de ejecución, fallas por día y los elementos que más sesiones consumen.
* Adelantar la recolección cuando acaba de ejecutar notebooks o jobs y quiere ver el resultado sin esperar las próximas 6 horas.
* Confirmar que la recolección está corriendo e investigar elementos que no pudieron leerse.
## Componentes de la pantalla
La pantalla tiene un encabezado (*Mapeo* y el subtítulo de la recolección) y dos tarjetas.
### Tarjeta Qué se recolecta
Describe la fuente, la frecuencia y el historial conservado (*Fuente, frecuencia y dónde aparecen los datos*) y trae, al pie, el enlace **Ver los datos recolectados en Sesiones de Spark →**, que lleva a la pantalla de datos.
### Tarjeta Ejecuciones de la recolección
La tarjeta **Ejecuciones de la recolección** (*Recolección automática cada 6 horas. Actívela manualmente si no quiere esperar.*) reúne los botones y el historial.
Ejecuciones de la recolección de sesiones de Spark
| Elemento | Para qué sirve |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ejecutar ahora** / **Reanudar** | Dispara una recolección manual. Cuando hay una ejecución **Pausada**, el botón pasa a llamarse **Reanudar** y continúa desde donde se detuvo. Funciona incluso con la recolección automática desactivada. |
| **Pausar** | Aparece solo durante una ejecución en curso. La pausa es cooperativa: aparece el aviso **Pausa solicitada: la ejecución se detiene después del próximo elemento procesado** y la ejecución pasa a **Pausada** al terminar el elemento actual. |
| Distintivos de estado | **Ejecución en curso (n)** (con barra de progreso), **Ejecución pausada** y, si el seguimiento automático termina, **Actualización automática finalizada. Recargue la página para ver el estado actual.** |
| Tabla de ejecuciones | Historial de la más reciente a la más antigua, con selector de elementos por página y paginación. |
| **Ver fallas** | Enlace en la columna **Fallas** que abre el modal **Fallas de la ejecución de {fecha}**, con **Elemento**, **Motivo** y **Detalle**. |
Columnas de la tabla:
| Columna | Contenido |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Disparo** | **Programado** o **Manual** (en las ejecuciones manuales, pase el mouse sobre el ícono 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**, **Pausada**, **Concluida**, **Falló** o **Bloqueada** |
| **Elementos procesados** | Cantidad de elementos (Lakehouses, Notebooks y Spark Job Definitions) ya recorridos por la ejecución |
| **Fallas** | Elementos que no pudieron leerse o guardarse; enlace **Ver fallas** |
| **Error** | Ícono con el mensaje de error general de la ejecución (pase el mouse) |
## Reglas y comportamiento
* **De dónde viene el dato:** API de Fabric (sesiones Livy de cada elemento), consultada con el Service Principal de la organización.
* **Qué se lee:** Lakehouses, Notebooks y Spark Job Definitions ya inventariados, no eliminados, de workspaces **monitoreados** y activos (vea [Gobernanza › Workspaces](/es/power-monitor/governanca/workspaces.md)). Los workspaces personales quedan fuera.
* **Frecuencia:** automática, **cada 6 horas**. Como se ejecuta varias veces al día, esta recolección no tiene la opción de **Frecuencia** (Diario, Semanal, Mensual). Puede desactivarse en [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md#escaneos-y-recolecciones), sección **Escaneos y Recolecciones**, grupo **Otros**, elemento **Sesiones de Spark** (viene activado por defecto). **Ejecutar ahora** funciona incluso con el interruptor desactivado.
* **Historial:** las sesiones se conservan durante **90 días**. En la primera lectura de un elemento entran las sesiones enviadas en los últimos 7 días; en las siguientes, solo lo nuevo. Las sesiones aún abiertas se vuelven a leer hasta que terminan (por hasta 7 días).
* **Límite por ejecución:** hasta **300 elementos** por ejecución, empezando por los nunca leídos y luego por los leídos hace más tiempo. Los que sobran entran en las próximas ejecuciones, así que un entorno grande se cubre en algunas rondas.
* **Elementos sin acceso:** si el Service Principal no puede leer las sesiones de un elemento (sin acceso al workspace o elemento que ya no existe), el elemento se trata como **no disponible** y **no** cuenta como falla.
* **Límite de solicitudes de Fabric:** si Fabric limita las llamadas, la ejecución termina como **Falló** con un mensaje que indica que se alcanzó el límite de solicitudes de Fabric (429) tras n de m elementos y que los demás quedan para la próxima ejecución (el mensaje se muestra en portugués). Lo ya guardado se conserva.
* **Fallas por elemento:** una falla en un elemento no tumba la recolección; se cuenta en **Fallas**, con el motivo (no se pudieron leer las sesiones de Spark del elemento, no se pudieron guardar, o una falla inesperada al procesar el elemento).
* **Bloqueada:** una ejecución sin progreso durante **10 minutos** se cierra como **Bloqueada**.
* **Concurrencia:** solo existe una ejecución activa (en curso o pausada) por organización. Al intentar disparar otra, aparece *Ya existe una ejecución en curso para esta organización.*
* **Actualización de la pantalla:** mientras hay una ejecución activa, la tabla se actualiza sola cada 20 segundos, por hasta 30 minutos.
* **Requisito previo:** Service Principal configurado y con acceso a los workspaces monitoreados. Vea [Permisos adicionales › Agregar Service Principal a los Workspaces](/es/power-monitor/configuracoes/permissoes-adicionais.md#agregar-service-principal-a-los-workspaces).
## Paso a paso
{% stepper %}
{% step %}
### Abra la pantalla de recolección
Acceda a *Mapeo › Operación › Sesiones de Spark* con una cuenta de administrador.
{% endstep %}
{% step %}
### Dispare la recolección
En la tarjeta **Ejecuciones de la recolección**, haga clic en **Ejecutar ahora**. No hay confirmación; el botón muestra **Ejecutando…** y aparece el mensaje *Ejecución en cola. El historial se actualiza cuando inicie.* 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.
{% endstep %}
{% step %}
### Haga el seguimiento
Observe el distintivo **Ejecución en curso** y la nueva fila en el historial. Si necesita interrumpirla, haga clic en **Pausar**; después use **Reanudar** para continuar.
{% endstep %}
{% step %}
### Confirme el resultado
Al terminar, Power Monitor avisa que la recolección concluyó (o que terminó con un fallo). Abra [Monitoreo › Sesiones de Spark](/es/power-monitor/monitoramento/sessoes-spark.md) mediante el enlace de la tarjeta **Qué se recolecta** y revise los datos.
{% endstep %}
{% endstepper %}
## Preguntas frecuentes
Disparé la recolección y la pantalla de Monitoreo no cambió.
Espere a que la ejecución aparezca como **Concluida** y recargue la pantalla de datos. Si la ejecución terminó con muchos elementos no disponibles, el Service Principal probablemente no tiene acceso a los workspaces; vea **Requisito previo** más arriba.
¿Por qué la recolección necesita varias ejecuciones para cubrir todo?
Cada ejecución lee como máximo 300 elementos, de los menos recientemente leídos a los más recientes. En entornos con muchos elementos, la cobertura completa lleva algunas rondas de 6 horas.
¿Puedo cambiar la frecuencia a semanal o mensual?
No. La opción de **Frecuencia** solo existe en las recolecciones que se ejecutan una vez al día. Puede desactivar la recolección en *Configuración › Monitoreo*.
La ejecución terminó como Falló con el mensaje del límite de solicitudes (429).
Fabric limitó las llamadas. No se pierde nada: los elementos restantes se leen en la próxima ejecución, en hasta 6 horas, o en un nuevo **Ejecutar ahora** más tarde.
## Páginas relacionadas
* [Monitoreo › Sesiones de Spark](/es/power-monitor/monitoramento/sessoes-spark.md)
* [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md)
* [Permisos adicionales](/es/power-monitor/configuracoes/permissoes-adicionais.md)
* [Gobernanza › Workspaces](/es/power-monitor/governanca/workspaces.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/sessoes-spark.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.
