> 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/readme/como-instalar-o-power-monitor/instalacao-manual.md).
# Instalação Manual
Passo a passo da instalação manual do Power Monitor usando um App Registration já existente no seu Microsoft Entra ID.
Na **Configuração Manual** (Avançado), você informa ao Power Monitor as credenciais de um **App Registration que já existe** no seu Microsoft Entra ID. É a opção indicada quando:
* a política da empresa não permite que um assistente externo crie aplicativos e grupos no Entra ID;
* você quer ter **controle total das credenciais** (nome do aplicativo, validade do secret, grupo usado);
* quem está instalando não é Administrador Global.
Esta página continua a partir do passo **Tipo de Instalação**. Os passos anteriores (região, organização e faturamento) estão em [Como instalar o Power Monitor?](/readme/como-instalar-o-power-monitor.md)
A trilha do modo manual tem 6 etapas: **Organização › Faturamento › Instalação › Credenciais › Workspaces › Concluído**.
***
## Parte 1: Prepare o aplicativo no seu tenant
Faça estas configurações **antes** de abrir o passo Credenciais. Elas exigem, respectivamente, um administrador do Entra ID e um administrador do Fabric.
{% stepper %}
{% step %}
### Registre o aplicativo no Entra ID
No [portal do Azure](https://portal.azure.com), acesse **Microsoft Entra ID › Registros de aplicativo › Novo registro**, dê um nome ao aplicativo (por exemplo, *PowerMonitor-APP*), mantenha **Contas somente neste diretório organizacional** e clique em **Registrar**.
Anote o **ID do aplicativo (cliente)**: é o *Client ID* que o Power Monitor vai pedir.
{% hint style="warning" %}
Não adicione ao aplicativo permissões do **Power BI Service** que exijam consentimento de administrador. A Microsoft não permite que um Service Principal com esse tipo de permissão use as APIs de administração somente leitura, que o Power Monitor utiliza para o inventário.
{% endhint %}
{% endstep %}
{% step %}
### Crie um client secret
No aplicativo, acesse **Certificados e segredos › Novo segredo do cliente**, defina a validade e copie o **Valor** do segredo (ele só é exibido uma vez). É o *Client Secret*.
Anote a data de expiração: quando o secret vencer, o Power Monitor deixa de coletar dados até que a credencial seja atualizada em **Configurações**.
{% endstep %}
{% step %}
### Crie um grupo de segurança e adicione o aplicativo
Em **Microsoft Entra ID › Grupos › Novo grupo**, crie um grupo do tipo **Segurança** (por exemplo, *PowerMonitor-Group*) e adicione como membro o **aplicativo empresarial (Service Principal)** criado no passo 1. Anote o **ID do objeto** do grupo: é o *Group ID*, opcional no Power Monitor.
O grupo é a forma recomendada pela Microsoft de liberar as APIs do Fabric para Service Principals sem liberá-las para todo o tenant.
{% endstep %}
{% step %}
### Habilite as configurações de locatário do Fabric
Com uma conta **Administrador do Fabric**, acesse o **Portal de administração do Fabric › Configurações de locatário** e habilite, **aplicando ao grupo de segurança** criado no passo anterior:
**Obrigatórias** (sem elas a coleta não funciona):
* **Service principals can access read-only admin APIs** (Entidades de serviço podem acessar APIs de administração somente leitura)
* **Enhance admin APIs responses with detailed metadata** (Aprimorar respostas das APIs de administração com metadados detalhados)
* **Enhance admin APIs responses with DAX and mashup expressions** (Aprimorar respostas das APIs de administração com expressões DAX e de mashup)
* **Service principals can call Fabric public APIs** (Entidades de serviço podem chamar APIs públicas do Fabric)
A lista completa, incluindo as configurações opcionais, está em [Pré-requisitos](/documentacao-tecnica/instalacao/pre-requisitos.md#configuracoes-de-locatario-do-fabric).
{% hint style="info" %}
A Microsoft pode levar alguns minutos para propagar as alterações das configurações de locatário.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Parte 2: Conclua no Power Monitor
{% stepper %}
{% step %}
### Credenciais Azure
No passo **Credenciais Azure**, preencha:
| Campo | O que informar |
| ------------------------------ | ------------------------------------------------------------------ |
| **Client ID (Application ID)** | O ID do aplicativo (cliente) do App Registration |
| **Client Secret** | O valor do segredo do cliente |
| **Group ID** (opcional) | O ID do objeto do grupo de segurança do qual o aplicativo é membro |
Clique em **Salvar Credenciais**. O Power Monitor **testa o Client ID e o Client Secret no Entra ID antes de gravar**; se forem recusados, a mensagem de erro aparece na tela e nada é salvo. As credenciais aceitas são armazenadas de forma criptografada.
{% endstep %}
{% step %}
### Termos de Aceite
Leia os **Termos de Uso, Política de Privacidade e Condições Comerciais**, marque **Li e aceito os termos de uso** e clique em **Prosseguir**. O aceite **ativa a organização** e inicia o período de avaliação de 30 dias.
{% endstep %}
{% step %}
### Selecionar Workspaces
Escolha os workspaces que serão monitorados (busca por nome, **Selecionar todos**, **Limpar seleção**):
* **Escanear Ambiente Completo:** todos os workspaces, inclusive os que forem criados no futuro, são monitorados.
* **Preparar Ambiente (N):** só os selecionados. Workspaces novos entram fora do monitoramento até que um administrador os inclua.
Se a lista não carregar, clique em **Consentir Power BI**: a lista é lida com o seu acesso ao Power BI, e cada usuário precisa autorizar esse acesso uma única vez.
Também é possível **Pular** esta etapa. Nesse caso, nenhum scan é iniciado agora; escolha os workspaces e inicie o scan depois em **Mapeamento › Inventários**.
{% endstep %}
{% step %}
### Concluído
O Power Monitor inicia os primeiros scans e mostra a tela **Preparando o ambiente**, com a lista **Scans iniciais**, a fase real de cada scan (**Na fila**, **Em execução** ou **Nova tentativa**) e o resumo *4 de 6 finalizados*. Os scans independentes começam juntos e na hora, sem esperar o ciclo de 5 minutos do serviço de coleta. Se a tela fechar antes de todos terminarem, a coleta continua em segundo plano e os dados aparecem conforme cada scan termina. Veja os detalhes em [Preparação do ambiente e conclusão](/readme/como-instalar-o-power-monitor/instalacao-automatica.md#preparacao-do-ambiente-e-conclusao).
Depois, a tela **Credenciais Salvas!** exibe o ID da organização e o botão **Acessar o painel**.
{% endstep %}
{% endstepper %}
***
## Depois da instalação manual
O modo manual **não** tem as etapas Permissões Adicionais e Fonte de Métricas. Configure-as em seguida:
1. **Configurações › Permissões Adicionais:** verifique as **Permissões básicas do Fabric**, conceda acesso aos gateways, a leitura do Entra ID (validade do secret e importação de usuários), o bot do Teams e as permissões do Azure para capacidades e custos. O caminho mais rápido é **Conceder todas as permissões necessárias** › **Executar tudo**, seguido de **Adicionar Service Principal** no card de workspaces. Veja [Permissões Adicionais › Como usar](/power-monitor/configuracoes/permissoes-adicionais.md#como-usar).
2. **Configurações › Monitoramento:** escolha a fonte de métricas de capacidade (aplicativo Fabric Capacity Metrics) e ative os monitoramentos (passo a passo em [Monitoramento › Como usar](/power-monitor/configuracoes/monitoramento.md#funcionalidades)). Veja também [Ativar Monitoramento de Capacidade](/power-monitor/monitoramento/capacidades/ativar-monitoramento-de-capacidade.md) e [Ativar Monitoramento de Gateways](/power-monitor/monitoramento/gateways/ativar-monitoramento-de-gateways.md).
3. Siga o [Primeiro acesso](/readme/primeiro-acesso.md).
{% hint style="info" %}
Recursos que dependem de leitura de grupos do Entra ID (por exemplo, a expansão de membros de grupos nas telas de permissões) exigem que o aplicativo tenha a permissão de **aplicativo** `GroupMember.Read.All` (ou `Directory.Read.All`) do Microsoft Graph, com consentimento de administrador. Ela pode ser concedida em **Configurações › Permissões Adicionais** ou diretamente no portal do Azure.
{% endhint %}
## Como usar
### Como atualizar as credenciais informadas na instalação
Depois da instalação, as credenciais do App Registration são mantidas em *Configurações › Organização* (somente Administradores):
1. Para um **novo secret do mesmo aplicativo**, use **Alteração Manual do Secret**: cole o valor, clique em **Validar** e depois em **Salvar**. Veja [Como trocar o secret manualmente](/power-monitor/configuracoes/organizacao.md#alteracao-manual-do-secret).
2. Para **outro aplicativo**, use o lápis do **Service Principal Identifier** (**Trocar Service Principal**). Veja [Como trocar o Service Principal](/power-monitor/configuracoes/organizacao.md#trocar-service-principal).
3. Para **outro grupo de segurança**, use o lápis do **Group ID**. Veja [Como trocar o grupo de segurança](/power-monitor/configuracoes/organizacao.md#trocar-group-id).
### Como renovar o secret antes do vencimento
1. Com a permissão **Validade do secret do aplicativo** concedida em *Configurações › Permissões Adicionais*, o Power Monitor avisa no topo das páginas quando faltam menos de 30 dias.
2. Em *Configurações › Organização*, clique em **Alteração Automática do Secret** e confirme em **Sim, criar e aplicar** (exige ser Administrador de Aplicativos ou proprietário do registro), ou crie o secret no portal do Azure e use **Alteração Manual do Secret**.
3. Veja o passo a passo completo em [Como renovar o secret automaticamente](/power-monitor/configuracoes/organizacao.md#alteracao-automatica-do-secret).
## Perguntas frequentes
A instalação diz que as credenciais foram recusadas
Confira se o Client ID é o **ID do aplicativo (cliente)** (e não o ID do objeto), se o Client Secret é o **Valor** do segredo (e não o ID do segredo) e se o segredo não está expirado.
A instalação terminou, mas o inventário ficou vazio
Quase sempre são as configurações de locatário do Fabric: confira se as quatro obrigatórias estão habilitadas **para o grupo do qual o aplicativo é membro** e aguarde a propagação. Depois, execute um novo scan em **Mapeamento › Inventários**.
## Páginas relacionadas
* [Como instalar o Power Monitor?](/readme/como-instalar-o-power-monitor.md)
* [Instalação Automática](/readme/como-instalar-o-power-monitor/instalacao-automatica.md)
* [Pré-requisitos](/documentacao-tecnica/instalacao/pre-requisitos.md)
* [Configuração de permissões no Azure](/readme/como-instalar-o-power-monitor/configuracao-de-permissoes-no-azure-para-o-power-monitor.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/readme/como-instalar-o-power-monitor/instalacao-manual.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.