{"_id":"5798ed4d65ed1a0e0096548d","githubsync":"","parentDoc":null,"user":"56688ec8ee1dbf0d008f62ae","__v":0,"project":"55db8f8f1a91690d007ad975","version":{"_id":"55db8f901a91690d007ad978","project":"55db8f8f1a91690d007ad975","__v":17,"createdAt":"2015-08-24T21:41:36.034Z","releaseDate":"2015-08-24T21:41:36.034Z","categories":["55db8f901a91690d007ad979","55db9856b3d6540d00886426","55dc751b00a8811900c230e3","55dc766255be9f21004ee250","55dc769200a8811900c230ed","55e4c701177b6e0d003330fa","55f4915caf0bc71900a53130","55f491b2be9c2b2100f0635d","560b22739c7be70d00100bd8","57488c53e8c6a420000b729c","574cefd95953e20e00f40f9f","5798edfd7700d30e00ad250c","579ac88234b5fd0e00b9e140","57c81c6d690c200e0047b72e","57d9b8fbda17c30e003897f1","57d9b90e608ea00e00f358d8","57d9b91cda17c30e003897f4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5798edfd7700d30e00ad250c","version":"55db8f901a91690d007ad978","__v":0,"project":"55db8f8f1a91690d007ad975","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-27T17:23:09.246Z","from_sync":false,"order":7,"slug":"integrations","title":"Integrations"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-27T17:20:13.249Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Datadog integration allows you to Integrate security intelligence with other operational data about your cloud environment and your applications. You can use the integration to create alerts in Datadog and to take advantage of further integrations between Datadog and other popular platforms such as Slack. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Creating a New API Key in Datadog\"\n}\n[/block]\nTo integrate your IMMUNIO account with Datadog you need to have a valid Datadog account and create a new API key. You can generate a new key in Datadog under Integrations -> APIs.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7d87018-immunio_datadog_instructions_1.jpg\",\n        \"immunio datadog instructions 1.jpg\",\n        1353,\n        506,\n        \"#dcdfe1\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using the API Key to Connect Your IMMUNIO Account with Datadog\"\n}\n[/block]\nIn order to connect your IMMUNIO account with your Datadog account you need to enter the API key in the Integration settings of your IMMUNIO account. You can navigate to the Integration Settings from the account settings as displayed in the image below:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/320760a-immunio_datadog_instructions_2.jpg\",\n        \"immunio datadog instructions 2.jpg\",\n        1402,\n        436,\n        \"#eaeae9\"\n      ]\n    }\n  ]\n}\n[/block]\nOnce the Integration Settings are updated the security events reported by IMMUNIO are pushed to Datadog in regular time intervals. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Security Metrics Available in Datadog\"\n}\n[/block]\nThe metrics that are available in Datadog are as follows:\n  * *immunio.requests* - count of all requests seen by the IMMUNIO agent (the same values we bill against)\n  * *immunio.attacks* - count of all attacks, tagged with the attack type so they can be segmented\n  * *immunio.mitigate.captcha* - count of all captchas served by the IMMUNIO agent\n  * *immunio.mitigate.blocked* - count of all requests that are blocked with a 403 Forbidden \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using IMMUNIO Security Metrics in Datadog\"\n}\n[/block]\nTo add IMMUNIO metrics in your dashboards you can quickly add IMMUNIO views from the main menu by selecting Integrations -> Integrations\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1157ae5-datadog_instructions_4.jpg\",\n        \"datadog instructions 4.jpg\",\n        1160,\n        666,\n        \"#eceded\"\n      ]\n    }\n  ]\n}\n[/block]\nThis should take you to the overview of available integrations and there you can select IMMUNIO:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8c44f89-datadog_instructions_5.jpg\",\n        \"datadog instructions 5.jpg\",\n        702,\n        287,\n        \"#eae9e9\"\n      ]\n    }\n  ]\n}\n[/block]\nSelect the IMMUNIO tile, go to the description of integration and select Configuration. At the bottom of the configuration page you can select the option: Install Integration. Click on the install will add IMMUNIO views to your dashboard:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d31d97e-datadog_instructions_6.jpg\",\n        \"datadog instructions 6.jpg\",\n        1203,\n        763,\n        \"#ebe9db\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"integrations","type":"basic","title":"Datadog Integration"}

Datadog Integration


Datadog integration allows you to Integrate security intelligence with other operational data about your cloud environment and your applications. You can use the integration to create alerts in Datadog and to take advantage of further integrations between Datadog and other popular platforms such as Slack. [block:api-header] { "type": "basic", "title": "Creating a New API Key in Datadog" } [/block] To integrate your IMMUNIO account with Datadog you need to have a valid Datadog account and create a new API key. You can generate a new key in Datadog under Integrations -> APIs. [block:image] { "images": [ { "image": [ "https://files.readme.io/7d87018-immunio_datadog_instructions_1.jpg", "immunio datadog instructions 1.jpg", 1353, 506, "#dcdfe1" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Using the API Key to Connect Your IMMUNIO Account with Datadog" } [/block] In order to connect your IMMUNIO account with your Datadog account you need to enter the API key in the Integration settings of your IMMUNIO account. You can navigate to the Integration Settings from the account settings as displayed in the image below: [block:image] { "images": [ { "image": [ "https://files.readme.io/320760a-immunio_datadog_instructions_2.jpg", "immunio datadog instructions 2.jpg", 1402, 436, "#eaeae9" ] } ] } [/block] Once the Integration Settings are updated the security events reported by IMMUNIO are pushed to Datadog in regular time intervals. [block:api-header] { "type": "basic", "title": "Security Metrics Available in Datadog" } [/block] The metrics that are available in Datadog are as follows: * *immunio.requests* - count of all requests seen by the IMMUNIO agent (the same values we bill against) * *immunio.attacks* - count of all attacks, tagged with the attack type so they can be segmented * *immunio.mitigate.captcha* - count of all captchas served by the IMMUNIO agent * *immunio.mitigate.blocked* - count of all requests that are blocked with a 403 Forbidden [block:api-header] { "type": "basic", "title": "Using IMMUNIO Security Metrics in Datadog" } [/block] To add IMMUNIO metrics in your dashboards you can quickly add IMMUNIO views from the main menu by selecting Integrations -> Integrations [block:image] { "images": [ { "image": [ "https://files.readme.io/1157ae5-datadog_instructions_4.jpg", "datadog instructions 4.jpg", 1160, 666, "#eceded" ] } ] } [/block] This should take you to the overview of available integrations and there you can select IMMUNIO: [block:image] { "images": [ { "image": [ "https://files.readme.io/8c44f89-datadog_instructions_5.jpg", "datadog instructions 5.jpg", 702, 287, "#eae9e9" ] } ] } [/block] Select the IMMUNIO tile, go to the description of integration and select Configuration. At the bottom of the configuration page you can select the option: Install Integration. Click on the install will add IMMUNIO views to your dashboard: [block:image] { "images": [ { "image": [ "https://files.readme.io/d31d97e-datadog_instructions_6.jpg", "datadog instructions 6.jpg", 1203, 763, "#ebe9db" ] } ] } [/block]