Módulo System

O módulo system fornece funções para obter informações sobre o sistema operacional, rede e ambiente de execução do agente. Este módulo é útil para scripts que precisam adaptar seu comportamento com base no ambiente, coletar informações de inventário ou realizar diagnósticos do sistema.

Características principais:

• Informações detalhadas do sistema operacional

• Nome do host e informações de rede

• Dados do agente (UUID, versão)

• Informações de kernel e distribuição

• Interface unificada para diferentes sistemas operacionais

Funções Disponíveis

1. system.env()

Retorna informações completas sobre o ambiente de execução do agente.

Parâmetros:

• Nenhum

Retorno:

• tabela: Estrutura com os seguintes campos:

  • os_type (string): Tipo do sistema operacional (ex: “linux”, “windows”, “macos”)

  • os_name (string): Nome do sistema operacional (ex: “Ubuntu”, “Windows 10”, “macOS”)

  • os_version (string): Versão do sistema operacional

  • kernel_version (string): Versão do kernel

  • agent (tabela ou nil): Informações do agente Monagent (se disponível):

    • uuid (string): UUID único do agente

    • version (string): Versão do Monagent

Exemplo de Uso:

-- Obter todas as informações do ambiente
local env_info = system.env()

print("Tipo do SO:", env_info.os_type)
print("Nome do SO:", env_info.os_name)
print("Versão do SO:", env_info.os_version)
print("Versão do Kernel:", env_info.kernel_version)

if env_info.agent then
    print("UUID do Agente:", env_info.agent.uuid)
    print("Versão do Monagent:", env_info.agent.version)
else
    print("Informações do agente não disponíveis")
end

-- Adaptar comportamento baseado no SO
local env = system.env()

if env.os_type == "linux" then
    -- Comandos específicos para Linux
    local saida, erro = process.exec("ps", "aux")
elseif env.os_type == "windows" then
    -- Comandos específicos para Windows
    local saida, erro = process.exec("tasklist")
elseif env.os_type == "macos" then
    -- Comandos específicos para macOS
    local saida, erro = process.exec("ps", "-ef")
end

2. system.hostname()

Retorna o nome do host do sistema.

Parâmetros:

• Nenhum

Retorno:

• string: Nome do host do sistema, ou “unknown” se não puder ser determinado

Exemplo de Uso:

-- Obter nome do host
local nome_host = system.hostname()
print("Nome do host:", nome_host)

-- Usar em identificadores únicos
local identificador = nome_host .. "_" .. os.date("%Y%m%d_%H%M%S")
print("Identificador único:", identificador)

-- Verificar se é um host específico
if nome_host == "servidor-producao" then
    log.info("Executando em servidor de produção")
    config.modo = "producao"
elseif string.find(nome_host:lower(), "test") then
    log.info("Executando em ambiente de teste")
    config.modo = "teste"
else
    log.info("Executando em host desconhecido:", nome_host)
    config.modo = "desenvolvimento"
end

-- Criar tags para métricas
local tags_metricas = {
    host = nome_host,
    ambiente = config.modo,
    timestamp = os.time()
}

3. system.networks()

Retorna uma lista de endereços IP de rede não-loopback do sistema.

Parâmetros:

• Nenhum

Retorno:

• array de strings: Lista de endereços IP das interfaces de rede (excluindo loopback)

Comportamento:

• Exclui endereços de loopback (127.0.0.1, ::1, etc.)

• Inclui endereços IPv4 e IPv6

• Atualiza a lista de interfaces antes de retornar

• Retorna apenas endereços IP, não nomes de interface

Exemplo de Uso:

-- Obter todos os endereços IP do sistema
local enderecos_ip = system.networks()

print("Endereços IP disponíveis:")
for i, ip in ipairs(enderecos_ip) do
    print("  " .. i .. ". " .. ip)
end

-- Identificar endereços IPv4 vs IPv6
local function classificar_enderecos()
    local enderecos = system.networks()
    local classificacao = {
        ipv4 = {},
        ipv6 = {},
        outros = {}
    }

    for _, ip in ipairs(enderecos) do
        if string.find(ip, ":") then
            -- IPv6
            table.insert(classificacao.ipv6, ip)
        elseif string.match(ip, "^%d+%.%d+%.%d+%.%d+$") then
            -- IPv4
            table.insert(classificacao.ipv4, ip)
        else
            -- Outro formato
            table.insert(classificacao.outros, ip)
        end
    end

    return classificacao
end

local ips = classificar_enderecos()
print("IPv4:", #ips.ipv4, "endereços")
print("IPv6:", #ips.ipv6, "endereços")

-- Encontrar endereço preferido para comunicação
local function encontrar_endereco_preferido()
    local enderecos = system.networks()

    -- Prioridade: IPv4 privado > IPv4 público > IPv6
    for _, ip in ipairs(enderecos) do
        -- Verificar se é IPv4 privado
        if string.match(ip, "^10%.") or
           string.match(ip, "^172%.%d?%d?%d?%.") or
           string.match(ip, "^192%.168%.") then