{"_id":"57fcc4870312b20e00ac64e7","user":"547d27d12eaee50800ed1157","project":"5435687035740020002a1c04","parentDoc":null,"__v":0,"version":{"_id":"57fcc4860312b20e00ac64c0","project":"5435687035740020002a1c04","__v":1,"createdAt":"2016-10-11T10:52:54.637Z","releaseDate":"2016-10-11T10:52:54.637Z","categories":["57fcc4860312b20e00ac64c1","57fcc4860312b20e00ac64c2","57fcc4860312b20e00ac64c3","57fcc4860312b20e00ac64c4","57fcc4860312b20e00ac64c5","57fcc4860312b20e00ac64c6","57fcc4860312b20e00ac64c7","57fcc4860312b20e00ac64c8","57fcc4860312b20e00ac64c9","57fcc4860312b20e00ac64ca","57fcc4860312b20e00ac64cb"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"[APP-1265], [APP-1035]","version_clean":"5.2.0","version":"5.2"},"category":{"_id":"57fcc4860312b20e00ac64c7","__v":0,"version":"57fcc4860312b20e00ac64c0","project":"5435687035740020002a1c04","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-11-25T22:05:12.981Z","from_sync":false,"order":6,"slug":"agent-integration","title":"Data Agent"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-01-29T00:16:25.063Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Downloading The Agent\",\n  \"body\": \"Download the TelemetryTV Agent for Linux, OS X and Windows on our [Github Agent Releases page](https://github.com/telemetryapp/gotelemetry_agent/releases)\"\n}\n[/block]\nSetting up the TelemetryTV Agent is a fairly straightforward process. We distribute binary builds of the Agent for Windows, OS X, and Linux. The binaries are statically linked, and have no external dependencies: You can simply download and execute them right away.\n\n# Hardware Requirements\n\nThe Agent is an extremely lightweight application with very modest system requirements. In most cases, it only needs a few megabytes of RAM, and can accommodate hundreds of concurrent flow updates on a small CPU or virtual machine.\n\nThe only significant requirement is that, for obvious reasons, the Agent must have access to both the Telemetry API and to the data that you intend to access and retrieve. Thus, it is designed to be located inside your firewall, where you have complete control. As long as the Agent can make outgoing connections to https://api.telemetryapp.com on port 433, you should have no problem running it on a completely locked-down machine.\n\n# Compiling From Source\n\nWhile we suggest using the pre-compiled binaries, you can also compile your own copy of the Agent directly from the source. Simply check out the [project from Github](https://github.com/telemetryapp/gotelemetry_agent), and compile against a recent version of Go (1.5 or higher):\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"# go get -u\\n# go build  # Build for your current platform. Use goxc to cross-compile.\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"agent-setup","type":"basic","title":"Installation"}
[block:callout] { "type": "info", "title": "Downloading The Agent", "body": "Download the TelemetryTV Agent for Linux, OS X and Windows on our [Github Agent Releases page](https://github.com/telemetryapp/gotelemetry_agent/releases)" } [/block] Setting up the TelemetryTV Agent is a fairly straightforward process. We distribute binary builds of the Agent for Windows, OS X, and Linux. The binaries are statically linked, and have no external dependencies: You can simply download and execute them right away. # Hardware Requirements The Agent is an extremely lightweight application with very modest system requirements. In most cases, it only needs a few megabytes of RAM, and can accommodate hundreds of concurrent flow updates on a small CPU or virtual machine. The only significant requirement is that, for obvious reasons, the Agent must have access to both the Telemetry API and to the data that you intend to access and retrieve. Thus, it is designed to be located inside your firewall, where you have complete control. As long as the Agent can make outgoing connections to https://api.telemetryapp.com on port 433, you should have no problem running it on a completely locked-down machine. # Compiling From Source While we suggest using the pre-compiled binaries, you can also compile your own copy of the Agent directly from the source. Simply check out the [project from Github](https://github.com/telemetryapp/gotelemetry_agent), and compile against a recent version of Go (1.5 or higher): [block:code] { "codes": [ { "code": "# go get -u\n# go build # Build for your current platform. Use goxc to cross-compile.", "language": "shell" } ] } [/block]