Miner

Changelog Miner

Version 1.5.5 (13/05/2022)

Features

  • Grafer
    Varje Miner, anslutning, jobb, datapunkt med mera kan beskrivas på ett standardiserat sätt med RDF.

Minern har således två nya fält i sin konfig:

  • Aktivera Minerns grafer - checkbox för att aktivera grafgenereringen. Denna checkbox aktiverar grafgenereringen och gör url:erna bakom <miner URL>/graph/… åtkomliga.
  • Internationalized Resource Identifier (IRI) - För att sätta IRI:n de genererade graferna ska börja på, ett exempel är http://data.iquest.se/connection/uuid där http://data.iquest.se är satt i konfigen.

Om aktiva grafjobb finns när ”Aktivera Minerns grafer” deaktiveras kommer de jobben att stoppas. I och med att graferna inte genereras längre går de heller inte att ladda upp.

Via Miners URLs kan användare själva se graferna, där funktionen är aktiverad. <miner URL>/graph/connection/uuid visar t.ex. grafen för en specifik connection.
Grafanslutningen låter användaren specificera vart graferna ska laddas upp. Grafanslutningen låter även användaren sätta hur ofta de grafjobb som använder anslutningen ska ladda upp graferna. Grafjobbet laddar upp de valda graferna till den valda grafdatabasen. Vid skapandet av grafjobbet får användaren välja vilka grafer som ska laddas upp. Observera att graferna för grafanslutningar och grafjobb inte kan laddas upp.

  • Larmsättning vid tappad anslutning och fel data
    Om minern har tappat sin anslutning för ett pågående jobb skickas det nu ut ett larm med information om vilket jobb det är och vilken Miner som har problem. Det skickas även ut ett larm när Miner får oförväntad data skickad till sig som den inte kan hantera, detta görs per datapunkt. Larmen återställs när anslutningen återupptas eller när datapunkten får förväntad data igen.
  • Utökad larmsättning vid tappade jobb
    Om Miner bland annat saknar lagringsutrymme händer det ibland att den inte kan spara jobbet korrekt. Det resultrerar i att jobbet inte läses in korrekt och jobbet försvinner från det grafiska användargränssnittet. Nu kan Miner larma när detta händer.
  • Tid innan historik hämtas
    Användare kan nu ställa in hur lång tid det ska gå innan historik ska hämtas (Minimal History Interval). Miner kommer jämföra och ta det högsta av Minimal History Interval och ”poll_interval_sec” multiplicerat med 2. Om en datapunkt inte fått ett värde efter det högsta av tidigare nämnda kommer Miner registrera detta som dataförlust och försöka hämta data för denna period under en senare körning.
  • Exportera CSV från Explorer
    Nu finns det möjlighet för användaren att exportera en CSV-fil som innehåller samtliga inlästa datapunkter innan själva jobbet skapas.

Bugfixes

  • Fel vid ändring av namn för jobb
    Ett fel hittades vid namnbyte av ett jobb som gjorde att det skapades ett nytt jobb med det nya namnet utan att det gamla jobbet försvinner.
  • Session cookies för Larmia
    Larmia gav en alldeles för lång giltighetstid på sin session-kaka som Miner inte tyckte om. Felet kommer åtgärdas från Larmia vid nästa uppdatering och Miner kan hantera den långa giltighetstiden tills vidare.
  • Förbättrad WDC-integration
    Integrationen mot WDC har förbättrats genom att låta användaren kunna hämta och se senaste värden från datapunkterna i Explorer innan jobbet är skapat.
  • Optimeringar i kommunikationen
    Kommunikationen mellan Orbiq och Miner har optimerats genom att skicka mindre data fram & tillbaka.
  • Quality-stamp för Lindinspect
    Lindinspect skickar det senaste värdet om det är fel på någon nod, något som Miner inte hanterat tidigare. Nu skickar Miner samma värde till Orbiq med en Quality-stamp på ”4” om det är något fel på noden. Du kan läsa mer om Quality-Stamps här.
  • Felkoder för Fidelix
    Om det är fel på någon datapunkt skickar Fidelix iväg en felkod som Miner nu kan hantera.
  • Fel värden för Digital Input/Output, Fidelix
    En bugg är fixad som gjorde att Miner inte sparade rätt värde för Digital Input och Digital Output.

