{"id":13526732,"url":"https://github.com/digitalocean/do-agent","last_synced_at":"2025-12-18T01:20:22.927Z","repository":{"id":37580323,"uuid":"70849987","full_name":"digitalocean/do-agent","owner":"digitalocean","description":"Collects system metrics from DigitalOcean Droplets","archived":false,"fork":false,"pushed_at":"2025-03-26T17:58:39.000Z","size":6724,"stargazers_count":603,"open_issues_count":15,"forks_count":102,"subscribers_count":80,"default_branch":"master","last_synced_at":"2025-06-08T06:08:52.859Z","etag":null,"topics":["agent","digitalocean","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalocean.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-13T21:33:12.000Z","updated_at":"2025-05-25T05:36:25.000Z","dependencies_parsed_at":"2024-02-01T20:31:14.334Z","dependency_job_id":"62c7eb53-3a15-4652-b979-94e7a88aaa5a","html_url":"https://github.com/digitalocean/do-agent","commit_stats":{"total_commits":232,"total_committers":38,"mean_commits":6.105263157894737,"dds":0.603448275862069,"last_synced_commit":"df9e730ac6c1eb7616ed40a7b622d0316841f900"},"previous_names":[],"tags_count":102,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean%2Fdo-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean%2Fdo-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean%2Fdo-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean%2Fdo-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalocean","download_url":"https://codeload.github.com/digitalocean/do-agent/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean%2Fdo-agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259178519,"owners_count":22817388,"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":["agent","digitalocean","hacktoberfest"],"created_at":"2024-08-01T06:01:33.858Z","updated_at":"2025-12-18T01:20:22.869Z","avatar_url":"https://github.com/digitalocean.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# DigitalOcean Agent\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/digitalocean/do-agent)](https://goreportcard.com/report/github.com/digitalocean/do-agent)\n[![Coverage Status](https://coveralls.io/repos/github/digitalocean/do-agent/badge.svg?branch=master)](https://coveralls.io/github/digitalocean/do-agent?branch=master)\n\n## Overview\ndo-agent enables droplet metrics to be gathered and sent to DigitalOcean to provide resource usage graphs and alerting. \n\nDO Agent currently supports:\n- Ubuntu (oldest [End Of Standard Support](https://wiki.ubuntu.com/Releases) LTS release and later)\n- Debian ([oldest supported](https://wiki.debian.org/LTS) LTS release and later)\n- Fedora 27+\n- CentOS 6+\n- Docker (see below)\n\n# Not officially supported\n- CloudLinux 6+\n\nNote:\n\nAlthough, we only officially support these distros and versions, do-agent works on most Linux distributions. Feel free to run it wherever you are successful, but any issues you encounter will not have official support from DigitalOcean\n\n### Special Note For SELinux Users\n\nThe do-agent install script sets the `nis_enabled` flag to 1. Without this setting the do-agent cannot reach the network to perform authentication or send metrics to DigitalOcean backend servers. If you reverse this action, or install the do-agent on a machine manually you will need to run `setsebool -P nis_enabled 1 \u0026\u0026 systemctl daemon-reexec` otherwise the do-agent will not operate.\n\n## Installation\n\nTo install the do-agent on new Droplets simply select the Monitoring checkbox on the Droplet create screen to get the latest stable version of do-agent. Use your OS package manager (yum/dnf/apt-get) to update and manage do-agent.\n\n## Installing via package managers\n\n```bash\ncurl -sSL https://repos.insights.digitalocean.com/install.sh | sudo bash\n# or wget\nwget -qO- https://repos.insights.digitalocean.com/install.sh | sudo bash\n```\n\nIf you prefer to inspect the script first:\n\n```bash\ncurl -L -o ./install.sh https://repos.insights.digitalocean.com/install.sh\n# inspect the file\nless ./install.sh\n# execute the file\nsudo ./install.sh\n```\n\n## Development\n\n### Requirements\n\n- [go](https://golang.org/dl/) 1.11 or later\n- [GNU Make](https://www.gnu.org/software/make/)\n- Docker\n\n```\ngit clone git@github.com:digitalocean/do-agent.git\ncd do-agent\n\n### build the project\nmake\n\n### add dependencies\n# first make sure you have the appropriate flags set to use go modules\n# We recommend using https://github.com/direnv/direnv to automatically set\n# these from the .envrc file in this project or you can manually set them\nexport GO111MODULE=on GOFLAGS=-mod=vendor\n\n# then add your imports to any go file and run\ngo mod vendor\n```\n\n### Uninstall\n\ndo-agent can be uninstalled with your distribution's package manager\n\n`apt-get remove do-agent` for Debian based distros\n\n`yum remove do-agent` for RHEL based distros\n\n\n### Run as a Docker container\n\nYou can optionally run do-agent as a docker container. In order to do so\nyou need to mount the host directory `/proc` to `/host/proc`.\n\nFor example:\n\n```\ndocker run \\\n        -v /proc:/host/proc:ro \\\n        -v /sys:/host/sys:ro \\\n        digitalocean/do-agent:stable\n```\n\n## Report an Issue\nFeel free to [open an issue](https://github.com/digitalocean/do-agent/issues/new)\nif one does not [already exist](https://github.com/digitalocean/do-agent/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalocean%2Fdo-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalocean%2Fdo-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalocean%2Fdo-agent/lists"}