{"_id":"56fb2fe61753a50e00d15541","__v":25,"project":"55c505b41469ad2500fa2ab7","category":{"_id":"56fac9925df15a20002972a2","version":"55d3b644f77e6d0d00b1b273","project":"55c505b41469ad2500fa2ab7","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-29T18:29:38.389Z","from_sync":false,"order":10,"slug":"logging-tool-integrations","title":"Logging Tool Integrations"},"user":"55c50f4a7c199a2f00665cbf","version":{"_id":"55d3b644f77e6d0d00b1b273","project":"55c505b41469ad2500fa2ab7","__v":6,"createdAt":"2015-08-18T22:48:36.632Z","releaseDate":"2015-08-18T22:48:36.632Z","categories":["55d3b645f77e6d0d00b1b274","55d3b645f77e6d0d00b1b275","55d3b645f77e6d0d00b1b276","55d3b645f77e6d0d00b1b277","55d3b645f77e6d0d00b1b278","55d3b645f77e6d0d00b1b279","55d3b645f77e6d0d00b1b27a","55d3b645f77e6d0d00b1b27b","55d3b645f77e6d0d00b1b27c","55d3b645f77e6d0d00b1b27d","55d7c2939510f00d007ec6fe","56fac9925df15a20002972a2","56fb2f7668e1d30e00a0b672","583498d411e8af2500f6b334","58e52a180ab7b03b00f4a97a"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-30T01:46:14.864Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"This guide will help you integrate your infrastructure with Neptune and install Neptune agents on your servers so that you can run runbooks whenever alerts are triggered.\n\n## Step 1 : Select integrations tab and then click \"Infrastructure integration\" section.\n\n * If you are on Heroku, DigitalOcean or SoftLayer and all you want to run is CLI commands, you do not need to install any agents. You can add the API key to the corresponding cloud and be ready to create rules.\n\n * However, you need to install agents on your servers either if you are not on above mentioned clouds or if you want to run non-cli based runbooks.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/MzzHGw8rRfWPlrvOH9bO_infra.png\",\n        \"infra.png\",\n        \"1919\",\n        \"958\",\n        \"#780c45\",\n        \"\"\n      ],\n      \"caption\": \"Infrastructure Integration\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"For Heroku, SoftLayer and DigitalOcean users\",\n  \"body\": \"If all you want to run is CLI commands, you do not need to follow below steps.\"\n}\n[/block]\n## Step 2 : Install Neptune agent on your servers\n\n* Run the one-liner agent installation command on your server as root.\n* However, for better security, Neptune agent never runs as root. It runs as 'neptune' user\n* To install agent as a different user, please change the `AGENT_USER` variable in the one-line command.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/MNBHHBN9TKGRfyM7rm1s_Install_Agent.png\",\n        \"Install_Agent.png\",\n        \"1633\",\n        \"925\",\n        \"#4e90f4\",\n        \"\"\n      ],\n      \"caption\": \"Neptune Agent installation\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"We also have chef , puppet recipies to install agents on several servers at once\",\n  \"body\": \"For more details on chef, puppet, windows and administration of agent, please refer to  [Agent installation guide](doc:agent-installation) and [Agent administration](doc:administration) sections\"\n}\n[/block]\n## Step 3 : Check if agents are correctly running on your servers\n\nClick Agent status tab in your left sidebar to see all the servers with neptuneio agents running. If you don't see any servers listed,  or if you find any errors in the logs, please contact Neptuneio support team by clicking chat window in the lower right corner, or email <support:::at:::neptune.io>\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/wOsPAYraQH2IoQCHuNc4_agentStatus.png\",\n        \"agentStatus.png\",\n        \"1631\",\n        \"887\",\n        \"#770743\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"infrastructure-integration","type":"basic","title":"Infrastructure Integration"}

Infrastructure Integration


This guide will help you integrate your infrastructure with Neptune and install Neptune agents on your servers so that you can run runbooks whenever alerts are triggered. ## Step 1 : Select integrations tab and then click "Infrastructure integration" section. * If you are on Heroku, DigitalOcean or SoftLayer and all you want to run is CLI commands, you do not need to install any agents. You can add the API key to the corresponding cloud and be ready to create rules. * However, you need to install agents on your servers either if you are not on above mentioned clouds or if you want to run non-cli based runbooks. [block:image] { "images": [ { "image": [ "https://files.readme.io/MzzHGw8rRfWPlrvOH9bO_infra.png", "infra.png", "1919", "958", "#780c45", "" ], "caption": "Infrastructure Integration" } ] } [/block] [block:callout] { "type": "info", "title": "For Heroku, SoftLayer and DigitalOcean users", "body": "If all you want to run is CLI commands, you do not need to follow below steps." } [/block] ## Step 2 : Install Neptune agent on your servers * Run the one-liner agent installation command on your server as root. * However, for better security, Neptune agent never runs as root. It runs as 'neptune' user * To install agent as a different user, please change the `AGENT_USER` variable in the one-line command. [block:image] { "images": [ { "image": [ "https://files.readme.io/MNBHHBN9TKGRfyM7rm1s_Install_Agent.png", "Install_Agent.png", "1633", "925", "#4e90f4", "" ], "caption": "Neptune Agent installation" } ] } [/block] [block:callout] { "type": "info", "title": "We also have chef , puppet recipies to install agents on several servers at once", "body": "For more details on chef, puppet, windows and administration of agent, please refer to [Agent installation guide](doc:agent-installation) and [Agent administration](doc:administration) sections" } [/block] ## Step 3 : Check if agents are correctly running on your servers Click Agent status tab in your left sidebar to see all the servers with neptuneio agents running. If you don't see any servers listed, or if you find any errors in the logs, please contact Neptuneio support team by clicking chat window in the lower right corner, or email <support@neptune.io> [block:image] { "images": [ { "image": [ "https://files.readme.io/wOsPAYraQH2IoQCHuNc4_agentStatus.png", "agentStatus.png", "1631", "887", "#770743", "" ] } ] } [/block]