API v2, API v1 e automação
A API v2 atual é REST, usa JSON, timestamps ISO-8601 UTC e raiz /api/v2. Ela é separada da API histórica v1.
Ponto técnico 1
A API v2 atual é REST, usa JSON, timestamps ISO-8601 UTC e raiz /api/v2. Ela é separada da API histórica v1.
Ponto técnico 2
A v2 ainda não é feature-complete; endpoints estáveis podem ser usados em produção, enquanto experimentais exigem avaliação de risco.
Ponto técnico 3
Autenticação suporta sessão/credenciais e API keys com Bearer. Crie chaves por integração e aplique privilégio mínimo.
Ponto técnico 4
Automação deve validar estado antes de criar/alterar objetos, registrar respostas e tolerar retries sem duplicar configuração.
Ponto técnico 5
Atualização 2026: a API v2 permanece separada da API v1; a documentação atual classifica a maioria dos endpoints como estáveis, mantém endpoints experimentais/deprecated e suporta autenticação por API key ou sessão Bearer. Prefira API keys dedicadas e com nível de acesso mínimo necessário.
Procedimento de engenharia
Escopo e impacto
Defina serviço, owner, estado esperado e impacto antes de alterar o monitoramento.
Evidência primeiro
Valide fonte, caminho, credenciais, baseline e timestamps antes de alterar thresholds.
Mudança controlada
Altere uma variável por vez e mantenha um caminho de rollback.
Rotina operacional recomendada
- Revise estados críticos, lacunas de coleta e falhas de entrega a cada turno.
- Revise alertas ruidosos, objetos lentos, credenciais e erros recorrentes semanalmente.
- Revise versões, backup/restore, permissões e capacidade periodicamente.
Sintoma → escopo → camada → evidência → hipótese → validação
Construa, quebre, diagnostique e recupere
- Registre um baseline saudável.
- Induza uma falha controlada relacionada ao tema.
- Identifique a camada com falha antes de reiniciar componentes.
- Corrija a causa identificada e valide a recuperação.
Pronto para produção?
Responsabilidade
Objetivo, escopo e owner estão definidos.
Segurança
Credenciais e integrações seguem menor privilégio.
Validação
Falha e recuperação foram testadas e documentadas.
Documentação sensível à versão
Conteúdo revisado contra documentação oficial Paessler atual. Requisitos de sistema, limites de sensores/canais, cluster, probes, API v2 e sensores suportados variam com a versão e devem ser reconfirmados antes de change.