Documentação

Visão geral

O Power Alerts Cloud reúne o monitoramento de SQL Server, SQL Server Express, Azure SQL Database, Hyperscale e Azure SQL Managed Instance. As métricas disponíveis dependem dos recursos e permissões de cada ambiente. Amazon RDS está previsto, ainda não disponível.

Power Alerts Agent: serviço Windows que consulta as instâncias e envia as coletas ao serviço central.
Portal: reúne instâncias, histórico, regras, alertas, notificações e acesso da equipe.

Não é necessário instalar procedures, tabelas ou banco de monitoramento no SQL, nem criar jobs no SQL Server Agent. São necessárias credenciais e permissões de consulta. O agente inicia a comunicação de saída com a API por HTTPS.

Instalação do agente

Use o instalador oficial PowerAlerts-Setup-<versão>.exe, disponibilizado pela sua organização em Configurações → Instalação no portal. O pacote instala o serviço e sua interface de configuração.

Pré-requisitos

Windows x64 compatível com o pacote distribuído, com privilégios administrativos para instalar.
Acesso de rede às instâncias e saída HTTPS para a API configurada (porta 443).
Chave do cliente/registro obtida no portal e credenciais SQL com as permissões adequadas.
O pacote distribuído inclui o runtime; não é necessário instalar um SDK .NET.

Passo a passo

Baixe o pacote oficial e execute como administrador.
Confirme o diretório. O padrão é C:\Program Files\PowerAlerts\Agent.
Ao concluir, abra o atalho PowerAlerts Agent. O instalador registra e inicia o serviço; sem instâncias configuradas, ele aguarda a configuração.
Informe a chave fornecida no portal e use Adicionar instância para configurar as conexões.
Teste cada conexão, revise as permissões apontadas e salve.
Confirme o status da coleta na interface do agente e depois no portal.

Nota: A chave pode ter validade e limites de uso. Se ela for recusada, confira a chave da sua organização antes de gerar outra ou reinstalar.

Configuração

Conexões

Na interface do Power Alerts Agent, use Adicionar instância. Informe tipo de ambiente, servidor/endpoint, banco quando necessário e a autenticação disponível para o tipo escolhido. Teste antes de salvar.

SQL Server / Express: endereço do servidor e, quando aplicável, nome da instância.
Azure SQL Database / Hyperscale: servidor lógico e banco específico.
Managed Instance: endpoint da instância gerenciada.

A autenticação Windows usa a identidade do serviço: o teste interativo e a execução do serviço podem ter permissões diferentes. Valide o acesso com a conta que executará o serviço.

Pausa e alterações

Você pode pausar uma instância sem desinstalar o agente. O heartbeat continua, mas a coleta é suspensa. Pausa de coleta e silenciamento de notificações são operações diferentes.

As alterações de conexão são recarregadas pelo agente. Mudanças de chave ou serviço podem exigir reinicialização orientada pela própria interface. Um agente pode acompanhar várias instâncias; configure e valide cada conexão.

Atualização do agente

O agente informa quando existe uma atualização publicada. A instalação é iniciada pelo usuário na interface do Power Alerts Agent; não é uma atualização silenciosa automática.

Abra a opção de atualização e confira a versão e as novidades.
Quando a atualização interna está disponível, o agente baixa o instalador por HTTPS e verifica seu SHA-256 antes de executar.
Se os metadados necessários não estiverem disponíveis, a interface encaminha para o download oficial.
O instalador para o serviço, substitui os binários e reinicia o serviço, preservando a configuração. Evite manter alterações não salvas na interface.
Após atualizar, confirme a versão e o retorno da coleta.

O que é coletado

O agente consulta métricas e informações de diagnóstico. Os coletores variam conforme a edição, o ambiente, as permissões e a configuração da instância.

SQL Server / Express / Managed Instance

CPU, memória, contadores e sessões.
Armazenamento, arquivos de dados/log, TempDB e latência de I/O, quando disponíveis.
Bloqueios, waits, consultas e execução longa.
Backups, integridade, índices e estatísticas conforme os coletores habilitados.
Jobs e recursos de alta disponibilidade apenas onde existem. Express não tem SQL Server Agent.

Azure SQL Database / Hyperscale

CPU/DTU, armazenamento, I/O, log, memória, workers e sessões.
Query Store e diagnósticos de consultas quando disponíveis.
Métricas específicas de Hyperscale e réplicas conforme o ambiente.

Frequência

A coleta leve pode ser ajustada em Configurações e na configuração da instância. O portal oferece intervalos de 1, 2 ou 5 minutos. Coletores periódicos e pesados têm agendamento próprio; nem toda métrica é atualizada a cada ciclo leve.

Nota: Diagnósticos podem conter trechos de consultas e identificadores de sessões. Leia a seção de privacidade antes de habilitar o monitoramento em ambientes com dados sensíveis.

Alertas

O catálogo reúne alertas de desempenho, capacidade, disponibilidade, backups, integridade, jobs e Azure SQL. A lista pública está na home. Recursos específicos só se aplicam aos ambientes compatíveis.

Regras e limites

