# kimetsunodarth/agente-monitor- architecture

> Architecture diagram of the GitHub repository kimetsunodarth/agente-monitor-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kimetsunodarth/agente-monitor-
- Repository: https://github.com/kimetsunodarth/agente-monitor-

## Overview

Agente Monitor é uma aplicação desktop para administrar remotamente e monitorar ambientes SAP Business One sobre HANA e SUSE. O operador inicia a aplicação, conecta-se ao servidor por SSH e configura ou executa operações de monitoramento e manutenção; os dados coletados alimentam um dashboard HTML. Há também fluxos distintos para auditoria de procedures e análise LAB de runtime dumps. Os trechos mostram algumas chamadas da GUI e do cliente SSH; conexões de coleta, publicação e visualização não demonstradas no código são indicadas como não verificadas ou omitidas.

Main entry points: [`app/gui.py`](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/gui.py) (Interface Tkinter), [`app/ssh_client.py`](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/ssh_client.py) (Cliente SSH), [`app/proc_audit_scripts.py`](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit_scripts.py) (Scripts remotos), [`app/hana_diagnostics.py`](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/hana_diagnostics.py) (Runner de dumps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Aplicação desktop"]
  node_entry["Inicialização<br/>[main.py]"]
  node_gui["Interface Tkinter<br/>[gui.py]"]
end

subgraph group_remote_ops["Operações remotas"]
  node_ssh["Cliente SSH<br/>[ssh_client.py]"]
  node_templates["Geradores de scripts<br/>[templates.py]"]
end

subgraph group_monitoring["Monitoramento"]
  node_dashboard["Dashboard HTML<br/>[dashboard.py]"]
  node_collector["Coletor embarcado"]
end

subgraph group_procedure_audit["Auditoria de procedures"]
  node_audit_logic["Lógica de auditoria<br/>[proc_audit.py]"]
  node_audit_scripts["Scripts remotos"]
  node_audit_report["Relatório de alterações"]
  node_audit_data["Dados de auditoria"]
end

subgraph group_diagnostics["Diagnóstico HANA"]
  node_diagnostics["Runner de dumps"]
  node_bundled["Recursos embarcados"]
end

node_operator(("Operador"))
node_hana[("SAP HANA")]
node_suse["Servidor SUSE"]
node_zabbix["Zabbix"]
node_analyzer["HANA Dump Analyzer"]

node_operator -->|"inicia"| node_entry
node_entry -->|"inicia"| node_gui
node_gui -->|"configura e executa"| node_ssh
node_gui -->|"valida configuração"| node_audit_logic
node_gui -->|"solicita relatório"| node_audit_report
node_gui -->|"instala diagnóstico"| node_diagnostics
node_ssh -->|"executa operações"| node_suse
node_ssh -->|"provisiona auditoria"| node_hana
node_ssh -->|"usa geradores"| node_templates
node_ssh -->|"valida configuração"| node_audit_logic
node_ssh -.->|"instala scripts"| node_audit_scripts
node_templates -.->|"gera artefatos remotos"| node_suse
node_collector -.->|"coleta métricas"| node_hana
node_collector -.->|"publica métricas"| node_zabbix
node_dashboard -.->|"exibe dados"| node_audit_data
node_audit_scripts -.->|"consulta alterações"| node_hana
node_audit_scripts -.->|"grava resultados"| node_audit_data
node_gui -.->|"abre dashboard"| node_dashboard
node_diagnostics -.->|"analisa dumps"| node_suse
node_diagnostics -->|"executa JAR"| node_analyzer
node_bundled -->|"valida recursos"| node_analyzer

click node_entry "https://github.com/kimetsunodarth/agente-monitor-/blob/main/main.py"
click node_gui "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/gui.py"
click node_ssh "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/ssh_client.py"
click node_templates "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/templates.py"
click node_dashboard "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/dashboard.py"
click node_collector "https://github.com/kimetsunodarth/agente-monitor-/blob/main/embedded_collector.py"
click node_audit_logic "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit.py"
click node_audit_scripts "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit_scripts.py"
click node_audit_report "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit_report.py"
click node_diagnostics "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/hana_diagnostics.py"
click node_bundled "https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/bundled_resources.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_gui toneBlue
class node_ssh,node_templates,node_hana toneAmber
class node_dashboard,node_collector toneMint
class node_audit_logic,node_audit_scripts,node_audit_report,node_audit_data toneRose
class node_diagnostics,node_bundled,node_operator,node_suse,node_zabbix,node_analyzer toneIndigo
```

## Components

### Aplicação desktop

- [Inicialização](https://github.com/kimetsunodarth/agente-monitor-/blob/main/main.py): `main.py`
- [Interface Tkinter](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/gui.py): `app/gui.py`

### Operações remotas

- [Cliente SSH](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/ssh_client.py): `app/ssh_client.py`
- [Geradores de scripts](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/templates.py): `app/templates.py`

### Monitoramento

- [Dashboard HTML](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/dashboard.py): `app/dashboard.py`
- [Coletor embarcado](https://github.com/kimetsunodarth/agente-monitor-/blob/main/embedded_collector.py): `embedded_collector.py`

### Auditoria de procedures

- [Lógica de auditoria](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit.py): `app/proc_audit.py`
- [Scripts remotos](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit_scripts.py): `app/proc_audit_scripts.py`
- [Relatório de alterações](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/proc_audit_report.py): `app/proc_audit_report.py`
- **Dados de auditoria**

### Diagnóstico HANA

- [Runner de dumps](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/hana_diagnostics.py): `app/hana_diagnostics.py`
- [Recursos embarcados](https://github.com/kimetsunodarth/agente-monitor-/blob/main/app/bundled_resources.py): `app/bundled_resources.py`

### Other components

- **Operador**
- **SAP HANA**
- **Servidor SUSE**
- **Zabbix**
- **HANA Dump Analyzer**

## Connections

- Operador → Inicialização: inicia (evidence: `main.py`)
- Inicialização → Interface Tkinter: inicia (evidence: `main.py`)
- Interface Tkinter → Cliente SSH: configura e executa (evidence: `app/gui.py`)
- Interface Tkinter → Lógica de auditoria: valida configuração (evidence: `app/gui.py`)
- Interface Tkinter → Relatório de alterações: solicita relatório (evidence: `app/gui.py`)
- Interface Tkinter → Runner de dumps: instala diagnóstico (evidence: `app/gui.py`)
- Cliente SSH → Servidor SUSE: executa operações (evidence: `app/ssh_client.py`)
- Cliente SSH → SAP HANA: provisiona auditoria (evidence: `app/ssh_client.py`)
- Cliente SSH → Geradores de scripts: usa geradores (evidence: `app/ssh_client.py`)
- Cliente SSH → Lógica de auditoria: valida configuração (evidence: `app/ssh_client.py`)
- Cliente SSH → Scripts remotos: instala scripts (evidence: `app/ssh_client.py`)
- Geradores de scripts → Servidor SUSE: gera artefatos remotos
- Coletor embarcado → SAP HANA: coleta métricas
- Coletor embarcado → Zabbix: publica métricas
- Dashboard HTML → Dados de auditoria: exibe dados
- Scripts remotos → SAP HANA: consulta alterações
- Scripts remotos → Dados de auditoria: grava resultados
- Interface Tkinter → Dashboard HTML: abre dashboard (evidence: `app/gui.py`)
- Runner de dumps → Servidor SUSE: analisa dumps
- Runner de dumps → HANA Dump Analyzer: executa JAR (evidence: `app/hana_diagnostics.py`)
- Recursos embarcados → HANA Dump Analyzer: valida recursos (evidence: `app/bundled_resources.py`)
