Introductie van KNM Lua-scripting

Kaseya Network Monitor biedt ondersteuning voor de scripttaal Lua. Lua is een krachtige, lichtgewicht programmeertaal die is ontworpen voor het uitbreiden van applicaties. Met Lua kunnen klanten op maat gemaakte monitors maken om systemen en apparatuur te testen die niet door een ingebouwde monitor worden ondersteund.

• Nieuwe monitors, acties en gebeurtenissen kunnen worden aangemaakt en getest in de ontwikkelomgeving van Kaseya, voordat ze worden geëxporteerd en gebruikt in Kaseya Network Monitor.
• Een uitgebreide bibliotheek met kant-en-klare klassen, zoals SFTP-client, HTTP-client en bestandsbeheer, is beschikbaar voor ontwikkelaars.
• De ontwikkelomgeving bevat debugger, trefwoordmarkering, geïntegreerde help en andere functies die beschikbaar zijn in geavanceerde ontwikkeltools.

Meegeleverde scripts

In het standaard KNM installatieprogramma zitten een aantal gebundelde scripts. De scripts bevinden zich in de map "script" in de KNM-map. De meegeleverde scripts zijn een goede plaats om te beginnen als u uw eigen script wilt leren ontwikkelen.

ApacheStatus_.lua
Bewaakt werkthreads in een Apache-webserver

BackupExec_.lua / BackupExec_11D_.lua
Controleert de voltooiingsstatus van back-uptaken.

CheckCertificateExpiryTime_.lua
Controleert of een HTTP-certificaat bijna verloopt. De periode kan in dagen worden ingesteld.

CiscoIPSecGlobalTunnelBandwidth_.lua
Controleert het bandbreedtegebruik van alle IPSec-tunnels die op een firewall zijn geopend.

CiscoIPSecTunnelBandwidth_.lua
Controleert de bandbreedte van een specifieke (benoemde) IPSec-tunnel.

iLoHealth_.lua
Bewaakt de gezondheidsparameters van een HP iLo2-watchdogcomputer.

PrinterOutOfPaper_.lua
Controleert of een aan Windows gekoppelde printer geen papier meer heeft.

WBEM_ESXi_HP_Fan_Status_.lua
WBEM_ESXi_HP_PSU_Status_.lua
WBEM_ESXi_HP_RaidArray_Status_.lua
Controleert VMWare ESXi-hardwareparameters (ventilator, raidarray en PSU-status)

Stappen om te beginnen met het ontwikkelen van scripts

Eerst moet je de Lua IDE downloaden. Deze wordt meegeleverd met KNM en het enige wat je moet doen is inloggen op de KNM webinterface en naar de "About page" gaan.

Klik op de Lua IDE link en download het installatieprogramma. Start het installatieprogramma en volg de instructies op het scherm. Wanneer het installatieprogramma klaar is, zoek je Lua IDE op in het startmenu en start je het.

Scripts moeten voldoen aan het programmeermodel van KNM. Om snel aan de slag te gaan en het schrijven van boilerplate-code te vermijden, kunt u een scriptsjabloon gebruiken. Klik in het menu "Code invoegen" op het menu-item "Scriptsjabloon invoegen".

Voordat we de debugger kunnen draaien en deze boilerplate code kunnen testen, moeten we een nieuwe host toevoegen. KNM Lua script wordt altijd uitgevoerd in de context van een host. API-aanroepen zijn altijd relatief aan een host, wat betekent dat het niet mogelijk is om acties uit te voeren tegen verschillende machines in dezelfde instantie van een script. Daarom moeten we altijd een host selecteren voordat we een debugsessie starten.

Klik op "Open host list" in de toolbar en voeg een host toe door deze in te voeren in het tekstveld onder de lijst en klik op "Add host". Selecteer de toegevoegde host in de lijst en klik op de knop "Select host".

Om de sjabloonscripts te testen die zojuist in het lege document zijn ingevoegd, klik je op het tandwiel in de werkbalk of druk je op CTRL+F5 om een nieuwe foutopsporingssessie te starten.

Het script zal door de IDE op exact dezelfde manier worden uitgevoerd als door KNM, de interface wordt geëmuleerd met standaard Windows-besturingselementen.

Open de onderstaande link voor meer informatie over het gebruik van de IDE en de Lua API.

Klik hier om de Lua API documentatie te openen.

Een script implementeren en gebruiken

Als u tevreden bent met uw script, is het tijd om het te deployen naar KNM.

1. Plaats het script op uw computer
2. Kopieer het script naar de map "script" in de KNM-map
3. Gedaan

Wanneer het wordt ingezet in KNM, kan het worden gebruikt in de Lua-scriptmonitor.

1. Selecteer een object en open de objectinformatiepagina
2. Klik op Nieuwe monitor
3. Selecteer Lua script in de scriptcategorie
4. Selecteer het script uit de vervolgkeuzelijst in de sectie "Lua script monitor eigenschappen".
5. De scriptparameters configureren
6. Gedaan

Als je een ander script wilt gebruiken, maak dan een nieuwe monitor aan voor dat script.

Ik hoop dat deze mini-tutorial nuttig is geweest. De Lua API biedt tal van mogelijkheden om company processen en systemen te monitoren.

Laat het ons weten als je een script hebt geschreven dat je wilt delen!