> 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/readme/como-instalar-o-power-monitor/instalacao-manual.md).

# Instalación manual

Paso a paso de la instalación manual de Power Monitor con un App Registration ya existente en su Microsoft Entra ID.

En la **Configuración Manual** (Avanzado), usted proporciona a Power Monitor las credenciales de un **App Registration que ya existe** en su Microsoft Entra ID. Es la opción indicada cuando:

* la política de la empresa no permite que un asistente externo cree aplicaciones y grupos en Entra ID;
* desea tener **control total de las credenciales** (nombre de la aplicación, vigencia del secret, grupo utilizado);
* quien realiza la instalación no es Administrador global.

Esta página continúa a partir del paso **Tipo de Instalación**. Los pasos anteriores (región, organización y facturación) se encuentran en [¿Cómo instalar Power Monitor?](/es/readme/como-instalar-o-power-monitor.md)

El recorrido del modo manual tiene 6 etapas: **Organización › Facturación › Instalación › Credenciales › Workspaces › Completado**.

***

## Parte 1: prepare la aplicación en su tenant

Realice estas configuraciones **antes** de abrir el paso Credenciales. Requieren, respectivamente, un administrador de Entra ID y un administrador de Fabric.

{% stepper %}
{% step %}

### Registre la aplicación en Entra ID

