Hoppa till huvudinnehåll

Lektion 3.1 Grafana

Grafana är ett populärt open source-verktyg för dashboards, kartor och larm. Med IoT-plattformens två Grafana-datakällor kan du visualisera dina enheters live- och historiska data, bygga flottöversikter och få aviseringar när något går fel. I denna lektion bygger du dina första Grafana-paneler mot IoT-plattformens data.

För fullständig referens (alla alternativ), se Grafana-användarguiden.

Innan du börjar​

  • Grafana måste redan vara installerat och anslutet till IoT-plattformen. Om det inte är det, gör engångskonfigurationen först: Grafana-installation.
  • Du behöver några aktiva enheter i ditt konto på IoT-plattformen (från tidigare lektioner) - helst något som rapporterar temperature, samt en tracker med lnglat för kartövningen.

Övning 1 - Din första tidsseriegraf​

  1. I Grafana, gå till Dashboards → New → New dashboard och klicka sedan på Add visualization.
  2. Välj datakällan JSON när du uppmanas.
  3. Överst till höger, sätt visualiseringstypen till Time series.
  4. I frågeredigeraren, öppna Metric-listan och välj en av dina enheter (varje enhet är en metric). Att välja * ritar alla dina aktiva enheter samtidigt.
  5. Sätt dashboardens tidsintervall (överst till höger) till t.ex. Last 24 hours och klicka på Refresh.
  6. Klicka på Apply (överst till höger) för att lägga till panelen i dashboarden.

→ Enhetens värden ritas upp över tid.

time series

Om lat/lng stör grafen, öppna Transform data → + Add transformation → Filter fields by name och avmarkera lat och lng.

Övning 2 - Placera dina enheter på en karta​

  1. I dashboarden, klicka på Add → Visualization och välj datakällan JSON igen.
  2. Sätt visualiseringstypen till Geomap.
  3. Välj din tracker (eller någon annan enhet med position) som Metric, och se till att lat och lng är inkluderade.
  4. För en trackers rutt, välj metricen <Din Tracker>.lnglat - spåret ritas automatiskt. För att färga det, lägg till en andra fråga <Din Tracker>.speed och färga efter det värdet med tröskelvärden under Map layers → Markers.
  5. Klicka på Apply.

→ Dina enheter visas som punkter; en tracker visar sin väg.

tracker map

Övning 3 - En flottöversiktstabell​

Denna använder Infinity-datakällan, som kan anropa vilken av IoT-plattformens REST-endpoints som helst.

  1. Add → Visualization; välj denna gång datakällan Infinity.
  2. Sätt visualiseringstypen till Table.
  3. I frågan, sätt Type = JSON, Source = URL, Method = GET, och URL = https://beta.yggio.net/api/iotnodes (lägg till ?q=batteryLevel för att bara lista dina sensorer).
  4. Öppna Parsing options & Result fields → Columns och lägg till en rad för varje (Selector → as → Format):
    • name → Device → String
    • batteryLevel → Battery % → Number
    • rssi → RSSI → Number
    • snr → SNR → Number
    • reportedAt → Last reported → Time
  5. Färga batterikolumnen: Field → Add field override → Fields with name → Battery %, sätt Cell display mode = Colored background, och lägg sedan under Thresholds till röd <20, gul <50, bas grön.
  6. Klicka på kolumnrubriken Last reported för att sortera, så att tysta enheter hamnar överst.
  7. Klicka på Apply.

→ En rad per enhet med batteri, signal och senast sedd.

fleet table

Du har nu en översiktlig hälsovy för varje enhet.

Extramål - få aviseringar​

Med Infinity-datakällan kan du få Grafana att meddela dig när ett värde korsar ett tröskelvärde (t.ex. för hög temperatur) eller när en enhet slutar rapportera. Följ steg-för-steg-guiden i användarguiden: Konfigurera ett enkelt larm.

Vad du lärde dig​

  • IoT-plattformens två datakällor: JSON (snabba enhetsgrafer och kartor) och Infinity (valfri REST-endpoint → tabeller, grafer, kartor, aviseringar).
  • Hur man bygger en tidsseriegraf, en Geomap och en flottöversiktstabell.
  • Var du hittar tröskelvärden, transformationer och aviseringar.

Vart härnäst​

  • Grafana-användarguiden - tabell över panelval, tips och tekniker samt fler recept (energi per dag, beläggningstidslinjer, aviseringar).
  • Nästa lektion: Power BI.