Configure regras para a organização ou ajuste uma instância específica. A condição pode usar um limite, leituras consecutivas ou uma janela de tempo. Alguns tipos precisam de ativação e dependem de coletores específicos.

Notificações por e-mail e webhook

Em Configurações → Notificações, configure destinatários de e-mail e endpoints de webhook. Revise as assinaturas e filtros disponíveis para escolher quais alertas devem notificar sua equipe ou suas integrações.

Use os silenciamentos para controlar notificações durante situações planejadas. Um alerta aberto, uma instância pausada e uma notificação silenciada representam estados diferentes. Consulte o histórico e os detalhes no portal para acompanhar a resolução.

Nota: Notificações e webhooks podem conter dados de diagnóstico. Configure apenas destinatários e endpoints autorizados pela sua organização.

Segurança

Comunicação e credenciais

O agente envia dados por HTTPS e assina as requisições com HMAC-SHA256. A API valida assinatura, timestamp e nonce. Credenciais locais são protegidas com DPAPI vinculada à máquina; a configuração não deve ser copiada como forma de migrar credenciais para outro computador.

Permissões SQL

Não é obrigatório conceder sysadmin ou db_owner. As permissões necessárias dependem do tipo de instância e de quais coletores serão usados. O teste de conexão e a verificação de permissões do agente ajudam a identificar as pendências.

SQL Server / MI: permissões de consulta de estado, definição de objetos e acesso aos bancos conforme a versão e os coletores.
Jobs: acesso correspondente ao msdb e ao SQL Server Agent, quando o recurso existir.
Backup e integridade: acesso aos metadados e históricos necessários; hardening do msdb pode exigir concessões adicionais.
Azure SQL Database: permissões no banco e, para determinados coletores, no master do servidor lógico.
Alguns diagnósticos de estatísticas e limites de colunas consultam dados agregados nas tabelas e podem exigir SELECT. Conceda apenas o escopo necessário, com revisão do DBA.

Nota: Um teste de conexão bem-sucedido não significa que todos os coletores têm acesso. Revise o relatório de permissões; ausência de dados não deve ser interpretada automaticamente como ambiente saudável.

Acesso ao portal

O portal utiliza cookies de sessão HttpOnly e controle de acesso por organização. A API mantém isolamento de dados por tenant e registros de auditoria. Esses controles não dispensam a proteção das contas, dos computadores e dos endpoints de integração.

Privacidade dos dados

Dados de diagnóstico

O monitoramento inclui métricas, nomes de instâncias e bancos, metadados e informações de diagnóstico. Alguns coletores enviam amostras de SQL e identificadores de sessão/login. Essas informações podem conter dados sensíveis presentes no texto da consulta.

A opção de coleta detalhada, configurada por instância no agente, habilita informações adicionais em determinados coletores. Ela não é uma garantia global de que nenhum texto SQL será enviado quando desativada: os coletores de CPU e execução longa também podem enviar amostras de consultas.

O agente não faz cópia de backups nem exportação integral de tabelas. Alguns diagnósticos consultam valores agregados para avaliar limites e estatísticas. Avalie as permissões e os dados envolvidos antes de habilitar cada recurso.

Armazenamento e retenção

Os dados são enviados ao serviço central. Confirme com o responsável pela implantação a região de hospedagem e as condições contratuais aplicáveis; esta página não estabelece uma região ou prazo contratual.

A retenção é configurada administrativamente por categoria e também considera as políticas do cliente. Métricas brutas e agregadas podem ter prazos diferentes. A remoção automática é executada por tarefas de manutenção; consulte os valores vigentes no portal administrativo.

Exclusão e integrações

Solicitações de exclusão devem ser tratadas com o administrador da organização e do serviço. Os procedimentos podem incluir janela de recuperação antes da remoção definitiva. E-mails, webhooks e exportações geram cópias externas, cuja retenção precisa ser administrada nos respectivos destinos.

Troubleshooting

O agente não aparece no portal

Confirme o serviço na interface do agente ou com o comando abaixo.
Verifique a chave do cliente, o endpoint da API configurado e a saída HTTPS.
Consulte os eventos do agente e o motivo das falhas antes de reinstalar.

Get-Service "PowerAlerts Agent"
Get-Content "C:\ProgramData\PowerAlerts\last-events.json" -Raw

Uma instância está offline ou sem métricas

Teste a conexão e confira senha, endereço, porta SQL e acesso de rede.
Revise as permissões e o estado de pausa.
Confirme se o coletor é compatível com a instância e aguarde seu intervalo específico.
Para autenticação Windows, confira a identidade que executa o serviço.

Falhas de envio

O agente mantém uma fila SQLite local e tenta reenviar as coletas pendentes. A fila tem capacidade limitada; não existe garantia de guardar qualquer duração de indisponibilidade. Sem o serviço em execução, novas métricas não são coletadas.

Atualização ou reinstalação

Prefira atualizar pelo fluxo oficial. Antes de reinstalar, preserve as configurações e solicite orientação se houver dados pendentes. Não apague ProgramData como procedimento padrão: isso pode remover credenciais, estado e fila de envio.