> 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/perguntas-frequentes/duvidas-tecnicas/como-o-power-monitor-funciona-internamente.md). # Como o Power Monitor funciona internamente? Como o Power Monitor se conecta ao seu tenant, quais APIs usa, com que frequência coleta os dados e onde eles ficam. O Power Monitor é uma aplicação SaaS hospedada pela Power Tuning no **Microsoft Azure**. Ele se conecta ao seu tenant pelas **APIs oficiais da Microsoft**, usando um **aplicativo (Service Principal) registrado no seu Microsoft Entra ID**, sem instalar nada no seu ambiente. ### Arquitetura resumida ``` Seu tenant Microsoft (Power BI / Microsoft Fabric / Entra ID / Azure) │ │ APIs oficiais da Microsoft │ (autenticadas com o aplicativo do Power Monitor no seu Entra ID) ▼ Power Monitor SaaS (Microsoft Azure, operado pela Power Tuning) • scans de inventário e metadados • verificações contínuas de saúde e consumo • banco de dados isolado por organização │ │ alertas e resumos ▼ Seus canais: e-mail, Microsoft Teams, Slack, Telegram ``` ### Quais APIs o Power Monitor utiliza? | API | Para quê | | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **APIs de administração do Power BI / Fabric** (Scanner API) | Inventário de workspaces e itens, metadados de modelos semânticos, linhagem, fontes de dados, usuários com acesso, capacidades, gateways, conexões e apps | | **APIs REST do Power BI** | Histórico de atualizações de modelos semânticos, status de gateways, agendamentos | | **APIs REST do Microsoft Fabric** | Execuções de pipelines, notebooks, Copy jobs e Dataflows Gen2, Fabric Mirroring, domínios | | **Aplicativo Microsoft Fabric Capacity Metrics** (consulta ao modelo semântico dele) | Consumo das capacidades em Capacity Units | | **Activity Events do Power BI** (quando habilitado) | Eventos de atividade e visualizações de relatórios | | **Microsoft Graph** | Durante a instalação automática; e, quando concedido, leitura de usuários, grupos e membros e da validade do client secret | | **Azure Resource Manager e Cost Management** (quando concedido) | Pausar, retomar e alterar o tamanho (SKU) de capacidades e ler o custo delas | ### Com que frequência o Power Monitor verifica o ambiente? | O quê | Frequência | | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | | Inventário completo (workspaces, itens, capacidades, gateways, conexões, apps) | Na instalação e depois **diariamente**, além de scans sob demanda em **Mapeamento** | | Consumo das capacidades | A cada **5 minutos** | | Status dos gateways | A cada **5 minutos** | | Falhas de atualização de modelos semânticos | A cada **15 minutos** | | Execuções de itens do Fabric | A cada **2 horas** | | Atualização de dados e Fabric Mirroring | A cada **10 minutos** | | Eventos de atividade (Activity Events) | **Três vezes ao dia** | | Quantidade de itens para faturamento | **Uma vez por dia** | ### O acesso é somente leitura? A **coleta** é de leitura: o Power Monitor lê metadados e status. Algumas ações, porém, **alteram o seu ambiente**, sempre de forma explícita e iniciadas por um administrador: * na **instalação automática**, criar o aplicativo e o grupo de segurança no Entra ID e aplicar as configurações de locatário do Fabric; * conceder ao aplicativo acesso de administrador a workspaces, gateways e capacidades (em **Permissões Adicionais**); * **pausar, retomar e alterar o tamanho (SKU)** de capacidades (agendamentos, Auto-Scale e alteração manual); * **reprocessar atualizações** de modelos semânticos com falha e alterar agendamentos de atualização, quando um administrador pede. ### Onde os dados são armazenados? Os metadados coletados (inventário, históricos, alertas, consumo, configurações) ficam na infraestrutura da Power Tuning no **Microsoft Azure**, em banco de dados com **isolamento por organização**. As credenciais do aplicativo são **criptografadas** com chaves gerenciadas no **Azure Key Vault**. Os **dados de negócio** dos seus relatórios e modelos não são copiados. Veja [Segurança e privacidade dos dados](/perguntas-frequentes/duvidas-tecnicas/seguranca-e-privacidade.md). ### Posso revogar o acesso a qualquer momento? Sim. Remova ou desabilite o aplicativo do Power Monitor em **Microsoft Entra ID › Aplicativos empresariais** (e, se quiser, exclua o App Registration e o grupo de segurança). A partir daí, o Power Monitor deixa de conseguir coletar dados do seu tenant. Para detalhes de arquitetura, veja a [Documentação Técnica](/documentacao-tecnica/documentacao-tecnica.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/perguntas-frequentes/duvidas-tecnicas/como-o-power-monitor-funciona-internamente.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.