> 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/power-monitor/qualidade-de-dados.md). # Qualidade de Dados Visão geral do módulo Qualidade de Dados: Raio-X do Ambiente, linhagem, dicionário, scores de boas práticas (modelos e relatórios) e de IA, inventário do ambiente, raio-x de workspace e exposição de d O módulo **Qualidade de Dados** é a parte do Power Monitor que olha **para dentro** dos seus modelos semânticos e relatórios: como foram construídos, de onde vêm os dados, quem os consome, se seguem boas práticas, se estão prontos para IA e se há credenciais expostas no código. Ele traz também o **Raio-X do Ambiente**, um diagnóstico geral que reúne em uma só tela os problemas da organização inteira. Enquanto **Governança** mostra o inventário de artefatos e **Monitoramento** mostra consumo e execução, a Qualidade de Dados responde perguntas como: * "Qual é a saúde geral do meu ambiente e o que devo corrigir primeiro?" * "Se eu mudar esta tabela no banco de origem, quais modelos e relatórios quebram?" * "Este modelo está bem documentado para o Copilot responder perguntas sobre ele?" * "Este relatório segue as boas práticas de design, governança e acessibilidade?" * "Existe senha ou token escrito direto no Power Query de algum modelo?" **Como acessar:** menu lateral **Qualidade de Dados**. As telas do módulo são de **leitura** e ficam disponíveis para qualquer perfil de usuário (Administrador ou Usuário), com uma exceção: o **Raio-X do Ambiente** é exclusivo de **Administradores**. Os dados exibidos respeitam o **escopo de workspaces** do seu usuário: se um administrador restringiu a sua visibilidade a alguns workspaces, você verá apenas os modelos, relatórios e itens desses workspaces. Um administrador também pode ocultar páginas específicas para um usuário em **Usuários**; o bloqueio vale também para as consultas feitas pelas APIs do produto. O perfil predefinido **Audit** vem com as telas deste módulo bloqueadas (um administrador pode liberá-las em **Usuários**). ## As telas do módulo | Tela | O que responde | | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | [Linhagem de Dados](/power-monitor/qualidade-de-dados/linhagem-de-dados.md) | De onde vêm os dados de um modelo e quem os consome (fontes, gateways, relatórios, apps e modelos compostos) | | [Raio-X do Ambiente](/power-monitor/qualidade-de-dados/raio-x-do-ambiente.md) | Diagnóstico geral da organização: nota de 0 a 100 e problemas por gravidade em seis áreas, com o link para resolver cada um (somente Administradores) | | [Dicionário de Dados](/power-monitor/qualidade-de-dados/dicionario-de-dados.md) | A partir de um objeto físico (gateway, servidor, banco, tabela, coluna), quais modelos e relatórios o usam | | [Score de Boas Práticas](/power-monitor/qualidade-de-dados/score-de-boas-praticas-bpa.md) | Aderência de um modelo a 55 regras de boas práticas (Best Practice Analyzer, diretrizes da Microsoft e heurísticas do Power Monitor) | | [Score de Boas Práticas de Relatórios](/power-monitor/qualidade-de-dados/score-de-boas-praticas-de-relatorios.md) | Aderência de um relatório a 61 regras de design de páginas, vínculo com os dados, governança, ciclo de vida e acessibilidade | | [Score de IA](/power-monitor/qualidade-de-dados/score-de-ia.md) | Quão preparado um modelo está para Copilot e perguntas em linguagem natural | | [Inventário do Ambiente](/power-monitor/qualidade-de-dados/inventario-do-ambiente.md) | Uma linha por modelo semântico do tenant, com dezenas de métricas de estrutura, saúde, uso e scores | | [Raio-X de Workspace](/power-monitor/qualidade-de-dados/raio-x-de-workspace.md) | Quantos artefatos de cada tipo existem em cada workspace | | [Exposição de Dados](/power-monitor/qualidade-de-dados/exposicao-de-dados.md) | Credenciais escritas no código dos modelos e outros riscos de vazamento | {% hint style="info" %} A **Limpeza de Modelo** (tabelas, colunas e medidas que nenhum relatório usa) agora fica no módulo **Performance**: veja [Limpeza de Modelo](/power-monitor/performance/limpeza-de-modelo.md). O endereço antigo continua funcionando. {% endhint %} {% hint style="info" %} Todas as análises do módulo trabalham sobre os **dados já coletados** pelo Power Monitor (inventário e mapeamento de modelos, estrutura de relatórios, permissões, uso). Nenhuma delas conecta ao seu modelo semântico em tempo real nem altera nada no Power BI/Fabric. Se um modelo foi alterado há pouco, aguarde a próxima coleta para ver o reflexo aqui. Veja [Mapeamento](/power-monitor/mapeamento.md). {% endhint %} ## Funcionalidades por tela Cada página do módulo tem uma seção **Funcionalidades** que apresenta, com print e passo a passo, cada recurso da tela. Resumo: | Tela | Principais funcionalidades | | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Linhagem de Dados](/power-monitor/qualidade-de-dados/linhagem-de-dados.md) | Abas **Tabela e Colunas** e **Itens do Power BI**, pesquisa de tabela/coluna com coluna de origem, pesquisa de item, diagrama com detalhes e destaque, zoom, tela cheia e exportação (PNG, JSON, texto) | | [Raio-X do Ambiente](/power-monitor/qualidade-de-dados/raio-x-do-ambiente.md) | Nota geral, achados por gravidade, tendência, cards das seis áreas com o link para a tela que resolve cada problema, **Atualizar análise**, **Resumir com IA** e exportação | | [Dicionário de Dados](/power-monitor/qualidade-de-dados/dicionario-de-dados.md) | Árvore Gateway › Servidor › Banco › Tabela › Coluna, pesquisa em todos os níveis, diagrama "onde é usado", zoom e exportação (PNG, JSON, CSV) | | [Score de Boas Práticas](/power-monitor/qualidade-de-dados/score-de-boas-praticas-bpa.md) | Seleção do modelo, score geral, nove categorias (clique para filtrar), tabela de achados com **Recomendação** e link de **Fonte** de cada regra, **Regras não avaliadas**, versão do catálogo, **Exportar CSV**, **Executar novamente** e a aba no detalhe do modelo | | [Score de Boas Práticas de Relatórios](/power-monitor/qualidade-de-dados/score-de-boas-praticas-de-relatorios.md) | Seleção do relatório (Power BI ou paginado), cinco categorias, etiqueta de origem de cada regra, **Regras não avaliadas** e cobertura, **Exportar CSV**, **Executar novamente** e a aba **Boas Práticas** no detalhe do relatório | | [Score de IA](/power-monitor/qualidade-de-dados/score-de-ia.md) | Seleção do modelo, score geral, seis categorias ponderadas, tabela de achados com filtros e **Itens por página**, **Regras não avaliadas**, **Exportar CSV**, **Executar novamente** e a aba no detalhe do modelo | | [Inventário do Ambiente](/power-monitor/qualidade-de-dados/inventario-do-ambiente.md) | Cartões de KPI, pesquisa geral (inclusive por tabela, coluna, medida ou relatório), filtros do cabeçalho, ordenação, **Itens por página** e detalhe do modelo | | [Raio-X de Workspace](/power-monitor/qualidade-de-dados/raio-x-de-workspace.md) | Pesquisa, filtro vindo do Dashboard de Governança, matriz por tipo de artefato, ordenação, menu de ações e detalhe do workspace | | [Exposição de Dados](/power-monitor/qualidade-de-dados/exposicao-de-dados.md) | Filtro de tipos de risco (credenciais e riscos amplos), aviso de mascaramento, resumo e achados por modelo, aviso e configuração de **artefatos padrão da Microsoft** | ## Conceitos que você vai encontrar **Linhagem de dados:** o caminho que um dado percorre desde a fonte original (banco, arquivo, Lakehouse) até o relatório, passando pelo modelo semântico. Ajuda a medir o impacto de uma mudança. **Modelo composto:** modelo semântico que consome outro modelo semântico do Power BI (DirectQuery para modelo semântico). Na linhagem aparece como *Modelo de origem* ou *Modelo dependente*. **Modo de armazenamento:** como o modelo guarda seus dados: **Import**, **DirectQuery**, **DirectLake**, **Dual** ou **Misto** (tabelas com modos diferentes). **Score:** nota de 0 a 100 que resume a aderência a um conjunto de critérios. Faixas usadas nos scores de modelos e de relatórios: **80 ou mais = Bom**, **60 a 79 = Atenção**, **abaixo de 60 = Requer atenção**. No Raio-X do Ambiente as faixas são **Saudável** (80 ou mais), **Atenção** e **Crítico** (abaixo de 50). **Best Practice Analyzer (BPA):** conjunto de regras de boas práticas de modelagem originado no Tabular Editor. Os scores de boas práticas do Power Monitor também usam regras de diretrizes da Microsoft e heurísticas próprias; no score de modelos, o link **Fonte** indica de onde vem a regra e, no de relatórios, cada regra traz também uma etiqueta de origem. **Regras não avaliadas:** regras que o score não conseguiu calcular por falta de dados (por exemplo, um relatório sem estrutura capturada). Elas ficam fora da nota e são listadas com o motivo. **RLS / OLS:** segurança em nível de linha (*Row-Level Security*) e em nível de objeto (*Object-Level Security*, que oculta tabelas ou colunas para determinados papéis). **Credencial hard-coded:** senha, token ou chave escrita diretamente no código do modelo (Power Query/M ou DAX) em vez de ficar protegida em uma conexão ou gateway. **Artefatos padrão da Microsoft:** itens que a própria Microsoft cria no tenant (Fabric Capacity Metrics, modelos de métricas de uso, workspace Admin monitoring). As análises os ignoram por padrão; veja [Artefatos padrão da Microsoft](/power-monitor/qualidade-de-dados/exposicao-de-dados.md#artefatos-padrao-da-microsoft). ## Como usar ### Como abrir uma tela do módulo 1. No menu lateral, clique em **Qualidade de Dados** para ver as telas do módulo. 2. Escolha a tela: **Linhagem de Dados**, **Raio-X do Ambiente** (Administradores), **Dicionário de Dados**, **Score de Boas Práticas**, **Score de Boas Práticas de Relatórios**, **Score de IA**, **Inventário do Ambiente**, **Raio-X de Workspace** ou **Exposição de Dados**. 3. Se uma tela não aparecer no menu, um administrador pode ter bloqueado o acesso a ela para o seu usuário em **Usuários**. ### Como analisar um modelo ou relatório específico As telas **Score de IA** e **Score de Boas Práticas** funcionam da mesma forma: 1. Digite pelo menos 2 caracteres no campo **Pesquisar modelo semântico...**. 2. Escolha o modelo na lista de sugestões (clique, ou **↑**/**↓** e **Enter**). A faixa abaixo da pesquisa confirma o modelo e o workspace. 3. Aguarde a mensagem *Analisando o modelo...* dar lugar ao resultado. Para refazer a análise depois de uma nova coleta, clique em **Executar novamente**. O **Score de Boas Práticas de Relatórios** segue o mesmo caminho, a partir do campo **Pesquisar relatório...**. ### Como começar pelo diagnóstico geral {% stepper %} {% step %} ### Raio-X do Ambiente Veja a nota geral e os achados críticos e altos em todas as áreas (somente Administradores). {% endstep %} {% step %} ### Siga o link do achado Cada achado leva à tela que resolve o problema: Alertas, Gateways, Exposição de Dados, Custo de Capacidade, Dashboard de Permissões e outras. {% endstep %} {% step %} ### Aprofunde com os scores Para problemas de qualidade de modelos, abra o Score de Boas Práticas ou o Score de IA do modelo apontado. {% endstep %} {% endstepper %} ### Como investigar a saúde de um modelo semântico {% stepper %} {% step %} ### Inventário do Ambiente Localize o modelo e veja, em uma linha, estrutura, RLS, falhas de atualização, scores de IA e de boas práticas e a classificação de eficiência de uso. {% endstep %} {% step %} ### Score de Boas Práticas e Score de IA Abra os problemas específicos do modelo, com a recomendação para cada um. {% endstep %} {% step %} ### Limpeza de Modelo Descubra o que pode ser removido do modelo para deixá-lo menor e mais simples, em [Performance › Limpeza de Modelo](/power-monitor/performance/limpeza-de-modelo.md). {% endstep %} {% step %} ### Exposição de Dados Confirme que não existe credencial escrita no código do modelo. {% endstep %} {% endstepper %} ### Como avaliar o impacto de uma mudança na origem {% stepper %} {% step %} ### Dicionário de Dados Parta do gateway, servidor, banco, tabela ou coluna que vai mudar e veja todos os modelos e relatórios que dependem dele. {% endstep %} {% step %} ### Linhagem de Dados Abra cada modelo afetado e confirme o caminho até os relatórios, apps e modelos compostos dependentes. {% endstep %} {% step %} ### Raio-X de Workspace Veja a composição dos workspaces envolvidos para planejar a comunicação com os responsáveis. {% endstep %} {% endstepper %} ### Como fazer uma revisão de segurança {% stepper %} {% step %} ### Exposição de Dados Liste os modelos com credenciais expostas e, se quiser, habilite os riscos amplos (exfiltração, destinos externos, conexões dinâmicas). {% endstep %} {% step %} ### Inventário do Ambiente Cruze os modelos afetados com RLS e rótulo de confidencialidade (*Sensitivity Label*). {% endstep %} {% step %} ### Auditoria de Permissões Verifique quem tem acesso aos workspaces e itens afetados em [Auditoria de Permissões](/power-monitor/auditoria/auditoria-de-permissoes.md). {% endstep %} {% endstepper %} ## Páginas relacionadas * [Performance](/power-monitor/performance.md): Limpeza de Modelo, Avaliação de Performance e Tempo Médio de Execução * [Governança › Modelos Semânticos](/power-monitor/governanca/modelos-semanticos.md): inventário e detalhe de cada modelo (as abas de linhagem e de scores também aparecem lá) * [Governança › Relatórios](/power-monitor/governanca/relatorios.md): a aba **Boas Práticas** no detalhe do relatório * [Mapeamento › Modelos e relatórios › Mapeamento de Modelo](/power-monitor/mapeamento/mapeamento-de-modelos.md): a coleta que alimenta a maioria destas telas * [Monitoramento › Modelos Semânticos](/power-monitor/monitoramento/modelos-semanticos.md): falhas e duração de atualizações * [Auditoria](/power-monitor/auditoria.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/power-monitor/qualidade-de-dados.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.