List Logs

Returns logs that match a log search query.

Use this action to build complex logs filtering and search.

This action may not work if your Datadog workspace does not have logs enabled.

caution

This action does not support OAuth connections.

External Documentation

To learn more, visit the Datadog documentation.

Basic Parameters

Parameter	Description
Indexes	For customers with multiple indexes, the indexes to search. Defaults to ['*'] which means all indexes.
Limit	Maximum number of logs in the response.
Query	The search query - following the log search syntax.

Advanced Parameters

Parameter	Description
From	The minimum time for the requested logs, supports date math and regular timestamps.
Timezone	The timezone can be specified both as an offset, for example: "UTC+03:00".
To	The maximum time for the requested logs, supports date math and regular timestamps.

Example Output

{
    "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.32Z"
            },
            "id": "AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA",
            "type": "log"
        },
        {
            "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.32Z"
            },
            "id": "AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA",
            "type": "log"
        }
    ],
    "links": {
        "next": "https://app.datadoghq.com/api/v2/logs/event?filter[query]=foo\u0026page[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"
            },
            {
                "code": "unknown_index",
                "detail": "indexes: foo, bar",
                "title": "One or several indexes are missing or invalid, results hold data from the other indexes"
            }
        ]
    }
}

Workflow Library Example

List Logs with Datadog and Send Results Via Email

Preview this Workflow on desktop