v1
latestOpenAPI 3.0.02026-07-142351,1971.3 MBLogs
Send logs
Send your logs to your Datadog platform over HTTP. Limits per HTTP request are:
- Maximum content size per payload (uncompressed): 5MB
- Maximum size for a single log: 1MB
- Maximum array size if sending multiple logs in an array: 1000 entries
Any log exceeding 1MB is accepted and truncated by Datadog:
- For a single log request, the API truncates the log at 1MB and returns a 2xx.
- For a multi-logs request, the API processes all logs, truncates only logs larger than 1MB, and returns a 2xx.
Datadog recommends sending your logs compressed. Add the Content-Encoding: gzip header to the request when sending compressed logs.
The status codes answered by the HTTP API are:
- 200: OK
- 400: Bad request (likely an issue in the payload formatting)
- 403: Permission issue (likely using an invalid API Key)
- 413: Payload too large (batch is above 5MB uncompressed)
- 5xx: Internal error, request should be retried after some time
post/v1/input
Query parameters
ddtagsstring
Log tags can be passed as query parameters with text/plain content type.
Headers
Content-Encoding'gzip' | 'deflate'
HTTP header used to compress the media-type.
HTTP header used to compress the media-type.
Request body
Example request
[
{
"ddsource": "nginx",
"ddtags": "env:staging,version:5.1",
"hostname": "i-012345678",
"message": "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World",
"service": "payment"
}
]Response
Response from server (always 200 empty JSON).
object required