Metriken
Finden, erstellen und verwalten Sie die gemeinsamen Metriken, die Gerätewerte in Kilo mit konsistenten Namen, Einheiten und Datentypen versehen.
Eine Metrik sagt Kilo, was ein Gerätewert bedeutet und wie er gespeichert wird. Sie kombiniert einen normalisierten Schlüssel, zum Beispiel temperature, mit einer Einheit, einem Werttyp und einem Datentyp.
Die beiden Typ-Felder beantworten unterschiedliche Fragen: Datentyp sagt, ob die Information Telemetrie, Geräte-Metadaten oder ein benutzerdefiniertes Attribut ist; Typ sagt, ob sein Wert als Float, Integer, String oder Boolean gespeichert wird.
Diese gemeinsame Definition ermöglicht es Geräten verschiedener Hersteller, dieselben Dashboards und Regeln zu verwenden. Ein Gerät kann temp_c senden und ein anderes kann t_celsius; indem beide Rohschlüssel der temperature Metrik zugeordnet werden, hat Kilo einen einheitlichen Messwert, mit dem es arbeiten kann.
Öffnen Sie den Metrikkatalog
Gehen Sie zu Geräte → Metriken.
Die Liste enthält jede für Ihre Organisation verfügbare Metrik. Jede Zeile zeigt ihren normalisierten Schlüssel, die Maßeinheit, den Werttyp und den Datentyp.
Verwenden Sie die Steuerelemente über der Liste, um eine Metrik zu finden:
Suche entspricht dem normalisierten Schlüssel.
Alle Einheiten filtert nach Einheit und schließt Metriken ohne Einheit ein. Wählen Sie die Einheiten aus und klicken Sie auf Anwenden.
Alle Typen filtert nach String, Integer, Float oder Boolean und wird sofort angewendet.
Alle Datentypen filtert nach Telemetrie, Geräte-Metadaten oder benutzerdefinierten Attributen und wird sofort angewendet.
Sortieren nach ordnet Metriken nach Neueste oder Älteste.
Die Filter für Einheit, Typ und Datentyp akzeptieren mehrere Werte gleichzeitig.
Von Ihrer Organisation erstellte Metriken bieten Bearbeiten und Löschen Aktionen. Von Kilo bereitgestellte Metriken tun das nicht, da ihre Definitionen über Bereitstellungen hinweg gemeinsam verwendet werden.
Eine Metrik erstellen
Gehen Sie zu Geräte → Metriken.
Klicken Sie auf Messwert hinzufügen.
Füllen Sie die vier Felder im Metrik hinzufügen Dialog aus.
Klicken Sie auf Hinzufügen.
Datentyp
Wählen Sie aus, welche Art von Information die Metrik darstellt:
Telemetry
Messwerte, die sich im Laufe der Zeit ändern
Temperatur, Luftfeuchtigkeit, Akkustand, Druck
Geräte-Metadaten
Informationen, die das Gerät über sich selbst meldet
Firmware-Version, Hardware-Revision
Benutzerdefinierte Attribute
Informationen, die Ihre Organisation hinzufügt
Installationsdatum, Asset-Tag, Wartungsintervall
Nur Telemetrie-Metriken erscheinen, wenn eingehende Gerätewerte zugeordnet werden. Geräte-Metadaten und benutzerdefinierte Attribute werden nicht als Telemetrie-Zuordnungen angeboten.
Typ
Wählen Sie aus, wie Kilo den Wert speichert:
Float
Zahlen mit Dezimalstellen
22.5, 67.3, 3.28
Integer
Ganze Zahlen
85, -120, 42
String
Text
"offen", "Bereitschaft"
Boolesch
Wahr oder falsch
Bewegung erkannt, Alarm aktiv
Diagramm-Widgets und die Last-Data-Anzeigen im Tacho-Stil erfordern eine Integer- oder Float-Metrik. Die Last Data Wert Anzeige kann auch Text- und Boolean-Werte anzeigen.
Normalisierter Schlüssel
Der normalisierte Schlüssel ist der Standardname für die Messung, unabhängig vom Rohnamen, den ein Gerät sendet.
Öffnen Normalisierter Schlüssel und wählen Sie entweder einen vorhandenen Schlüssel aus oder wählen Sie Einen neuen normalisierten Schlüssel erstellen. Verwenden Sie einen beschreibenden Namen wie soil_moisture, nicht einen gerätespezifischen Namen wie sensor_3_value. Namen in Kleinbuchstaben mit Unterstrichen halten den Katalog konsistent.
Jeder normalisierte Schlüssel kann nur zu einer Metrik gehören. Wenn der ausgewählte Schlüssel bereits verwendet wird, meldet das Formular Eine Metrik mit diesem normalisierten Schlüssel existiert bereits.
Normalisierte Schlüssel werden in diesem Feld erstellt, umbenannt und gelöscht. Von Kilo bereitgestellte Schlüssel können nicht umbenannt oder entfernt werden.
Maßeinheit
Wählen Sie die Einheit aus, die neben dem Wert angezeigt wird, z. B. °C, %, lx oder mV. Wählen Sie eine vorhandene Einheit oder wählen Sie Eine neue Einheit erstellen und geben Sie das Symbol genau so ein, wie es erscheinen soll.
Eine Einheit ist für Telemetrie erforderlich. Für Geräte-Metadaten und benutzerdefinierte Attribute ist sie optional, da Werte wie eine Firmware-Version oder ein Asset-Tag möglicherweise keine Einheit haben.
Einheiten werden in diesem Feld erstellt, umbenannt und gelöscht. Von Kilo bereitgestellte Einheiten können nicht umbenannt oder entfernt werden.
Eine Metrik bearbeiten
Metriken werden organisationsweit gemeinsam genutzt und nicht für jedes Gerät separat konfiguriert. Das Bearbeiten einer Metrik ändert die Definition für jedes Gerät, dem sie zugeordnet ist.
Finden Sie die Metrik unter Geräte → Metriken.
Klicken Sie auf Bearbeiten.
Aktualisieren Sie die erforderlichen Felder.
Klicken Sie auf Speichern.
Überprüfen Sie die Bestätigung, die die organisationsweite Auswirkung beschreibt, und bestätigen Sie die Änderung.
Wenn nur ein Gerät eine andere Definition benötigt, erstellen Sie stattdessen eine neue Metrik und ordnen Sie dieses Gerät neu zu, anstatt die gemeinsame Metrik zu bearbeiten.
Eine Metrik löschen
Klicken Sie auf Löschen bei einer von Ihrer Organisation erstellten Metrik und bestätigen Sie die Aktion.
Kilo weigert sich, eine Metrik zu löschen, die noch einem Gerät zugeordnet ist. Entfernen Sie die Zuordnung von jedem Gerät, das sie verwendet, und versuchen Sie es dann erneut.
Ein Geräte-Messwert der Metrik zuordnen
Das Erstellen einer Metrik verbindet sie nicht automatisch mit einem Gerät. Öffnen Sie die Messwerte Registerkarte des Geräts und ordnen Sie den vom Gerät gesendeten Rohschlüssel der normalisierten Metrik zu.
Nachdem mehrere Gerätetypen ihre Roh-Temperaturschlüssel der temperaturezugeordnet haben, kann dasselbe Dashboard-Widget, dieselbe Regel oder dieselbe Abfrage alle verwenden, ohne herstellerspezifische Logik.
Fehlerbehebung
Eine Metrik fehlt in einem Diagramm oder einer Last-Data-Anzeige im Tacho-Stil
Bestätigen Sie, dass ihr Typ Integer oder Float ist und das Gerät einen numerischen Wert sendet.
Eine Metrik fehlt in einer Gerätezuordnung
Bestätigen Sie, dass ihr Datentyp ist Telemetrie.
Ein normalisierter Schlüssel kann nicht ausgewählt werden
Eine andere Metrik verwendet ihn möglicherweise bereits. Durchsuchen Sie den Katalog nach diesem Schlüssel.
Bearbeiten und Löschen sind nicht verfügbar
Die Metrik, der Schlüssel oder die Einheit wurden von Kilo bereitgestellt und können nicht geändert werden.
Löschen wird verweigert
Entfernen Sie die Metrik aus jeder Gerätezuordnung, bevor Sie sie löschen.
Siehe auch
Geräte registrieren — Rohgeräte-Daten während der Registrierung zuordnen
Geräteverwaltung — Zuordnungen an einem vorhandenen Gerät ändern
Diagramm-Widget — numerische Metriken im Zeitverlauf anzeigen
Zuletzt aktualisiert