mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review Monitor documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,218 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Avaliação e inventário | Auditoria e relatórios",
|
||||
"description": "Avaliação de Auditoria e relatórios: perfis dos relatórios, classificação dos resultados, riscos aceites, fontes ilegíveis, Lynis e inventário do nó."
|
||||
},
|
||||
"header": {
|
||||
"title": "Avaliação e inventário",
|
||||
"description": "A avaliação inspeciona o nó, mantém seus achados e responde a diferentes perguntas dependendo do perfil do relatório.",
|
||||
"section": "Auditoria e relatórios"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "read-only",
|
||||
"blocks": [
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Uma avaliação inspeciona; não altera a configuração",
|
||||
"body": "Lê a configuração e o estado da máquina. Ele escreve seus resultados, relatórios e registros, e as verificações de inicialização podem montar partições do sistema EFI por um momento. A configuração que avalia não é modificada."
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "<strong>Executar avaliação</strong> inicia uma execução com o perfil escolhido em <strong>Relatório</strong>. A vista mostra a data da última execução e o tempo decorrido."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "profiles",
|
||||
"title": "Perfis de relatórios",
|
||||
"intro": "Cada perfil responde a uma pergunta diferente. Os controlos e secções são seleccionados antes da composição do documento.",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Perfil",
|
||||
"O que cobre"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Auditoria completa",
|
||||
"Todas as verificações e toda a estrutura disponível."
|
||||
],
|
||||
[
|
||||
"Diagnóstico rápido",
|
||||
"Cada verificação; o resultado se abre com os achados críticos, as advertências e as leituras que não puderam ser verificadas."
|
||||
],
|
||||
[
|
||||
"Inventário",
|
||||
"Uma descrição do nó, sem verificações e sem classificação."
|
||||
],
|
||||
[
|
||||
"Revisão da segurança",
|
||||
"Exposição, acesso, privilégios, certificados, atualizações, repositórios e Lynis."
|
||||
],
|
||||
[
|
||||
"Garantia de backup",
|
||||
"Cobertura, idade, resultados, verificação, retenção e recuperação dos backups."
|
||||
],
|
||||
[
|
||||
"Capacidade e desgaste",
|
||||
"Margem de crescimento, memória, uso do espaço e a vida útil dos discos."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "O conteúdo de cada documento está descrito em <reportsLink>Relatórios e comparações</reportsLink>."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "results",
|
||||
"title": "Como os resultados são classificados",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Classificação",
|
||||
"Significado"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Crítico",
|
||||
"Uma condição falhada que tem prioridade."
|
||||
],
|
||||
[
|
||||
"Aviso",
|
||||
"Uma condição que precisa de uma revisão, dada a evidência ou a política."
|
||||
],
|
||||
[
|
||||
"Observação",
|
||||
"Informações sobre o nó que não é relatado como uma falha."
|
||||
],
|
||||
[
|
||||
"Não verificado",
|
||||
"Não foi possível ler a fonte necessária à verificação. Isto não significa que o problema não exista."
|
||||
],
|
||||
[
|
||||
"Conforme",
|
||||
"A condição preenche o critério aplicado."
|
||||
],
|
||||
[
|
||||
"Não aplicável",
|
||||
"Não se aplica nada no âmbito do controlo."
|
||||
],
|
||||
[
|
||||
"Risco aceite",
|
||||
"A descoberta existe e uma decisão sobre ela foi registrada."
|
||||
],
|
||||
[
|
||||
"Excluído pela política",
|
||||
"A política declara que o elemento está fora da contagem."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Os achados podem ser filtrados por área: Sistema, Armazenamento, Rede, Segurança, Backup, Convidados e Hardware. Cada achado mantém sua evidência, com a fonte da qual foi lido."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "unverified",
|
||||
"title": "Quando uma fonte não pode ser lida",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Caso",
|
||||
"Comportamento"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Não verificado",
|
||||
"A verificação mantém a sua identidade, indica nas evidências qual a fonte que falhou e não transforma dados em falta num resultado conforme."
|
||||
],
|
||||
[
|
||||
"Evidência incompleta",
|
||||
"O relatório indica a fonte e a hora da recolha para distinguir um problema real de uma leitura insuficiente."
|
||||
],
|
||||
[
|
||||
"Uma nova execução",
|
||||
"Uma vez que o acesso, pacote ou serviço é corrigido, o mesmo perfil é executado novamente e a comparação mostra se o resultado pode ser verificado."
|
||||
]
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "lynis",
|
||||
"title": "Lynis",
|
||||
"blocks": [
|
||||
{
|
||||
"p": "A revisão de segurança utiliza o relatório Lynis do anfitrião. Se Lynis nunca foi executado ou o relatório ultrapassa a antiguidade permitida pela política, um diálogo oferece <strong>Executar com Lynis</strong>, que demora alguns minutos mais, ou <strong>Executar sem Lynis</strong>, que utiliza o relatório existente."
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/monitor/audit/lynis-dialog.png",
|
||||
"alt": "Janela que se oferece para executar a avaliação com ou sem Lynis",
|
||||
"caption": "O diálogo Lynis antes de uma revisão de segurança."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "accept",
|
||||
"title": "Aceitar um risco",
|
||||
"blocks": [
|
||||
{
|
||||
"p": "<strong>Aceitar risco</strong> regista uma decisão sobre uma conclusão. A justificação é obrigatória e é guardada com o autor e a data."
|
||||
},
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Campo",
|
||||
"Opções"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Justificação",
|
||||
"Texto livre, necessário."
|
||||
],
|
||||
[
|
||||
"Deixa de aplicar-se após",
|
||||
"90 dias, 180 dias, 1 ano ou não expirar. Quando o período termina o achado torna-se ativo novamente."
|
||||
],
|
||||
[
|
||||
"Lembrar-me de rever",
|
||||
"Um lembrete que traz a decisão de volta à atenção enquanto ela permanece em vigor."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Uma conclusão aceite continua visível com a decisão; <strong>Voltar a ativo</strong> revoga a aceitação. Aceitar um risco não o corrige: a comparação apresenta-o como aceite, não como resolvido."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inventory",
|
||||
"title": "Inventário",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"Identidade, versão Proxmox VE, kernel, assinatura e cluster.",
|
||||
"CPU, memória, placa, BIOS, controladores e IOMMU.",
|
||||
"Discos, SMART, horas de energia e eventos gravados.",
|
||||
"Adaptadores, bonds, bridges, latência e ligações.",
|
||||
"Armazenamento, hóspedes com seus discos e interfaces e backups.",
|
||||
"A passagem PCI e o software ProxMenux gerenciam."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,208 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Alterações | Auditoria e relatórios",
|
||||
"description": "Registo de alterações de Auditoria e relatórios: o que o ProxMenux alterou no anfitrião, estado anterior, diferenças e possibilidade de anular."
|
||||
},
|
||||
"header": {
|
||||
"title": "Alterações",
|
||||
"description": "Registo das operações realizadas pelo ProxMenux no anfitrião e, quando capturado, do estado anterior e posterior de cada uma.",
|
||||
"section": "Auditoria e relatórios"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "purpose",
|
||||
"blocks": [
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Do script executado à alteração efetuada",
|
||||
"body": "Uma função longa pode alterar apenas duas linhas. O registo guarda cada operação concreta com o script, função e versão responsáveis, recurso afetado, diferenças e possibilidade de anular."
|
||||
}
|
||||
},
|
||||
{
|
||||
"flow": {
|
||||
"nodes": [
|
||||
{
|
||||
"label": "Script",
|
||||
"detail": "função + versão"
|
||||
},
|
||||
{
|
||||
"label": "Capturar",
|
||||
"detail": "conteúdo antes"
|
||||
},
|
||||
{
|
||||
"label": "Operação",
|
||||
"detail": "arquivo · pacote · serviço"
|
||||
},
|
||||
{
|
||||
"label": "Registo",
|
||||
"detail": "atribuição + diferença"
|
||||
}
|
||||
],
|
||||
"caption": "A captura é feita durante a operação e é consolidada quando o Monitor lê o registo."
|
||||
}
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/monitor/audit/changes-view.png",
|
||||
"alt": "Vista Alterações de Auditoria e relatórios com entradas agrupadas por opção pós-instalação e script",
|
||||
"caption": "A visão Mudanças, com a diferença de um arquivo editado por ProxMenux."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "types",
|
||||
"title": "Tipos de entrada",
|
||||
"intro": "O filtro no topo separa as entradas por tipo.",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Tipo",
|
||||
"O que grava"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Configuração",
|
||||
"ProxMenux escreveu, editou ou removeu um arquivo, alterou uma configuração ou alterou um serviço."
|
||||
],
|
||||
[
|
||||
"Instalações",
|
||||
"ProxMenux adicionou um pacote ou componente, e os pacotes que realmente apareceram são gravados."
|
||||
],
|
||||
[
|
||||
"Execuções",
|
||||
"O ProxMenux executou um comando; as alterações dependem do próprio comando."
|
||||
],
|
||||
[
|
||||
"Aplicado",
|
||||
"Uma função foi aplicada antes de existir o registo; o estado anterior não foi capturado."
|
||||
]
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "groups",
|
||||
"title": "Como se organiza a visão",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Secção",
|
||||
"Conteúdo"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Otimizações pós-instalação",
|
||||
"Agrupado pela opção pós-instalação selecionada pelo usuário."
|
||||
],
|
||||
[
|
||||
"Scripts do ProxMenux",
|
||||
"GPU, Coral, rede, armazenamento, segurança, utilitários e os outros scripts instrumentados, incluindo o instalador ProxMenux e ProxMenux Monitor."
|
||||
],
|
||||
[
|
||||
"Pacotes e utilitários instalados",
|
||||
"Software instalado pelo ProxMenux no anfitrião."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Dentro de cada seção, <strong>Por função</strong> agrupa as entradas sob a função que as fez."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "entry",
|
||||
"title": "O que cada item mostra",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"O script, função e versão responsável.",
|
||||
"A data e o recurso afetado.",
|
||||
"O estado conhecido antes e depois da mudança.",
|
||||
"As linhas adicionadas e removidas.",
|
||||
"Os pacotes que foram realmente adicionados.",
|
||||
"A transição de estado de um serviço.",
|
||||
"<strong>Anular esta alteração</strong>: <em>Repõe exatamente o estado anterior</em>, <em>Elimina o ficheiro (não existia antes)</em>, <em>O pacote pode ser desinstalado</em>, uma anulação parcial ou <em>Não pode ser anulado a partir do registo</em>."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "before",
|
||||
"title": "O que significa o estado anterior",
|
||||
"blocks": [
|
||||
{
|
||||
"p": "O estado anterior pode ser conteúdo capturado, um ficheiro criado pela primeira vez ou um estado desconhecido. As alterações anteriores ao registo não podem ser reconstruídas; voltar a executar a função captura primeiro o estado encontrado nesse momento."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "limits",
|
||||
"title": "Âmbito do registo",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"As alterações manuais e feitas por outros softwares não são gravadas.",
|
||||
"Apenas as operações que passam pelos primitivos de auditoria ProxMenux estão cobertas.",
|
||||
"A gravação nunca bloqueia a operação que descreve: se a entrada não puder ser escrita, a operação continua.",
|
||||
"Mudanças sucessivas em um recurso são mostradas como a origem conhecida contra o estado atual."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "retention",
|
||||
"title": "Provas armazenadas",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Elemento",
|
||||
"Comportamento"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Entradas",
|
||||
"As entradas são guardadas no anfitrião; nada é removido automaticamente do registo."
|
||||
],
|
||||
[
|
||||
"Conteúdo capturado",
|
||||
"Um objeto capturado é mantido enquanto uma entrada se refere a ele."
|
||||
],
|
||||
[
|
||||
"Tamanho de uma captura",
|
||||
"O conteúdo com mais de 1 MiB não é guardado na totalidade; a entrada regista que a captura foi omitida devido ao tamanho."
|
||||
],
|
||||
[
|
||||
"Leitura",
|
||||
"O Monitor não carrega objetos armazenados acima de 2 MiB."
|
||||
],
|
||||
[
|
||||
"Diferença",
|
||||
"São apresentadas no máximo 400 linhas; uma diferença maior é assinalada como truncada."
|
||||
],
|
||||
[
|
||||
"Listagem",
|
||||
"A API devolve por predefinição 200 entradas por pedido, até um máximo de 1000."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"calloutWarning": {
|
||||
"title": "Guardar o conteúdo não implica anular automaticamente",
|
||||
"body": "O conteúdo anterior pode ser consultado e reposto manualmente, mas a vista Alterações não anula operações. Uma entrada de execução regista o comando sem conhecer todos os efeitos da ferramenta executada."
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,136 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Auditoria e relatórios | ProxMenux Monitor",
|
||||
"description": "Avalie um nó Proxmox VE, registe as alterações do ProxMenux e declare o que se espera dos sistemas convidados e do armazenamento, com relatórios imprimíveis."
|
||||
},
|
||||
"header": {
|
||||
"title": "Auditoria e relatórios",
|
||||
"description": "Avaliação do nó, registo das alterações do ProxMenux e declaração das expectativas, com documentos que podem ser impressos ou guardados em PDF.",
|
||||
"section": "ProxMenux Monitor"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "views",
|
||||
"blocks": [
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Três vistas, três perguntas",
|
||||
"body": "Auditoria e relatórios distingue os factos do nó, as intervenções do ProxMenux e as expectativas declaradas. Uma configuração que não possa ser avaliada face a um objetivo declarado é descrita sem ser assinalada como falha."
|
||||
}
|
||||
},
|
||||
{
|
||||
"cards": {
|
||||
"items": [
|
||||
{
|
||||
"icon": "shield",
|
||||
"title": "Avaliação — como está o nó?",
|
||||
"body": "Realiza as verificações do perfil escolhido, compõe o inventário e classifica o que precisa de atenção, com as evidências de cada resultado."
|
||||
},
|
||||
{
|
||||
"icon": "refresh",
|
||||
"title": "Alterações — o que fez o ProxMenux?",
|
||||
"body": "Lista os ficheiros, pacotes, serviços e comandos alterados pelos scripts ProxMenux instrumentados, incluindo o estado anterior quando foi capturado."
|
||||
},
|
||||
{
|
||||
"icon": "fileText",
|
||||
"title": "Política — o que se espera?",
|
||||
"body": "Declara quais os sistemas convidados que necessitam de cópia de segurança ou devem arrancar com o anfitrião, qual o armazenamento essencial e os limiares das verificações."
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"flow": {
|
||||
"nodes": [
|
||||
{
|
||||
"label": "Avaliação",
|
||||
"detail": "factos"
|
||||
},
|
||||
{
|
||||
"label": "Política",
|
||||
"detail": "contexto"
|
||||
},
|
||||
{
|
||||
"label": "Alterações",
|
||||
"detail": "intervenções"
|
||||
}
|
||||
],
|
||||
"caption": "A avaliação fornece os factos, a política dá-lhes contexto e o registo documenta as ações do ProxMenux."
|
||||
}
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/monitor/audit/assessment-view.png",
|
||||
"alt": "Auditoria e relatórios no ProxMenux Monitor com as vistas Avaliação, Alterações e Política",
|
||||
"caption": "Auditoria e Relatório, com a visão de Avaliação aberta."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "boundaries",
|
||||
"title": "Três funções diferentes",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Função",
|
||||
"O que ele faz"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"<healthLink>Monitor de estado</healthLink>",
|
||||
"Observa métricas e eventos continuamente e pode gerar notificações."
|
||||
],
|
||||
[
|
||||
"Auditoria e relatórios",
|
||||
"Executa uma avaliação a pedido, documenta o nó e compara as execuções entre si."
|
||||
],
|
||||
[
|
||||
"Registo de alterações",
|
||||
"Regista as operações realizadas pelo ProxMenux através das suas primitivas de auditoria."
|
||||
]
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "pages",
|
||||
"title": "Páginas desta secção",
|
||||
"blocks": [
|
||||
{
|
||||
"next": {
|
||||
"items": [
|
||||
{
|
||||
"label": "Avaliação e inventário",
|
||||
"href": "/docs/monitor/audit-report/assessment",
|
||||
"tail": "Perfis, resultados, riscos aceites e inventário."
|
||||
},
|
||||
{
|
||||
"label": "Alterações",
|
||||
"href": "/docs/monitor/audit-report/changes",
|
||||
"tail": "o diário do que ProxMenux mudou no host."
|
||||
},
|
||||
{
|
||||
"label": "Política",
|
||||
"href": "/docs/monitor/audit-report/policy",
|
||||
"tail": "sistemas convidados, armazenamento e limiares."
|
||||
},
|
||||
{
|
||||
"label": "Relatórios e comparações",
|
||||
"href": "/docs/monitor/audit-report/reports",
|
||||
"tail": "os seis documentos e a execução de referência."
|
||||
},
|
||||
{
|
||||
"label": "Âmbito de aplicação e garantias",
|
||||
"href": "/docs/monitor/audit-report/scope",
|
||||
"tail": "fontes, limites e dados armazenados."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,111 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Política | Auditoria e relatórios",
|
||||
"description": "Política do nó em Auditoria e relatórios: cópia de segurança, arranque automático e objetivo de recuperação de cada sistema convidado, função de cada armazenamento e limiares das verificações."
|
||||
},
|
||||
"header": {
|
||||
"title": "Política",
|
||||
"description": "A política declara o que uma inspeção não pode deduzir: a finalidade de cada sistema convidado e armazenamento e os limiares aplicados pelas verificações.",
|
||||
"section": "Auditoria e relatórios"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "principle",
|
||||
"blocks": [
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Sem declaração o relatório descreve; com ela avalia",
|
||||
"body": "Uma avaliação vê o que o anfitrião faz, não para que serve. Um convidado sem backup cuja finalidade não é declarada é relatado como uma observação. Caso seu backup seja declarado necessário, a mesma ausência é reportada como advertência. Nada precisa ser declarado."
|
||||
}
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/monitor/audit/policy-view.png",
|
||||
"alt": "Vista Política com os sistemas convidados, armazenamento e limiares do nó",
|
||||
"caption": "A vista Política."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "guests",
|
||||
"title": "Convidados",
|
||||
"intro": "Cada VM e LXC do nó tem três campos. Um valor deixado como padrão toma o valor geral, mostrado ao lado dele.",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Campo",
|
||||
"Valores",
|
||||
"Efeito na avaliação"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Cópia de Segurança",
|
||||
"Necessário, Não exigido, Não indicado",
|
||||
"Um backup ausente é um aviso quando é necessário, uma observação quando não é indicado, e é deixado fora da contagem quando não é necessário."
|
||||
],
|
||||
[
|
||||
"Arranque automático",
|
||||
"Necessário, Não exigido, Não indicado",
|
||||
"Indica se o sistema convidado deve arrancar com o anfitrião."
|
||||
],
|
||||
[
|
||||
"Objetivo de recuperação",
|
||||
"Horas",
|
||||
"A idade máxima aceitável do último backup."
|
||||
]
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "storage",
|
||||
"title": "Armazenamento",
|
||||
"blocks": [
|
||||
{
|
||||
"p": "Um armazenamento inalcançável é relatado como crítico quando é declarado essencial ou serve um hóspede em execução, como um aviso quando seu papel não é declarado, e como uma observação quando é declarado opcional."
|
||||
}
|
||||
],
|
||||
"intro": "Cada armazenamento do nó é declarado Essencial, Opcional ou Não indicado."
|
||||
},
|
||||
{
|
||||
"id": "thresholds",
|
||||
"title": "Limiares",
|
||||
"intro": "Um limiar vazio utiliza o valor predefinido incluído, apresentado como texto indicativo.",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"Verificação da capacidade de armazenamento (%) e do preenchimento do thin pool (%).",
|
||||
"Rácio de sobreaprovisionamento thin e rácio de sobrealocação de memória.",
|
||||
"Intervalo de scrub ZFS (dias).",
|
||||
"Limite de recurso para a antiguidade das cópias de segurança (dias) e margem sobre o calendário (rácio).",
|
||||
"Aviso de validade do certificado (dias).",
|
||||
"Vida útil do disco (horas) e janela de erro do disco recente (dias).",
|
||||
"Antiguidade do relatório Lynis (dias) e do índice de pacotes (dias).",
|
||||
"Utilização do journal face ao seu limite (%).",
|
||||
"Verificação do espaço (%) e dos inodes (%) do sistema de ficheiros."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "save",
|
||||
"title": "Como a política é salva",
|
||||
"blocks": [
|
||||
{
|
||||
"p": "A declaração é validada e guardada atomicamente em <code>/usr/local/share/proxmenux/audit_policy.json</code>. Cada gravação inclui uma revisão: se outra sessão tiver alterado a declaração, o rascunho não é guardado e a vista propõe recarregar a versão gravada."
|
||||
},
|
||||
{
|
||||
"calloutWarning": {
|
||||
"title": "A política nunca é inferida",
|
||||
"body": "O ProxMenux não acrescenta requisitos por iniciativa própria. Um campo vazio mantém o valor predefinido ou fica não indicado; uma declaração parcial só afeta os elementos que menciona."
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,247 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Relatórios e comparações | Auditoria e relatórios",
|
||||
"description": "Os seis documentos de Auditoria e relatórios, a impressão ou gravação em PDF e a comparação das execuções com uma referência."
|
||||
},
|
||||
"header": {
|
||||
"title": "Relatórios e comparações",
|
||||
"description": "Seis documentos para perguntas diferentes e a comparação de cada execução com uma referência.",
|
||||
"section": "Auditoria e relatórios"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "intro",
|
||||
"blocks": [
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Seis documentos, não seis estilos",
|
||||
"body": "O motor seleciona as verificações e seções antes de compor o documento. Um diagnóstico rápido não é uma auditoria completa com menos páginas, e um inventário não apresenta resultados de avaliação. Os documentos da amostra abaixo utilizam dados fictícios."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "documents",
|
||||
"title": "Os seis documentos",
|
||||
"blocks": [
|
||||
{
|
||||
"downloads": {
|
||||
"items": [
|
||||
{
|
||||
"title": "Auditoria completa",
|
||||
"body": "Documenta todo o nó como registo técnico.",
|
||||
"href": "/monitor/audit/sample-audit-full-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "Todas as verificações disponíveis."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Resumo executivo; identidade e cluster; hardware; rede e latência; armazenamento; sistemas convidados; passthrough; aplicações; conclusões com evidências; fontes e âmbito."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Diagnóstico rápido",
|
||||
"body": "Mostra o que precisa de atenção sem o inventário completo.",
|
||||
"href": "/monitor/audit/sample-audit-diagnostic-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "Os mesmos controlos que a auditoria completa."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Identidade mínima; conclusões críticas; advertências; observações relevantes; leituras não verificadas e ações prioritárias. Diagramas, inventário e anexos longos são deixados de fora."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Inventário",
|
||||
"body": "Descreve o que existe no nó sem avaliá-lo.",
|
||||
"href": "/monitor/audit/sample-audit-inventory-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "Nenhum; nenhum achado é classificado."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Identidade; cluster; CPU e memória; placa, BIOS e controladores; rede; armazenamento; VMs e LXCs; passthrough; aplicações e elementos geridos pelo ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Revisão da segurança",
|
||||
"body": "Cobre a exposição e os controles sobre o acesso ao nó.",
|
||||
"href": "/monitor/audit/sample-audit-security-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "A área de segurança, além de privilégios de contêiner, atualizações, repositórios e a cadeia APT."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Identidade e cluster; rede e latência; acesso; firewall; 2FA; certificados; privilégios; atualizações; repositórios; estado e idade de Lynis."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Garantia de backup",
|
||||
"body": "Verifica que a proteção declarada existe e que seus backups são utilizáveis.",
|
||||
"href": "/monitor/audit/sample-audit-backup-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "A área de backup, além de conectividade de armazenamento e entrega de notificação."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Cobertura por sistema convidado; objetivo de recuperação declarado; antiguidade e resultado; destino; retenção; verificação; tarefas falhadas; recuperação e fontes incompletas."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Capacidade e desgaste",
|
||||
"body": "Mede a margem de crescimento e os sinais de esgotamento ou envelhecimento.",
|
||||
"href": "/monitor/audit/sample-audit-capacity-report.pdf",
|
||||
"facts": [
|
||||
{
|
||||
"label": "Controlos",
|
||||
"value": "As áreas de armazenamento e hardware, além de memória, swap, diário e o sistema de arquivos host."
|
||||
},
|
||||
{
|
||||
"label": "Conteúdo",
|
||||
"value": "Utilização e limiares; thin pools; sobreaprovisionamento; memória; inodes; ZFS; temperaturas; horas de funcionamento; erros SMART e vida útil NVMe/SSD."
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/monitor/audit/audit-report-preview.png",
|
||||
"alt": "Primeira página de um relatório de auditoria completo",
|
||||
"caption": "Cada documento compartilha o identificador do relatório, seções numeradas, data, nó, perfil e rodapé."
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Conforme o perfil, o documento inclui identidade do nó e data da avaliação, resumo executivo, resumo por área, estrutura de hardware, rede e armazenamento, proteção dos sistemas convidados, conclusões com evidências, fontes ilegíveis e âmbito e política aplicados."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "print",
|
||||
"title": "Impressão ou gravação como PDF",
|
||||
"blocks": [
|
||||
{
|
||||
"steps": {
|
||||
"items": [
|
||||
{
|
||||
"title": "Executar",
|
||||
"body": "A avaliação utiliza o perfil selecionado em <strong>Relatório</strong>."
|
||||
},
|
||||
{
|
||||
"title": "Revisão",
|
||||
"body": "A execução final mostra suas descobertas, as fontes que não pôde ler e a política que aplicou."
|
||||
},
|
||||
{
|
||||
"title": "Gerar relatório",
|
||||
"body": "<strong>Gerar relatório</strong> abre a vista preparada como documento."
|
||||
},
|
||||
{
|
||||
"title": "Imprimir",
|
||||
"body": "<strong>Imprimir ou guardar como PDF</strong> abre o diálogo de impressão do navegador para escolher uma impressora ou <em>Guardar como PDF</em>."
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"calloutTip": {
|
||||
"title": "A impressão é um documento, não uma imagem",
|
||||
"body": "A barra de ação está escondida, uma tabela que continua na próxima página repete seu cabeçalho, blocos evitam quebras desnecessárias e cada página mantém a identificação e numeração."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "compare",
|
||||
"title": "Comparando com uma execução de referência",
|
||||
"intro": "<strong>Usar como referência</strong> marca uma execução terminada. As seguintes são comparadas com ela e as conclusões são agrupadas em:",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Grupo",
|
||||
"Significado"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Novo",
|
||||
"Informado agora e não antes."
|
||||
],
|
||||
[
|
||||
"Pioraram",
|
||||
"Continuam presentes, mas são mais graves ou abrangentes do que antes."
|
||||
],
|
||||
[
|
||||
"Melhoraram",
|
||||
"Continuam presentes, mas são menos graves ou abrangentes do que antes."
|
||||
],
|
||||
[
|
||||
"Resolvido",
|
||||
"Já não são apresentados e ninguém os aceitou."
|
||||
],
|
||||
[
|
||||
"Aceites",
|
||||
"Não mais contado porque um risco foi aceito, não porque o hospedeiro mudou."
|
||||
],
|
||||
[
|
||||
"Já não avaliados",
|
||||
"Presentes antes mas ausentes desta execução; não foi verificado que tenham desaparecido."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Execução de referência",
|
||||
"Comportamento"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Configurando",
|
||||
"Qualquer execução terminada pode ser marcada; nenhuma é marcada automaticamente."
|
||||
],
|
||||
[
|
||||
"Mudando",
|
||||
"Marcar outra execução muda a referência sem eliminar o histórico."
|
||||
],
|
||||
[
|
||||
"Comparando",
|
||||
"Quando não são selecionadas duas execuções, a comparação usa a referência e a execução selecionada ou mais recente."
|
||||
],
|
||||
[
|
||||
"Conservar execuções",
|
||||
"São conservadas as 30 execuções mais recentes; a referência nunca é removida."
|
||||
],
|
||||
[
|
||||
"Sem referência",
|
||||
"A vista indica que ainda não foi escolhida uma execução de referência, pelo que não existe base de comparação."
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"calloutWarning": {
|
||||
"title": "Um relatório descreve um momento",
|
||||
"body": "Uma avaliação não certifica um período inteiro. Os resultados antigos deixam de descrever o estado atual; a vista mostra a antiguidade da última execução e cada fonte conserva a hora da recolha."
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Âmbito e garantias | Auditoria e relatórios",
|
||||
"description": "Origem dos dados de Auditoria e relatórios, limites do âmbito, garantias da conceção e localização dos dados."
|
||||
},
|
||||
"header": {
|
||||
"title": "Âmbito e garantias",
|
||||
"description": "De onde vêm os dados de uma avaliação, o que fica fora do seu âmbito e onde Auditoria e relatórios guarda os dados.",
|
||||
"section": "Auditoria e relatórios"
|
||||
},
|
||||
"sections": [
|
||||
{
|
||||
"id": "sees",
|
||||
"title": "O que observa",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"A configuração e o estado do nó local.",
|
||||
"A configuração declarada das VMs e LXCs.",
|
||||
"O estado do armazenamento tal como é conhecido pelo Proxmox VE.",
|
||||
"O histórico disponível de backups e verificações.",
|
||||
"Dados SMART e os eventos que o Monitor recolheu.",
|
||||
"O estado dos serviços, cluster, HA e fontes locais."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "outside",
|
||||
"title": "O que está fora da sua visão",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"O interior dos convidados, além do que eles declaram para Proxmox VE.",
|
||||
"Equipamento de rede fora do hospedeiro.",
|
||||
"Dependências remotas que o nó não consegue observar.",
|
||||
"Estado físico que o hardware não expõe.",
|
||||
"O registo de alterações não inclui ações manuais ou de outro software."
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"calloutWarning": {
|
||||
"title": "Provas em falta não são provas de ausência",
|
||||
"body": "Uma fonte que não pode ser lida dá um resultado não verificado ou incompleto, nunca conforme. O relatório enumera as fontes que não estavam disponíveis."
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "guarantees",
|
||||
"title": "Garantias do projecto",
|
||||
"blocks": [
|
||||
{
|
||||
"list": {
|
||||
"items": [
|
||||
"Identificadores estáveis para as verificações.",
|
||||
"Histórico de execuções e conclusões.",
|
||||
"Uma política validada, salva atomicamente.",
|
||||
"Riscos aceitos com uma razão, visíveis.",
|
||||
"Atribuição de alterações ao script e função.",
|
||||
"Captura do estado anterior e posterior, quando disponível.",
|
||||
"Um resultado explícito quando algo não pode ser medido ou capturado."
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "storage",
|
||||
"title": "Onde são guardados os dados",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Dados",
|
||||
"Localização"
|
||||
],
|
||||
"rows": [
|
||||
[
|
||||
"Política",
|
||||
"<code>/usr/local/share/proxmenux/audit_policy.json</code>"
|
||||
],
|
||||
[
|
||||
"Avaliações",
|
||||
"A base de dados de auditoria do Monitor"
|
||||
],
|
||||
[
|
||||
"Objetos capturados",
|
||||
"<code>/usr/local/share/proxmenux/changes/objects/</code>"
|
||||
],
|
||||
[
|
||||
"Entradas pendentes",
|
||||
"<code>/usr/local/share/proxmenux/changes/spool/</code>"
|
||||
],
|
||||
[
|
||||
"Registo consolidado",
|
||||
"<code>/usr/local/share/proxmenux/changes.db</code>"
|
||||
]
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"calloutInfo": {
|
||||
"title": "Uma ferramenta para rever, não uma certificação",
|
||||
"body": "Auditoria e relatórios revê, compara e documenta o nó. Os resultados são interpretados de acordo com a finalidade do sistema, a política declarada e as fontes disponíveis."
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user