En el [portal de Azure](https://portal.azure.com), acceda a **Microsoft Entra ID › Registros de aplicaciones › Nuevo registro**, asigne un nombre a la aplicación (por ejemplo, *PowerMonitor-APP*), mantenga **Solo las cuentas de este directorio organizativo** y haga clic en **Registrar**.

Anote el **Id. de aplicación (cliente)**: es el *Client ID* que Power Monitor le solicitará.

{% hint style="warning" %}
No agregue a la aplicación permisos de **Power BI Service** que requieran consentimiento de administrador. Microsoft no permite que un Service Principal con ese tipo de permiso use las API de administración de solo lectura, que Power Monitor utiliza para el inventario.
{% endhint %}
{% endstep %}

{% step %}

### Cree un client secret

En la aplicación, acceda a **Certificados y secretos › Nuevo secreto de cliente**, defina la vigencia y copie el **Valor** del secreto (solo se muestra una vez). Es el *Client Secret*.

Anote la fecha de vencimiento: cuando el secret venza, Power Monitor dejará de recopilar datos hasta que la credencial se actualice en **Configuración**.
{% endstep %}

{% step %}

### Cree un grupo de seguridad y agregue la aplicación

En **Microsoft Entra ID › Grupos › Nuevo grupo**, cree un grupo del tipo **Seguridad** (por ejemplo, *PowerMonitor-Group*) y agregue como miembro la **aplicación empresarial (Service Principal)** creada en el paso 1. Anote el **Id. de objeto** del grupo: es el *Group ID*, opcional en Power Monitor.

El grupo es la forma recomendada por Microsoft para habilitar las API de Fabric para Service Principals sin habilitarlas para todo el tenant.
{% endstep %}

{% step %}

### Habilite la configuración del inquilino de Fabric

Con una cuenta de **Administrador de Fabric**, acceda a **Portal de administración de Fabric › Configuración del inquilino** y habilite, **aplicándolas al grupo de seguridad** creado en el paso anterior:

**Obligatorias** (sin ellas la recopilación no funciona):

* **Service principals can access read-only admin APIs** (Las entidades de servicio pueden acceder a las API de administración de solo lectura)
* **Enhance admin APIs responses with detailed metadata** (Mejorar las respuestas de las API de administración con metadatos detallados)
* **Enhance admin APIs responses with DAX and mashup expressions** (Mejorar las respuestas de las API de administración con expresiones DAX y de mashup)
* **Service principals can call Fabric public APIs** (Las entidades de servicio pueden llamar a las API públicas de Fabric)

La lista completa, incluidas las configuraciones opcionales, se encuentra en [Requisitos previos](/es/documentacion-tecnica/instalacao/pre-requisitos.md#configuracion-de-inquilino-de-fabric).

{% hint style="info" %}
Microsoft puede tardar algunos minutos en propagar los cambios de la configuración del inquilino.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Parte 2: complete la instalación en Power Monitor

{% stepper %}
{% step %}

### Credenciales de Azure

En el paso **Credenciales de Azure**, complete:

| Campo                          | Qué indicar                                                              |
| ------------------------------ | ------------------------------------------------------------------------ |
| **Client ID (Application ID)** | El Id. de aplicación (cliente) del App Registration                      |
| **Client Secret**              | El valor del secreto de cliente                                          |
| **Group ID** (opcional)        | El Id. de objeto del grupo de seguridad del que la aplicación es miembro |

Haga clic en **Guardar Credenciales**. Power Monitor **prueba el Client ID y el Client Secret en Entra ID antes de guardarlos**; si se rechazan, el mensaje de error aparece en la pantalla y no se guarda nada. Las credenciales aceptadas se almacenan cifradas.
{% endstep %}

{% step %}

### Términos de Aceptación

Lea los **Términos de Uso, la Política de Privacidad y las Condiciones Comerciales**, marque **Leí y acepto los términos de uso** y haga clic en **Continuar**. La aceptación **activa la organización** e inicia el período de evaluación de 30 días.
{% endstep %}

{% step %}

### Seleccionar Workspaces

Elija los workspaces que se van a monitorear (búsqueda por nombre, **Seleccionar todos**, **Limpiar selección**):

* **Escanear Entorno Completo:** se monitorean todos los workspaces, incluidos los que se creen en el futuro.
* **Preparar Entorno (N):** solo los seleccionados. Los workspaces nuevos quedan fuera del monitoreo hasta que un administrador los incluya.

Si la lista no se carga, haga clic en **Dar Consentimiento a Power BI**: la lista se lee con su acceso a Power BI, y cada usuario debe autorizar ese acceso una sola vez.

También es posible **Omitir** esta etapa. En ese caso, no se inicia ningún escaneo ahora; elija los workspaces e inicie el escaneo más tarde en **Mapeo › Inventario**.
{% endstep %}

{% step %}

### Completado

Power Monitor inicia los primeros escaneos y muestra la pantalla de preparación del entorno, con la lista **Escaneos iniciales**, la fase real de cada escaneo (**En cola**, **En ejecución** o **Reintentando**) y el resumen *4 de 6 terminados*. Los escaneos independientes empiezan juntos y de inmediato, sin esperar el ciclo de 5 minutos del servicio de recolección. Si la pantalla se cierra antes de que todos terminen, la recolección continúa en segundo plano y los datos aparecen a medida que termina cada escaneo. Vea los detalles en [Preparación del entorno y finalización](/es/readme/como-instalar-o-power-monitor/instalacao-automatica.md#preparacion-del-entorno-y-finalizacion).

Después, la pantalla **¡Credenciales Guardadas!** muestra el ID de la organización y el botón **Abrir el panel**.
{% endstep %}
{% endstepper %}

***

## Después de la instalación manual

El modo manual **no** incluye las etapas Permisos adicionales y Fuente de Métricas. Configúrelas a continuación:

1. **Configuración › Permisos adicionales:** verifique los **Permisos básicos de Fabric** y conceda el acceso a los gateways, la lectura de Entra ID (vigencia del secret e importación de usuarios), el bot de Teams y los permisos de Azure para capacidades y costos. El camino más rápido es **Conceder todos los permisos necesarios** › **Ejecutar todo**, seguido de **Agregar Service Principal** en la tarjeta de workspaces. Consulte [Permisos adicionales › Cómo usar](/es/power-monitor/configuracoes/permissoes-adicionais.md#como-usar).
2. **Configuración › Monitoreo:** elija la fuente de métricas de capacidad (aplicación Fabric Capacity Metrics) y active los monitoreos (paso a paso en [Monitoreo › Cómo usar](/es/power-monitor/configuracoes/monitoramento.md#funcionalidades)). Consulte también [Activar el Monitoreo de Capacidad](/es/power-monitor/monitoramento/capacidades/ativar-monitoramento-de-capacidade.md) y [Activar el Monitoreo de Gateways](/es/power-monitor/monitoramento/gateways/ativar-monitoramento-de-gateways.md).
3. Siga el [Primer acceso](/es/readme/primeiro-acesso.md).

{% hint style="info" %}
Los recursos que dependen de la lectura de grupos de Entra ID (por ejemplo, la expansión de miembros de grupos en las pantallas de permisos) requieren que la aplicación tenga el permiso de **aplicación** `GroupMember.Read.All` (o `Directory.Read.All`) de Microsoft Graph, con consentimiento de administrador. Se puede conceder en **Configuración › Permisos adicionales** o directamente en el portal de Azure.
{% endhint %}

## Cómo usar

### Cómo actualizar las credenciales indicadas en la instalación

Después de la instalación, las credenciales del App Registration se administran en *Configuración › Organización* (solo Administradores):

1. Para un **nuevo secret de la misma aplicación**, use **Cambio Manual del Secreto**: pegue el valor, haga clic en **Validar** y luego en **Guardar**. Consulte [Cómo cambiar el secret manualmente](/es/power-monitor/configuracoes/organizacao.md#cambio-manual-del-secreto).
2. Para **otra aplicación**, use el lápiz de **ID de Aplicación** (**Reemplazar la entidad de servicio**). Consulte [Cómo reemplazar el Service Principal](/es/power-monitor/configuracoes/organizacao.md#reemplazar-la-entidad-de-servicio).
3. Para **otro grupo de seguridad**, use el lápiz de **Group ID**. Consulte [Cómo reemplazar el grupo de seguridad](/es/power-monitor/configuracoes/organizacao.md#reemplazar-el-id-de-grupo).

### Cómo renovar el secret antes del vencimiento

1. Con el permiso **Vigencia del secreto de la aplicación** concedido en *Configuración › Permisos adicionales*, Power Monitor muestra un aviso en la parte superior de las páginas cuando faltan menos de 30 días.
2. En *Configuración › Organización*, haga clic en **Cambio Automático del Secreto** y confirme en **Sí, crear y aplicar** (requiere ser Administrador de aplicaciones o propietario del registro), o cree el secret en el portal de Azure y use **Cambio Manual del Secreto**.
3. Consulte el paso a paso completo en [Cómo renovar el secret automáticamente](/es/power-monitor/configuracoes/organizacao.md#cambio-automatico-del-secreto).

## Preguntas frecuentes

<details>

<summary>La instalación indica que las credenciales fueron rechazadas</summary>

Verifique que el Client ID sea el **Id. de aplicación (cliente)** (y no el Id. de objeto), que el Client Secret sea el **Valor** del secreto (y no el Id. del secreto) y que el secreto no esté vencido.

</details>

<details>

<summary>La instalación terminó, pero el inventario quedó vacío</summary>

Casi siempre se trata de la configuración del inquilino de Fabric: verifique que las cuatro obligatorias estén habilitadas **para el grupo del que la aplicación es miembro** y espere la propagación. Luego, ejecute un nuevo escaneo en **Mapeo › Inventario**.

</details>

## Páginas relacionadas

* [¿Cómo instalar Power Monitor?](/es/readme/como-instalar-o-power-monitor.md)
* [Instalación automática](/es/readme/como-instalar-o-power-monitor/instalacao-automatica.md)
* [Requisitos previos](/es/documentacion-tecnica/instalacao/pre-requisitos.md)
* [Configuración de permisos en Azure](/es/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/es/readme/como-instalar-o-power-monitor/instalacao-manual.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.