View as Markdown
Datadog icon

Datadog ACTION

List Logs

Get a list of logs matching a filter query. Uses the GET endpoint with a higher rate limit (3600/hr vs 300/hr). See the docs
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Datadog account once, then configure and run List Logs from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "datadog-list-logs",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    datadog: { authProvisionId: "apn_xxxxxxx" },
    region: "Region",
    query: "Query",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Logs inputs
Property Type Description
region Region string
The regional site for a Datadog customer
Required
query Query string
Search query following log search syntax. E.g. service:web-app status:error
Required
from From string
Minimum timestamp for requested logs. Supports ISO-8601 strings or epoch milliseconds. Defaults to 15 minutes ago.
Optional
to To string
Maximum timestamp for requested logs. Supports ISO-8601 strings or epoch milliseconds. Defaults to now.
Optional
indexes Indexes string[]
List of log index names to search. Defaults to all indexes.
Optional
limit Max Results integer
Maximum number of logs to return per page. Default 10, max 1000.
Optional
sort Sort string
Sort order for results.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
datadog-list-logs
Version
0.0.1
App
Datadog
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes