{"id":20215162,"url":"https://github.com/root-gg/wigo","last_synced_at":"2025-04-10T14:10:48.976Z","repository":{"id":58110671,"uuid":"49214764","full_name":"root-gg/wigo","owner":"root-gg","description":"Wigo, aka \"What Is Going On\" is a light pull/push monitoring tool written in Golang.","archived":false,"fork":false,"pushed_at":"2023-08-08T20:37:46.000Z","size":9930,"stargazers_count":42,"open_issues_count":0,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-24T12:55:32.067Z","etag":null,"topics":["golang","light","monitoring","monitoring-server","monitoring-tool","probe"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/root-gg.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-07T16:04:00.000Z","updated_at":"2024-11-16T10:52:00.000Z","dependencies_parsed_at":"2024-06-19T00:05:49.809Z","dependency_job_id":"edb3efe0-42cf-4b79-8655-91ff40f8eb2b","html_url":"https://github.com/root-gg/wigo","commit_stats":{"total_commits":618,"total_committers":10,"mean_commits":61.8,"dds":0.4110032362459547,"last_synced_commit":"f3e2439a7574e7a36e965c0cd5551a0d043358fe"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-gg%2Fwigo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-gg%2Fwigo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-gg%2Fwigo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/root-gg%2Fwigo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/root-gg","download_url":"https://codeload.github.com/root-gg/wigo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248232400,"owners_count":21069487,"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":["golang","light","monitoring","monitoring-server","monitoring-tool","probe"],"created_at":"2024-11-14T06:20:10.394Z","updated_at":"2025-04-10T14:10:48.954Z","avatar_url":"https://github.com/root-gg.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Wigo\n=========\n\nWigo, aka \"What Is Going On\" is a light pull/push monitoring tool written in Golang.\n\nMain features\n  - Write probes in any language you want\n  - Notifications when a probe status change (http,email)\n  - Proxy mode for hosts behind NAT/Gateways\n  - Graphing probes metrics to OpenTSDB instances\n\n[Install Wigo Monitoring from Chrome Web Store](https://chrome.google.com/webstore/detail/wigo-monitoring/eaoeankffafdpnhgnamdlifgaknjdcog)\n\n#### Screenshots:\n\n##### Web UI Main view:\n![Main view](https://user-images.githubusercontent.com/666182/98400230-f9384e00-2063-11eb-9f82-01138f87942d.png)\n\n##### Web UI Group view:\n![Group view](https://user-images.githubusercontent.com/666182/98400233-fa697b00-2063-11eb-955a-e9f165a90bef.png)\n\n##### Web UI Host view:\n![Host view](https://user-images.githubusercontent.com/666182/98400236-fb021180-2063-11eb-8605-9dd65d26f7ac.png)\n\n\n### Installation\n\n\u003e Warning : Breaking change since version 0.73.19 :\n\u003e A change in the wigo push protocol can cause crashes if your wigo push server version is \u003c 0.73.22.\n\u003e You should update both wigo push clients and server to (at least) 0.73.22.\n\n##### Debian :\nDeb packages are available for Debian 9, 10 and 11\n```sh\napt-get install lsb-release\nwget -O- http://deb.carsso.com/deb.carsso.com.key | apt-key add -\necho \"deb http://deb.carsso.com $(lsb_release --codename --short) main\" \u003e /etc/apt/sources.list.d/deb.carsso.com.list\napt-get update\napt-get install wigo\n```\n_Debian 7 \u0026 8 packages are not available anymore, it's time to upgrade :)_\n\n##### Centos :\n_Centos packages are not available anymore, but you can build them by yourself_\n\n### Configuration / Setup\n\n- Wigo configuration is in `/etc/wigo/wigo.conf`\n- Probes configurations are in `/etc/wigo/conf.d/`\n\n##### PULL\nThe master fetch remote clients over the http api.\nCommunications should be secured using firewall rules, TLS and http basic authentication.\n\n##### PUSH\nClients send their data to a remote master over a persistent tcp connection.\nCommunications should be secured using firewall rules and TLS.\n\n##### TLS\nWigo needs a key pair to enable HTTPS api.\nYou can generate a self signed key pair by running this command:\n```\n/usr/local/wigo/bin/generate_cert -ca=false -duration=87600h0m0s -host \"hostnames,ips,...\" --rsa-bits=4096\n```\n\nWigo needs a CA key pair to secure PUSH communications.\nYou can generate a CA self signed key pair by running this command on the push server :\n```\n/usr/local/wigo/bin/generate_cert -ca=true -duration=87600h0m0s -host \"hostnames,ips,...\" --rsa-bits=4096\n```\n\n\n##### Default probes \n\nThe directory name is the interval of check in seconds\n\n```sh\n/usr/local/wigo/probes\n├── 120\n├── 300\n│   ├── apt-security -\u003e ../../probes-examples/apt-security\n│   └── smart -\u003e ../../probes-examples/smart\n└── 60\n    ├── check_mdadm -\u003e ../../probes-examples/check_mdadm\n    ├── check_processes\n    ├── hardware_disks -\u003e ../../probes-examples/hardware_disks\n    ├── hardware_load_average -\u003e ../../probes-examples/hardware_load_average\n    ├── hardware_memory -\u003e ../../probes-examples/hardware_memory\n    ├── ifstat -\u003e ../../probes-examples/ifstat\n    ├── supervisord\n    └── needrestart\n\n```\n\n### Building from sources\n\n##### Environment\nTo build from sources, you need `golang` and `gcc` installed.\nThe `$GOPATH` environment variable should also be set on your system.\n\n##### Dependencies\n```sh\nmake deps\n```\n\n##### Building for your system\n```sh\nmake clean release\n```\n\n##### Building for all supported archs (amd64 \u0026 armhf)\nYou will need `arm-linux-gnueabihf-gcc`\n```sh\nmake clean releases\n```\n\n##### Build debian packages\nYou will need `reprepro`\n```sh\nmake debs\n```\n\n##### Build rpm packages\nYou will need rpm-building tools\n```sh\ncd build/rpm/\n./makePackege.sh\n```\n\n### Usage\n\n##### Wigo web interface\n\n`http://[your-ip]:4000/` (by default)\n\n\n##### Wigo CLI\n\n```sh\n# wigocli\nWigo v0.51.5 running on backbone.root.gg \nLocal Status    : 100\nGlobal Status   : 250\n\nRemote Wigos : \n\n    1.2.3.4:4000 ( ns2 ) - Wigo v0.51.5: \n        apt-security              : 100  No security packages availables\n        hardware_disks            : 250  Highest occupation percentage is 93% in partition /dev/md0\n        hardware_load_average     : 100  0.09 0.04 0.05\n        hardware_memory           : 100  Current memory usage is 19.32%\n        ifstat                    : 100  tap0 0.00/0.01 mbps , eth1 0.00/0.00 mbps , eth0 0.01/0.01 mbps , \n        smart                     : 100  /dev/sdc : PASSED /dev/sdb : PASSED \n\n```\n\n\n##### Write your own probes !\n\nProbes are binaries, written in any language you want, that output a json string with at least Status param :\n```sh\n\n$ ./hardware_load_average\n{\n   \"Detail\" : \"\",\n   \"Version\" : \"0.11\",\n   \"Message\" : \"0.38 0.26 0.24\",\n   \"Status\" : 100,\n   \"Metrics\" : [\n      {\n         \"Value\" : 0.38,\n         \"Tags\" : {\n            \"load\" : \"load5\"\n         }\n      },\n      {\n         \"Value\" : 0.26,\n         \"Tags\" : {\n            \"load\" : \"load10\"\n         }\n      },\n      {\n         \"Value\" : 0.24,\n         \"Tags\" : {\n            \"load\" : \"load15\"\n         }\n      }\n   ]\n}\n```\n\n##### Status codes :\n```\n    100         OK\n    101 to 199  INFO\n    200 to 299  WARN\n    300 to 499  CRIT\n    500+        ERROR\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froot-gg%2Fwigo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froot-gg%2Fwigo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froot-gg%2Fwigo/lists"}