{"_id":"56fad8ae283ee90e004acaba","user":"55c50f4a7c199a2f00665cbf","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"},"parentDoc":null,"project":"55c505b41469ad2500fa2ab7","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"},"__v":33,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-29T19:34:06.166Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"**How it works : **\n1. You add your Logentries account key in the integration page in Neptune.\n2. Neptune automatically adds a Neptune endpoint as webhook to all your Logentries alerts. If the account key has read-only permissions, you might have to do this manually.\n3. Create rules in Neptune to automate all Logentries alerts.\n\n**Benefits :** Once integrated, Neptune can understand your Logentries alerts with deeper knowledge about type of alert, log source, host, Dyno name if it is a Heroku app, etc. You can then automate all your Logentries alerts with one click. For e.g :\n\n* Restart Heroku dyno (only) whenever it sees \"Memory quota exceeded\" errors. Very common on Heroku.\n* Restart Heroku app in response to any Heroku platform errors.\n* Scale up/down your #dynos based on some log patterns.\n* Scale up/down Sidekiq workers based on log patterns.\n\n## Step 1: Go to your integrations page to get started with Logentries integration.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Ot5IKqWQCjGj3buSkMqg_Screen%20Shot%202016-03-29%20at%2012.36.35%20PM.png\",\n        \"Screen Shot 2016-03-29 at 12.36.35 PM.png\",\n        \"1905\",\n        \"954\",\n        \"#740946\",\n        \"\"\n      ],\n      \"caption\": \"Logentries Integration\"\n    }\n  ]\n}\n[/block]\n## Step 2: Get Logentries account key from Papertrail app settings\nIn your Logentries, go to (1) Account --> (2) Profile --> (3) Click show Account key and then add the key in the form above.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1EUxGqoMTBiC57dKlJQk_logentriesAPIToken.png\",\n        \"logentriesAPIToken.png\",\n        \"1194\",\n        \"695\",\n        \"#67a766\",\n        \"\"\n      ],\n      \"caption\": \"Get Logentries account key\"\n    }\n  ]\n}\n[/block]\n## Step 3: Add the Logentries account key in Neptune integration page of Step#1\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dgh8XPN8RAqlXswDro9c_Screen%20Shot%202016-03-29%20at%2012.39.40%20PM.png\",\n        \"Screen Shot 2016-03-29 at 12.39.40 PM.png\",\n        \"1903\",\n        \"315\",\n        \"#3d0525\",\n        \"\"\n      ],\n      \"caption\": \"Add Logentries account key\"\n    }\n  ]\n}\n[/block]\nLeave the \"send alerts to Neptune\" checkbox setting with \"Yes\" if your account key has write permissions so that Neptune would add a webhook to all your Logentries alerts programmatically so that we start receiving all your Logentries alerts immediately.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If your Logentries account key has write permissions, you do not need to do the below steps.\",\n  \"title\": \"Info\"\n}\n[/block]\n## Step 4: Add Neptune endpoint as a webhook in Logentries alerts (only required if account is read-only)\n\n  * Use the Neptune endpoint URL specified in the integration page (It contains a unique URL with your Neptune API key)\n  * In your Logentries account, go to (1) Tags & Alerts --> (2) Edit the alert --> (3) Select \"Other options\" in \"Add An Alert\" section (4) Select webhook and add the above URL in provided text box.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/xJHcA1xOSQKZZw0MPLBL_Screen%20Shot%202016-03-29%20at%2012.44.11%20PM.png\",\n        \"Screen Shot 2016-03-29 at 12.44.11 PM.png\",\n        \"1914\",\n        \"875\",\n        \"#ed4b24\",\n        \"\"\n      ],\n      \"caption\": \"Add Neptune webhook in Logentries alert\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/oK7bbNEyQJmoV9qOW3xM_Screen%20Shot%202016-03-29%20at%2012.44.52%20PM.png\",\n        \"Screen Shot 2016-03-29 at 12.44.52 PM.png\",\n        \"1920\",\n        \"895\",\n        \"#c44c38\",\n        \"\"\n      ],\n      \"caption\": \"Add Neptune webhook in Logentries alert\"\n    }\n  ]\n}\n[/block]\n * Repeat the above steps for all your Logentries alerts.\n\nAll Done ! Now you can start creating rules in Neptune for your alerts from Logentries.","excerpt":"","slug":"logentries","type":"basic","title":"Logentries"}
**How it works : ** 1. You add your Logentries account key in the integration page in Neptune. 2. Neptune automatically adds a Neptune endpoint as webhook to all your Logentries alerts. If the account key has read-only permissions, you might have to do this manually. 3. Create rules in Neptune to automate all Logentries alerts. **Benefits :** Once integrated, Neptune can understand your Logentries alerts with deeper knowledge about type of alert, log source, host, Dyno name if it is a Heroku app, etc. You can then automate all your Logentries alerts with one click. For e.g : * Restart Heroku dyno (only) whenever it sees "Memory quota exceeded" errors. Very common on Heroku. * Restart Heroku app in response to any Heroku platform errors. * Scale up/down your #dynos based on some log patterns. * Scale up/down Sidekiq workers based on log patterns. ## Step 1: Go to your integrations page to get started with Logentries integration. [block:image] { "images": [ { "image": [ "https://files.readme.io/Ot5IKqWQCjGj3buSkMqg_Screen%20Shot%202016-03-29%20at%2012.36.35%20PM.png", "Screen Shot 2016-03-29 at 12.36.35 PM.png", "1905", "954", "#740946", "" ], "caption": "Logentries Integration" } ] } [/block] ## Step 2: Get Logentries account key from Papertrail app settings In your Logentries, go to (1) Account --> (2) Profile --> (3) Click show Account key and then add the key in the form above. [block:image] { "images": [ { "image": [ "https://files.readme.io/1EUxGqoMTBiC57dKlJQk_logentriesAPIToken.png", "logentriesAPIToken.png", "1194", "695", "#67a766", "" ], "caption": "Get Logentries account key" } ] } [/block] ## Step 3: Add the Logentries account key in Neptune integration page of Step#1 [block:image] { "images": [ { "image": [ "https://files.readme.io/dgh8XPN8RAqlXswDro9c_Screen%20Shot%202016-03-29%20at%2012.39.40%20PM.png", "Screen Shot 2016-03-29 at 12.39.40 PM.png", "1903", "315", "#3d0525", "" ], "caption": "Add Logentries account key" } ] } [/block] Leave the "send alerts to Neptune" checkbox setting with "Yes" if your account key has write permissions so that Neptune would add a webhook to all your Logentries alerts programmatically so that we start receiving all your Logentries alerts immediately. [block:callout] { "type": "info", "body": "If your Logentries account key has write permissions, you do not need to do the below steps.", "title": "Info" } [/block] ## Step 4: Add Neptune endpoint as a webhook in Logentries alerts (only required if account is read-only) * Use the Neptune endpoint URL specified in the integration page (It contains a unique URL with your Neptune API key) * In your Logentries account, go to (1) Tags & Alerts --> (2) Edit the alert --> (3) Select "Other options" in "Add An Alert" section (4) Select webhook and add the above URL in provided text box. [block:image] { "images": [ { "image": [ "https://files.readme.io/xJHcA1xOSQKZZw0MPLBL_Screen%20Shot%202016-03-29%20at%2012.44.11%20PM.png", "Screen Shot 2016-03-29 at 12.44.11 PM.png", "1914", "875", "#ed4b24", "" ], "caption": "Add Neptune webhook in Logentries alert" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/oK7bbNEyQJmoV9qOW3xM_Screen%20Shot%202016-03-29%20at%2012.44.52%20PM.png", "Screen Shot 2016-03-29 at 12.44.52 PM.png", "1920", "895", "#c44c38", "" ], "caption": "Add Neptune webhook in Logentries alert" } ] } [/block] * Repeat the above steps for all your Logentries alerts. All Done ! Now you can start creating rules in Neptune for your alerts from Logentries.