{"_id":"55dc7d407fa0290d00559154","user":"55dc702d7fa0290d00559106","category":{"_id":"55dc751b00a8811900c230e3","pages":["55dc75b27fa0290d00559123","55dc75c055be9f21004ee24e","55dc75ef00a8811900c230e7","55dc76036f16451700843e0c","55dc760e00a8811900c230e9","55dc767d55be9f21004ee251","55df5db386ae7f0d00db4ccd","55df64cfaf76b70d0060a60e","55df7263c59b180d005fa70e","55e0b72fa44fae0d002148c5","55e0c42b5087cb1900986c0f","55e36b1bac4eef230079a735","55f363ea2d3bae21009c47aa","55f36bcc5f8674370067b73c","55f36c23ec46040d0030326a","5605d2eda4574a0d00811346","560ac5fef6994b0d0023bca6","561be02937781d0d007942b0","56782f0048c8d00d0094b7fc"],"project":"55db8f8f1a91690d007ad975","version":"55db8f901a91690d007ad978","__v":19,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-25T14:00:59.500Z","from_sync":false,"order":1,"slug":"how-to-get-started","title":"Agent Installation"},"project":"55db8f8f1a91690d007ad975","githubsync":"","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"},"__v":9,"parentDoc":null,"updates":["560affa6afa0990d00979512"],"next":{"pages":[],"description":""},"createdAt":"2015-08-25T14:35:44.415Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Symptom: Agent does not connect to the Dashboard\"\n}\n[/block]\nIf after you've created your application in the dashboard and installed the agent, you still see it shown as *Inactive* below are some steps that can help you with troubleshooting:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"What to Try\",\n    \"h-1\": \"Explanation\",\n    \"0-0\": \"Load the web application in the web client, or a browser and make at least one HTTP request to the monitored application.\",\n    \"0-1\": \"The IMMUNIO agent needs to see at least one HTTP request received by the web application in before communicating with the back end. If the web application is not running the agent will appear offline.\",\n    \"1-0\": \"Check the agent properties file, or environmental variables used to store application key and secret.\",\n    \"1-1\": \"If the key or the secret values given to the agent differ from those specified in the Dashboard, the agent will appear offline.\",\n    \"2-0\": \"Check the connection with the Dashboard back-end: https://agent.immun.io. Contact your IT administrator if you are unable to reach this URL.\",\n    \"2-1\": \"If you are unable to connect to agent.immun.io from the application server, the agent is not ablbe to check in to the IMMUNIO Dashboard. Some typical reasons for failed connections are firewall rules, or proxy filters.\",\n    \"3-0\": \"Review the content of `log/immunio.log` or wherever the log file is configured in the settings of your agent.\",\n    \"3-1\": \"Difficulties starting the agent or calling home are logged here. If there are failures when attempting to connect to https://agent.immun.io, check that outbound connections to the address are unblocked. If you see a message about the agent using the default value, it's either because you didn't set the key/secret or because the agent can't find the configuration file.\",\n    \"4-0\": \"Review platform installation documents and ensure that agent runs on a supported host system.\",\n    \"4-1\": \"The IMMUNIO agent contains a native component that requires a supported host system to compile properly during installation. For example, 32-bit platforms are not supported and it is important that the host system running the application is a 64-bit host. Other OS requirements can be found in the installation section for that agent.\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\nOnce the connection is successful, you should see these two lines of information in the log file:​\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"2015-08-14T13:41:24.137Z immunio INFO   : Agent connected to https://agent.immun.io/\\n2015-08-14T13:41:24.527Z immunio INFO   : Agent UUID: 043f1de9-02ea-4d4b-bc07-925d50600f70\",\n      \"language\": \"yaml\",\n      \"name\": \"immunio.log\"\n    }\n  ]\n}\n[/block]\nFor any other issues, please go to [https://support.immun.io](https://support.immun.io) to open an issue or review our knowledge base.​","excerpt":"","slug":"agent-not-connected","type":"basic","title":"Troubleshooting Agent Installation"}

Troubleshooting Agent Installation


[block:api-header] { "type": "basic", "title": "Symptom: Agent does not connect to the Dashboard" } [/block] If after you've created your application in the dashboard and installed the agent, you still see it shown as *Inactive* below are some steps that can help you with troubleshooting: [block:parameters] { "data": { "h-0": "What to Try", "h-1": "Explanation", "0-0": "Load the web application in the web client, or a browser and make at least one HTTP request to the monitored application.", "0-1": "The IMMUNIO agent needs to see at least one HTTP request received by the web application in before communicating with the back end. If the web application is not running the agent will appear offline.", "1-0": "Check the agent properties file, or environmental variables used to store application key and secret.", "1-1": "If the key or the secret values given to the agent differ from those specified in the Dashboard, the agent will appear offline.", "2-0": "Check the connection with the Dashboard back-end: https://agent.immun.io. Contact your IT administrator if you are unable to reach this URL.", "2-1": "If you are unable to connect to agent.immun.io from the application server, the agent is not ablbe to check in to the IMMUNIO Dashboard. Some typical reasons for failed connections are firewall rules, or proxy filters.", "3-0": "Review the content of `log/immunio.log` or wherever the log file is configured in the settings of your agent.", "3-1": "Difficulties starting the agent or calling home are logged here. If there are failures when attempting to connect to https://agent.immun.io, check that outbound connections to the address are unblocked. If you see a message about the agent using the default value, it's either because you didn't set the key/secret or because the agent can't find the configuration file.", "4-0": "Review platform installation documents and ensure that agent runs on a supported host system.", "4-1": "The IMMUNIO agent contains a native component that requires a supported host system to compile properly during installation. For example, 32-bit platforms are not supported and it is important that the host system running the application is a 64-bit host. Other OS requirements can be found in the installation section for that agent." }, "cols": 2, "rows": 5 } [/block] Once the connection is successful, you should see these two lines of information in the log file:​ [block:code] { "codes": [ { "code": "2015-08-14T13:41:24.137Z immunio INFO : Agent connected to https://agent.immun.io/\n2015-08-14T13:41:24.527Z immunio INFO : Agent UUID: 043f1de9-02ea-4d4b-bc07-925d50600f70", "language": "yaml", "name": "immunio.log" } ] } [/block] For any other issues, please go to [https://support.immun.io](https://support.immun.io) to open an issue or review our knowledge base.​