https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/ta-p/214354 <P><EM>Summary:&nbsp;HTTP monitors in Dynatrace may return health status codes indicating connectivity or configuration issues. This guide lists common error codes, explains their meaning, and provides steps to restore monitoring accuracy.</EM></P> <P>&nbsp;</P> <P><LI-TOC indent="15" liststyle="disc" maxheadinglevel="2"></LI-TOC></P> <P>&nbsp;</P> <H2>Where to find HTTP Monitor Error/ Health Status Codes&nbsp;</H2> <P>&nbsp;</P> <P>HTTP Monitor executions don't always succeed. In addition to the HTTP response codes that a request can return, there are several Dynatrace error codes.&nbsp;</P> <P>A summary of the HTTP Monitor error codes for a period can be seen in the <A href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/analysis-and-alerting/synthetic-details-for-http-monitors-classic#failed-requests" target="_self">HTTP Monitor details&gt; Failed Requests card</A>.&nbsp;</P> <P><span class="lia-inline-image-display-wrapper lia-image-align-inline" image-alt="HannahM_2-1686150676387.png"><img src="https://community.dynatrace.com/t5/image/serverpage/image-id/12132iBA27D6E4B38DB96D/image-size/medium?v=v2&amp;px=400" alt="HannahM_2-1686150676387.png" title="HannahM_2-1686150676387.png" /></span></P> <P>You can also, find the error code for <SPAN>the most recent failed, successful and on-demand executions</SPAN> in<SPAN>&nbsp;</SPAN><A class="anchor" href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/analysis-and-alerting/synthetic-details-for-http-monitors-classic#analyze-last-execution" target="_blank" rel="noopener"><STRONG>Analyze last failed execution</STRONG></A><SPAN>. You can filter the JSON to just show the error. In the JSON the error code is called HealthStatusCode and the error description is HealthStatus.&nbsp;</SPAN></P> <P><span class="lia-inline-image-display-wrapper lia-image-align-inline" image-alt="HannahM_3-1686151110064.png"><img src="https://community.dynatrace.com/t5/image/serverpage/image-id/12133i5B4741006C55BAFF/image-size/medium?v=v2&amp;px=400" alt="HannahM_3-1686151110064.png" title="HannahM_3-1686151110064.png" /></span></P> <P>&nbsp;</P> <H2>Error/Health Status Codes and Suggested Actions</H2> <P>&nbsp;</P> <TABLE> <TBODY> <TR> <TD> <P>Error/</P> <P>Health Status Code</P> <P>&nbsp;</P> </TD> <TD> <P>Error Description/ Health Status</P> </TD> <TD> <P>Suggested Actions</P> </TD> </TR> <TR> <TD> <P>0</P> </TD> <TD> <P>Healthy</P> </TD> <TD> <P>&nbsp;</P> </TD> </TR> <TR> <TD> <P>1</P> </TD> <TD> <P>SSL Communication error</P> </TD> <TD> <P>Check vuc-http-execution.log for more details.</P> </TD> </TR> <TR> <TD> <P>2</P> </TD> <TD> <P>DNS query timeout</P> </TD> <TD> <P>Check vuc-http-execution.log for more details.</P> </TD> </TR> <TR> <TD> <P>3</P> </TD> <TD> <P>Unknown Host</P> </TD> <TD> <P>Check nslookup from the ActiveGate.</P> </TD> </TR> <TR> <TD> <P>4</P> </TD> <TD> <P>Unexpected Error</P> </TD> <TD> <P>Check vuc-http-execution.log and vuc-http.log for more info</P> </TD> </TR> <TR> <TD> <P>5</P> </TD> <TD> <P>Redirects not allowed</P> </TD> <TD> <P>&nbsp;</P> </TD> </TR> <TR> <TD> <P>6</P> </TD> <TD> <P>Invalid Code</P> </TD> <TD> <P>Status Code validation failed <BR />Check Monitor&gt; Settings&gt;HTTP Requests&gt; Request&gt; Response Status Code Verification setting</P> </TD> </TR> <TR> <TD> <P>7</P> </TD> <TD> <P>Script execution failed</P> </TD> <TD> <P>There was a problem running one of the pre- or post-execution scripts. Some common causes are:</P> <UL> <LI>typos or syntax errors</LI> <LI>referring to a method/ variable that hasn't been defined in the script</LI> </UL> <P>Check vuc-http-execution.log for more details.</P> </TD> </TR> <TR> <TD> <P>8</P> </TD> <TD> <P>Script Fail</P> </TD> <TD> <P>Check vuc-http-execution.log for more details.</P> </TD> </TR> <TR> <TD> <P>12</P> </TD> <TD> <P>Http Monitor Execution Timeout</P> </TD> <TD> <P>Use Adapt Request Timeout to increase up to 60s. The HTTP Monitor Advanced settings preview can be used to increase the monitor timeout. Ask your CSM or Support for more details.</P> </TD> </TR> <TR> <TD> <P>13</P> </TD> <TD> <P>Too many redirects</P> </TD> <TD> <P>The maximum number of redirects for synthetic monitors is 10. When a monitor reaches 11 redirects, it fails with this error.&nbsp;<BR />Reach out to your application team to find out why there are so many redirects and reduce them.&nbsp;</P> </TD> </TR> <TR> <TD> <P>15</P> </TD> <TD> <P>Connection timeout</P> </TD> <TD> <P><A href="https://community.dynatrace.com/t5/Troubleshooting/Firewall-Constraints-and-allowlisting-for-Synthetic-Monitoring/ta-p/213876#toc-hId-370831897" target="_self">Test connection using curl from the ActiveGate</A><BR />Is a proxy needed?<BR />If a public location, is this endpoint available? Do the <A href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/general-information/public-synthetic-locations#ip-addresses" target="_self">public location IP addresses</A> need to be allowlisted by the application?</P> </TD> </TR> <TR> <TD> <P>16</P> </TD> <TD> <P>Connection Refused</P> </TD> <TD> <P>Does this endpoint require specific headers to be added?<BR />Private location: <A href="https://community.dynatrace.com/t5/Troubleshooting/Firewall-Constraints-and-allowlisting-for-Synthetic-Monitoring/ta-p/213876#toc-hId--978951428" target="_self">Test connection using curl from the ActiveGate</A>.&nbsp;Is a proxy needed?&nbsp;<BR />Public location: Is this endpoint available? Do the <A href="https://www.dynatrace.com/support/help/platform-modules/digital-experience/synthetic-monitoring/general-information/public-synthetic-locations#ip-addresses" target="_self">public location IP addresses</A> need to be allowlisted by the application?</P> </TD> </TR> <TR> <TD> <P>17</P> </TD> <TD> <P>Constraint Violated value</P> </TD> <TD> <P>Response validation failed. <BR />Check Monitor&gt; Settings&gt;HTTP Requests&gt; Request&gt; Set rule for response validation setting</P> </TD> </TR> <TR> <TD> <P>18</P> </TD> <TD> <P>Unknown Method Error</P> <P><SPAN>UNKNOWN_METHOD_ERROR</SPAN></P> </TD> <TD> <P>Check vuc-http-execution.log and vuc-http.log for more info.<BR />This occurs when a method is called in the pre-/ post- execution script that the monitor is unaware of. These are usually from third-party libraries. For these situations, you must add the code for the function into the script. Like these examples <A href="https://community.dynatrace.com/t5/Troubleshooting/AES-Encryption-and-Decryption-in-Synthetic-HTTP-Monitor-using/ta-p/209462" target="_self">here</A>&nbsp;and <A href="https://community.dynatrace.com/t5/Troubleshooting/HTTP-Monitors-How-to-sign-a-request-for-AWS-Signature-Version-4/ta-p/219868" target="_self">here</A></P> </TD> </TR> <TR> <TD> <P>20</P> </TD> <TD> <P>SSL Expiry warning</P> </TD> <TD> <P>&nbsp;</P> </TD> </TR> <TR> <TD> <P>24</P> </TD> <TD> <P>Request Timeout</P> </TD> <TD> <P><A href="https://community.dynatrace.com/t5/Troubleshooting/Firewall-Constraints-and-allowlisting-for-Synthetic-Monitoring/ta-p/213876#toc-hId-370831897" target="_self">Test connection using curl from the ActiveGate</A></P> <P>Is a <A href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/private-synthetic-locations/setting-up-proxy-for-private-synthetic" target="_self">proxy</A> needed?<BR />If a public location, is this endpoint available? Do the <A href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/general-information/public-synthetic-locations#ip-addresses" target="_self">public location IP addresses</A> need to be allowlisted by the application?</P> </TD> </TR> <TR> <TD> <P>30</P> </TD> <TD> <P>Forbidden URL Error</P> </TD> <TD> <P>IP resolves to localhost, which, due to security reasons, is not allowed</P> </TD> </TR> </TBODY> </TABLE> <P>&nbsp;</P> <H2>Where to find HTTP Monitor Logs</H2> <P>You can either download the support archive or check directly for HTTP Monitor logs on a Private location. You can find where to check <A href="https://community.dynatrace.com/t5/Troubleshooting/Useful-Synthetic-ActiveGate-logs/ta-p/214478" target="_self">here.</A></P> <P>&nbsp;</P> <H2>What's next</H2> <P>Open a chat or contact support if&nbsp;</P> <UL> <LI><SPAN>you need to check the logs for an HTTP Monitor running on a public location, or</SPAN></LI> <LI><SPAN>the issue is still not resolved after taking the above actions</SPAN></LI> </UL> <P>&nbsp;</P> <P><STRONG><SPAN data-contrast="auto">What to read next:</SPAN></STRONG><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:299,&quot;335559739&quot;:299}">&nbsp;</SPAN></P> <P><SPAN data-contrast="auto"><span class="lia-unicode-emoji" title=":open_book:">📖</span>&nbsp;</SPAN><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}">&nbsp;<A id="link_6" class="page-link lia-link-navigation lia-custom-event" href="https://community.dynatrace.com/t5/Troubleshooting/Synthetic-Troubleshooting-Map/ta-p/250426" target="_blank" rel="noopener">Synthetic Troubleshooting Map</A></SPAN></P> <P><SPAN data-contrast="auto"><span class="lia-unicode-emoji" title=":open_book:">📖</span>&nbsp;</SPAN><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}">&nbsp;<A id="link_6" class="page-link lia-link-navigation lia-custom-event" href="https://community.dynatrace.com/t5/Troubleshooting/Synthetic-Browser-Monitor-Error-Codes/ta-p/198177" target="_blank" rel="noopener">Synthetic Browser Monitor Error Codes</A></SPAN></P> <P><SPAN data-contrast="auto"><span class="lia-unicode-emoji" title=":open_book:">📖</span></SPAN><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}">&nbsp;&nbsp;<A id="link_7" class="page-link lia-link-navigation lia-custom-event" href="https://community.dynatrace.com/t5/Troubleshooting/How-can-I-find-which-ActiveGate-my-HTTP-Monitor-execution-ran-on/ta-p/236034" target="_blank" rel="noopener">How can I find which ActiveGate my HTTP Monitor execution ran on?</A></SPAN></P> <P><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}"><span class="lia-unicode-emoji" title=":open_book:">📖</span>&nbsp;&nbsp;<A id="link_7" class="page-link lia-link-navigation lia-custom-event" href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/synthetic-on-grail/synthetic-app/create-and-configure-an-http-monitor" target="_blank" rel="noopener">Create and configure an HTTP monitor</A></SPAN></P> <P><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}"><span class="lia-unicode-emoji" title=":open_book:">📖</span>&nbsp;&nbsp;<A id="link_7" class="page-link lia-link-navigation lia-custom-event" href="https://docs.dynatrace.com/docs/shortlink/http-monitors-config" target="_blank" rel="noopener">Configure HTTP monitors (classic)</A></SPAN></P> <P><SPAN data-contrast="auto"><span class="lia-unicode-emoji" title=":open_book:">📖</span></SPAN><SPAN data-ccp-props="{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;335559738&quot;:240,&quot;335559739&quot;:240}">&nbsp;&nbsp;<A id="link_7" class="page-link lia-link-navigation lia-custom-event" href="https://docs.dynatrace.com/docs/observe/digital-experience/synthetic-monitoring/http-monitors-classic/pre-and-post-scripting-for-http-monitors-classic" target="_blank" rel="noopener">Pre- and post-execution scripts for HTTP monitors (classic)</A></SPAN></P> <P>&nbsp;</P> Wed, 26 Aug 2026 15:03:08 GMT HannahM 2026-08-26T15:03:08Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/ta-p/214354 <P><LI-TOC indent="15" liststyle="disc" maxheadinglevel="2"></LI-TOC></P> <DIV class="lia-message-template-content-zone"> <P>*<EM>Use a table of contents for longer articles.&nbsp;</EM></P> <H2>Summary</H2> <P><EM>*This is a mandatory section.</EM></P> <P><EM>Short description of which part of the Dynatrace platform the article refers to and what kind of problem it will help resolve/ task it will describe.</EM></P> <P>&nbsp;</P> <H2>Problem</H2> <P><EM>*This is a mandatory section.</EM></P> <P><EM>Provide a precise description of the problem/ task to be described. Use anonymized screenshots, and include text for&nbsp;important messages, errors, or information that will help the customer find this article when searching.</EM></P> <P>&nbsp;</P> <H2>Troubleshooting steps</H2> <P><EM>*This section can be omitted as necessary.</EM></P> <P><EM>Explain what troubleshooting steps should be taken to ensure the problem matches this article.</EM></P> <P>&nbsp;</P> <H2>Resolution</H2> <P><EM>*This section can be omitted for articles that guide customers on case creation.</EM></P> <P><EM>Explain the solution or all possible solutions resulting from the troubleshooting steps.<BR /><BR /></EM></P> <H2>What's next</H2> <P><EM>*This is a mandatory section. Customers need a way to respond or follow up if they have questions.&nbsp;</EM></P> <P><EM>Explain what to do if the article didn't help.&nbsp;</EM><EM>Note that there are multiple options available, including:</EM></P> <OL> <LI><EM><STRONG>Opening a chat or support case&nbsp;</STRONG>- be as specific as possible about the information the customer should include in the case.&nbsp;</EM><EM>Use the following formula and fill or change the bullet points:<BR /><BR /></EM> If this article didn't help, <STRONG>create a chat or open a support case</STRONG> <UL> <LI>Mention that you reviewed this article.</LI> <LI>Include the following details: <UL> <LI>Link to XYZ</LI> <LI>Screenshot of XYZ</LI> <LI>Information about XYZ</LI> </UL> </LI> </UL> </LI> <LI><EM><STRONG>Suggesting Product Idea</STRONG> - encourage the customer to suggest/ vote for a Product Idea explaining their business use case.<BR /></EM> <DIV>Please submit a Product Idea with detailed information about your request and use case in the Product Ideas forum. Our Product Management team regularly reviews these suggestions:</DIV> <A href="https://community.dynatrace.com/t5/Dynatrace-product-ideas/idb-p/DynatraceProductIdeas" target="_blank" rel="noopener">https://community.dynatrace.com/t5/Dynatrace-product-ideas/idb-p/DynatraceProductIdeas</A></LI> <LI><STRONG><EM>Explain this will change in the future </EM></STRONG><EM>- explain that this behavior will change in a future release. (No product idea / support case needed)</EM></LI> <LI><STRONG><EM>Alternatives -</EM></STRONG><EM>&nbsp;any other actions or links to other articles that could move the customer forward.</EM></LI> </OL> <H2><BR />Related reading</H2> <P><EM>*Link this article to other relevant configuration or troubleshooting guides, including any applicable troubleshooting maps.<BR />:open_book:&nbsp;&nbsp;</EM><A href="https://community.dynatrace.com/t5/Troubleshooting/" target="_blank" rel="noopener">XXX Troubleshooting Map</A></P> <P>:open_book:&nbsp; Link 1</P> <P>:open_book:&nbsp; Link 2</P> <P>:open_book:&nbsp; Link 3</P> <P>:open_book:&nbsp; Link 4</P> </DIV> Wed, 26 Aug 2026 15:03:08 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/ta-p/214354 HannahM 2026-08-26T15:03:08Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/215018#M254 <P>Thanks for sharing this out&nbsp;<a href="https://community.dynatrace.com/t5/user/viewprofilepage/user-id/1433">@HannahM</a>&nbsp;</P> Wed, 14 Jun 2023 15:41:42 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/215018#M254 ChadTurner 2023-06-14T15:41:42Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/218111#M269 <P><a href="https://community.dynatrace.com/t5/user/viewprofilepage/user-id/1433">@HannahM</a>&nbsp; This is awesome, can this information be posted on the public documentation site? The table you created is so informative. We were just having problem #7 and we found this post while troubleshooting.&nbsp; So valuable.</P> Fri, 14 Jul 2023 15:43:56 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/218111#M269 ct_27 2023-07-14T15:43:56Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/218180#M271 <P><a href="https://community.dynatrace.com/t5/user/viewprofilepage/user-id/1433">@HannahM</a>&nbsp;Very Informative!&nbsp;</P> Mon, 17 Jul 2023 06:15:30 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/218180#M271 nadeem_m 2023-07-17T06:15:30Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/293895#M1056 <P>What can be typical cause for the error number 7?</P><P>I am running some checks from a public location, so unable to check for myself.</P> Thu, 29 Jan 2026 23:09:35 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/293895#M1056 tarjei 2026-01-29T23:09:35Z https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/293946#M1057 <P>For error code 7,&nbsp;Script execution failed, there was a problem running one of the pre- or post-execution scripts. Some common causes are:</P> <UL> <LI>typos or syntax errors</LI> <LI>referring to a method/ variable that hasn't been defined in the script</LI> </UL> <P>If you can't find the error, you can open a chat or support ticket, and Dynatrace will provide the relevant log lines from the public location.</P> <P>&nbsp;</P> Fri, 30 Jan 2026 14:16:55 GMT https://community.dynatrace.com/t5/Troubleshooting/Resolve-HTTP-Monitor-Error-Health-Status-Codes-in-Dynatrace/tac-p/293946#M1057 HannahM 2026-01-30T14:16:55Z