Apresentando a linguagem de script Lua do KNM

O Kaseya Network Monitor oferece suporte à linguagem de script Lua. A Lua é uma linguagem de programação leve e poderosa, projetada para ampliar as funcionalidades das aplicações. Com a Lua, os clientes podem criar monitores personalizados para testar sistemas e equipamentos que não são suportados por nenhum monitor integrado.

• É possível criar e testar novos monitores, ações e eventos no ambiente de desenvolvimento fornecido pela Kaseya, antes de exportá-los e utilizá-los no Kaseya Network Monitor.
• Uma biblioteca abrangente de classes predefinidas, como cliente SFTP, cliente HTTP e gerenciamento de arquivos, está disponível para os desenvolvedores.
• O ambiente de desenvolvimento inclui depurador, destaque de palavras-chave, ajuda integrada e outros recursos disponíveis em ferramentas de desenvolvimento de última geração.

Scripts incluídos

No instalador padrão do KNM, há vários scripts agrupados. Os scripts estão localizados no diretório "script" na pasta KNM. Os scripts incluídos são um ótimo ponto de partida se você quiser aprender a desenvolver seu próprio script.

ApacheStatus_.lua
Monitora os threads de trabalho em um servidor web Apache

BackupExec_.lua / BackupExec_11D_.lua
Monitora o status de conclusão das tarefas de backup.

CheckCertificateExpiryTime_.lua
Verifica se um certificado HTTP está prestes a expirar; o prazo pode ser definido em dias.

CiscoIPSecGlobalTunnelBandwidth_.lua
Monitora o uso da largura de banda de todos os túneis IPSec abertos em um firewall.

CiscoIPSecTunnelBandwidth_.lua
Monitora a largura de banda de um túnel IPSec específico (nomeado).

iLoHealth_.lua
Monitora os parâmetros de estado de saúde de um computador de vigilância HP iLo2.

PrinterOutOfPaper_.lua
Verifica se uma impressora conectada ao Windows está sem papel.

WBEM_ESXi_HP_Fan_Status_.lua
WBEM_ESXi_HP_PSU_Status_.lua
WBEM_ESXi_HP_RaidArray_Status_.lua
Monitora os parâmetros de hardware do VMware ESXi (estado de integridade das ventoinhas, matrizes RAID e fontes de alimentação)

Etapas para começar a desenvolver scripts

Primeiro, você precisa fazer o download do IDE Lua. Ele é fornecido com o KNM e tudo o que você precisa fazer é acessar a interface da Web do KNM e ir para a página "About" (Sobre).

Clique no link do IDE Lua e faça o download do instalador. Inicie o instalador e siga as instruções na tela. Quando o instalador estiver concluído, localize o Lua IDE no menu Iniciar e inicie-o.

Os scripts escritos devem aderir ao modelo de programação do KNM. Para começar rapidamente e evitar escrever código padrão, você pode usar um modelo de script. No menu "Insert code" (Inserir código), clique no item de menu "insert template script" (Inserir script modelo).

Antes de podermos executar o depurador e testar esse código padrão, precisamos adicionar um novo host. O script KNM Lua é sempre executado no contexto de um host. As chamadas de API são sempre relativas a um host, o que significa que não é possível executar ações em máquinas diferentes na mesma instância de um script. Portanto, antes de iniciar uma sessão de depuração, sempre precisamos selecionar um host.

Clique em "Open host list" (Abrir lista de hosts) na barra de ferramentas e adicione um host inserindo-o no campo de texto abaixo da lista e clique em "Add host" (Adicionar host). Depois de adicionado, selecione-o na lista e clique no botão "select host" (selecionar host).

Para testar os scripts de modelo que acabaram de ser inseridos no documento vazio, clique na roda dentada na barra de ferramentas ou pressione CTRL+F5 para iniciar uma nova sessão de depuração.

O script será executado pelo IDE exatamente da mesma forma que o KNM o executará; a interface será emulada usando controles padrão do Windows.

Para saber mais sobre como usar o IDE e a API Lua, abra o link abaixo.

Clique aqui para abrir a documentação da API Lua.

Como implementar e usar um script

Quando estiver satisfeito com seu script, é hora de implementá-lo no KNM.

1. Localize o script em seu computador
2. Copie o script para o diretório "script" na pasta KNM
3. Feito

Quando implantado no KNM, ele pode ser usado no monitor de script Lua.

1. Selecione um objeto e abra a página de informações do objeto
2. Clique em Novo monitor
3. Selecione Lua script na categoria de scripts
4. Selecione o script na lista suspensa da seção "Propriedades do monitor de script Lua".
5. Configurar os parâmetros do script
6. Feito

Observe que, ao selecionar um script, ele remove permanentemente a opção de selecionar outro script. Se você precisar usar um script diferente, crie um novo monitor para esse script.

Espero que este minitutorial tenha sido útil; a API Lua abre muitas possibilidades para monitorar processos e sistemas específicos da empresa.

Informe-nos se tiver escrito um roteiro que queira compartilhar!