fabricgov¶

Biblioteca Python para assessment automatizado de governança em Microsoft Fabric.

O que é?¶

fabricgov automatiza a coleta de dados de governança no Microsoft Fabric via CLI ou Python. Combina chamadas às APIs do Power BI e Microsoft Fabric para extrair inventário, acessos, refresh, atividades e infraestrutura em arquivos CSV/JSON — prontos para análise e relatórios.

Instalação¶

pip install fabricgov

Para Azure Key Vault:

pip install fabricgov[keyvault]

Quick Start — CLI¶

# 1. Configurar autenticação
fabricgov auth sp

# 2. Coletar tudo
fabricgov collect all --days 7

# 3. Gerar relatório HTML
fabricgov report --open

# 4. Ver findings de governança no terminal
fabricgov analyze

Quick Start — Python¶

from fabricgov import FabricGov

fg = FabricGov.from_env()
run_dir = fg.collect.all(days=28)
fg.report(output_path=run_dir / "report.html", lang="pt")

findings = fg.analyze(source_dir=run_dir)
for f in findings:
    print(f["severity"], f["count"], f["message"])

Funcionalidades¶

Funcionalidade	Descrição
12 coletores	Inventário, acessos, refresh, domínios, tags, capacidades, atividades
Relatório HTML	Standalone com Plotly + Bootstrap 5, PT e EN
`fabricgov analyze`	Findings de governança no terminal + `findings.json`
`fabricgov diff`	Comparação de dois snapshots de output
Python API	Facade `FabricGov` para uso programático sem CLI
Checkpoint	Retomada automática após rate limit (429)
Azure Key Vault	Credenciais sem texto plano em disco

Navegação¶

Python API — Uso programático com FabricGov
Autenticação — Service Principal, Device Flow, Key Vault
Coletores — Os 12 coletores disponíveis
Atividades — Log de atividades do tenant
Diff de Snapshots — Comparação entre runs
Relatório HTML — Seções, fontes e regras de governança
Limitações — Rate limits e restrições

Autor¶

Luciano Borba — GitHub · LinkedIn · YouTube

Data Engineering Consultant — Microsoft Fabric & Power BI