Files

245 lines
20 KiB
JSON
Raw Permalink Normal View History

{
"meta": {
"title": "ProxMenux Monitor — Painel: VM e LXC | Documentação ProxMenux",
"description": "O separador VMs e LXCs inventaria todos os sistemas convidados do anfitrião com utilização de CPU, memória e disco em direto. Os detalhes de cada um mostram configuração, recursos, cópias de segurança, o registo de consola dos contentores OCI, notas e Iniciar / Desligar / Reiniciar / Forçar paragem."
},
"header": {
"title": "Painel: VM e LXC",
"description": "Inventário completo dos sistemas convidados do nó: quatro métricas no topo, lista ordenável de cada VM e LXC por baixo e detalhes com configuração, recursos, cópias de segurança, o registo de consola dos contentores OCI e os quatro controlos de ciclo de vida (Iniciar / Desligar / Reiniciar / Forçar paragem).",
"section": "ProxMenux Monitor · Painel"
},
"intro": {
"title": "Controlos dos sistemas convidados",
"body": "Este separador controla o ciclo de vida dos sistemas convidados. As ações de ciclo de vida passam por <code>POST /api/vms/&lt;vmid&gt;/control</code>; Reiniciar e Forçar paragem pedem que escreva o VMID para confirmar, e a resposta reflete-se na linha do sistema. O desligamento forçado exige o botão específico Forçar paragem."
},
"topRow": {
"heading": "Linha superior: quatro cartas estatísticas",
"intro": "Quatro cartões resumem o estado dos sistemas convidados: totais, uso CPU, memória atribuída face à capacidade do host e espaço de disco atribuído.",
"imageAlt": "Página VMs & LXCs — linha superior de quatro placas estatísticas: Total de VMs & LXCs, Total de CPU, Memória Total, Disco Total",
"imageCaption": "Linha superior: totais e estados Em execução / Parados, uso CPU, memória utilizada / atribuída a sistemas ativos / atribuída total com indicador Dentro dos limites e espaço de disco atribuído.",
"headerCard": "Cartão",
"headerWhat": "O que mostra",
"totalLabel": "Total de VMs e LXCs",
"totalWhat": "Contagem total com dois emblemas — <em>X Running</em> (verde) e <em>Y parado</em> (vermelho, apenas quando > 0). O número que vês quando algo não aparece depois de uma reinicialização.",
"cpuLabel": "CPU total",
"cpuWhat": "Utilização CPU total em direto dos sistemas convidados, como percentagem da CPU física do host, com o texto <em>“Uso CPU atribuído”</em>.",
"memoryLabel": "Memória total",
"memoryIntro": "Três leituras empilhadas verticalmente:",
"memoryItems": [
"<strong>Utilizada atualmente</strong> — valor principal, como <em>15.4 GB</em>, e <em>X.X % de Y GB</em> face à RAM do host. A barra azul indica a percentagem.",
"<strong>Atribuída aos ativos</strong> + <strong>Atribuída total</strong> — soma de <code>maxmem</code> dos sistemas <em>em execução</em> e de <em>todos</em>, incluindo os parados. A primeira importa agora, a segunda ao iniciá-los todos.",
"<strong>Dentro dos limites</strong>, a verde, muda para <em>Sobre-alocada</em> se o total ultrapassar a RAM do host. Uma sobre-alocação controlada pode funcionar com KSM; o indicador avisa quando a margem diminui."
],
"diskLabel": "Disco total",
"diskWhat": "Soma do espaço em disco alocado em todos os hóspedes, na unidade apropriada (GB / TB), com a linha de rodapé <em>\"Espaço em disco alocado\"</em>."
},
"inventory": {
"heading": "Lista de máquinas virtuais e contentores",
"intro": "Uma fila por convidado. A lista é de origem única a partir de <code>/api/vms</code>, que consolida <code>qm list</code> + <code>pct list</code> + <code>pvesh /cluster/resources</code> no host.",
"imageAlt": "Lista de máquinas virtuais e contentores — uma linha por sistema, com estado, tipo, nome, ID e percentagens CPU/memória/disco",
"imageCaption": "O layout otimizado para dispositivos móveis do inventário — os mesmos dados que a área de trabalho mostra, recolocado em uma única coluna com as porcentagens e indicadores de status mantidos compactos.",
"rowsIntro": "Cada linha mostra:",
"rows": [
"<strong>Ícone de estado</strong> — triângulo verde para Em execução ou quadrado vermelho para Parado. O restante da linha fica atenuado nos sistemas parados.",
"<strong>Tipo</strong> — <em>LXC</em> a ciano para contentores, <em>VM</em> a roxo para máquinas virtuais.",
"<strong>Nome</strong> — nome do host ou nome apresentado do sistema convidado.",
"<strong>VMID</strong> — o ID numérico Proxmox abaixo do nome.",
"<strong>Metricas em linha</strong> — três percentagens com o seu ícone (CPU %, Memória %, Disco %). Cada ícone fica laranja quando a métrica cruza um limiar de atenção (por exemplo, memória acima de 90 %), então uma varredura rápida lhe diz qual hóspede está sob pressão sem abri-lo."
],
"clickHint": "Clique numa linha para abrir os detalhes, esteja o sistema em execução ou parado.",
"mobileTitle": "Lista concebida para dispositivos móveis",
"mobileBody": "Em telemóveis e janelas estreitas, tipo, nome, ID e três percentagens ficam empilhados numa coluna, como na imagem. Em ecrãs largos distribuem-se na horizontal. Toda a linha permite abrir os detalhes."
},
"drillIn": {
"heading": "Janela de detalhes do sistema convidado",
"intro": "A janela mostra nome, VMID, tipo, estado e tempo de atividade. Os separadores adaptam-se ao sistema: <strong>Estado</strong>, <strong>App</strong> e <strong>Atualizações</strong> para aplicações LXC, <strong>Montagens</strong> quando existem, <strong>Registos</strong> para contentores OCI manager Apps, <strong>Cópias de segurança</strong> e <strong>Firewall</strong>. A barra fixa mantém os controlos de ciclo de vida e o terminal LXC disponíveis.",
"statusTitle": "Página 1 — Estado",
"statusImageAlt": "Detalhes do sistema — Estado com CPU, memória e disco em direto, E/S de disco e rede, logótipo do sistema e Recursos / Endereços IP",
"statusImageCaption": "Estado: CPU, memória e disco com barras no topo; totais de E/S (disco lido/escrito, rede recebida/enviada); depois Recursos com Notas, + Info e lista de endereços IP.",
"statusIntro": "O separador inicial permite verificar o estado do sistema. Três blocos:",
"liveTitle": "1. Linha de métricas ao vivo",
"liveItems": [
"<strong>Utilização CPU (X núcleos)</strong> — percentagem com barra. O número de núcleos configurados no cabeçalho esclarece o que significa 100 %.",
"<strong>Memória</strong> — <em>utilizada / máxima</em> em GB com barra.",
"<strong>Disco</strong> — <em>utilizado / máximo</em> da imagem de disco principal, no mesmo formato."
],
"ioTitle": "2. Total I/O + Logótipo do sistema operacional",
"ioItems": [
"<strong>E/S de disco</strong> — totais de leitura (↓) e escrita (↑) desde o arranque. Ajuda a detetar aumentos súbitos face à atividade habitual do sistema convidado.",
"<strong>E/S de rede</strong> — receção (↓) e envio (↑) acumulados, com o mesmo princípio.",
"<strong>Logótipo do sistema</strong> — ícone Debian / Ubuntu / Alpine / Windows / etc. conforme o sistema detetado. Ajuda a identificar as janelas abertas."
],
"resourcesTitle": "3. Bloco de recursos",
"resourcesIntro": "Configuração segundo o Proxmox: núcleos CPU, memória (<code>maxmem</code> configurado) e swap. Duas secções expansíveis no cabeçalho:",
"resourcesItems": [
"<strong>Notas</strong> — descrição editável do sistema convidado. Guardar chama <code>PUT /api/vms/&lt;vmid&gt;/config</code> e escreve em <code>/etc/pve/qemu-server/&lt;vmid&gt;.conf</code> ou <code>/etc/pve/lxc/&lt;vmid&gt;.conf</code>.",
"<strong>+ Info</strong> — campos extras que são muito verbosos para a visualização padrão: modo bios, tipo de máquina, estado do agente, entradas hostpci passthrough, pontos de montagem (CT), ordem de inicialização."
],
"ipsTitle": "4. Endereços IP",
"ipsBody": "Cada endereço IPv4 ou IPv6 aparece numa etiqueta verde. A lista fica vazia com o sistema parado ou numa VM sem agente QEMU; os LXC comunicam os endereços diretamente.",
"appTitle": "Página 2 — Aplicação (LXC apenas)",
"appIntro": "Regista aplicações LXC, guarda ligações web e compara versões opcionalmente. As sugestões vêm da cache inicial; <strong>Procurar aplicações</strong> repete a deteção neste LXC após novas instalações.",
"appLinkLead": "Veja o",
"appLinkLabel": "página de aplicação dedicada",
"appLinkTail": "para descoberta em cache, registro assistido por catálogo, links web Docker e detectores de versões.",
"updatesTitle": "Página 3 — Actualizações (LXC apenas)",
"updatesIntro": "Mantém separados <strong>pacotes do sistema</strong>, aplicações, <strong>Docker Engine</strong> e imagens Docker. Cada alvo pode ser executado sozinho ou selecionado para uma ação em bloco ou agendada.",
"updatesLinkLead": "Veja o",
"updatesLinkLabel": "página de atualizações dedicadas",
"updatesLinkTail": "para atualizadores integrados e personalizados, recriação Docker, seleção em bloco, opções de segurança e agendamento.",
"mountsTitle": "Tab 4 — Montagens (LXC apenas, quando presente)",
"mountsImageAlt": "Detalhes LXC, Montagens: volumes PVE, bind mounts do host ou armazenamento PVE e NFS/CIFS montados no CT. Cada cartão mostra tipo, capacidade, bytes utilizados/totais, opções e estado: verde normal, âmbar só leitura/divergente, vermelho inacessível.",
"mountsImageCaption": "Montagens só aparece em LXC com pelo menos um ponto de montagem ou montagem remota adicionada. Sem montagens, o separador está ausente.",
"mountsIntro": "O Proxmox mostra montagens configuradas como <code>mpX</code>, mas não as adicionadas depois no CT com <code>mount.cifs</code>, NFS via <code>autofs</code>, etc. Este separador reúne <strong>as duas vistas</strong>: montagens configuradas <strong>e</strong> detetadas no contentor, com estado e capacidade quando o servidor a consegue obter.",
"mountTypesTitle": "Tipos de montagem detectados",
"mountTypesItems": [
"<strong>Volume PVE</strong> — armazenamento gerido pelo Proxmox, como subvolume ZFS, diretório ou Ceph RBD. A capacidade vem das estatísticas PVE e coincide com o Proxmox.",
"<strong>Bind de armazenamento PVE</strong> — entrada <code>mpX</code> que aponta para um caminho de armazenamento conhecido pelo PVE.",
"<strong>Bind do host</strong> — entrada <code>mpX</code> com um caminho arbitrário do host (<code>/mnt/something</code>). A capacidade vem de <code>df</code> desse caminho.",
"<strong>Ad-hoc dentro de CT</strong> — montagem que <em>somente</em> existe no namespace de montagem do contêiner (por exemplo, um compartilhamento NFS que o CT monta sozinho). A capacidade é lida por meio de <code>pct exec &lt;vmid&gt; df</code>, que é a única maneira de vê-la - <code>/proc/&lt;pid&gt;/root</code> do host não expõe as estatísticas reais da montagem remota."
],
"mountStateTitle": "Ponto de estado e avisos por cartão",
"mountStateItems": [
"<green/> <strong>Verde</strong> — montagem normal e acessível.",
"<amber/> <strong>Âmbar</strong> — configurado mas não montado, só leitura ou <em>bind zombie</em>. A origem desapareceu do host mas o CT ainda a vê montada, por exemplo após desligar um disco USB ou executar <code>umount</code> no host.",
"<red/> <strong>Vermelho</strong> — inacessível: a verificação não alcança a montagem, por exemplo uma partilha NFS com servidor indisponível."
],
"mountsCalloutTitle": "Informação adicional face ao Proxmox",
"mountsCalloutBody": "Vista dos caminhos lidos e escritos pelo contentor e respetiva capacidade. Partilhas NFS/CIFS montadas no CT, invisíveis no Proxmox, têm aqui a mesma apresentação e controlo. Montagens inacessíveis e binds zombie são assinalados antes de causarem problemas numa cópia de segurança.",
"logsTitle": "Tab 5 — Registos (apenas contentores OCI)",
"logsBody": "Só para contentores OCI manager Apps. Mostra a consola do processo principal da imagem em <code>/var/log/proxmenux/oci/VMID.console.log</code>: últimas 100, 500 ou 1000 linhas, acompanhamento em direto enquanto ativo, filtro e transferência. Relê o ficheiro ao abrir, mesmo com o contentor parado. Detalhes: <ociLink>Contentores OCI no ProxMenux Monitor</ociLink>.",
"backupsTitle": "Página 6 — Cópias de segurança",
"backupsImageAlt": "Detalhes do sistema — Cópias de segurança com lista de cópias disponíveis, destinos, tamanhos e botão Criar cópia",
"backupsImageCaption": "Todas as cópias do sistema nos armazenamentos Proxmox configurados, da mais recente à mais antiga. O cabeçalho mostra a contagem.",
"backupsIntro": "Lista as cópias do sistema nos armazenamentos Proxmox, da mais recente à mais antiga. O contador no título permite ver se existem cópias. Cada linha mostra:",
"backupsItems": [
"<strong>Data e hora</strong> — momento da execução.",
"<strong>Destino</strong> — armazenamento (PBS-Cloud, PBS-Local, NFS-Backup, …), colorido conforme o estado.",
"<strong>Tamanho</strong> — tamanho final em disco da cópia."
],
"backupsOutro": "<strong>+ Criar cópia de segurança</strong> inicia uma cópia no armazenamento marcado “Backup target” no Proxmox. O restauro faz-se na interface web Proxmox; o Monitor mostra as cópias recentes do sistema e permite criar novas.",
"firewallTitle": "Página 7 — Firewall",
"firewallIntro": "Lê o registo do firewall Proxmox de cada sistema diretamente do host, sem serviço adicional nem consultas periódicas. O separador está sempre presente; o conteúdo depende da ativação do firewall e de uma regra registar pacotes.",
"firewallItems": [
"<strong>Firewall desativado</strong> — um aviso a laranja indica onde o ativar no Proxmox (<em>&lt;Container|VM&gt; → Firewall → Options</em>) e recorda que pelo menos uma regra precisa de <code>log: info</code> ou nível superior para os pacotes aparecerem.",
"<strong>Firewall ativo, sem eventos</strong> — a vista vazia lembra o requisito de registo, útil logo após a ativação.",
"<strong>Eventos presentes</strong> — painel monoespaçado com deslocamento e entradas originais por ação: <green>ACCEPT</green> verde, <orange>REJECT</orange> laranja, <red>DROP</red> vermelho. O contador no cabeçalho mostra as entradas carregadas."
],
"firewallRefresh": "<em>Atualizar</em> carrega as entradas recentes a pedido. Sem atualização automática, a lista mostra o momento da abertura ou do último clique. A origem é <code>/var/log/pve-firewall.log</code>, filtrada por VMID através de <code>GET /api/vms/&lt;vmid&gt;/firewall/log</code>.",
"firewallCalloutTitle": "Porquê tê-lo aqui quando a UI Proxmox já o mostra?",
"firewallCalloutBody": "Evita mudar para o Proxmox e mantém a vista do mesmo VMID: inicie o sistema, verifique montagens e eventos do firewall e volte a pará-lo no painel. As regras editam-se no Proxmox; o Monitor não as altera.",
"actionBarTitle": "Barra de ação inferior",
"actionBarIntro": "Sempre visível no pé do modal, independentemente da aba ativa:",
"consoleItem": "<strong>Consola</strong>, apenas em LXC ativos, abre <code>pct enter &lt;vmid&gt;</code> no contentor. Usa xterm.js e WebSocket como o <link>separador Terminal</link>, com a <strong>barra móvel</strong>: ESC, TAB, setas, Enter e Ctrl+C / Ctrl+X / Ctrl+R. Funciona em telemóvel ou tablet. Para VM use a consola Proxmox noVNC.",
"lifecycleIntro": "Quatro botões em grelha 2×2 enviam <code>POST /api/vms/&lt;vmid&gt;/control</code> com a <code>action</code> correspondente. A disponibilidade depende do estado do sistema.",
"headerButton": "Botão",
"headerEnabled": "Activado quando",
"headerAction": "Acção enviada para a máquina",
"lifecycleRows": [
{
"button": "Iniciar",
"color": "green",
"enabled": "O hóspede está parado.",
"action": "qm start / pct start"
},
{
"button": "Desligar",
"color": "blue",
"enabled": "O sistema convidado está em execução.",
"action": "qm shutdown / pct shutdown — desligamento ordenado, ACPI"
},
{
"button": "Reiniciar",
"color": "blue",
"enabled": "O sistema convidado está em execução.",
"action": "qm reboot / pct reboot — reinício ordenado"
},
{
"button": "Forçar parada",
"color": "red",
"enabled": "O sistema convidado está em execução.",
"action": "qm stop / pct stop — desligamento forçado"
}
],
"forceStopTitle": "Forçar paragem interrompe imediatamente a execução",
"forceStopBody": "<strong>Forçar paragem</strong> ignora o desligamento, como cortar a alimentação. Use <strong>Desligar</strong> enquanto o sistema responder. Force apenas se o desligamento bloquear e aceitar o risco de perda de dados. O botão vermelho e a etiqueta ajudam a evitar cliques acidentais."
},
"dataCollected": {
"heading": "Como os dados são coletados",
"headerSection": "Secção da página",
"headerEndpoint": "Endpoint",
"headerSource": "Origem",
"rows": [
{
"section": "Lista de inventários",
"endpoint": "/api/vms",
"source": "<code>pvesh get /cluster/resources --type vm</code> para VMs e CTs."
},
{
"section": "Painel de detalhes (configuração, rede, discos)",
"endpoint": "/api/vms/<vmid>",
"source": "<code>qm config &lt;id&gt;</code> para VMs / <code>pct config &lt;id&gt;</code> para CTs."
},
{
"section": "Gráfico de métricas do sistema convidado",
"endpoint": "/api/vms/<vmid>/metrics",
"source": "Dados PVE RRD (<code>pvesh get /nodes/&lt;node&gt;/qemu/&lt;id&gt;/rrddata</code>) condensados a uma forma amigável a gráficos."
},
{
"section": "Registo de consola OCI (separador Logs)",
"endpoint": "/api/lxc/<vmid>/console-log",
"source": "Saída de consola do processo principal da imagem, lida de <code>/var/log/proxmenux/oci/&lt;vmid&gt;.console.log</code> no anfitrião. Mostrado apenas para contentores OCI."
},
{
"section": "Backups disponíveis para hóspedes",
"endpoint": "/api/vms/<vmid>/backups",
"source": "<code>pvesm list &lt;storage&gt;</code> filtrado por VMID."
},
{
"section": "Registo do firewall do sistema convidado (separador Firewall)",
"endpoint": "/api/vms/<vmid>/firewall/log",
"source": "<code>/var/log/pve-firewall.log</code> filtrado por VMID."
},
{
"section": "Botões de energia (Iniciar / Parar / Reiniciar / Desligar)",
"endpoint": "/api/vms/<vmid>/control",
"source": "Equivalências <code>qm start|stop|reboot|shutdown</code> ou <code>pct</code>."
}
],
"codeComment1": "# Comparar os dados do painel com PVE",
"codeComment2": "# Inspecionar a configuração do sistema como aparece na janela",
"codeComment3": "# VM",
"codeComment4": "# CT"
},
"whereNext": {
"heading": "Para onde seguir",
"items": [
{
"label": "Monitor de Saúde",
"href": "/docs/monitor/health-monitor",
"tailRich": " — a categoria VMs & Containers (boot falhado, tempo limite QMP, falhas de desligamento CT)."
},
{
"label": "Notificações",
"href": "/docs/monitor/notifications",
"tailRich": " — o que os acontecimentos <code>vm_*</code>, <code>ct_*</code>, <code>migration_*</code> e <code>backup_*</code> provocam a jusante."
},
{
"label": "Referência da API",
"href": "/docs/monitor/api",
"tailRich": " — endpoints de VM e cópias de segurança."
},
{
"label": "Índice do painel",
"href": "/docs/monitor/dashboard",
"tailRich": " — os outros separadores."
},
{
"label": "ProxMenux → Criar VM",
"href": "/docs/create-vm",
"tailRich": " — criação de sistemas: modelos NAS (Synology e outros), VM Linux/Windows e valores adaptados ao Proxmox."
}
]
}
}