{"id":7855,"date":"2022-03-22T17:29:30","date_gmt":"2022-03-22T16:29:30","guid":{"rendered":"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/user-guide\/status-management\/"},"modified":"2022-06-02T16:38:47","modified_gmt":"2022-06-02T15:38:47","slug":"status-management","status":"publish","type":"page","link":"http:\/\/documentation-wp.hub.av.priv\/de\/aurora-vision-apis\/user-guide\/status-management\/","title":{"rendered":"Fehler Status Verwaltung"},"content":{"rendered":"\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Jede in Aurora Vision registrierte Entit\u00e4t ist durch einen <code>Status<\/code> gekennzeichnet, der es erm\u00f6glicht, das Vorhandensein aktiver Fehlerereignisse zu identifizieren.<\/p>\n\n\n\n<p>Aurora Vision kann den status einer anlage und folglich aller darin registrierten entit\u00e4ten nur dann auswerten, wenn die anlage korrekt mit einem fehlerauswertungsprofil verkn\u00fcpft ist. Jede in einem portfolio registrierte pflanze wird automatisch dem von Aurora Vision erstellten standardfehlerprofil zugewiesen; der administrator eines portfolios hat jedoch jederzeit die m\u00f6glichkeit, verschiedene fehlerprofile personalisiert zu erstellen und diese verschiedenen werken zuzuordnen. Letztendlich kann es also anlagen geben, die unterschiedlich bewertet werden, weil sie mit unterschiedlichen fehlerprofilen assoziiert sindciated with different error profiles.<\/p>\n\n\n\n<p>Wir werden dieses kapitel in mehrere seiten unterteilen, um einen vollst\u00e4ndigen und konsistenten \u00dcberblick dar\u00fcber zu geben, wie das fehlermanagement funktioniert: <\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul><li>Auf <strong>Page 2<\/strong> analysieren wir die struktur des standardfehlerprofils und die darin enthaltenen kategorien;<\/li><li>Auf <strong>Page 3<\/strong> wir werden die hauptfehlerkategorien analysieren, die auf Aurora Vision vorhanden sind, und einen allgemeinen \u00dcberblick geben;<\/li><li>Auf <strong>Page 4<\/strong> werden wir die APIs analysieren, die es erm\u00f6glichen, den status und fehlerereignisse verschiedener zu bewerten entit\u00e4ten auf hierarchischen ebenen;<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Allgemeine Struktur der Fehlerprofile<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Um mehr klarheit zu schaffen, werden wir das standardfehlerprofil analysieren, das Aurora Vision f\u00fcr jedes portfolio erstellt (<em>das nicht bearbeitet werden kann<\/em> ).<\/p>\n\n\n\n<p>Auf Aurora Vision wird ein Fehlerprofil immer durch einen <strong>Namen<\/strong>, ein <strong>Akronym<\/strong> und einen <strong>Ersteller<\/strong> identifiziert und enth\u00e4lt darin eine reihe von <strong>Fehlerkategorien<\/strong> die dazu dienen, das Vorliegen von Fehlerereignissen f\u00fcr die Anlagen, denen das Profil zugeordnet ist, auszuwerten und so die Aktivierung von<code> Profile<\/code>  ereignissen zu erzeugen:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles-2-1024x408.jpg\" alt=\"\" class=\"wp-image-7082\" width=\"1024\" height=\"408\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles-2-1024x408.jpg 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles-2-300x119.jpg 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles-2-768x306.jpg 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles-2.jpg 1236w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Der Administrator eines portfolios hat je nach seinen bed\u00fcrfnissen und den Anlagen, denen das fehlerprofil zugeordnet werden muss, v\u00f6llige freiheit bei der erstellung von fehlerprofilen und dem hinzuf\u00fcgen spezifischer fehlerkategorien darin und kann auch die bewertungsparameter f\u00fcr jedes einzelne festlegen fehlerkategorien.<\/p>\n\n\n\n<p>Es gibt 4 hauptparameter, die bearbeitet werden k\u00f6nnens that can be edited:<\/p>\n\n\n\n<ul><li><strong>Verstrichene Zeit<\/strong>: gibt die zeit an, die vergehen muss, bevor Aurora Vision, sobald der fehler erkannt wurde, ihn anhebt, um ihn den betroffenen hierarchieebenen als aktiv anzuzeigen. Der mindestwert, der zugewiesen werden kann, um das Ausl\u00f6sen falscher fehler zu vermeiden, betr\u00e4gt 15 minuten;<\/li><li><strong>Bewertung<\/strong>: gibt das zeitfenster an, f\u00fcr das Aurora Vision die anwesenheit oder abwesenheit bewertet von fehlern in bezug auf diese bestimmte kategorie gem\u00e4\u00df den eingestellten parametern. Es k\u00f6nnen verschiedene zeitfenster gew\u00e4hlt werden, aber es muss beachtet werden, dass Aurora Vision au\u00dferhalb des definierten fensters diese spezifische fehlerkategorie, die zu diesem fehlerprofil geh\u00f6rt, nicht auswertet;<\/li><li><strong>Schweregrad<\/strong>: gibt den schweregrad des fehlers an, der eins zu eins dem <code>Status<\/code> der vom fehler betroffenen hierarchischen entit\u00e4t zugeordnet wird. Es gibt 4 schweregrade: <code>INFO <\/code>(<em>informationsereignis<\/em> ), <code>LOW <\/code>(<em>ereignis mit niedrigem schweregrad<\/em> ), <code>MEDIUM <\/code>(<em>ereignis mit mittlerem schweregrad<\/em> ), <code>HIGH <\/code>(<em>ereignis mit hohem schweregrad<\/em> );<\/li><li><strong>Schwellenwert<\/strong>: Das fehlerereignis wird nur aktiviert, wenn der angegebene schwellenwert \u00fcberschritten wird. Dieser parameter ist nicht bei allen fehlerkategorien vorhanden (<em>weitere details finden Sie auf Seite 3<\/em> ).<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Zum beispiel setzt sich der fehler <code>Power Off<\/code> (<code>PWROFF<\/code>) aus den folgenden parametern zusammen:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"120\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles_PWROFF-1024x120.jpg\" alt=\"\" class=\"wp-image-7120\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles_PWROFF-1024x120.jpg 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles_PWROFF-300x35.jpg 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles_PWROFF-768x90.jpg 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_profiles_PWROFF.jpg 1103w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul><li><strong>Elapsed Time<\/strong>: 8 hours<\/li><li><strong>Evaluation<\/strong>: During Daylight &#8211; 2 hours after sunrise and before sunset<\/li><li><strong>Severity<\/strong>: MEDIUM<\/li><li><strong>Threshold<\/strong>: 100 W\/m<sup>2<\/sup><\/li><\/ul>\n\n\n\n<p>Das bedeutet, dass Aurora Vision das Vorhandensein eines <code>PWROFF <\/code>fehlerereignisses nur bei tageslicht, zwei stunden nach sonnenaufgang und zwei stunden vor sonnenuntergang auswertet; es aktiviert den fehler nur, wenn der schwellenwert 100 W\/m<sup>2<\/sup> \u00fcberschreitet, und zwar 8 stunden nach der erkennung, wodurch der <code>Status <\/code>der betroffenen hierarchischen einheiten auf <code>MEDIUM<\/code>, entsprechend dem eingestellten schweregrad.<\/p>\n\n\n\n<p>Fehlerprofile sind immer werken zugeordnet und folglich kann sich der <code>Status<\/code> einer entit\u00e4t erst ab dieser hierarchieebene \u00e4ndern; Es gibt jedoch fehlerkategorien, die nur auf Plant Level (<code>LVL 3<\/code>) und\/oder auf Logger level (<code>LVL 4<\/code>) und\/oder auf Device level (<code>LVL 5<\/code>). Wenn ein fehler auf einer bestimmten hierarchischen ebene erkannt und aktiviert wird, wird dieser an alle hierarchisch \u00fcbergeordneten einheiten (<em><em>ab werksebene<\/em><\/em> ) weitergegeben und dies f\u00fchrt dazu, dass die <code>Status <\/code>dieser entit\u00e4ten wird einheitlich ge\u00e4ndert.<\/p>\n\n\n\n<p>Schauen wir uns ein beispiel an:<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-1 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 class=\"has-medium-font-size\" id=\"single\">Hierarchische Weitergabe des Status von Entit\u00e4ten<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Nehmen wir als Beispiel einen Teil des hierarchischen Schemas aus dem Kapitel &#8222;Hierarchische Struktur&#8220; und nehmen wir an, dass <strong>Plant 1<\/strong> dem standardfehlerprofil zugewiesen wurde:<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"515\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-2-1024x515.png\" alt=\"\" class=\"wp-image-7374\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-2-1024x515.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-2-300x151.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-2-768x386.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-2.png 1396w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><br>F\u00fcr <strong>Inverter 1<\/strong>,wurde zu einem bestimmten zeitpunkt ein <code>PWROFF<\/code> fehler ausgel\u00f6st; das bedeutet, dass sein <code>Status <\/code>von <code>NORMAL <\/code>(<em>keine fehler<\/em> ) auf <code>MEDIUM<\/code> (<em>gem\u00e4\u00df der schweregrad, der vom standardprofil dem PWROFF-fehler zugewiesen wird<\/em> ).<br>Jedoch ist, <strong>Inverter 1<\/strong> teil einer hierarchie, die, wenn sie hochskaliert wird, aus <strong>Logger 1<\/strong> und <strong>Plant 1<\/strong>.<br>Folglich, wenn man bedenkt, dass ein fehlerprofil ab anlagenhierarchieebene zugewiesen wird, der <code>Status <\/code>von <strong>Logger 1<\/strong> und <strong>Plant 1<\/strong> ist ebenfalls von <code>NORMAL <\/code>auf <code>MEDIUM<\/code>.<\/p>\n<\/div>\n<\/div>\n\n\n\n<p>Das obige beispiel macht uns verst\u00e4ndlich, dass eine zusammenfassung die bewertung des vorhandenseins\/fehlens von fehlern kann direkt auf der anlagenhierarchieebene erfolgen. Weitere details finden sie auf <strong>Page 4<\/strong>, wo wir ein konkretes beispiel der API <code>GET Plant Status<\/code> analysieren werden.<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Beschreibung der Fehlerkategorien<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Die aktivierung eines fehlers, der zu einer beliebigen kategorie geh\u00f6rt, die in einem fehlerprofil definiert ist, kann vom vorhandensein\/fehlen von daten und\/oder quellereignissen abh\u00e4ngen. <code>Profile<\/code> fehlerereignisse k\u00f6nnen daher aktiviert werden, wenn bestimmte bedingungen in den daten erkannt werden oder wenn ein ger\u00e4t Aurora Vision die identifizierung eines <code>Source<\/code> fehlerereignisses (<em>ein maschinenfehler, der von einem ger\u00e4t identifiziert und an Aurora Vision gesendet wird, das ihn basierend auf dem ger\u00e4t modelliert, das ihn gesendet hat<\/em>) der in eine der profilfehlerkategorien f\u00e4llt.<\/p>\n\n\n\n<p>Im folgenden sind die kategorien von Fehlern aufgef\u00fchrt, deren bewertung von bestimmten bedingungen abh\u00e4ngt, die in den daten festgestellt wurdend (<em>nur auf Englisch verf\u00fcgbar<\/em>):<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>Category Error<\/strong><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>Description<\/strong><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>Default Status<\/strong><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong> <\/strong><strong>Hierarchical Evaluation<\/strong><\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>NOTCOM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">One or more devices have been correctly registered on Aurora Vision, but they haven&#8217;t communicated yet.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>INFO<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Plant Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>LOGCOM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Aurora Vision&#8217;s has not received any data from the inverter (<em>or logger<\/em>) for the configured timeout. Devices events will not be evaluated until communication with Aurora Vision is re-established.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>HIGH<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Logger\/Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>DEVCOM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">The device (<em>e.g. meter, weather station, battery&#8230;<\/em>) has not communicated with the inverter (<em>or logger<\/em>) for the configured timeout. Device events will not be evaluated until device communication is re-established.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>MEDIUM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>PWROFF<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">The inverter has not produced power for the Elapsed Time duration, while irradiance remains above the Irradiance Threshold. If the plant does not have a functioning irradiance sensor, only the Elapsed Time will be used to trigger this event.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>MEDIUM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>STROFF<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">A String Off State has been detected on this string. No current was produced by the string over a period of time when the average current output of all strings at the plant was above the threshold value.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>MEDIUM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>STRLOW<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">A String Low State has been detected for the string. The current produced by the string was low, compared to the average current output of all strings at the plant, over a period of time when the average was above the threshold value.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>MEDIUM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>SUBOFF<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">An OFF state has been detected for the sub-array. No current was produced over a period of time when the average current output, of all sub-arrays on the combiner, was above the threshold value.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>MEDIUM<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Device Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>PR-RNG<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">An Out-of-Range state has been detected. The Performance Ratio of the plant was detected out of range for a configured timeout.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>LOW<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Plant Level<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Alle anderen Fehlerkategorien werden basierend auf dem vorhandensein von quellereignissen bewertet, die direkt vom ger\u00e4t an Aurora Vision \u00fcbermittelt werden. Unabh\u00e4ngig von der art der vorgenommenen auswertung unterliegt die aktivierung eines profilfehlers immer den regeln, die f\u00fcr die im fehlerprofil definierte spezifische fehlerkategorie festgelegt wurden.<\/p>\n\n\n\n<p>Sie k\u00f6nnen die Excel<sup>TM<\/sup> datei aller fehlerkategorien mit ihrer beschreibung unten herunterladen:<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide has-background\" style=\"background-color:#ffe97d\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-left\"><strong>Aurora Vision Error Categories &#8211; Description File<\/strong><br>Letzte Aktualisierung: 05\/05\/2022<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<div class=\"wp-container-2 wp-block-buttons\">\n<div class=\"wp-block-button has-custom-width wp-block-button__width-100 is-style-fill\"><a class=\"wp-block-button__link\" href=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/AV_error_categories_REV2022.05.05.xlsx\" style=\"border-radius:0px\" target=\"_blank\" rel=\"noreferrer noopener\" download=\"AV_error_categories_REV2022.05.05.xlsx\">\u2b73\u00a0\u00a0\u00a0Download Excel File<\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Beurteilung des Status von Entit\u00e4ten und Fehlerereignissen<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Wie auf <strong>Page 2<\/strong>, erw\u00e4hnt, sind fehlerprofile immer werken zugeordnet und folglich kann sich der <code>Status<\/code> einer entit\u00e4t erst ab dieser hierarchieebene \u00e4ndern. Wenn ein fehlerereignis auf einer bestimmten hierarchischen ebene identifiziert und aktiviert wird, wird es an alle hierarchisch \u00fcbergeordneten einheiten (<em>ab werksebene<\/em>) weitergegeben, und dies bedeutet daher, dass der <code>Status <\/code>dieser einheiten wird einheitlich ge\u00e4ndert; dieses verhalten wird als das prinzip der hierarchischen statusweitergabe identifiziert.<\/p>\n\n\n\n<p>Die API <code>GET Status<\/code> API erm\u00f6glicht es, den <code>Status <\/code>einer <code>Plant<\/code>, <code>Logger<\/code> und\/oder <code>Device <\/code>(<em>abh\u00e4ngig von der hierarchieebene und der suite<\/em>).<br>Die besonderheit dieser API ist ihr dynamisches verhalten: Sie gibt immer die explosion aller hierarchisch niedrigeren entit\u00e4ten zur\u00fcck, deren <code>Status<\/code> unterscheidet sich von <code>NORMAL<\/code>, und gibt somit an, welche von aktiven fehlerereignissen betroffen sind (<span style=\"text-decoration: underline;\">aber nicht den eigentlichen ereignisfehlertyp<\/span>).<\/p>\n\n\n\n<p>Nehmen wir das folgende hierarchische schema als beispiel und nehmen wir an, wir m\u00f6chten den <code>Status <\/code>von <strong>Plant 1<\/strong>, \u00fcberpr\u00fcfen, um zu verstehen, ob es m\u00f6glicherweise aktive fehlerereignisse gibt:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"515\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-3-1024x515.png\" alt=\"\" class=\"wp-image-7382\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-3-1024x515.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-3-300x151.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-3-768x386.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/hierarchy_truncated-3.png 1396w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Auf der hierarchischen ebene der anlage rufen wir die API <code>GET Plant Status<\/code> auf:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/plant\/{entityID}\/status<\/code><\/p>\n\n\n\n<p>Wenn es kein aktives fehlerereignis gibt, erhalten wir eine antwort, in der <code>Status <\/code>von <strong>Plant 1<\/strong> gleich <code>NORM <\/code>(was \u00e4quivalent zu <code>NORMAL<\/code>):<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_NORMAL-1.png\" alt=\"\" class=\"wp-image-7350\" width=\"256\" height=\"138\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_NORMAL-1.png 512w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_NORMAL-1-300x162.png 300w\" sizes=\"(max-width: 256px) 100vw, 256px\" \/><\/figure>\n\n\n\n<p>Wenn es mindestens ein aktives fehlerereignis gibt, bedeutet dies, dass mindestens einem der in <strong>Plant 1<\/strong>, registrierten ger\u00e4te, die daher hierarchische kinder von letzterem sind, ein aktives fehlerereignis zugeordnet ist; in diesem Fall passt sich die antwort der API dynamisch an, indem der <code>Status <\/code>von <strong>Plant 1<\/strong> explodiert wird, aber auch von allen hierarchischen untergeordneten entit\u00e4ten, deren <code>Status <\/code>ist abweichend von <code>NORM<\/code>:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_exploded-2.png\" alt=\"\" class=\"wp-image-7390\" width=\"440\" height=\"428\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_exploded-2.png 880w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_exploded-2-300x292.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/plant_status_exploded-2-768x747.png 768w\" sizes=\"(max-width: 440px) 100vw, 440px\" \/><\/figure>\n\n\n\n<p>Wir k\u00f6nnen sehen, wie die Antwort jetzt strukturierter ist und wie der status von <strong>Plant 1<\/strong> jetzt gleich <code>MEDIUM<\/code>, ist, ein symptom daf\u00fcr, dass f\u00fcr einige ein fehlerereignis aktiv ist einheiten niedrigerer hierarchieebene. Dieses fehlerereignis ist f\u00fcr <strong>Inverter 1<\/strong>, aktiv, da die API uns eine explodierte antwort f\u00fcr alle hierarchieebenen liefert, die von <strong>Plant 1<\/strong> (<code>LVL 3<\/code>) an <strong>Inverter 1<\/strong> (<code>LVL 5<\/code>). Der <code>Status <\/code>aller drei entit\u00e4ten ist daher gleich <code>MEDIUM<\/code>, aufgrund des prinzips der hierarchischen weitergabe, das wir oben auf der seite erw\u00e4hnt haben.<\/p>\n\n\n\n<p>Das prinzip der verarbeitung einer dynamischen antwort durch eine <code>GET Status<\/code> API ist auch auf niedrigeren hierarchieebenen vorhanden.<br>Wenn wir f\u00fcr das obige beispiel den<code> GET Logger Status<\/code>, lautet die zur\u00fcckgegebene antwort:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/logger_status_exploded-1.png\" alt=\"\" class=\"wp-image-7493\" width=\"427\" height=\"293\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/logger_status_exploded-1.png 854w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/logger_status_exploded-1-300x206.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/logger_status_exploded-1-768x527.png 768w\" sizes=\"(max-width: 427px) 100vw, 427px\" \/><\/figure>\n\n\n\n<p>Wir k\u00f6nnen sehen, dass die antwort genau dieselbe struktur hat wie die, die mit der API  <code>GET Plant Status<\/code> , erhalten wird, wobei sowohl <strong>Logger 1<\/strong> als auch <strong>Inverter 1<\/strong> haben ihren <code>Status <\/code>gleich <code>MEDIUM<\/code>. Der einzige unterschied ist das vorhandensein einer hierarchieebene weniger (<em>weil wir gezielt ressourcen einer niedrigeren hierarchieebene haben<\/em>).<\/p>\n\n\n\n<p>Wir haben also gesehen, wie das prinzip der hierarchischen ausbreitung gilt: jedes ger\u00e4t mit einem aktiven fehlerereignis, das dazu f\u00fchrt, dass sein <code>Status <\/code>sich von <code>NORMAL<\/code>, unterscheidet, \u00e4ndert gleichzeitig den <code>Status <\/code>aller hierarchisch \u00fcbergeordneten einheiten (<em>ab werksebene<\/em>). Dies erm\u00f6glicht es, das vorhandensein oder nichtvorhandensein von fehlern sofort zu unterscheiden, indem einfach die <code>GET Plant Status <\/code>API genutzt wird.<\/p>\n\n\n\n<p>Nat\u00fcrlich sind wir, sobald wir das vorhandensein von fehlerereignissen festgestellt haben, daran interessiert zu wissen, was diese fehlerereignisse sind. Dazu k\u00f6nnen wir die API <code>GET Events <\/code>verwenden, die es erm\u00f6glicht, die fehlerereignisse einer <code>Plant<\/code>, <code>Logger<\/code> und\/oder <code>Device <\/code>(<em>abh\u00e4ngig von der hierarchischen ebene, an der wir interessiert sind<\/em>) mit erweiterter Filterung nach: kategorie, typ, zustand und vorkommen.<\/p>\n\n\n\n<p>Sehen wir uns die vollst\u00e4ndige API-anfrage an und schl\u00fcsseln sie dann auf, um sie im detail zu analysieren:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/{plant,logger,device}\/{entityID}\/events?eventsKind={Profile,Source}&amp;eventsType={eventsType}&amp;eventsState={ALL,ACTIVE,CLOSED}&amp;eventsOccurrence={H24,D7,D30}&amp;page={pageNumber}<\/code><\/p>\n\n\n\n<p>Der pfad, der es ihnen erm\u00f6glicht, auf die gew\u00fcnschten ressourcen zu verweisen, erfordert immer den <code>{entityID}<\/code> und je nach hierarchieebene und der suite, auf der sie sich befinden, kann es ein <code>Plant<\/code>, <code>Logger<\/code> oder <code>Device<\/code> EID:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/{plant,logger,device}\/{entityID}\/events<\/code><\/p>\n\n\n\n<p>Die API erfordert immer den abfrageparameter <code>{eventsKind}<\/code> um den typ der aufzurufenden fehlerereignisse zu unterscheiden.<br>Dieser parameter kann zwei verschiedene werte haben:<\/p>\n\n\n\n<ul><li><code>Profile<\/code>: erm\u00f6glicht das abrufen von fehlerereignissen vom typ profil, i.e. solche, die von Aurora Vision basierend auf dem fehlerprofil mit seinen konfigurierten regeln aktiviert werden, die der betrachteten anlage zugeordnet sind (<em>oder f\u00fcr eines der hierarchisch untergeordneten ger\u00e4te<\/em>)<\/li><li><code>Source<\/code>: erm\u00f6glicht das abrufen von fehlerereignissen vom typ quelle, i.e. maschinenfehler, die von einem ger\u00e4t identifiziert wurden und welche werden dann an Aurora Vision \u00fcbermittelt (<em>das sie basierend auf dem ger\u00e4t modelliert, das sie gesendet hat<\/em>)<\/li><\/ul>\n\n\n\n<p>Wir haben zuvor gesagt, dass die aktivierung eines fehlers, der zu einer beliebigen kategorie geh\u00f6rt, die in einem fehlerprofil definiert ist, vom vorhandensein\/fehlen von daten und\/oder quellereignissen abh\u00e4ngen kann. <code>Profile <\/code>fehlerereignisse k\u00f6nnen aktiviert werden, wenn bestimmte bedingungen in den daten erkannt werden oder wenn ein ger\u00e4t Aurora Vision die identifikation einer <code>Source <\/code>fehlerereignis, das in eine der profilfehlerkategorien f\u00e4llt. In anbetracht dessen, dass quellereignisse schwieriger zu verstehen sind als die profilereignisse, da sie aus abk\u00fcrzungen bestehen, die von ger\u00e4t zu ger\u00e4t unterschiedlich sein k\u00f6nnen, und dass Aurora Vision implizit die modellierung dieser ereignisse in fehlerkategorien verwaltet, um den richtigen profilfehler zu aktivieren event ist es ratsam, die API immer wie folgt zu filtern:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/{plant,logger,device}\/{entityID}\/events?eventsKind=Profile<\/code><\/p>\n\n\n\n<p>Obwohl die restlichen <code>queryParameters <\/code>nicht erforderlich sind, um eine antwort zu erhalten, ist es bei der arbeit mit fehlerereignissen immer n\u00fctzlich, typ, auftreten und zustand filtern zu k\u00f6nnen:<\/p>\n\n\n\n<ul><li><code>eventsType<\/code>: erm\u00f6glicht das filtern der art von profilfehlerereignissen; es kann jeweils nur eine art von fehlerereignis gefiltert werden (eine vollst\u00e4ndige tabelle zu den arten von fehlerereignissen finden sie auf <strong>Seite<\/strong> <strong>4<\/strong>). Wenn nicht in die API eingef\u00fcgt, werden alle ereignistypen zur\u00fcckgegeben;<\/li><li><code>eventsOccurrence<\/code>: erm\u00f6glicht das auftreten von fehlerereignissen zu filtern; akzeptierte werte sind <code>24H<\/code>, f\u00fcr ein zeitfenster von 24 stunden, <code>7D<\/code>, f\u00fcr ein zeitfenster von 7 tagen oder, oder <code>30D<\/code>, f\u00fcr eine zeitfenster von 30 tagen. Wenn nicht in die API eingef\u00fcgt, werden alle ereignisse zur\u00fcckgegeben, die lebensdauer der anlage abdecken;<\/li><li><code>eventsState<\/code>: erm\u00f6glicht das filtern des Status der fehlerereignisse; akzeptierte werte sind <code>ACTIVE<\/code>, f\u00fcr aktive ereignisse, die daher keine abschlie\u00dfende zeitliche singularit\u00e4t hatten, <code>CLOSED<\/code>, f\u00fcr geschlossene ereignisse, oder <code>ALL<\/code>, f\u00fcr anfragen gleichzeitig aktive und geschlossene ereignisse. Wenn es nicht in die API eingef\u00fcgt wird, werden alle aktiven und geschlossenen ereignisse zur\u00fcckgegeben;<\/li><\/ul>\n\n\n\n<p>An diesem punkt haben wir alle tools, um zu verstehen, welche fehlerereignisse f\u00fcr <strong>Plant 1<\/strong>:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/plant\/12345678\/events?eventsKind=Profile&amp;eventsOccurrence=24H&amp;eventsState=ACTIVE<\/code><\/p>\n\n\n\n<p>Wir haben uns auf der hierarchischen ebene <code>plant <\/code>platziert, indem wir die EID von Plant 1 (<code>12345678<\/code>), eingegeben und <code>ACTIVE <\/code>fehlerereignisse angefordert haben die letzten <code>24H<\/code>:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/error_events_response_active-862x1024.png\" alt=\"\" class=\"wp-image-7601\" width=\"431\" height=\"512\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/error_events_response_active-862x1024.png 862w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/error_events_response_active-253x300.png 253w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/error_events_response_active-768x912.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/05\/error_events_response_active.png 896w\" sizes=\"(max-width: 431px) 100vw, 431px\" \/><\/figure>\n\n\n\n<p>Aus der antwort k\u00f6nnen wir ersehen, dass zwei profiltyp-fehlerereignisse aktiv sind: ein <code>DEVCOM <\/code>f\u00fcr <strong>Inverter 1<\/strong> und ein <code>LOGCOM <\/code>f\u00fcr <strong>Logger 1<\/strong>. Die beiden fehlerereignisse werden zu unterschiedlichen zeitpunkten aktiviert und anhand der definitionen k\u00f6nnen wir davon ausgehen, dass <strong>Inverter 1<\/strong> bei aufgeh\u00f6rt hat zu senden <strong>Logger 1<\/strong> daten an <code>eventStart<\/code>; letzteres kommunizierte immer noch korrekt mit Aurora Vision, h\u00f6rte aber anschlie\u00dfend bei <code>eventStart<\/code>.<\/p>\n\n\n\n<p>Das prinzip der hierarchischen statusweitergabe gilt auch f\u00fcr diese art von API, wodurch best\u00e4tigt wird, dass ein fehlerereignis, wenn es auf einer bestimmten hierarchischen ebene identifiziert und aktiviert wird, an alle hierarchisch \u00fcbergeordneten einheiten weitergegeben wird; damit wird ein fehlerereignis, das ein ger\u00e4t betrifft, auch auf der anlagenhierarchieebene angezeigt, wie wir am obigen beispiel gut erkennen k\u00f6nnen..<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Jede in Aurora Vision registrierte Entit\u00e4t ist durch einen Status gekennzeichnet, der es erm\u00f6glicht, das Vorhandensein aktiver Fehlerereignisse zu identifizieren. Aurora Vision kann den status einer anlage und folglich aller darin registrierten entit\u00e4ten nur dann auswerten, wenn die anlage korrekt mit einem fehlerauswertungsprofil verkn\u00fcpft ist. Jede in einem portfolio registrierte pflanze wird automatisch dem von [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":1792,"menu_order":10,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/7855"}],"collection":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/comments?post=7855"}],"version-history":[{"count":120,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/7855\/revisions"}],"predecessor-version":[{"id":9917,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/7855\/revisions\/9917"}],"up":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/1792"}],"wp:attachment":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/media?parent=7855"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}