Log

Inleiding

Met deze component kun je registreren wat er in het systeem gebeurt. De plugin lijkt op die van Email, maar in plaats van een bericht te verzenden, registreert hij de gebeurtenis in een bestand dat je later kunt raadplegen.

Toepassingen

• Met deze component kun je de verschillende statuswijzigingen van specifieke componenten volgen.

• Deze component is handig om specifieke gegevens bij te houden die je wilt exporteren, zoals energieverbruik/-productie, of temperaturen afkomstig van sensoren en meetsondes.

Componenteigenschappen

GUI

Deze voorbeeldcomponent is aangemaakt via de Graphic UI-gateway.

We raden aan het hoofdstuk “Gateway / Protocollen” te raadplegen voor meer informatie.

Inschakelen: selecteer de schakelaar om de logregistratie in of uit te schakelen;

Uitvoeringscomponent: selecteer een Schakelaar-component die de registratie van een status laat starten. Onthoud dat de log ook werkt zonder triggercomponent;

Flank van de gebeurtenis: selecteer het type flank dat de status moet hebben om in de registratie te worden meegenomen;

Elke (seconden): tijdsinterval dat wordt gebruikt om het log vast te leggen. Laat dit leeg als je het niet nodig hebt;

Logtitel: voer de titel van de informatie-inhoud in;

Bestandsnaam: voer de naam in van het bestand waarin het log wordt opgeslagen;

Aanvullende informatie kan in de informatie-inhoud worden opgenomen (tot 4 informatie-items):

Informatie (#1): Dropdownmenu: Gekleurde info, Tekstinfo, Info, Schakelaar, Schuifregelaar, Veilige schakelaar of de component instelbare waarde;

Informatie (#2): Dropdownmenu: Gekleurde info, Tekstinfo, Info, Schakelaar, Schuifregelaar, Veilige schakelaar of de component instelbare waarde;

Informatie (#3): Dropdownmenu: Gekleurde info, Tekstinfo, Info, Schakelaar, Schuifregelaar, Veilige schakelaar of de component instelbare waarde;

Informatie (#4): Dropdownmenu: Gekleurde info, Tekstinfo, Info, Schakelaar, Schuifregelaar, Veilige schakelaar of de component instelbare waarde;

Log bij wijziging: indien geselecteerd, wordt de informatie geregistreerd bij elke statuswijziging van de geselecteerde component. Voorbeelden: deuren open of dicht, of een energieverbruik dat verandert.

Inhoud: tekst die wordt geregistreerd; om de eerder genoemde informatie in te voegen, voeg het symbool # toe, gevolgd door het informatienummer (bijv. #1). Als je meerdere componenten wilt registreren, gebruik dan dit formaat:

JOUWTEKST #1, JOUWTEKST #2, JOUWTEKST #3, enz.

Meer dan 4 informatie-items tegelijk: als je meer dan 4 informatie-items tegelijk wilt registreren, volg dan deze procedure:

Voeg in het tekstveld Inhoud (Content) de parameter “##IDVANDECOMPONENTVOORHETLOG##” toe: op die manier kun je alle parameters die je nodig hebt aan het log toevoegen.

Vergeet niet de “,” te gebruiken aan het einde van elke informatie: hiermee wordt de tekst binnen het .csv-bestand correct gescheiden en opgemaakt.

Verzend e-mail bij loggebeurtenis: selecteer een Email-component om e-mailberichten te verzenden wanneer de triggercomponent van status verandert.

Verzend Telegram-bericht bij loggebeurtenis: selecteer een Telegram-component die bij elke loggebeurtenis wordt geactiveerd.

Voorbeeld van weergave van het CSV-bestand

Voorbeeld van .csv-bestand

Dit is een voorbeeld van een log dat controleert of een deur wel of niet is geopend. Zoals je kunt zien, registreert het de statuswijziging van een component en het exacte tijdstip waarop deze plaatsvond. Als je het bestand wilt exporteren in .csv-formaat, voeg dan de extensie .csv toe in het tekstveld “Bestandsnaam” in Ilevia Manager.

Logtijd

In de map “logs” van de server worden twee logs opgeslagen: een dagelijkse genaamd “today_NAAMVANJOUWBESTAND” en een map met de datum (JJ/MM) met daarin alle logs van de maand; dit helpt om de logbestanden te organiseren.

Herinnering voordat je verdergaat:

• Download en installeer de Ilevia Logic-plugin om plugins in te schakelen (link);

• Wacht na het uploaden van het project naar de server een paar minuten voordat de logica wordt geactiveerd.

Hoe het logbestand te downloaden

Hieronder staat de procedure om het logbestand te downloaden:

1. Download een FTP-programma om toegang te krijgen tot de server, bijvoorbeeld Filezilla;

2. Na installatie op de computer start je het programma en open je de sitebeheerfunctie via het menu linksboven “Bestand – Sitebeheer”;

3. Er wordt een scherm geopend: klik op “Nieuwe site” en vul de velden in: Host (het adres van de Ilevia-server), inlogtype “Normaal” en voor gebruiker en wachtwoord voer je “eveweb” in. Zodra de velden zijn ingevuld, klik je op “Verbinden”;

4. Aan de linkerkant zie je de mappen van je computer en aan de rechterkant die van de Ilevia-server;

5. Volg dit pad op de Ilevia-server: http/logic/plugin/log/logs, en open vervolgens de map van de huidige maand;

6. Zoek het gewenste logbestand;

7. Om het bestand te openen, installeer je op je pc LibreOffice of Microsoft Excel als die nog niet aanwezig zijn, klik daarna met de rechtermuisknop op het bestand, kies “Openen met” en selecteer LibreOffice Calc.

Alternatieve manieren om het logbestand te downloaden

Je kunt het logbestand ook downloaden via een link die aan de component in de gebruikersinterface is gekoppeld en rechtstreeks naar de downloadpagina leidt.

Dit is een voorbeeld van een downloadlink:

http://indirizzo_IP_del_tuo_server/logic/plugins/Log/logs/last_sensors.txt

Hoe je het tijdsinterval kiest dat in de webbrowser wordt weergegeven:

• Huidige dag: http://indirizzo_IP_del_tuo_server/logic/plugins/Log/logs/today_nomefile;

• Huidige maand: http://indirizzo_IP_del_tuo_server/logic/plugins/Log/logs/current_month_nomefile;

• Laatste geregistreerde gegevens: http://indirizzo_IP_del_tuo_server/logic/plugins/Log/logs/last_nomefile.

Download het demoproject van het Log-component en probeer het zelf.

Download het project hier!