https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/ta-p/293224 <H1>&nbsp;</H1> <DIV class="article-content"> <H2>Summary</H2> <P>Dynatrace extensions can hit CPU or memory soft or hard limits enforced by the <STRONG>Extension Execution Controller (EEC)</STRONG>. When this happens, tasks may be rejected or stopped, and monitoring configurations may fail to assign. This article explains how to diagnose, troubleshoot, and resolve these issues.</P> <H2>Problem description</H2> <P>Extensions running on an <STRONG>ActiveGate</STRONG> or <STRONG>OneAgent</STRONG> may exceed CPU or memory limits. When these limits are reached:</P> <UL> <LI>Extensions may fail to start or stop running.</LI> <LI>Incoming tasks may be rejected.</LI> <LI>Monitoring configurations may remain in Pending or Error state.</LI> </UL> <P>Common error messages include:</P> <UL> <LI><EM>High system resources consumption detected for datasources (soft limit)</EM></LI> <LI><EM>Rejecting configuration… Reason: soft limit reached</EM></LI> <LI><EM>Hard limit reached, stopping extension tasks</EM></LI> <LI><EM>Failed to assign monitoring configuration due to resource limits</EM></LI> </UL> <P>These messages typically also include details explaining which limit was exceeded and by what margin.</P> <P>Soft limits reject new tasks once usage exceeds the threshold. Hard limits stop tasks until consumption returns below the threshold. For background on limits and performance profiles, read <A href="https://docs.dynatrace.com/docs/ingest-from/extensions/concepts" target="_blank" rel="noopener">Extension limits and performance profiles documentation</A>.</P> <H2>Troubleshooting steps</H2> <H3>Investigation steps</H3> <UL> <LI>Open the Extensions app in your Dynatrace environment.</LI> <LI>Locate the affected extension.</LI> <LI>Check for configurations in Pending or Error state.</LI> <LI>Select the error entry to view logs.</LI> <LI>Inspect logs for limit breaches. Look for messages such as: <UL> <LI><EM>soft limit reached</EM></LI> <LI><EM>hard limit reached</EM></LI> <LI><EM>High memory usage detected</EM></LI> </UL> </LI> <LI>If logs are inconclusive, collect a Support Archive. This bundles logs and configuration details for troubleshooting.<BR /><A href="https://community.dynatrace.com/t5/Troubleshooting/Collect-a-Support-Archive-for-nbsp-Troubleshooting-issues-in/ta-p/252022" target="_blank" rel="noopener">How to collect a Support Archive</A>.</LI> </UL> <H2>Log locations</H2> <P>The EEC writes limit-related errors on the host running the extension.</P> <P><STRONG>ActiveGate</STRONG></P> <PRE><CODE>Linux: /var/lib/dynatrace/remotepluginmodule/agent/log/ Windows: C:\ProgramData\dynatrace\remotepluginmodule\agent\log\ </CODE></PRE> <P><STRONG>OneAgent</STRONG></P> <PRE><CODE>Linux: /var/log/dynatrace/remotepluginmodule/agent/log/ Windows: C:\ProgramData\dynatrace\remotepluginmodule\agent\log\ </CODE></PRE> <H3>What to look for</H3> <UL> <LI><STRONG>Python-based extensions</STRONG> <UL> <LI>python*.log: CPU/memory messages (soft limit reached, hard limit reached)</LI> <LI>ruxitagent_extensionsmodule_XXX.log: lifecycle events, enforcement</LI> <LI>EEC controller log: enforcement details</LI> <LI>*.out and *.err: standard output and error</LI> </UL> </LI> <LI><STRONG>Non-Python datasources (SNMP, WMI, JMX, SQL)</STRONG> <UL> <LI>Datasource-specific logs: runtime activity</LI> <LI>remotepluginmodule.log: failures and enforcement</LI> <LI>EEC controller log: enforcement decisions</LI> </UL> </LI> </UL> <H2>Resolution</H2> <H3>Dynatrace Managed</H3> <UL> <LI><STRONG>Use a dedicated ActiveGate for extensions (recommended best practice)</STRONG><BR />A dedicated ActiveGate isolates extension workloads from ingestion, synthetic, and routing modules and improves stability under load.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/advanced-configuration/dedicated-performance-profile" target="_blank" rel="noopener">Dedicated performance profile documentation</A>.</LI> <LI><STRONG>Switch to the High Limits performance profile (temporary mitigation)</STRONG><BR />Temporarily increase CPU and memory headroom for extension execution by selecting High Limits under:<BR /><CODE>Settings → Monitoring → Monitored technologies → [Your extension] → Performance profile</CODE><BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/concepts" target="_blank" rel="noopener">Performance profile documentation</A>.</LI> <LI><STRONG>Increase memory or CPU assigned to the ActiveGate</STRONG><BR />If the host regularly approaches resource limits, allocate additional CPU or memory to the ActiveGate.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/configuration/configure-activegate" target="_blank" rel="noopener">ActiveGate configuration documentation</A>.</LI> <LI><STRONG>Add another ActiveGate to the ActiveGate group where the monitoring configuration is assigned</STRONG><BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/activegate-group" target="_blank" rel="noopener">ActiveGate group documentation</A>.</LI> </UL> <H3>Dynatrace SaaS</H3> <UL> <LI><STRONG>Use an ActiveGate configured exclusively for extensions and assign it to a specific ActiveGate group</STRONG><BR />Isolation is recommended in SaaS environments to ensure predictable load distribution and failover.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/activegate-group" target="_blank" rel="noopener"> ActiveGate group documentation </A>.</LI> <LI><STRONG>Enable dedicated performance mode</STRONG><BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/advanced-configuration/dedicated-performance-profile" target="_blank" rel="noopener">Dedicated performance profile documentation</A>.</LI> <LI><STRONG>Increase limits or switch to High Limits</STRONG><BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/concepts" target="_blank" rel="noopener">Performance profile documentation</A> and <A href="https://docs.dynatrace.com/docs/ingest-from/extensions/extension-limits" target="_blank" rel="noopener">Extension limits documentation</A>.</LI> <LI><STRONG>Scale horizontally by adding additional ActiveGates to the same ActiveGate group</STRONG><BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/activegate-group" target="_blank" rel="noopener">ActiveGate group documentation</A>.</LI> </UL> <H2>Best practice summary</H2> <UL> <LI><STRONG>Use an ActiveGate configured exclusively for extensions and assign it to a specific ActiveGate group</STRONG><BR />This ensures isolation of extension workloads, reducing resource contention and improving stability in SaaS environments.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/activegate-group" target="_blank" rel="noopener"> ActiveGate group documentation </A>.</LI> <LI><STRONG>Use High Limits only as a temporary workaround</STRONG><BR />Increasing limits can prevent short-term disruptions, but it may lead to resource exhaustion if used permanently. Always plan for scaling instead.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/extension-limits" target="_blank" rel="noopener"> Extension limits documentation </A>.</LI> <LI><STRONG>Monitor logs for early warnings such as “High system resources consumption detected”</STRONG><BR />Proactive log monitoring helps identify performance issues before they impact extension execution or ActiveGate stability.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/extensions/troubleshoot" target="_blank" rel="noopener"> Extension troubleshooting and logs </A>.</LI> <LI><STRONG>Add more ActiveGates to distribute extension workloads as environments grow</STRONG><BR />Scaling out ActiveGates prevents overload and ensures predictable performance and failover capabilities.<BR /><A href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/installation" target="_blank" rel="noopener"> ActiveGate installation and scaling guide </A>.</LI> </UL> <H2>Configuration paths</H2> <P><STRONG>Windows</STRONG></P> <PRE><CODE>C:\ProgramData\dynatrace\remotepluginmodule\agent\conf\extensionsuser.conf C:\Program Files\dynatrace\remotepluginmodule\agent\conf\launcheruserconfig.conf C:\Program Files\dynatrace\remotepluginmodule\agent\conf\custom.properties </CODE></PRE> <P><STRONG>Linux</STRONG></P> <PRE><CODE>/var/lib/dynatrace/remotepluginmodule/agent/conf/extensionsuser.conf /var/lib/dynatrace/remotepluginmodule/agent/conf/launcheruserconfig.conf /var/lib/dynatrace/remotepluginmodule/agent/conf/custom.properties </CODE></PRE> <P>For details on overriding limits, read the&nbsp;<A href="https://docs.dynatrace.com/docs/ingest-from/extensions/advanced-configuration/eec-custom-configuration" target="_blank" rel="noopener">EEC custom configuration documentation</A>.</P> <H2>What’s next</H2> <UL> <LI>Open a support ticket if this article did not resolve your issue. Include: <UL> <LI>Link to the affected extension</LI> <LI>Link to the failing monitoring configuration</LI> <LI>Support Archive</LI> <LI>Screenshots of errors</LI> <LI>Relevant log entries</LI> <LI>Recent configuration changes</LI> </UL> </LI> <LI>Suggest a product idea: Describe your use case, limitations, expected outcome, and business impact.</LI> <LI>Additional resources: <UL> <LI><A href="https://community.dynatrace.com/t5/Troubleshooting/SNMP-based-Extensions-Troubleshooting-Guide/ta-p/275088" target="_blank" rel="noopener">SNMP-based Extensions Troubleshooting Guide</A> – Covers timeouts, authentication issues, and resource limits.</LI> <LI><A href="https://community.dynatrace.com/t5/Troubleshooting/SQL-Extensions-Troubleshooting-Guide/ta-p/281473" target="_blank" rel="noopener">SQL Extensions Troubleshooting Guide</A> – Explains connectivity diagnostics and missing metrics.</LI> <LI><A href="https://community.dynatrace.com/t5/Troubleshooting/Database-extension-troubleshooting/ta-p/267257" target="_blank" rel="noopener">Database extension troubleshooting</A> – Provides steps for driver configuration and unreachable hosts.</LI> <LI><A href="https://community.dynatrace.com/t5/Troubleshooting/How-to-use-a-Support-Archive-to-Troubleshoot-Extensions/ta-p/287635" target="_blank" rel="noopener">How to use a Support Archive to troubleshoot extensions</A> – Shows how to collect and interpret Support Archives.</LI> </UL> </LI> </UL> </DIV> Thu, 09 Apr 2026 11:31:13 GMT MartinVolb 2026-04-09T11:31:13Z https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/ta-p/293224 <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> <H1>Summary</H1> <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> <H1>Problem</H1> <P><EM>*This is a mandatory section.</EM></P> <P><EM>Provide a precise description of the problem / task to be described.</EM></P> <P>&nbsp;</P> <H1>Troubleshooting steps</H1> <P><EM>*This section can be omitted.</EM></P> <P>&nbsp;</P> <H1>Resolution</H1> <P><EM>*This section can be omitted for ticket‑creation articles.</EM></P> <H1>What's next</H1> <P><EM>*This is a mandatory section.</EM></P> </DIV> Thu, 09 Apr 2026 11:31:13 GMT https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/ta-p/293224 MartinVolb 2026-04-09T11:31:13Z https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/293717#M1053 <P>Thank you!&nbsp;<img class="lia-deferred-image lia-image-emoji" src="https://community.dynatrace.com/html/@9BD876A77FEF3D5EF4BC972CF8A97CB1/images/emoticons/take_my_money.png" alt=":take_my_money:" title=":take_my_money:" /></P> Tue, 27 Jan 2026 16:41:39 GMT https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/293717#M1053 AntonPineiro 2026-01-27T16:41:39Z https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/295635#M1084 <P>Hi Martin,</P><P>You speak about&nbsp;<STRONG>Scale horizontally by adding additional ActiveGates to the same ActiveGate group.</STRONG></P><P>Good enough but I have a configuration with 3 AG with dedicated profile.</P><P>What I see is that I have only 1 AG who is working hard, with regularly soft limits alerts and 2 other doing almost nothing!</P><P>There is no load balancing occuring nor extension moved to another AG from same group.</P><P>For me seems&nbsp; that Scale horizontally is useless. Any other solution to propose?</P> Wed, 04 Mar 2026 13:51:54 GMT https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/295635#M1084 AlainD 2026-03-04T13:51:54Z https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/295637#M1085 <P><a href="https://community.dynatrace.com/t5/user/viewprofilepage/user-id/44706">@AlainD</a>&nbsp;<BR /><BR />Hi Alain,<BR /><BR />A controlled restart of the ActiveGate experiencing high load will allow traffic and processing to be redistributed to other ActiveGates.<BR /><BR /></P> <DIV> <DIV><STRONG><A class="fui-Link ___w5et180 f2hkw1w f3rmtva f1ewtqcl fyind8e f1k6fduh f1w7gpdv f1mo0ibp fjoy568 ff5ikls f1s184ao f1mk8lai fnbmjn9 f1o700av f13mvf36 f1cmlufx f9n3di6 f1ids18y f1tx3yz7 f1deo86v f1eh06m1 f1iescvh fhgqx19 f1olyrje f1p93eir f1nev41a" tabindex="0" href="https://docs.dynatrace.com/docs/ingest-from/dynatrace-activegate/operation/stop-restart-activegate" rel="noopener noreferrer" data-tabster="{&quot;restorer&quot;:{&quot;type&quot;:1}}" target="_blank">Start/stop/restart ActiveGate</A></STRONG> – Describes how to restart an ActiveGate</DIV> </DIV> Wed, 04 Mar 2026 14:18:01 GMT https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/295637#M1085 MartinVolb 2026-03-04T14:18:01Z https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/296241#M1094 <P><a href="https://community.dynatrace.com/t5/user/viewprofilepage/user-id/44706">@AlainD</a>&nbsp;you can force the endpoint to get evenly distributed, I believe it is called Task Bucket set to 1, which is available when configuring the end point.</P><P>Good luck</P><P>Thanks</P><P>Raj</P> Mon, 16 Mar 2026 18:35:41 GMT https://community.dynatrace.com/t5/Troubleshooting/Understanding-and-troubleshooting-Dynatrace-extension-resource/tac-p/296241#M1094 mrc15816 2026-03-16T18:35:41Z