{"id":20338385,"url":"https://github.com/alerta/riemann-alerta","last_synced_at":"2025-04-11T23:11:38.523Z","repository":{"id":11055133,"uuid":"13394475","full_name":"alerta/riemann-alerta","owner":"alerta","description":"Create alerts from riemann metrics","archived":false,"fork":false,"pushed_at":"2018-09-04T15:55:44.000Z","size":865,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-11T23:11:35.178Z","etag":null,"topics":["alerta","clojure","riemann"],"latest_commit_sha":null,"homepage":"http://alerta.io","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alerta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-07T20:11:28.000Z","updated_at":"2018-09-04T15:55:46.000Z","dependencies_parsed_at":"2022-08-28T20:21:06.418Z","dependency_job_id":null,"html_url":"https://github.com/alerta/riemann-alerta","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Friemann-alerta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Friemann-alerta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Friemann-alerta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Friemann-alerta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alerta","download_url":"https://codeload.github.com/alerta/riemann-alerta/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248492877,"owners_count":21113163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alerta","clojure","riemann"],"created_at":"2024-11-14T21:12:58.731Z","updated_at":"2025-04-11T23:11:38.501Z","avatar_url":"https://github.com/alerta.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"Riemann-to-Alerta\n=================\n\nForward Riemann events to Alerta for a consolidated view and improved visualisation.\n\nTransform this ...\n\n![nagios](/docs/images/riemann.png?raw=true)\n\nInto this ...\n\n![alerta](/docs/images/riemann26-alerta-v3.png?raw=true)\n\nInstallation\n------------\n\nTo install Riemann on Debian/Ubuntu...\n\n    $ export VERSION=0.3.1\n    $ sudo apt-get install openjdk-7-jre\n    $ wget -nv https://github.com/riemann/riemann/releases/download/${VERSION}/riemann_${VERSION}_all.deb\n    $ sudo dpkg -i riemann_${VERSION}_all.deb\n\nReplace the default riemann.config file with the example...\n\n    $ sudo mv /etc/riemann/riemann.config{,.bak}\n    $ wget https://raw.github.com/alerta/riemann-alerta/master/riemann.config\n    $ sudo cp riemann.config /etc/riemann/\n\nAdd the alerta clojure library...\n\n    $ wget https://raw.github.com/alerta/riemann-alerta/master/alerta.clj\n    $ sudo cp alerta.clj /etc/riemann/\n\nConfiguration\n-------------\n\nInclude and require the Alerta plugin:\n\n```clojure\n(include \"alerta.clj\")\n(:require '[alerta :refer [alert heartbeat]])\n```\n\nSet the alert and heartbeat endpoints depending on where the alerta API is located:\n\n```clojure\n; Alerta configuration\n(def alert (alerta/alert {:endpoint \"https://alerta-api.herokuapp.com\" :api-key \"demo-key\"}))\n(def heartbeat (alerta/heartbeat {:endpoint \"https://alerta-api.herokuapp.com\" :api-key \"demo-key\"}))\n```\n\nStart Riemann...\n    \n    $ sudo service riemann start\n\n\nTesting\n-------\n\nGenerate some test alerts by generating metrics using `riemann-health`...\n\n    $ sudo apt-get install ruby1.9.1 ruby1.9.1-dev\n    $ sudo gem install riemann-tools\n    $ riemann-health\n\nTroubleshooting\n---------------\n\nTo generate debug output from the HTTP client add `debug` and/or\n`debug-body` to the Alerta configuration definitions as shown:\n\n```clojure\n; Alerta configuration\n(def alert (alerta/alert {:endpoint \"https://alerta-api.herokuapp.com\" :debug true :debug-body true}))\n(def heartbeat (alerta/heartbeat {:endpoint \"https://alerta-api.herokuapp.com\" :debug true :debug-body true}))\n```\n\n**Example Debug output**\n\n```\nHttpRequest:\n{:config nil,\n :method \"POST\",\n :requestLine\n #object[org.apache.http.message.BasicRequestLine 0x1eb6380d \"POST https://alerta-api.herokuapp.com/alert HTTP/1.1\"],\n :aborted false,\n :params\n #object[org.apache.http.params.BasicHttpParams 0x4678323f \"org.apache.http.params.BasicHttpParams@4678323f\"],\n :protocolVersion\n #object[org.apache.http.HttpVersion 0x389a53e1 \"HTTP/1.1\"],\n :URI\n #object[java.net.URI 0xede089 \"https://alerta-api.herokuapp.com/alert\"],\n :class org.apache.http.client.methods.HttpPost,\n :allHeaders\n [#object[org.apache.http.message.BasicHeader 0x42265e51 \"Connection: close\"],\n  #object[org.apache.http.message.BasicHeader 0x11b5e77c \"Authorization: Key demo-key\"],\n  #object[org.apache.http.message.BasicHeader 0x574090ad \"content-type: application/json\"],\n  #object[org.apache.http.message.BasicHeader 0x34bc7ac8 \"accept: application/json\"],\n  #object[org.apache.http.message.BasicHeader 0x675e94f2 \"accept-encoding: gzip, deflate\"]],\n :entity\n #object[org.apache.http.entity.StringEntity 0x59ee0162 \"[Content-Type: text/plain; charset=UTF-8,Content-Length: 471,Chunked: false]\"]}\n```\n\nReferences\n----------\n\n * clj-http - https://github.com/dakrone/clj-http\n\nLicense\n-------\n\nCopyright (c) 2013,2018 Nick Satterly. Available under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falerta%2Friemann-alerta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falerta%2Friemann-alerta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falerta%2Friemann-alerta/lists"}