{"id":157,"date":"2019-12-08T12:29:43","date_gmt":"2019-12-08T11:29:43","guid":{"rendered":"http:\/\/thomas-kopton.de\/vblog\/?p=157"},"modified":"2019-12-08T20:34:12","modified_gmt":"2019-12-08T19:34:12","slug":"maintenance-mode-for-vrealize-operations-objects-part-1","status":"publish","type":"post","link":"https:\/\/thomas-kopton.de\/vblog\/?p=157","title":{"rendered":"Maintenance Mode for vRealize Operations Objects, Part 1"},"content":{"rendered":"\n

In this<\/strong> and following<\/strong> posts I will show you few different ways of putting vROps objects into maintenance.<\/p>\n\n\n\n

Objects in vROps – short intro<\/h4>\n\n\n\n

The method used to mark an object as being in the maintenances state depends on the actual use case. As usually, the use case itself is being defined by: <\/p>\n\n\n\n

  • Requirements<\/strong> \u2013 what does \u201cmaintenance\u201d mean from technical perspective, what exactly needs to be achieved?<\/li>
  • Constraints<\/strong> \u2013 is there any automation in place, which team is involved, what and how many objects are involved?<\/li>
  • Assumptions<\/strong> \u2013 can we assume that especially the number and kind of objects will stay the same or what is the expected growth?<\/li>
  • Risks<\/strong> \u2013 what are the risks of using a certain method?<\/li><\/ul>\n\n\n\n

    Let us assume our first use case is:<\/p>\n\n\n\n

    \u201cIn case of ESXi host maintenance mode I will to stop collecting any data for this host and disable all alerts.\u201d<\/em><\/p>\n\n\n\n

    As always, before we start any design and implementation, we did a proper assessment and collected further information:<\/p>\n\n\n\n

    • There are only few ESXi hosts in\nmaintenance at the same time<\/li>
    • The team doing the maintenance in\nvCenter can also access and use the vROps UI<\/li>
    • Automation could be used but is not mandatory<\/li>
    • All implications from stopping\nmetrics and property collection for a given object, like ESXi host are known\nand accepted<\/li><\/ul>\n\n\n\n

      Let us first look at one specific vROps object, in that case a Host System (ESXi host), using the vROps inventory option: <\/p>\n\n\n\n

      \"\"
      Host System object in vROps Inventory – “Show Detail” option<\/figcaption><\/figure>\n\n\n\n

      <\/p>\n\n\n\n

      We see that the object is properly collecting metrics and properties according to both indicators. The details of the selected object can be checked by clicking the \u201cShow Detail\u201d button. This redirects you to the Summary page of the object. The currently collected metrics and properties can be checked by activating the \u201cShow collecting metrics\u201d option: <\/p>\n\n\n\n

      \"\"
      Collected metrics for the selected object<\/figcaption><\/figure>\n\n\n\n

      Activating the maintenance mode – the UI-way<\/h4>\n\n\n\n

      The easiest way to put an object into maintenance mode is to use the \u201cStart Maintenance\u201d button in the Inventory overview: <\/p>\n\n\n\n

      \"\"
      Enabling Maintenance Mode in vROps UI<\/figcaption><\/figure>\n\n\n\n

      In the following dialog you can specify how long the object should be put into maintenance: <\/p>\n\n\n\n

      \"\"
      Specifying the Maintenance duration<\/figcaption><\/figure>\n\n\n\n

      After starting the Maintenance, you can again check the new status of the object in the Inventory view:<\/p>\n\n\n\n

      \"\"

      Object status during vROps Maintenance<\/figcaption><\/figure>\n\n\n\n

      Now, if you use the same \u201cShow collecting metrics\u201d option in the metrics tab of the object you can see that there are no metrics or properties collecting data. The object stopped the data collection entirely: <\/p>\n\n\n\n

      \"\"
      No collected metrics and\/or properties during vROps Maintenance for an object<\/figcaption><\/figure>\n\n\n\n

      At this point you need to know that from the monitoring perspective this object is still in the inventory but the is no single data point being collected, stored and calculated in any way. Any calculations relying on data points coming in for that particular object will not provide new data or calculate nor entirely correct data. What “correct” means, depends on the actual metric, dashboard, view etc.<\/p>\n\n\n\n

      Deactivating the maintenance mode – the UI-way<\/h4>\n\n\n\n

      As easy as we started the maintenance as easy it can be stopped again using the UI: <\/p>\n\n\n\n

      \"\"
      Disabling Maintenance Mode in vROps UI<\/figcaption><\/figure>\n\n\n\n

      After clicking on the “End Maintenance” button, vROps will start collecting all data for the object again.<\/p>\n\n\n\n

      Activating the maintenance mode – the REST-API-way<\/h4>\n\n\n\n

      Starting and ending the Maintenance Mode using the UI is easy and convenient if you have to deal with a small number of objects and there are no other constraints like complying with e.g. change management process which may require automation.<\/p>\n\n\n\n

      If you need to deal with a large number of objects or if the vROps Maintenance Mode should be part of an automated process, leveraging the vROps API is the best way to implement it.<\/p>\n\n\n\n

      As always when using the REST API, the first step is to obtain the Access Token. To acquire the token, following POST method needs to be used:<\/p>\n\n\n\n

      POST \/api\/auth\/token\/acquire<\/pre>\n\n\n\n
      \"\"
      aquireToken REST API call<\/figcaption><\/figure>\n\n\n\n
      Once we have a valid token, we can call the Maintenance Mode related operations. Following REST operation starts the Maintenance Mode for a given object:<\/p>\n\n\n\n
      \"\"
      REST API method to start the maintenance mode<\/figcaption><\/figure>\n\n\n\n
      As you can see, you will need to determine the vROps Object ID of the object(s) you need to put into maintenance before you can call the actual Maintenance Mode calls.<\/p>\n\n\n\n
      Once you have the ID(s) the method can be used:<\/p>\n\n\n\n
      \"\"
      REST API Call – Start Maintenance Mode<\/figcaption><\/figure>\n\n\n\n
      Deactivating the maintenance mode – the REST-API-way<\/h4>\n\n\n\n
      To end the maintenance following REST API method has to be used:<\/p>\n\n\n\n
      \"\"
      REST API Call – End Maintenance Mode<\/figcaption><\/figure>\n\n\n\n
      Again, you will need the vROps Object ID to call this method.<\/p>\n\n\n\n
      Part 2 – Outlook<\/h4>\n\n\n\n
      In the upcoming Part 2 of this post, I will describe other methods which may be used in cases when the requirements differ from the use case described in this post. <\/p>\n","protected":false},"excerpt":{"rendered":"
      In this and following posts I will show you few different ways of putting vROps objects into maintenance. Objects in vROps – short intro The method used to mark an object as being in the maintenances state depends on the actual use case. As usually, the use case itself is being defined by: Requirements \u2013 …<\/p>\n","protected":false},"author":1,"featured_media":178,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[6,3],"class_list":["post-157","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vrops","tag-rest","tag-vrops"],"yoast_head":"\nMaintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/thomas-kopton.de\/vblog\/?p=157\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Maintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps\" \/>\n<meta property=\"og:description\" content=\"In this and following posts I will show you few different ways of putting vROps objects into maintenance. Objects in vROps – short intro The method used to mark an object as being in the maintenances state depends on the actual use case. As usually, the use case itself is being defined by: Requirements \u2013 ...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/thomas-kopton.de\/vblog\/?p=157\" \/>\n<meta property=\"og:site_name\" content=\"TOMsOps\" \/>\n<meta property=\"article:published_time\" content=\"2019-12-08T11:29:43+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-12-08T19:34:12+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1602\" \/>\n\t<meta property=\"og:image:height\" content=\"393\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Thomas Kopton\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Thomas Kopton\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157\"},\"author\":{\"name\":\"Thomas Kopton\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/#\\\/schema\\\/person\\\/892d6b96c66b1dd4b75c6e32fdbfea82\"},\"headline\":\"Maintenance Mode for vRealize Operations Objects, Part 1\",\"datePublished\":\"2019-12-08T11:29:43+00:00\",\"dateModified\":\"2019-12-08T19:34:12+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157\"},\"wordCount\":828,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/wp-content\\\/uploads\\\/2019\\\/12\\\/Picture-7.png\",\"keywords\":[\"REST\",\"vROps\"],\"articleSection\":[\"vROps\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157\",\"url\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157\",\"name\":\"Maintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/wp-content\\\/uploads\\\/2019\\\/12\\\/Picture-7.png\",\"datePublished\":\"2019-12-08T11:29:43+00:00\",\"dateModified\":\"2019-12-08T19:34:12+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/#\\\/schema\\\/person\\\/892d6b96c66b1dd4b75c6e32fdbfea82\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#primaryimage\",\"url\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/wp-content\\\/uploads\\\/2019\\\/12\\\/Picture-7.png\",\"contentUrl\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/wp-content\\\/uploads\\\/2019\\\/12\\\/Picture-7.png\",\"width\":1602,\"height\":393},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?p=157#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Maintenance Mode for vRealize Operations Objects, Part 1\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/#website\",\"url\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/\",\"name\":\"TOMsOps\",\"description\":\"Just another VMware Cloud Management Blog\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/#\\\/schema\\\/person\\\/892d6b96c66b1dd4b75c6e32fdbfea82\",\"name\":\"Thomas Kopton\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g\",\"caption\":\"Thomas Kopton\"},\"url\":\"https:\\\/\\\/thomas-kopton.de\\\/vblog\\\/?author=1\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Maintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/thomas-kopton.de\/vblog\/?p=157","og_locale":"en_US","og_type":"article","og_title":"Maintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps","og_description":"In this and following posts I will show you few different ways of putting vROps objects into maintenance. Objects in vROps – short intro The method used to mark an object as being in the maintenances state depends on the actual use case. As usually, the use case itself is being defined by: Requirements \u2013 ...","og_url":"https:\/\/thomas-kopton.de\/vblog\/?p=157","og_site_name":"TOMsOps","article_published_time":"2019-12-08T11:29:43+00:00","article_modified_time":"2019-12-08T19:34:12+00:00","og_image":[{"width":1602,"height":393,"url":"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png","type":"image\/png"}],"author":"Thomas Kopton","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Thomas Kopton","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#article","isPartOf":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157"},"author":{"name":"Thomas Kopton","@id":"https:\/\/thomas-kopton.de\/vblog\/#\/schema\/person\/892d6b96c66b1dd4b75c6e32fdbfea82"},"headline":"Maintenance Mode for vRealize Operations Objects, Part 1","datePublished":"2019-12-08T11:29:43+00:00","dateModified":"2019-12-08T19:34:12+00:00","mainEntityOfPage":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157"},"wordCount":828,"commentCount":0,"image":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#primaryimage"},"thumbnailUrl":"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png","keywords":["REST","vROps"],"articleSection":["vROps"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/thomas-kopton.de\/vblog\/?p=157#respond"]}]},{"@type":"WebPage","@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157","url":"https:\/\/thomas-kopton.de\/vblog\/?p=157","name":"Maintenance Mode for vRealize Operations Objects, Part 1 - TOMsOps","isPartOf":{"@id":"https:\/\/thomas-kopton.de\/vblog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#primaryimage"},"image":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#primaryimage"},"thumbnailUrl":"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png","datePublished":"2019-12-08T11:29:43+00:00","dateModified":"2019-12-08T19:34:12+00:00","author":{"@id":"https:\/\/thomas-kopton.de\/vblog\/#\/schema\/person\/892d6b96c66b1dd4b75c6e32fdbfea82"},"breadcrumb":{"@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/thomas-kopton.de\/vblog\/?p=157"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#primaryimage","url":"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png","contentUrl":"https:\/\/thomas-kopton.de\/vblog\/wp-content\/uploads\/2019\/12\/Picture-7.png","width":1602,"height":393},{"@type":"BreadcrumbList","@id":"https:\/\/thomas-kopton.de\/vblog\/?p=157#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/thomas-kopton.de\/vblog"},{"@type":"ListItem","position":2,"name":"Maintenance Mode for vRealize Operations Objects, Part 1"}]},{"@type":"WebSite","@id":"https:\/\/thomas-kopton.de\/vblog\/#website","url":"https:\/\/thomas-kopton.de\/vblog\/","name":"TOMsOps","description":"Just another VMware Cloud Management Blog","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/thomas-kopton.de\/vblog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/thomas-kopton.de\/vblog\/#\/schema\/person\/892d6b96c66b1dd4b75c6e32fdbfea82","name":"Thomas Kopton","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e746aafbd3733172ceb4d600ba1feda61bc87cd3b70f5a9dfb581907cc7973b1?s=96&d=mm&r=g","caption":"Thomas Kopton"},"url":"https:\/\/thomas-kopton.de\/vblog\/?author=1"}]}},"_links":{"self":[{"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/posts\/157","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=157"}],"version-history":[{"count":17,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/posts\/157\/revisions"}],"predecessor-version":[{"id":189,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/posts\/157\/revisions\/189"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=\/wp\/v2\/media\/178"}],"wp:attachment":[{"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=157"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=157"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/thomas-kopton.de\/vblog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=157"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}