{"_id":"55d3b647f77e6d0d00b1b286","category":{"_id":"55d3b645f77e6d0d00b1b27c","__v":4,"pages":["55d3b647f77e6d0d00b1b286","55d3b647f77e6d0d00b1b287","55d3b647f77e6d0d00b1b288","55d3b647f77e6d0d00b1b289","55d3b647f77e6d0d00b1b28a","55d3b647f77e6d0d00b1b28b","55d3b647f77e6d0d00b1b28c","55d3b647f77e6d0d00b1b28d","55d3b647f77e6d0d00b1b28e","55d3b647f77e6d0d00b1b28f","55d3b647f77e6d0d00b1b290","55d3b647f77e6d0d00b1b291","562ea6c53b2af20d006ad03d","56312e4024014b0d00bd9a48","564e4d122b223c2b00496a27"],"project":"55c505b41469ad2500fa2ab7","version":"55d3b644f77e6d0d00b1b273","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-10T18:45:23.276Z","from_sync":false,"order":9,"slug":"integration-guides","title":"Integration Guides"},"parentDoc":null,"__v":69,"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"},"project":"55c505b41469ad2500fa2ab7","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-10T19:40:21.002Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"**How it works : **\n1. Add your write-enabled pagerduty API key to Neptune. We then automatically add Neptune endpoint as webhook to all your pagerduty services and incidents will start flowing to Neptune\n2. (Optional) If you prefer to add a read-only API key then you need to manually add Neptune's webhook to all your pagerduty services\n\n**Benefits :** Once integrated, Neptune keeps receiving incidents from pagerduty, and Neptune applies its trigger intelligence on the incidents to let you :\n\n1. Quickly fix the incidents right from Neptune dashboard by acting on the trigger hosts or apps or a cluster of hosts\n2. You can also create rules to automatically trigger remediation actions when the same alerts occur again in future\n\n**Get started by clicking pagerduty in your integrations page**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/uRYbSESXSRi5UobTXtkt_pagerdutyGetStarted.png\",\n        \"pagerdutyGetStarted.png\",\n        \"1613\",\n        \"1034\",\n        \"#a71b68\",\n        \"\"\n      ],\n      \"caption\": \"Adding PagerDuty integration\"\n    }\n  ]\n}\n[/block]\n## Step 1: Add your pagerduty API key in Neptune\n\n1. In pagerduty, go to (1)Configuration --> (2)API Access --> (3){ Give a key name, e.g : Neptuneio_API_Key } --> (4) Don't select Read-only option as we want a write API key ---> (5) Copy key --> (6)Add API key in Neptune\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/yO48lGQSLqGe2L7n3zHm_pagerdutyAPIKeys.png\",\n        \"pagerdutyAPIKeys.png\",\n        \"1317\",\n        \"869\",\n        \"#3db855\",\n        \"\"\n      ],\n      \"caption\": \"Get PagerDuty API key\"\n    }\n  ]\n}\n[/block]\n2. Save the API key in Neptune with a name (e.g : NeptuneioPagerDutyKeys)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Xq7WbzcYR2yx7oxvjI17_pagerdutyAddAPIKeys.png\",\n        \"pagerdutyAddAPIKeys.png\",\n        \"896\",\n        \"357\",\n        \"#a4236a\",\n        \"\"\n      ],\n      \"caption\": \"Add PagerDuty API Key\"\n    }\n  ]\n}\n[/block]\n## Step 2: (Optional) Add Neptune endpoint as a webhook for your pagerduty services\n\nIf you added a read-only pagerduty API key instead of write capable API key, then you need to manually add Neptune endpoint as webhook to all of your services in pagerduty\n\n1. Use the Neptune endpoint specified in the pagerduty integration page\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6EQPATnwRnedOvZOT6xw_pagerdutyWebhook.png\",\n        \"pagerdutyWebhook.png\",\n        \"860\",\n        \"64\",\n        \"#ba0c04\",\n        \"\"\n      ],\n      \"caption\": \"Get Neptune.io endpoint\"\n    }\n  ]\n}\n[/block]\n2. In pagerduty, go to (1)Configuration --> (2)Services --> (3){Select a service}\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/G9ZpoKixS6e7QYxkVTlu_pagerdutySelectService.png\",\n        \"pagerdutySelectService.png\",\n        \"1345\",\n        \"897\",\n        \"#24b968\",\n        \"\"\n      ],\n      \"caption\": \"Add Neptune.io endpoint in PD service\"\n    }\n  ]\n}\n[/block]\n3. For the selected service (1)Give webhook name -->(2)Add the Neptune endpoint  and save the webhook\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/aV5xWpacSDmvKxOkzjnq_pagerdutyEditWebhook.png\",\n        \"pagerdutyEditWebhook.png\",\n        \"1170\",\n        \"559\",\n        \"#a74640\",\n        \"\"\n      ],\n      \"caption\": \"Add Neptune.io endpoint in PD service\"\n    }\n  ]\n}\n[/block]\n## Step 3 : Integrate your monitoring tool\n\nAlthough you have integrated your pagerduty account with Neptune, we require that you integrate your monitoring tool as well, so that Neptune can dynamically query your monitoring tool to apply it's [trigger intelligence](doc:triggers-overview) and better understand the alert context\n\nRefer to Integration guides section in the left sidebar for your specific monitoring tool\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Pagerduty users should NOT add a Neptune webhook in your monitoring tool\",\n  \"body\": \"Doing so will send two alerts to Neptune, one from pagerduty and another from your monitoring tool\"\n}\n[/block]\n\n## Step 4 : Manage all your incidents at one place\n\nOnce your pagerduty and monitoring tool integrations are done, incidents will start flowing into Neptune, and you can see all the open and resolved incidents in the Neptune incidents dashboard. You can then :\n\n1. Quickly fix the open incidents right from Neptune because we automatically understand the trigger hosts dynamically, and you need not login to them.\n\n2. Understand your alert statistics (which alarms are occuring the most and which are causing the most damage in terms of MTTR). You can then apply the 80-20 rule to automate your top 20% alarms and sleep peacefully 80% of the time\n \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/fBSJoumtSvWE55OjHJc3_incidentDashboard.png\",\n        \"incidentDashboard.png\",\n        \"1380\",\n        \"867\",\n        \"#800942\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Congrats ! Your Pagerduty integration is done. Now you can fix your alerts automatically with Neptune\",\n  \"body\": \"\"\n}\n[/block]","excerpt":"","slug":"pagerduty-integration","type":"basic","title":"PagerDuty"}
**How it works : ** 1. Add your write-enabled pagerduty API key to Neptune. We then automatically add Neptune endpoint as webhook to all your pagerduty services and incidents will start flowing to Neptune 2. (Optional) If you prefer to add a read-only API key then you need to manually add Neptune's webhook to all your pagerduty services **Benefits :** Once integrated, Neptune keeps receiving incidents from pagerduty, and Neptune applies its trigger intelligence on the incidents to let you : 1. Quickly fix the incidents right from Neptune dashboard by acting on the trigger hosts or apps or a cluster of hosts 2. You can also create rules to automatically trigger remediation actions when the same alerts occur again in future **Get started by clicking pagerduty in your integrations page** [block:image] { "images": [ { "image": [ "https://files.readme.io/uRYbSESXSRi5UobTXtkt_pagerdutyGetStarted.png", "pagerdutyGetStarted.png", "1613", "1034", "#a71b68", "" ], "caption": "Adding PagerDuty integration" } ] } [/block] ## Step 1: Add your pagerduty API key in Neptune 1. In pagerduty, go to (1)Configuration --> (2)API Access --> (3){ Give a key name, e.g : Neptuneio_API_Key } --> (4) Don't select Read-only option as we want a write API key ---> (5) Copy key --> (6)Add API key in Neptune [block:image] { "images": [ { "image": [ "https://files.readme.io/yO48lGQSLqGe2L7n3zHm_pagerdutyAPIKeys.png", "pagerdutyAPIKeys.png", "1317", "869", "#3db855", "" ], "caption": "Get PagerDuty API key" } ] } [/block] 2. Save the API key in Neptune with a name (e.g : NeptuneioPagerDutyKeys) [block:image] { "images": [ { "image": [ "https://files.readme.io/Xq7WbzcYR2yx7oxvjI17_pagerdutyAddAPIKeys.png", "pagerdutyAddAPIKeys.png", "896", "357", "#a4236a", "" ], "caption": "Add PagerDuty API Key" } ] } [/block] ## Step 2: (Optional) Add Neptune endpoint as a webhook for your pagerduty services If you added a read-only pagerduty API key instead of write capable API key, then you need to manually add Neptune endpoint as webhook to all of your services in pagerduty 1. Use the Neptune endpoint specified in the pagerduty integration page [block:image] { "images": [ { "image": [ "https://files.readme.io/6EQPATnwRnedOvZOT6xw_pagerdutyWebhook.png", "pagerdutyWebhook.png", "860", "64", "#ba0c04", "" ], "caption": "Get Neptune.io endpoint" } ] } [/block] 2. In pagerduty, go to (1)Configuration --> (2)Services --> (3){Select a service} [block:image] { "images": [ { "image": [ "https://files.readme.io/G9ZpoKixS6e7QYxkVTlu_pagerdutySelectService.png", "pagerdutySelectService.png", "1345", "897", "#24b968", "" ], "caption": "Add Neptune.io endpoint in PD service" } ] } [/block] 3. For the selected service (1)Give webhook name -->(2)Add the Neptune endpoint and save the webhook [block:image] { "images": [ { "image": [ "https://files.readme.io/aV5xWpacSDmvKxOkzjnq_pagerdutyEditWebhook.png", "pagerdutyEditWebhook.png", "1170", "559", "#a74640", "" ], "caption": "Add Neptune.io endpoint in PD service" } ] } [/block] ## Step 3 : Integrate your monitoring tool Although you have integrated your pagerduty account with Neptune, we require that you integrate your monitoring tool as well, so that Neptune can dynamically query your monitoring tool to apply it's [trigger intelligence](doc:triggers-overview) and better understand the alert context Refer to Integration guides section in the left sidebar for your specific monitoring tool [block:callout] { "type": "danger", "title": "Pagerduty users should NOT add a Neptune webhook in your monitoring tool", "body": "Doing so will send two alerts to Neptune, one from pagerduty and another from your monitoring tool" } [/block] ## Step 4 : Manage all your incidents at one place Once your pagerduty and monitoring tool integrations are done, incidents will start flowing into Neptune, and you can see all the open and resolved incidents in the Neptune incidents dashboard. You can then : 1. Quickly fix the open incidents right from Neptune because we automatically understand the trigger hosts dynamically, and you need not login to them. 2. Understand your alert statistics (which alarms are occuring the most and which are causing the most damage in terms of MTTR). You can then apply the 80-20 rule to automate your top 20% alarms and sleep peacefully 80% of the time [block:image] { "images": [ { "image": [ "https://files.readme.io/fBSJoumtSvWE55OjHJc3_incidentDashboard.png", "incidentDashboard.png", "1380", "867", "#800942", "" ] } ] } [/block] [block:callout] { "type": "success", "title": "Congrats ! Your Pagerduty integration is done. Now you can fix your alerts automatically with Neptune", "body": "" } [/block]