vC Ops Adapter<\/h2>\n
Was muss und kann ich also tun, um Daten aus anderen Quellen an vC Ops anzubinden? Daf\u00fcr sind die “Adapter” gedacht. Durch vC Ops Adapter kann ich \u00a0mehr oder minder ausgefeilt und komplex nahezu jegliche Datenquellen an vC Ops anbinden. Dies k\u00f6nnen SNMP daten, Text-Files, SQL Datenbanken oder sonstiges sein.<\/p>\n
Bevor ich allerdings anfange Hinz und Kunz Daten in vC Ops einfliessen zu lassen, sollte man \u00fcber die Ziele und die Sinnhaftigkeit der Daten im Klaren sein. Die Diskussion \u00fcber das “warum” und “was” sollte auf jeden Fall gef\u00fchrt werden, bevor man die Kaffeemaschine und Tonerstand im Drucker in sein Anforderungskatalog aufnimmt.<\/p>\n
Um die grunds\u00e4tzlichen M\u00f6glichkeiten kennenzulernen, sollte man die allgemeine Dokumentation der verschiedenen Adapter lesen. Die Adapter sind in der K\u00fcrze in “vC Ops Enterprise Adapter Guide” vorgestellt:\u00a0http:\/\/www.vmware.com\/pdf\/vcops-enterprise10-adapter-guide.pdf<\/a><\/p>\n Diese Mindmap stellt die Anbindungsm\u00f6glichkeiten und die verschiedenen Adapter dar (kein Anspruch auf Vollst\u00e4ndigkeit, da immer neue Herstelleradapter erstellt und freigegeben werden).<\/p>\n Der einfachste Adapter ist der HTTP POST Adapter. Dieser ist schon vorinstalliert und kann ganz einfach mit einem REST Client getestet werden.<\/p>\n Um dem beschriebenen Vorgehen folgen zu k\u00f6nnen brauchen wir folgende Zutaten<\/p>\n Sollte man im Besitz einer Internetf\u00e4higen Wetterstation sein, k\u00f6nnte man diese auf dem Dach installieren und die Daten ablesen. Da wir aber grunds\u00e4tzlich das Geb\u00e4ude nicht ohne Grund verlassen wollen, holen wir die Wetterdaten aus dem Internet (oder im Neudeutsch der Tageszeitungen: “die Daten kommen aus der Cloud” \ud83d\ude42 In diesem Fall von http:\/\/openweathermap.org<\/a>\u00a0– auf dieser Seite k\u00f6nnen Daten f\u00fcr viele Lokationen werbefrei und in verschiedenen Formaten abgefragt werden. \u00a0F\u00fcr Bonn w\u00e4re es z.B. die folgende URL:<\/p>\n http:\/\/api.openweathermap.org\/data\/2.5\/weather?q=Bonn,de<\/a><\/p>\n Erstaunlicherweise funktioniert es sogar f\u00fcr Bielefeld.<\/p>\n In meinem Fall steht die Cluster und der vCenter in Z\u00fcrich. Ausserdem m\u00f6chte ich die Daten metrisch und nicht in Kelvin geliefert bekommen und nicht in json sondern im XML-Format:<\/p>\n http:\/\/api.openweathermap.org\/data\/2.5\/weather?q=Zuerich&units=metric&mode=xml<\/a><\/p>\n Aus dem gelieferten XML-File k\u00f6nnen wir mit awk die gew\u00fcnschten Metriken herausw\u00e4hlen. Zum Posten der Daten \u00fcber HTTP POST ben\u00f6tigen wir nur noch die Beschreibung des Objekts (neu oder vorhanden) und den Zeitstempel. Die Dokumentation unter der folgenden URL (lokal, vcops mit dem Namen oder IP des vC Ops-Servers ersetzen):<\/p>\n https:\/\/vcops\/HttpPostAdapter<\/a><\/p>\n Der Vorgang, der in diesem Fall benutzt wird, ist unter dem Stichpunkt “AddGeneralMetricObservations<\/em>” beschrieben.<\/p>\n Das Erbenis-Post-File sollte in etwa so aussehen:<\/p>\n Erkl\u00e4rung der ersten Zeile: <\/em><\/p>\n Dieses kann man \u00fcber einen Browser mit einem REST AddOn testen (Authentifizierung nicht vergessen):<\/p>\n Um den Vorgang zu automatisieren, benutze ich curl um die Wetterdaten abzuholen, awk um die gew\u00fcnschten Metriken auszulesen und wieder curl um das erzeugte Post-File \u00fcber die REST API an vC Ops zu \u00fcbergeben.\u00a0Das komplette bash-Skript k\u00f6nnte zum Beispiel so aussehen:<\/p>\n Die Wetterdaten sollen alle 5 Minuten abgefragt und gepostet werden. Hierzu kann man auf der Konsole folgendes Kommando aufrufen:<\/p>\n Der entsprechender Eintrag in der crontab:<\/p>\n <\/p>\n In der Custom-UI des vC Ops taucht ein neues Objekt auf: Zuerich. Man kann dem Objekt (eigentlich dem Object-Kind) auch ein geeignetes Icon zuweisen. Hier ist das Ergebnis:<\/p>\n Mit wenigen Klicks kann ich nun in der Custom-UI ein “custom dashboard” f\u00fcr die Wetterdaten erstellen. Somit kann der arme Admin trotz seiner Fensterlosigkeit bei dem Wetter-Smalltalk mithalten:<\/p>\n <\/p>\n Nun ist es zwar spannend sich das Wetter in verschiedenen selbsterstellten Dashboards der Custom UI anzeigen zu lassen, doch m\u00f6chte man vielleicht diese Daten in der “Standard” vSphere-UI sehen und eventuell bei bestimmten Objekten anzeigen zu lassen (vCenter, Datacenter, Cluster oder ESX Hosts). Auch dies ist mit einem einfachen Griff m\u00f6glich: man muss lediglich die ID des Objekts herausfinden und die POST Kopfzeile anpassen.<\/p>\n Um die korrekte Ressourcen Bezeichnung herauszufinden, m\u00fcssen wir im REST-Client folgendes Kommando (nach erfolgter Authentifizierung) per POST eingeben:<\/p>\n Die Antwort sieht in meinem Fall wie folgt aus:<\/p>\n Die daraus resultierende Kopfzeile beim Posten der Daten sieht dann wie folgt aus:<\/p>\n Entscheidend ist es, die Ressourcenbezeichnungen “resourceName=” zu entfernen und ein \u00a0“false” durch “true” zu ersetzen. Mit “true” wird kein neues Objekt erzeugt, sondern die Metriken auf das existierende drangeh\u00e4ngt.<\/p>\n Dar Ergebnis ist dann in der vSphere-UI \u00a0in dem Bereich “All Metrics” zusammen mit allen anderen Metriken des Objekts zu sehen:<\/p>\n Damit sind die Wetterdaten pl\u00f6tzlich Bestandteil der Metriken des Datacenters und k\u00f6nnen im Zusammenhang betrachtet werden.<\/p>\n Das vollst\u00e4ndige Skript sieht in diesem Fall so aus:<\/p>\n Ich hoffe dieses kleine Beispiel hilft, zu verstehen, wie externe Daten im einfachsten Fall an vC Ops angebunden werden k\u00f6nnen. Wenn es mit Wetter klappt, k\u00f6nnte man auch an Blutdruck, den Kaffeestand oder Mouse-Meter des Administrators denken…<\/p>\n P.S. So sieht unser Wetter-Dashboard in dem M\u00fcnchner-Lab aus:<\/p>\n![\"vC](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/vC-Ops-Adapters-300x211.png\")
<\/a><\/p>\nAnbindung der Wetterdaten an vC Ops<\/h2>\n
Voraussetzungen<\/h3>\n
\n
Wetterdaten holen<\/h3>\n
HTTP POST Adapter testen<\/h3>\n
Zuerich,HttpPost,Stadt,,SchoeneStadt,5,\r\nMeteoData|Temperature|Temperature in Celsius,3,NoValue,1369644692071,9.83,\r\nMeteoData|Humidity|Humidity in percent,3,NoValue,1369644692071,71,\r\nMeteoData|Air Pressure|Pressure in hPA,3,NoValue,1369644692071,1013,<\/pre>\n
Objekt,Adapter,Objektart,,Objektbeschreibung,Minuten,<\/pre>\n
![\"rest-api\"](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/rest-api-300x180.png\")
<\/a><\/p>\n\u00a0Bash-Skript zur Automatisierung<\/h2>\n
#Script to integrate local weather metrics in vC Ops\r\n# Author: tbaublys@vmware.com\r\n\r\n\/usr\/bin\/curl -s http:\/\/api.openweathermap.org\/data\/2.5\/weatherq=Zuerich&units=metric&mode=xml\">http:\/\/api.openweathermap.org\/data\/2.5\/weather?q=Zuerich&units=metric&mode=xml\" > wetter.xml\r\nTIMESTAMP=$( date +%s%N | cut -b1-13)TEMP=$(awk -v RS='\"' '\/temperature value=$\/{getline;print} ' wetter.xml)\r\nHUMID=$(awk -v RS='\"' '\/humidity value=$\/{getline;print} ' wetter.xml)\r\nPRESS=$(awk -v RS='\"' '\/pressure value=$\/{getline;print} ' wetter.xml)\r\necho \"Zuerich,HttpPost,Stadt,,SchoeneStadt,5,\" > postfile;\r\necho \"MeteoData|Temperature|Temperature in Celsius,3,NoValue,$TIMESTAMP,$TEMP,\" >> postfile;\r\necho \"MeteoData|Humidity|Humidity in percent,3,NoValue,$TIMESTAMP,$HUMID,\" >> postfile;\r\necho \"MeteoData|Air Pressure|Pressure in hPA,3,NoValue,$TIMESTAMP,$PRESS,\" >> postfile;\r\n\r\n# Upload the postfile content using HTTP Post API\r\n\/usr\/bin\/curl -k -v -H -X POST --data-binary \"@postfile\" -u admin:password https:\/\/vcops:443\/HttpPostAdapter\/OpenAPIServlet<\/pre>\nwhile :; do sh \/root\/wetter\/wetter; sleep 300; done<\/pre>\n
*\/5 * * * * \u00a0 root \u00a0 \/root\/wetter\/wetter >\/dev\/null 2>&1<\/pre>\n
\u00a0<\/i><\/pre>\n
Das Ergebnis in der Custom-UI<\/h2>\n
![\"zuerich\"](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/zuerich-300x162.png\")
<\/a><\/p>\n![\"Screen](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/Screen-Shot-2013-06-02-at-18.46.36-300x156.png\")
<\/a><\/p>\nWetterdaten an ein existierendes Objekt dranh\u00e4ngen<\/h1>\n
action=lookupResource&resourceName=PCPt_MGMT<\/pre>\n
resourceName=PCPt_MGMT&adapterKindKey=VMWARE&resourceKindKey=Datacenter&identifiers=VMEntityName::PCPt_MGMT::false$$VMEntityObjectID::datacenter-2$$VMEntityVCID::CFB22C5F-32AF-45D6-A670-5A456C8214E6<\/pre>\n
PCPt_MGMT,VMWARE,Datacenter,VMEntityName::PCPt_MGMT::true$$VMEntityObjectID::datacenter-2$$VMEntityVCID::CFB22C5F-32AF-45D6-A670-5A456C8214E6,,5,,<\/pre>\n
![\"Screen](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/Screen-Shot-2013-06-02-at-19.13.52-300x163.png\")
<\/a><\/p>\n#!\/bin\/bash#Script to integrate local weather metrics in vC Ops\r\n# Author: tbaublys@vmware.com\r\n\r\n\/usr\/bin\/curl -s http:\/\/api.openweathermap.org\/data\/2.5\/weather?q=Zuerich&units=metric&mode=xml > wetter.xml\r\n\r\nTIMESTAMP=$( date +%s%N | cut -b1-13)\r\nTEMP=$(awk -v RS='\"' '\/temperature value=$\/{getline;print} ' wetter.xml)\r\nHUMID=$(awk -v RS='\"' '\/humidity value=$\/{getline;print} ' wetter.xml)\r\nPRESS=$(awk -v RS='\"' '\/pressure value=$\/{getline;print} ' wetter.xml)\r\n\r\necho PCPt_MGMT,VMWARE,Datacenter,VMEntityName::PCPt_MGMT::true\\$\\$VMEntityObjectID::datacenter-2\\$\\$VMEntityVCID::CFB22C5F-32AF-45D6-A670-5A456C8214E6,,5,,\"> postfile1;\r\necho \"MeteoData|Temperature|Temperature in Celsius,3,NoValue,$TIMESTAMP,$TEMP,\" >> postfile1;\r\necho \"MeteoData|Humidity|Humidity in percent,3,NoValue,$TIMESTAMP,$HUMID,\" >> postfile1;\r\necho \"MeteoData|Air Pressure|Pressure in hPA,3,NoValue,$TIMESTAMP,$PRESS,\" >> postfile1;\r\n\/usr\/bin\/curl -k -v -H -X POST --data-binary \"@postfile1\" -u admin:password https:\/\/vcops:443\/HttpPostAdapter\/OpenAPIServlet<\/pre>\n<\/address>\n
![\"tb_sc_2014-03-30_12-16-36_pm\"](\"http:\/\/wiegehtdasmitdemcloud.de\/wp-content\/uploads\/2013\/06\/tb_sc_2014-03-30_12-16-36_pm.png\")
<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"