[{"_1":2,"_180":-5,"_181":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_159":160},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":89,"_112":113,"_150":-5,"_151":11,"_152":21,"_153":11,"_154":-5,"_155":11,"_156":-5,"_157":158},"canonicalUrl","https://hub.docker.com/r/polyverse/hermes/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","polyverse","reponame","hermes","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":62,"_64":65,"_66":-5,"_67":68,"_69":70,"_71":11,"_72":33,"_73":74,"_79":21,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2018-02-01T21:53:16.643167Z","description","Hermes Standalone aggregator/collector","is_private","last_updated","2018-03-08T18:07:58.351267Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",223,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","# Hermes\n\nHermes is a Status collecting, publishing, and reporting framework in complex supervision trees, especially those created by massive microservice deployments.\n\nThe main challenge with monitoring fan-out services (services that start other services) is fundamentally the need for external infrastructure. You must either have a log sink or a metrics sink set up previously. You must then connect your \"supervisor\" (the service launching other services) to this sink to read status of what's going on. Alternatively, you could reach out to the fabric on which you launch those services (such as Kubernetes), in which case the best visibility you can expect is \"Running\", \"Stopped\", or \"Not running.\"\n\nThis leads to a lot of side-channel coding and cumbersome workarounds. They lead to vendor-locking, but more so, they lead to infra-lockin! Infra-lockin is when you have to set pre-determined endpoints for your AWS CloudWatch region and so on and so forth. When running on localhost, you have to use other tricks. It's just a nightmare.\n\nHermes was inspired by Prometheus's simplicit of scrapable endpoints exposing metrics. Hermes exposes state of a system in a similar fashion.\n\nThis means when you instrument a component, it exposes it's Hermes status directly which you can query. If it is executed by a parent, the parent is able to receive updates from the child (and others) seamlessly exposing a consolidated status of the tree below it. If the parent is ever executed under a larger parent, that parent seamlessly gains access to the status tree.\n\nFor reactive components that are monitoring, changing, adapting, this ability does away with the need to go poll logs from children, or to do creative querying, etc. View the complete state of your system from your supervisor.\n\n## Getting Started\n\n### Monitoring a Hermes component\n\n#### Plain Text\nFor any Hermes-instrumented component, run:\n\n

\ncurl http://localhost:9091\n\nstatus: pending\nchild1/status: launching\nchild1/message: Starting logger...\n

\n\n#### JSON\n\nJSON-formatted output provides a bit more metadata, such as a key's creation time, along with its age and prescribed TTL. All durations are in seconds, and all consumers must support floating point numbers. They are not required to honor more than the integer part (this rounding UP to the nearst second), but they *MUST NOT* fail when they encounter a decimal.\n\n

\ncurl http://localhost:9091?type=json\n{\n  \"status\": {\n    \"age\": 12,\n    \"ttl\": 15,\n    \"value\": \"pending\"\n    },\n  \"child1/status\": {\n    \"age\": 1,\n    \"ttl\": 30,\n    \"value\": \"launching\"\n  },\n  \"child1/message\": {\n    \"age\": 5,\n    \"ttl\": 10,\n    \"value\": \"Starting logger...\"\n  }\n}\n

\n\n### Instrumenting with Hermes\n\nAll client bindings are only supported for Golang at the moment. We welcome contributions for bindings to other languages/platforms/frameworks.\n\n#### Exposing Status\n\nAll Hermes components are required to expose direct status in a scrapable endpoint. Much like Prometheus, if pushing of status updates is required, this may be done using external/additional processes.\n\n

\n\npackage main\n\nimport (\n\t\"flag\"\n\t\"log\"\n\t\"net/http\"\n\n\thermes \"github.com/polyverse/hermes\"\n)\n\nvar addr = flag.String(\"hermes-address\", \":9091\", \"The address to listen on for Hermes HTTP requests.\")\n\nfunc main() {\n\tflag.Parse()\n\thttp.Handle(\"/status\", hermes.GetHandler())\n\tlog.Fatal(http.ListenAndServe(*addr, nil))\n}\n

\n\n#### Reporting status\n\n

\n\npackage runner\n\nimport (\n\thermes \"github.com/polyverse/hermes\"\n)\n\nfunc run() {\n  hermes.ReportStatus(\n    \"runner.status\", // Key\n    \"running\")  // Value\n}\n

\n\n# Purpose, Design, and implementation\n\n## \"Status\" as a Fundamental Monitoring Channel for Reactive Applications\n\nStatus is the current \"state\" of a system with ZERO KNOWLEDGE of *WHY* the system is in that state, *HOW* it got there, or *WHAT* can make it change.\n\nStatus is a machine and human-understandable representation of the state a system/component is at any given time, for the intent and purpose of reacting to it. Traditional applications have two main channels for monitoring their state - logging, and some kind of aggregate metrics. However, when writing controllers or supervisors that operate on those applications, these controllers need to live outside the fabric of the apps, and must be connected through elaborate and complex channels to the logs/metrics destination. This means that supervision trees are difficult to set up.\n\nHermes provides an infrastructure-neutral status reporting channel, and more so, a consistent standard to do it. This means that when you write controllers or supervisors to launch more components (such as workers, nodes, etc.), those controllers can use Hermes to consistently monitor the state of those workers, and the controllers' controllers can monitor the tree.\n\n## Data Scheme\n\nThe data obtained from each component is an aggregation of the status keys of itself, along with the collection of status keys obtained from its children, forming a tree.\n\nAs an observer, you are required only to ask the supervisor, and you should get the complete state of the tree that supervisor is supervising - either directly, or through proxy supervisors running as its children. All keys may have additional metadata such as *ttl* (time to live).\n\n### Proc Keys\nAll State is stored as Key-Value pairs of strings. Each key must meet the following contract:\n1. It must not begin or end with a \".\"\n2. It may contain any letters (upper or lowercase), digits, underscore (\\_) and dot (\\.)\n3. The regex for it is:

^[\\w][\\w\\.]*[\\w]$

\n\nIt is suggested that dots (.) be used to separate subsystems or namespaces within a process.\n\n*Examples:*\n

\nstatus: \"launching\"\nmessage: \"Starting logger...\"\n

\n\n### Child keys\n\nThe special separator slash (/) is used to indicate a child process's namespace.\n\n*Examples:*\n

\nstatus: \"pending\"\ncomponent1/status: \"launching\"\ncomponent1/message: \"Starting logger...\"\n

\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",7322921,"orgData",{"_90":91,"_92":93,"_94":95,"_96":33,"_97":98,"_99":100,"_101":98,"_102":103,"_104":105,"_106":107,"_108":109,"_110":109,"_111":21},"id","558941489f054436977680ef5a8e3bcf","uuid","55894148-9f05-4436-9776-80ef5a8e3bcf","type","organization","orgname","full_name","Polyverse Corporation","location","Seattle","company","profile_url","https://polyverse.io","date_joined","2015-03-09T18:28:00.560385Z","gravatar_url","https://www.gravatar.com/avatar/3492903a696309c732a74a1142704377?s=80&r=g&d=mm","gravatar_email","","badge","is_active","recentTags",[114],{"_115":44,"_116":117,"_118":119,"_90":120,"_121":122,"_50":139,"_140":117,"_141":33,"_142":56,"_57":143,"_144":145,"_146":130,"_147":139,"_148":65,"_149":21},"content_type","creator",239739,"full_size",2594748,21632721,"images",[123],{"_124":125,"_126":127,"_128":109,"_129":130,"_131":132,"_133":134,"_135":109,"_136":-5,"_137":119,"_63":65,"_138":-5},"architecture","amd64","digest","sha256:35fe3f52eddf40d8db4f77a51734055a40aa475cb6ab2b4d9298a6dc75c2ba44","features","last_pulled","2026-09-28T04:38:28.58487969Z","last_pushed","2018-03-08T18:07:58Z","os","linux","os_features","os_version","size","variant","2018-03-08T18:07:57.987842Z","last_updater","last_updater_username","media_type","latest","repository",3762570,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_38":161,"_168":169,"_157":178,"_179":11},{"_40":162,"_42":163,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":164,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":62,"_64":65,"_66":-5,"_67":68,"_69":70,"_71":11,"_72":33,"_73":165,"_79":21,"_80":167,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":166},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_170":62,"_171":-5,"_172":-5,"_173":174},"count","next","previous","results",[175],{"_115":44,"_116":117,"_118":119,"_90":120,"_121":176,"_50":139,"_140":117,"_141":33,"_142":56,"_57":143,"_144":145,"_146":130,"_147":139,"_148":65,"_149":21},[177],{"_124":125,"_126":127,"_128":109,"_129":130,"_131":132,"_133":134,"_135":109,"_136":-5,"_137":119,"_63":65,"_138":-5},[],"canDeleteTags","actionData","errors"]

polyverse/hermes

Tags for polyverse/hermes