v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Logs

Search logs (GET)

List endpoint returns logs that match a log search query. Results are paginated.

Use this endpoint to search and filter your logs.

If you are considering archiving logs for your organization, consider use of the Datadog archive capabilities instead of the log list API. See Datadog Logs Archive documentation.

get/api/v2/logs/events

Query parameters

filter[query]string

Search query following logs syntax.

filter[indexes]string[]

For customers with multiple indexes, the indexes to search. Defaults to '*' which means all indexes

filter[from]string date-time

Minimum timestamp for requested logs.

filter[to]string date-time

Maximum timestamp for requested logs.

filter[storage_tier]'indexes' | 'online-archives' | 'flex'

Specifies storage type as indexes, online-archives or flex

Example:indexes

Specifies the storage type to be used

sort'timestamp' | '-timestamp'

Sort parameters when querying logs.

Order of logs in results.

page[cursor]string

List following results with a cursor provided in the previous query.

page[limit]integer

Maximum number of logs in the response.

Response

Example response

{
  "data": [
    {
      "attributes": {
        "attributes": {
          "customAttribute": 123,
          "duration": 2345
        },
        "host": "i-0123",
        "message": "Host connected to remote",
        "service": "agent",
        "status": "INFO",
        "tags": [
          "team:A"
        ],
        "timestamp": "2019-01-02T09:42:36.320Z"
      },
      "id": "AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA",
      "type": "log"
    }
  ],
  "links": {
    "next": "https://app.datadoghq.com/api/v2/logs/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ=="
  },
  "meta": {
    "elapsed": 132,
    "page": {
      "after": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ=="
    },
    "request_id": "MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR",
    "status": "done",
    "warnings": [
      {
        "code": "unknown_index",
        "detail": "indexes: foo, bar",
        "title": "One or several indexes are missing or invalid, results hold data from the other indexes"
      }
    ]
  }
}