> 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/modelo-de-dados.md).

# Modelo de datos

Principales entidades del modelo de datos del Power Monitor y los artefactos de Power BI / Fabric que rastrea.

Esta página describe, a nivel conceptual, la información principal que el Power Monitor almacena sobre cada organización. Todos los datos se guardan en PostgreSQL, con fechas en UTC.

## Aislamiento por organización

* Toda entidad con datos de clientes pertenece a **una organización** (identificador de la organización registrado en cada registro).
* Los identificadores son **GUIDs generados por la aplicación**.
* El **tenant de Entra ID** y la **organización del Power Monitor** son identificadores diferentes: el tenant se utiliza para descubrir la organización en el inicio de sesión; a partir de ahí, todas las consultas se filtran por la organización.

## Entidades principales

### Organización

Representa a un cliente (un tenant de Microsoft Entra ID).

| Información                   | Descripción                                                                                                      |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Tenant de Entra ID            | Tenant al que está vinculada la organización                                                                     |
| Datos de registro             | Nombre comercial, razón social, CPF/CNPJ o número de registro, país, moneda, teléfono, WhatsApp                  |
| Credenciales de la aplicación | Client ID, Client Secret y grupo de seguridad, **cifrados** (sobre AES-256 + RSA en Azure Key Vault)             |
| Tipo de instalación           | Automática, manual o heredada                                                                                    |
| Estado                        | **Incomplete** (instalación en curso), **Active** o **Suspended**                                                |
| Aceptaciones                  | Términos de uso y consentimiento del cobro automático (con fecha/hora y versión del texto)                       |
| Preferencias                  | Selección de workspaces monitoreados (curaduría), monitoreos activados, proveedor de IA, canales de notificación |

### Usuario y perfil

| Información           | Descripción                                                                                                                     |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Usuario               | Cuenta Microsoft del tenant, rol (**Usuario** o **Administrador**), perfil y límite mensual de uso de IA                        |
| Perfil                | Conjunto de páginas bloqueadas; tres perfiles predeterminados por organización (Admin, Member, Audit) y perfiles personalizados |
| Alcance de workspaces | Workspaces que el usuario **puede ver** y de los que **recibe alertas**                                                         |

### Workspace

| Información           | Descripción                                                                       |
| --------------------- | --------------------------------------------------------------------------------- |
| Identificador remoto  | ID del workspace en Power BI / Fabric                                             |
| Nombre, tipo y estado | Estado activo, eliminado, huérfano, etc.                                          |
| Capacidad y dominio   | Capacidad y dominio de Fabric a los que pertenece                                 |
| Monitoreado           | Si el workspace está en el monitoreo (define pantallas, alertas y facturación)    |
| Eliminación detectada | Fecha en que el Power Monitor detectó la eliminación en el tenant                 |
| Gobernanza            | Responsable, responsable del área de negocio, área, subárea y nivel de criticidad |

### Artefactos (elementos)

**34 tipos de elemento** de workspace, cada uno con referencia al workspace, metadatos recopilados por la Scanner API y fecha de eliminación detectada:

| Categoría                 | Tipos                                                                                                                                   |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Power BI**              | Report, Dataset (modelo semántico), Dashboard, Dataflow, Datamart                                                                       |
| **Almacenamiento**        | Lakehouse, Warehouse, SQL Database, Mirrored Database, KQL Database, Eventhouse                                                         |
| **Ingeniería de datos**   | Notebook, Data Pipeline, Copy Job, Spark Job Definition, Apache Airflow Job, dbt Job, Environment, User Data Function, Variable Library |
| **Ciencia de datos e IA** | ML Model, ML Experiment, Data Agent                                                                                                     |
| **Tiempo real**           | Eventstream, KQL Dashboard, KQL Queryset, Reflex (Activator), Event Subscription                                                        |
| **Otros**                 | Exploration, Metric Set, Org App, Ontology, Graph Model, App Backend                                                                    |

Los modelos semánticos también guardan tablas, columnas, medidas, expresiones, orígenes de datos, tamaño y programaciones.

**Recursos a nivel de tenant:** capacidades, gateways, conexiones y aplicaciones de Power BI. **Relaciones derivadas:** modelo semántico × conexión, dataflow × conexión, app × informe y el linaje entre elementos.

### Tareas y programaciones

| Información                 | Descripción                                                                                                                                                                                                                                                         |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tarea                       | Tipo de escaneo o de monitoreo, estado (**Pending**, **Running**, **Completed**, **Failed**, **Cancelled**), expresión cron para tareas recurrentes, próxima y última ejecución, progreso, resultado, mensaje de error e intentos (hasta 3 de forma predeterminada) |
| Programaciones de capacidad | Pausa/reanudación, cambio de SKU, regla de escalado automático y alertas de horario                                                                                                                                                                                 |

### Monitoreo

| Información                                | Descripción                                                                                                                         |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Estado de salud del recurso                | Estado actual (Unknown, Healthy, Degraded, Unhealthy), incidente abierto, inicio y duración, recuento de fallas y de notificaciones |
| Historial de actualizaciones y ejecuciones | Actualizaciones de modelos semánticos y ejecuciones de elementos de Fabric, con estado, duración y error                            |
| Consumo de las capacidades                 | Series de uso interactivo, en segundo plano y acumulado, por capacidad, elemento y operación                                        |
| Anomalías                                  | Líneas base y desviaciones de consumo por elemento                                                                                  |
| Costos                                     | Costo diario por capacidad                                                                                                          |
| Alertas                                    | Tipo, recurso de origen, severidad, mensaje, fecha/hora y envío                                                                     |

### Auditoría

| Información              | Descripción                                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Eventos de actividad     | Eventos de Power BI/Fabric (cuando la recopilación está habilitada): usuario, operación, elemento, workspace, IP y ubicación estimada   |
| Eventos de la aplicación | Acciones de los usuarios en el Power Monitor: evento, recurso, ruta, usuario, IP, navegador, valores anteriores y nuevos, éxito o falla |
| Registro de correos      | Correos enviados por la plataforma                                                                                                      |
| Acciones de capacidad    | Pausas, reanudaciones y escalados ejecutados, con el origen (manual, programado o automático)                                           |

### Facturación

| Información          | Descripción                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Datos de facturación | Datos fiscales, correos de cobro, vencimiento, recurrencia, pago en cuotas de la tarifa de adhesión                            |
| Medición diaria      | Cantidad de elementos monitoreados por día (con la lista de elementos contabilizados), marcando los días del período de prueba |
| Cobros               | Mensualidades y cuotas de la tarifa de adhesión, con valores bruto, descuento y neto y el estado de envío y pago               |

## Fechas y horarios

Todas las fechas se almacenan como instantes en **UTC** (`timestamptz`), utilizando la biblioteca NodaTime en el backend, lo que evita ambigüedades de zona horaria entre organizaciones de distintos países.

## Páginas relacionadas

* [Visión general de la arquitectura](/es/documentacion-tecnica/documentacao-tecnica/visao-geral.md)
* [Flujo de escaneos](/es/documentacion-tecnica/documentacao-tecnica/fluxo-de-scans.md)
* [¿Qué se contabiliza como artefacto?](/es/perguntas-frequentes/licenciamento/o-que-e-contado-como-artefato.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/modelo-de-dados.md?ask=<question>&goal=<user_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.