{"id":1658,"date":"2010-07-29T10:04:07","date_gmt":"2010-07-29T09:04:07","guid":{"rendered":"http:\/\/www.devco.net\/?p=1658"},"modified":"2010-08-07T18:25:27","modified_gmt":"2010-08-07T17:25:27","slug":"making_machine_meta_data_visible","status":"publish","type":"post","link":"https:\/\/www.devco.net\/archives\/2010\/07\/29\/making_machine_meta_data_visible.php","title":{"rendered":"Making machine metadata visible"},"content":{"rendered":"<p>I&#8217;m quite the fan of data, metadata and querying these to interact with my infrastructure rather than interacting by hostnames and wanted to show how far I am down this route.   <\/p>\n<p>This is more an iterative ongoing process than a fully baked idea at this point since the concept of hostnames is so heavily embedded in our Sysadmin culture.  Today I can&#8217;t yet fully break away from it due to tools like nagios etc still relying heavily on the hostname as the index but these are things that will improve in time.<\/p>\n<p>The background is that in the old days we attempted to capture a lot of metadata in hostnames, domain names and so forth.  This was kind of OK since we had static networks with relatively small amounts of hosts.  Today we do ever more complex work on our servers and we have more and more servers.  The advent of cloud computing has also brought with it a whole new pain of unpredictable hostnames, rapidly changing infrastructures a much bigger emphasis on role based computing.<\/p>\n<p>My metadata about my machines comes from 3 main sources:<\/p>\n<ul>\n<li>My Puppet manifests &#8211; classes and modules that gets put on a machine<\/li>\n<li>Facter facts with the ability to add many per machine easily<\/li>\n<li>MCollective stores the meta data in a MongoDB and let me query the network in real time<\/li>\n<\/ul>\n<h2>Puppet manifests based on query<\/h2>\n<p>When setting up machines I keep some data like database master hostnames in extlookup but in many cases I am now moving to a search based approach to finding resources.  Here&#8217;s a sample manifest that will find the master database for a customers development machines:<\/p>\n<p><code><\/p>\n<pre lang=\"puppet\">\r\n$masterdb = search_nodes(\"{'facts.customer': '${customer}', 'facts.environment':${environment}, classes: 'mysql::master'}\")\r\n<\/pre>\n<p><\/code><\/p>\n<p>This is MongoDB query against my infrastructure database, it will find for a given node the name of a node that has the class <em>mysql::master<\/em> on it, by convention there should be only one per customer in my case.  When using it in a template I can get back full objects with all the meta data for a node.  Hopefully with Puppet 2.6 I can get full hashes into puppet too!<\/p>\n<h2>Making Metadata Visible<\/h2>\n<p>With machines doing a lot of work, filling a lot of roles etc and with more and more machines you need to be able to tell immediately what machine you are on.<\/p>\n<p>I do this in several places, first my MOTD can look something like this:<\/p>\n<p><code><\/p>\n<pre lang=\"text\">\r\n   Welcome to Synchronize Your Dogmas \r\n            hosted at Hetzner, Germany\r\n\r\n        Puppet Modules:\r\n                - apache\r\n                - iptables\r\n                - mcollective member\r\n                - xen dom0 skeleton\r\n                - mw1.xxx.net virtual machine\r\n<\/pre>\n<p><\/code><\/p>\n<p>I build this up using snippet from my <a href=\"http:\/\/github.com\/ripienaar\/puppet-concat\">concat<\/a> module, each important module like apache can just put something like this in:<\/p>\n<p><code><\/p>\n<pre lang=\"puppet\">\r\nmotd::register{\"Apache Web Server\": }\r\n<\/pre>\n<p><\/code><\/p>\n<p>Being managed by my snippet library, if you just remove the <em>include<\/em> line from the manifests the MOTD will automatically update.<\/p>\n<p>With a big block of welcome done, I now need to also be able to show in my prompts what a machine does, who its for a importantly what environment it is in.<\/p>\n<p><center><img decoding=\"async\" src=\"http:\/\/www.devco.net\/images\/context-prompt.png\"><\/center><\/p>\n<p>Above a shot of 2 prompts in different environments, you see customer name, environment and major modules.  Like with the motd I have a <em>prompt::register<\/em> define that module use to register into the prompt.<\/p>\n<h2>SSH Based on Metadata<\/h2>\n<p>With all this meta data in place, mcollective rolled out and everything integrated it&#8217;s very easy to now find and access machines based on this.<\/p>\n<p>MCollective does real time resource discovery, so keeping with the mysql example above from puppet:<\/p>\n<p><code><\/p>\n<pre>\r\n$ mc-ssh -W \"environment=development customer=acme mysql::master\"\r\nRunning: ssh db1.acme.net\r\nLast login: Thu Jul 29 00:22:58 2010 from xxxx\r\n\r\n$\r\n<\/pre>\n<p><\/code><\/p>\n<p>Here i am ssh&#8217;ing to a server based on a query, if it found more than one machine matching the query a menu would be presented offering me a choice.<\/p>\n<h2>Monitoring Based on Metatdata<\/h2>\n<p>Finally setting up monitoring and keeping it in sync with reality can be a big challenge especially in dynamic cloud based environments, again I deal with this through discovery based on meta data:<\/p>\n<p><code><\/p>\n<pre lang=\"text\">\r\n$ check-mc-nrpe -W \"environment=development customer=acme mysql::master\"  check_load\r\ncheck_load: OK: 1 WARNING: 0 CRITICAL: 0 UNKNOWN: 0|total=1 ok=1 warn=0 crit=0 unknown=0 checktime=0.612054\r\n<\/pre>\n<p><\/code><\/p>\n<h2>Summary<\/h2>\n<p>This is really the tip of the ice berg, there is a lot more that I already do &#8211; like scheduling puppet runs on groups of machines based on metadata &#8211;  but also a lot more to do this really is early days down this route.  I am very keen to get views from others who are struggling with shortcomings in hostname based approaches and how they deal with it.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>I&#8217;m quite the fan of data, metadata and querying these to interact with my infrastructure rather than interacting by hostnames and wanted to show how far I am down this route. This is more an iterative ongoing process than a fully baked idea at this point since the concept of hostnames is so heavily embedded [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","footnotes":""},"categories":[1],"tags":[85,78,21],"_links":{"self":[{"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/posts\/1658"}],"collection":[{"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/comments?post=1658"}],"version-history":[{"count":14,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/posts\/1658\/revisions"}],"predecessor-version":[{"id":1689,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/posts\/1658\/revisions\/1689"}],"wp:attachment":[{"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/media?parent=1658"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/categories?post=1658"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devco.net\/wp-json\/wp\/v2\/tags?post=1658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}