https://community.dynatrace.com/t5/Troubleshooting/Troubleshooting-log-Ingestion-via-API-POST-ingest-logs/ta-p/286608 <P><LI-TOC indent="15" liststyle="disc" maxheadinglevel="2"></LI-TOC></P> <DIV class="lia-message-template-content-zone"> <H1>&nbsp;</H1> <H1>Summary</H1> <P><SPAN>This guide covers how to push custom logs to Dynatrace using the&nbsp;</SPAN><STRONG>Log Monitoring API</STRONG><SPAN>&nbsp;(</SPAN><CODE>POST /logs/ingest</CODE><SPAN>). It applies to both&nbsp;</SPAN><STRONG>SaaS environments</STRONG><SPAN>&nbsp;and&nbsp;</SPAN><STRONG>ActiveGate deployments</STRONG><SPAN>&nbsp;with the Log Analytics Collector module enabled.</SPAN></P> <H1>&nbsp;</H1> <H1>Troubleshooting steps</H1> <P>&nbsp;</P> <H2>1.<SPAN>&nbsp;</SPAN><STRONG>Verify API Endpoint</STRONG></H2> <UL> <LI>Confirm you're using the correct endpoint:</LI> <LI>SaaS:<SPAN>&nbsp;</SPAN><CODE>https://{environmentid}.live.dynatrace.com/api/v2/logs/ingest</CODE></LI> <LI>ActiveGate:<SPAN>&nbsp;</SPAN><CODE>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingest</CODE><BR /><BR /></LI> </UL> <H2>2.<SPAN>&nbsp;</SPAN><STRONG>Check Authentication</STRONG></H2> <UL> <LI class="task-list-item">Ensure your access token includes the<SPAN>&nbsp;</SPAN><CODE>logs.ingest</CODE><SPAN>&nbsp;</SPAN>scope.</LI> <LI class="task-list-item">Validate token format and expiration.</LI> </UL> <H2><BR />3.<SPAN>&nbsp;</SPAN><STRONG>Validate Headers</STRONG></H2> <UL> <LI class="task-list-item"><CODE>Authorization: Api-Token {your-token}</CODE></LI> <LI class="task-list-item"><CODE>Content-Type</CODE>: Must be one of: <UL> <LI><CODE>text/plain</CODE></LI> <LI><CODE>application/json</CODE></LI> <LI><CODE>application/jsonl</CODE></LI> <LI><CODE>application/x-ndjson</CODE></LI> </UL> </LI> </UL> <H2><BR />4.<SPAN>&nbsp;</SPAN><STRONG>Inspect Payload Format</STRONG></H2> <UL> <LI class="task-list-item">Confirm UTF-8 encoding.</LI> <LI class="task-list-item">For JSON payloads: <UL> <LI class="task-list-item">Use an array of log objects.</LI> <LI class="task-list-item">Include required fields like<SPAN>&nbsp;</SPAN><CODE>content</CODE>,<SPAN>&nbsp;</SPAN><CODE>timestamp</CODE>, and<SPAN>&nbsp;</SPAN><CODE>severity</CODE>.</LI> <LI class="task-list-item">Flatten nested attributes using dot notation.</LI> </UL> </LI> </UL> <H2><BR />5.<SPAN>&nbsp;</SPAN><STRONG>Check Timestamp Validity</STRONG></H2> <UL> <LI class="task-list-item">Ensure timestamps are: <UL> <LI>In UTC</LI> <LI>RFC3339 or RFC3164 format</LI> <LI>Not older than 24 hours</LI> </UL> </LI> </UL> <H2><BR />6.<SPAN>&nbsp;</SPAN><STRONG>Review Attribute Depth</STRONG></H2> <UL> <LI class="task-list-item">Limit nesting to 5 levels.</LI> <LI class="task-list-item">Avoid conflicting keys (Dynatrace will prefix with<SPAN>&nbsp;</SPAN><CODE>overwritten1</CODE>, etc.).</LI> </UL> <H2><BR />7.<SPAN>&nbsp;</SPAN><STRONG>Monitor Response Codes</STRONG></H2> <UL> <LI class="task-list-item"><SPAN>&nbsp;</SPAN><CODE>200 OK</CODE>: Success (some logs may be dropped)</LI> <LI class="task-list-item"><CODE>204 No Content</CODE>: Success</LI> <LI class="task-list-item"><CODE>400 Bad Request</CODE>: Check payload structure</LI> <LI class="task-list-item"><CODE>401 Unauthorized</CODE>: The token is invalid</LI> <LI class="task-list-item"><CODE>402 Payment Required</CODE>:&nbsp;<SPAN>Failed. This is due either to the status of your licensing agreement or because you've exhausted your&nbsp;</SPAN><A class="_z2r50s3-1-8-0 _1v1skpy0-1-8-0 sc-3cdd2013-0 eccFTo" href="https://www.dynatrace.com/support/help/shortlink/dynatrace-platform-subscription" target="_blank" rel="noopener">DPS license</A><SPAN>.</SPAN></LI> <LI class="task-list-item"><SPAN><CODE>403 Forbidden</CODE>: The token lacks the proper permissions</SPAN></LI> <LI class="task-list-item"><CODE>404 Not Found</CODE>:&nbsp;<SPAN>Failed. The requested resource doesn't exist. This may happen when no ActiveGate is available with the Log Analytics Collector module enabled.</SPAN></LI> <LI class="task-list-item"><CODE>413 Payload Too Large</CODE>: Reduce payload size</LI> <LI class="task-list-item"><CODE>429 Too Many Requests</CODE>: Apply exponential backoff</LI> <LI class="task-list-item"><CODE>503 Service Unavailable</CODE>: Retry later</LI> </UL> <H2><BR />8.<SPAN>&nbsp;</SPAN><STRONG>Enable Semantic Attributes (Optional)</STRONG></H2> <UL> <LI class="task-list-item">Use attributes like<SPAN>&nbsp;</SPAN><CODE>host.name</CODE>,<SPAN>&nbsp;</SPAN><CODE>http.status_code</CODE>,<SPAN>&nbsp;</SPAN><CODE>dt.entity.service</CODE><SPAN>&nbsp;</SPAN>for enhanced querying.</LI> </UL> <H1>&nbsp;</H1> <H1><STRONG class="_wxp4dd0-1-8-0">Limitations</STRONG></H1> <P class="_487p2n0-1-8-0 _da9a8v0-1-8-0 _da9a8v2-1-8-0 _da9a8v3-1-8-0 _da9a8vb-1-8-0 sc-d1bf1c63-0 iVriGI">Please refer to the following documentation pages:</P> <DIV class="sc-afe78283-0 gGdaYh"> <UL class="_rup8ap0-1-8-0 _16276mt0-1-8-0"> <LI class="_16276mt1-1-8-0"><A class="_z2r50s3-1-8-0 _1v1skpy0-1-8-0 sc-3cdd2013-0 eccFTo" href="https://docs.dynatrace.com/docs/analyze-explore-automate/logs/lma-limits" target="_blank" rel="noopener">Grail tenant limits</A></LI> <LI class="_16276mt1-1-8-0"><A class="_z2r50s3-1-8-0 _1v1skpy0-1-8-0 sc-3cdd2013-0 eccFTo" href="https://docs.dynatrace.com/docs/analyze-explore-automate/log-monitoring/log-monitoring-limits" target="_blank" rel="noopener">LM v2 SaaS tenant limits</A></LI> <LI class="_16276mt1-1-8-0"><A class="_z2r50s3-1-8-0 _1v1skpy0-1-8-0 sc-3cdd2013-0 eccFTo" href="https://docs.dynatrace.com/managed/analyze-explore-automate/log-monitoring/log-monitoring-limits" target="_blank" rel="noopener">LM v2 Managed tenant limits</A></LI> </UL> </DIV> <P><EM>&nbsp;</EM></P> <H1>What's next</H1> <P>If this article did not help, please open a support ticket, mention that this article was used and provide the following information:</P> <DIV class="p-client_container"> <DIV class="p-ia4_client_container"> <DIV class="p-ia4_client p-ia4_client--with-search-in-top-nav p-ia4_client--workspace-switcher-rail-visibletest p-ia4_client--sidebar-wide p-ia4_client--narrow-feature-on"> <DIV class="p-client_workspace_wrapper" role="tabpanel" aria-label="Dynatrace"> <DIV class="p-client_workspace" role="tabpanel" aria-label="DMs"> <DIV class="p-client_workspace__layout"> <DIV class="active-managed-focus-container" role="none"> <DIV class="p-view_contents p-view_contents--primary" tabindex="-1" role="dialog" aria-label="Conversation with Anton Konikov"> <DIV class="tabbed_channel__Abx5r"> <DIV class="tabbed_channel__Abx5r"> <DIV class="channel_tab_panel__zJ5Bt c-tabs__tab_panel c-tabs__tab_panel--active c-tabs__tab_panel--full_height" role="none" data-qa="tabs_content_container"> <DIV class="p-file_drag_drop__container"> <DIV class="p-workspace__primary_view_body"> <DIV class="p-message_pane p-message_pane--classic-nav p-message_pane--scrollbar-float-adjustment p-message_pane--with-bookmarks-bar" data-qa="message_pane"> <DIV role="presentation"> <DIV class="c-virtual_list c-virtual_list--scrollbar c-message_list c-message_list--floating c-message_list--dark c-scrollbar c-scrollbar--fade" role="presentation"> <DIV class="c-scrollbar__hider" role="presentation" data-qa="slack_kit_scrollbar"> <DIV class="c-scrollbar__child" role="presentation"> <DIV class="c-virtual_list__scroll_container" tabindex="-1" role="list" data-qa="slack_kit_list" aria-label="Anton Konikov (direct message, active)"> <DIV id="1734101723.604509" class="c-virtual_list__item" tabindex="0" role="listitem" aria-setsize="-1" data-qa="virtual-list-item" data-item-key="1734101723.604509"> <DIV class="c-message_kit__background p-message_pane_message__message c-message_kit__message p-message_pane_message__message--last" role="presentation" data-qa="message_container" data-qa-unprocessed="false" data-qa-placeholder="false"> <DIV class="c-message_kit__hover" role="document" aria-roledescription="message" data-qa-hover="true"> <DIV class="c-message_kit__actions c-message_kit__actions--above"> <DIV class="c-message_kit__gutter"> <DIV class="c-message_kit__gutter__right" role="presentation" data-qa="message_content"> <DIV class="c-message_kit__blocks c-message_kit__blocks--rich_text"> <DIV class="c-message__message_blocks c-message__message_blocks--rich_text" data-qa="message-text"> <DIV class="p-block_kit_renderer" data-qa="block-kit-renderer"> <DIV class="p-block_kit_renderer__block_wrapper p-block_kit_renderer__block_wrapper--first"> <DIV class="p-rich_text_block" dir="auto"> <UL class="p-rich_text_list p-rich_text_list__bullet p-rich_text_list--nested" data-stringify-type="unordered-list" data-list-tree="true" data-indent="0" data-border="1" data-border-radius-top-cap="0"> <LI data-stringify-indent="0" data-stringify-border="1">Link to tenant</LI> <LI data-stringify-indent="0" data-stringify-border="1"><SPAN>API endpoint used&nbsp;</SPAN></LI> <LI data-stringify-indent="0" data-stringify-border="1"><SPAN>Responses to ingest requests including response codes and messages</SPAN></LI> </UL> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> </DIV> <H1><FONT size="4">More articles can be found on the</FONT></H1> <P>&nbsp;</P> <P><FONT size="3"><STRONG><A id="link_6" class="page-link lia-link-navigation lia-custom-event" href="https://community.dynatrace.com/t5/Troubleshooting/Logs-Troubleshooting-Map/ta-p/302260" target="_blank">Logs Troubleshooting Map</A></STRONG></FONT></P> </DIV> Thu, 20 Aug 2026 07:37:48 GMT noel_david 2026-08-20T07:37:48Z https://community.dynatrace.com/t5/Troubleshooting/Troubleshooting-log-Ingestion-via-API-POST-ingest-logs/ta-p/286608 <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 ticket 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 did not help.&nbsp;</EM><EM>Note that there are multiple options available, including:</EM></P> <OL> <LI><EM><STRONG>Opening a support ticket</STRONG> - be as specific as possible about the information the customer should include in the ticket.&nbsp;</EM> If this article did not help, please open a support ticket, mention that this article was used and provide the following in the ticket: <UL> <LI>link to XYZ</LI> <LI>screenshot of XYZ</LI> <LI>information about XYZ</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.</EM></LI> <LI><EM><STRONG>Explain this will change in the future</STRONG> - explain that this behaviour will change in a future release. (No product idea / support ticket needed)</EM></LI> <LI><EM><STRONG>Alternatives -</STRONG>&nbsp;any other actions or links to other articles that could move the customer forward.</EM></LI> </OL> <P>&nbsp;</P> <P><EM>*If it exists, link this article to the relevant troubleshooting map using the following guideline</EM></P> <H3>More articles can be found on the <A href="https://community.dynatrace.com/t5/Troubleshooting/" target="_self">XXX Troubleshooting Map</A></H3> </DIV> Thu, 20 Aug 2026 07:37:48 GMT https://community.dynatrace.com/t5/Troubleshooting/Troubleshooting-log-Ingestion-via-API-POST-ingest-logs/ta-p/286608 noel_david 2026-08-20T07:37:48Z