Korrigeringar

En del stavfel har rättats till och mindre språkändringar gjorts.

Version 1.4.8 (11/11/2021)

Features

  • Ny integrationslösning för Fidelix (2-vägskommunikation)
    Stabilare datahämtning och kommunikation med direkt med Fidelix DUC:ar utan behov av mellanliggande programvara, såsom databaser eller OPC-server, m.h.a. Fidelix kommunikationsprotokoll. Integrationen möjliggör även skrivning av data till Fidelixer, exempelvis för uppdatering av börvärden, start/stop av utrustning m.m.
  • SMHI integration
    En ny typ av anslutning och jobb. Jobbet hämtar väderprognoser för angivna positioner, där varje datapunkt i jobbet är en parameter i prognosen. Uppdelningen gör det möjligt att endast hämta de delar av prognosen som anses relevanta. Exempel på datapunkter är lufttemperatur, luftfuktighet, vindhastighet och vindriktning. SMHI integrationens anslutning är en av de mer komplicerade anslutningarna. För att bättre förstå den kommer en mer detaljerad guide finnas tillgänglig på wikin.
  • Uppdatering av WDC-integrationsprofil (2-vägskommunikation)
    Tidigare har det enbart gått att hämta data från datapunkter där det finns lokal historik i WDC. Integrationen är numera omgjord till att kunna läsa och skriva till alla datapunkter och även hämta historik om det finns. Det är därmed möjligt att utföra överstyrningar vid behov. Notera att befintliga WDC-anslutningar inte är kompatibla med den nya integrationen, vilket innebär att nya anslutningar behöver skapas vid behov av den utökade funktionaliteten. I och med denna uppdatering kommer den gamla WDC-integrationen inte längre att kunna användas för några nya jobb.
  • Sökruta för anslutningslistan
    En sökruta har lagts till för att söka bland befintliga anslutningar. Sökningen filtrerar på anslutningarnas namn och typ.
  • Endast relevanta profiler
    I formuläret för att skapa en ny anslutning innehåller numera rullistan med profiler endast relevanta valmöjligheter för den valda anslutningen. Om endast ett relevant alternativ finns kommer profilen att väljas på förhand och rullistan inte vara synlig i formuläret. De flesta typer av anslutningar kommer därmed att ha en förvald profil.
  • Defaultvärden för anslutningar
    När vissa typer av anslutningar skapas kommer vissa formulärfält att vara förifyllda när formuläret öppnas upp. De ifyllda värdena är förväntade värden, exempelvis port 3306 för MySQL.
  • Tooltip för anslutningsformulär
    Formulärsfälten för en ny anslutning har fått en kort beskrivning som visas när muspekaren hålls över fältet.
  • Webport poller, batch-hämtning av data
    Webport-pollern hämtar numera flera datapunkter åt gången istället för en datapunkt i taget med minskad datatrafik som följd. I och med denna uppdatering kommer den gamla Webport-integrationen inte längre att kunna användas för några nya jobb.
  • Smartare omskrivning
    Tidigare buffrades varje datapunkt lokalt vid en omskrivning vilket ledde till att det inte skickades någon data för det jobbet tills omskrivningen blev klar. Nu buffras enbart värden för de datapunkter som behöver en omskrivning. De som inte behöver en omskrivning körs som vanligt.

