> 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/documentacion-tecnica/documentacao-tecnica/fluxo-de-scans.md). # Flujo de escaneos Cómo el Power Monitor recopila el inventario y los metadatos de Power BI y de Microsoft Fabric de cada organización. Los **escaneos** (*scans*) son el mecanismo mediante el cual el Power Monitor recopila y sincroniza el inventario y los metadatos del entorno Power BI / Microsoft Fabric de cada organización. Están separados del [monitoreo continuo](/es/documentacion-tecnica/documentacao-tecnica/monitoramento-continuo.md), que verifica el estado y las fallas en ciclos cortos. ## Visión general ``` Programación (diaria) o solicitud de un administrador (Mapeo) │ ▼ Cola persistente de tareas (base de datos) │ ▼ Procesador en segundo plano ── una tarea a la vez por organización │ ▼ Especificación del tipo de escaneo ──▶ APIs de Power BI / Fabric │ (Service Principal del cliente) ▼ Mapeo ▶ persistencia ▶ conciliación (elementos eliminados) ``` * Las tareas se almacenan en una **cola persistente en la base de datos**: no se pierde nada si la aplicación se reinicia. * El procesador ejecuta **como máximo una tarea por organización al mismo tiempo**, para no sobrecargar las APIs del tenant, y registra el inicio, el fin, el progreso, el resultado y los errores de cada ejecución (visibles en **Mapeo › Registros de Escaneos**). * Las tareas bloqueadas se detectan y se concilian automáticamente. ## Tipos de escaneo de inventario | Tipo | Qué recopila | | ---------------------------------------------- | -------------------------------------------------------------------------------------------- | | **Full** | Todos los workspaces (excepto los personales) y todos los elementos, mediante la Scanner API | | **Incremental** | Solo los workspaces modificados desde el último escaneo | | **Capacity** | Capacidades Fabric, Premium y Embedded y sus administradores | | **Gateway** | Gateways de datos | | **Connection** | Conexiones (orígenes de datos) del tenant | | **App** | Aplicaciones de Power BI y sus informes | | **DatasetConnection** / **DataflowConnection** | Relación entre modelos semánticos/dataflows y conexiones | Además de estos, hay recopilaciones especializadas: tamaño de los modelos (VertiPaq, mediante XMLA), estructura de informes, mapeo de modelos, dominios, eventos de actividad, costo de capacidad, métricas de consumo por elemento, programaciones de elementos de Fabric y ejecuciones de Dataflows Gen1. ## Cuándo se ejecutan los escaneos | Momento | Qué sucede | | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Fin de la instalación** | Escaneos de capacidades, inventario completo (de los workspaces elegidos), gateways, conexiones, apps y relaciones modelo × conexión | | **Diariamente** (03:00 UTC) | Los mismos escaneos, de forma automática | | **A demanda** | Un administrador puede iniciar escaneos en **Mapeo** (por ejemplo, la pantalla **Inventario**, para workspaces seleccionados) | | **Recopilaciones especializadas** | En horarios propios: mapeo de modelos (diario, 03:26 UTC), tamaño de modelos y estructura de informes (diarios, 01:16 y 01:50 UTC), dominios (diario, 09:15 UTC), eventos de actividad (3 veces al día: 04:22, 11:22 y 21:22 UTC), costo de capacidad (diario, 08:27 UTC), ejecuciones de Dataflows Gen1 (cada 2 horas) | ## Integración con la Scanner API El escaneo completo utiliza las APIs de administración de Power BI (Scanner API): 1. **Lista los workspaces** del tenant (`GET /v1.0/myorg/admin/groups`, solo workspaces colaborativos). En el escaneo incremental, utiliza `GET /v1.0/myorg/admin/workspaces/modified`. 2. Envía **lotes de hasta 100 workspaces** a `POST /v1.0/myorg/admin/workspaces/getInfo`, con las opciones `lineage`, `datasourceDetails`, `datasetSchema`, `datasetExpressions` y `getArtifactUsers`. 3. **Supervisa el estado** de cada lote (`GET .../admin/workspaces/scanStatus/{scanId}`) hasta su finalización. 4. **Obtiene el resultado** (`GET .../admin/workspaces/scanResult/{scanId}`) y mapea cada tipo de elemento al modelo de datos del Power Monitor. {% hint style="info" %} Las opciones de metadatos detallados y de expresiones DAX/M dependen de la configuración de inquilino **Enhance admin APIs responses with detailed metadata** y **Enhance admin APIs responses with DAX and mashup expressions**. Consulte [Requisitos previos](/es/documentacion-tecnica/instalacao/pre-requisitos.md). {% endhint %} ## Reglas importantes * **Workspaces monitoreados:** el escaneo detallado de los elementos ignora los workspaces marcados como no monitoreados. Los workspaces **nuevos**, descubiertos por el propio escaneo, se recopilan en la misma ejecución; si la organización utiliza la selección de workspaces (el comportamiento predeterminado), nacen **no monitoreados** y quedan fuera de las pantallas, de las alertas y de la facturación hasta que un administrador los incluya. Recopilar no es lo mismo que contabilizar. * **Escaneo acotado:** cuando un administrador elige workspaces específicos, estos pasan a ser monitoreados. * **Elementos eliminados:** en cada ciclo, el inventario del tenant se compara con el registrado. Un elemento que desaparece se **marca como eliminado**, deja de contabilizarse en todas las pantallas y en la facturación y pasa a aparecer en **Gobernanza › Operación › Artefactos Eliminados**, con la fecha en que se detectó la eliminación. * **Credenciales:** las llamadas utilizan el Service Principal de la organización (flujo *client credentials*). Los escaneos iniciados manualmente por un administrador pueden usar su token delegado, cuando está disponible, con retorno automático al Service Principal. ## Páginas relacionadas * [Monitoreo continuo](/es/documentacion-tecnica/documentacao-tecnica/monitoramento-continuo.md) * [Modelo de datos](/es/documentacion-tecnica/documentacao-tecnica/modelo-de-dados.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/documentacion-tecnica/documentacao-tecnica/fluxo-de-scans.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.