{"__v":29,"_id":"56fadd187478b90e00b29808","category":{"project":"55c505b41469ad2500fa2ab7","version":"55d3b644f77e6d0d00b1b273","_id":"56fac9925df15a20002972a2","__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","user":"55c50f4a7c199a2f00665cbf","version":{"__v":5,"_id":"55d3b644f77e6d0d00b1b273","project":"55c505b41469ad2500fa2ab7","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"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"updates":["5780258b6a18cd0e00db00de"],"next":{"pages":[],"description":""},"createdAt":"2016-03-29T19:52:56.878Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"**How it works : **\n1. You add your SumoLogic access key pair in the integration page in Neptune\n2. Attach a \"GET_LOGS\" action to any of the Neptune rules to get logs from your SumoLogic account very easily.\n3. Every time the Neptune is triggered, Neptune pulls the logs from SumoLogic and makes them available for you.\n\n**Benefits :** Once integrated, Neptune can query logs for given search patterns from SumoLogic and attach it to any of your Neptune rules. Logs could be very helpful in diagnosing issues faster.\n\n* Grep for the requests causing 5xx errors in response to a high error rate alert.\n* Query all the logs with error information when your API calls are timing out.\n* Get a quick snapshot of API times when application performance is degraded.\n\n## Step 1: Go to your integrations page to get started with SumoLogic integration.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/YGgtj3AuRQ6Sfnwud3N1_Screen%20Shot%202016-03-29%20at%2012.58.13%20PM.png\",\n        \"Screen Shot 2016-03-29 at 12.58.13 PM.png\",\n        \"1917\",\n        \"956\",\n        \"#790844\",\n        \"\"\n      ],\n      \"caption\": \"SumoLogic Integration\"\n    }\n  ]\n}\n[/block]\n## Step 2: Get SumoLogic access key pair\n * Navigate to your SumoLogic account preferences by clicking top right corner of your SumoLogic app \n * Generate new key pair and name it with something like \"NeptuneioUser\" (could be anything though) \n * Copy access id and access key into Neptune integration page. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/NLEJSxzTGGBhja284rXE_SumoLogicKeyPairGenerationSteps.png\",\n        \"SumoLogicKeyPairGenerationSteps.png\",\n        \"1911\",\n        \"947\",\n        \"#11274d\",\n        \"\"\n      ],\n      \"caption\": \"Get SumoLogic access key pair\"\n    }\n  ]\n}\n[/block]\n## Step 3: Add the SumoLogic access keys in Neptune integration page of Step#1\nGet your API URL based on your service URL (please see [SumoLogic wiki](https://github.com/SumoLogic/sumo-api-doc/wiki)) and copy it into above form. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/KKLvYDCmTPSGFQDFRiZf_Screen%20Shot%202016-03-29%20at%201.01.28%20PM.png\",\n        \"Screen Shot 2016-03-29 at 1.01.28 PM.png\",\n        \"1909\",\n        \"285\",\n        \"#254b7b\",\n        \"\"\n      ],\n      \"caption\": \"Add SumoLogic access keys and API endpoint\"\n    }\n  ]\n}\n[/block]\n**That's it! SumoLogic integration is done. Now you can get logs from SumoLogic with steps below.**\n\n## Step 4: Attach an action to get logs from SumoLogic to any of Neptune rules\n\nTo any of your Neptune rules, add a new `GET_LOGS` action with target as SumoLogic. Use existing SumoLogic runbook and tweak it for your purposes.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/SHLlq68R72iqR2dUjobd_Screen%20Shot%202016-03-29%20at%201.03.21%20PM.png\",\n        \"Screen Shot 2016-03-29 at 1.03.21 PM.png\",\n        \"1660\",\n        \"812\",\n        \"#539fae\",\n        \"\"\n      ],\n      \"caption\": \"Getting SumoLogic logs with GET_LOGS action\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"sumologic","type":"basic","title":"SumoLogic"}
**How it works : ** 1. You add your SumoLogic access key pair in the integration page in Neptune 2. Attach a "GET_LOGS" action to any of the Neptune rules to get logs from your SumoLogic account very easily. 3. Every time the Neptune is triggered, Neptune pulls the logs from SumoLogic and makes them available for you. **Benefits :** Once integrated, Neptune can query logs for given search patterns from SumoLogic and attach it to any of your Neptune rules. Logs could be very helpful in diagnosing issues faster. * Grep for the requests causing 5xx errors in response to a high error rate alert. * Query all the logs with error information when your API calls are timing out. * Get a quick snapshot of API times when application performance is degraded. ## Step 1: Go to your integrations page to get started with SumoLogic integration. [block:image] { "images": [ { "image": [ "https://files.readme.io/YGgtj3AuRQ6Sfnwud3N1_Screen%20Shot%202016-03-29%20at%2012.58.13%20PM.png", "Screen Shot 2016-03-29 at 12.58.13 PM.png", "1917", "956", "#790844", "" ], "caption": "SumoLogic Integration" } ] } [/block] ## Step 2: Get SumoLogic access key pair * Navigate to your SumoLogic account preferences by clicking top right corner of your SumoLogic app * Generate new key pair and name it with something like "NeptuneioUser" (could be anything though) * Copy access id and access key into Neptune integration page. [block:image] { "images": [ { "image": [ "https://files.readme.io/NLEJSxzTGGBhja284rXE_SumoLogicKeyPairGenerationSteps.png", "SumoLogicKeyPairGenerationSteps.png", "1911", "947", "#11274d", "" ], "caption": "Get SumoLogic access key pair" } ] } [/block] ## Step 3: Add the SumoLogic access keys in Neptune integration page of Step#1 Get your API URL based on your service URL (please see [SumoLogic wiki](https://github.com/SumoLogic/sumo-api-doc/wiki)) and copy it into above form. [block:image] { "images": [ { "image": [ "https://files.readme.io/KKLvYDCmTPSGFQDFRiZf_Screen%20Shot%202016-03-29%20at%201.01.28%20PM.png", "Screen Shot 2016-03-29 at 1.01.28 PM.png", "1909", "285", "#254b7b", "" ], "caption": "Add SumoLogic access keys and API endpoint" } ] } [/block] **That's it! SumoLogic integration is done. Now you can get logs from SumoLogic with steps below.** ## Step 4: Attach an action to get logs from SumoLogic to any of Neptune rules To any of your Neptune rules, add a new `GET_LOGS` action with target as SumoLogic. Use existing SumoLogic runbook and tweak it for your purposes. [block:image] { "images": [ { "image": [ "https://files.readme.io/SHLlq68R72iqR2dUjobd_Screen%20Shot%202016-03-29%20at%201.03.21%20PM.png", "Screen Shot 2016-03-29 at 1.03.21 PM.png", "1660", "812", "#539fae", "" ], "caption": "Getting SumoLogic logs with GET_LOGS action" } ] } [/block]