Bugfixes

  • Historikhämtning för Webport
    Fixat ett fel i historikhämtningen för Webport där jobbet tidigare inte hämtat historiken efter avbrott/tappad anslutning.
  • Minska utskriften till loggen
    Historikhämtningen loggade information för varje enskild datapunkt och för varje period av datahämtning. Loggfilerna växte snabbt och kunde leda till problem med diskutrymmet. Det har nu ändrats till att enbart skriva ut i loggen när historikhämtningen sker.
  • Kontroll av datapunkter som körs i andra jobb på samma miner
    Den befintliga funktionen slutade fungera i och med tidigare versionsuppdateringar. När nya datapunkter lades till med explorern uteblev för en del jobbtyper information om att datapunkterna redan lästes inom ett annat jobb (om så nu var fallet). Vi har återinfört funktionen för Webport, WDC och SMHI-integrationen, och kommer att åtgärda de andra integrationerna i kommande releaser.
  • WDC-miner hanterar inte tomma listor
    Ibland resulterar anrop till WDC i att antingen tidsstämpel eller mätvärde utelämnas från svaret. Detta hanterades inte väl av Miner. Numera skriver den ett felmeddelande till loggen när detta sker för att vid behov förenkla felsökningsarbetet.

Korrigeringar

En del stavfel har rättats till och mindre språkändringar gjorts. Nedan följer några av de mest märkbara

  • Minas av miner/jobb
    Den tidigare kolumnen ”Minas av miner”, som syns när datapunkter läggs till genom explorern, heter numera ”Minas av jobb”.
  • Pollers per sida
    Texten ”Pollers per sida”, som syntes när datapunkter lades till i ett jobb med explorern, har nu korrigerats till ”Datapunkter per sida”.
  • Minerns konfigurationsformulär
    En del engelska och svengelska har korrigerats till svenska i Minerns konfigurationsformulär.

Version 1.3.3 (10/06/2021)

  • Hämta värden för oBix-integration (bl.a. Tridium-baserade system) utan att starta jobbet.
    Nu kan man hämta det senaste värdet för datapunkterna utan att starta jobbet. Data som hämtas via denna funktion sparas inte i databasen.
  • Watchdoglarm vid diff av tidstämplar för datapunkter inom samma jobb
    Om det skiljer mer än (exempelvis) 2 timmar mellan tidstämpeln för jobbets senaste körning och tidstämpeln för någon datapunkt inom jobbet. Ett sådant larm skulle dels kunna uppmärksamma på fel vid dataavläsning från automationssystem och dels uppmärksamma på fel vid dataöverföringar till externa applikationer.
  • Larm vid för mycket mellanlagrad data
    När något går fel lagras all data lokalt hos Miner. Det kan hända att det tar lång tid innan felet är löst vilket leder till att lokal data byggs på. Nu skickas det larm när lagringen blir för stor.
  • Hämta nya datapunkter för befintligt Lindinspect-jobb
    Det går nu att hämta nya datapunkter från explorer för alla jobb av typen Lindinspect.
  • Ändringar i användargränssnittet
    Användargränssnittet är nu helt och hållet på Svenska. Plus-ikonen längst ned till höger har nu ändrats till att enbart skapa jobb och anslutningar. Tidigare har man fått välja mellan Poller, Miner och Connection men nu har Poller och Miner slagits ihop till ett och samma val.
  • Rätt kolumner vid en CSV-export för Webport
    Fixade en bugg som inte skrev ut poll_interval_sec, cov och minimal_save_interval som kolumner vid en CSV-export för Webport.
  • Datum för när ett jobb körs första gången
    För att enklare kunna felsöka vid eventuella fel som uppstår finns nu ett datum för när ett jobb startas första gången. Datumet sparas som ett element i konfigurationsfilen för varje jobb efter första start.
  • Möjlighet att ändra konfigurationen för Miner
    Denna funktion hittas längst upp i vänster spalt. Den är till för att ändra hur Miner ska bete sig, bland annat vart den ska skicka all sin data. Använd med stor försiktighet.