View as Markdown
AWS icon

AWS TRIGGER

New Records Returned by CloudWatch Logs Insights Query

Executes a CloudWatch Logs Insights query on a schedule, and emits the records as invidual events (default) or in batch
  • Trigger
  • Polling
  • API key
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's AWS account, configure the source, and choose the webhook where your backend receives events.

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 deployed = await pd.triggers.deploy({
  id: "aws-new-records-returned-by-cloudwatch-logs-insights-query",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    aws: { authProvisionId: "apn_xxxxxxx" },
    region: "AWS Region",
    logGroupNames: ["CloudWatch Log Groups"],
  },
  webhookUrl: "https://example.com/webhooks/aws",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New Records Returned by CloudWatch Logs Insights Query configuration
Property Type Description
region AWS Region string
The AWS region
Required Dynamic
logGroupNames CloudWatch Log Groups string[]
The log groups you'd like to query
Required Dynamic
queryString Logs Insights Query string
The query you'd like to run. See this AWS doc for help with query syntax
Required
emitResultsInBatch Emit query results as a single event boolean
If true, all events are emitted as an array, within a single Pipedream event. If false, each row of results is emitted as its own event. Defaults to true
Optional
timer Polling schedule $.interface.timer
How often you want to query CloudWatch Logs Insights for results
Required

01

Connect

Your user authorizes AWS through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
aws-new-records-returned-by-cloudwatch-logs-insights-query
Version
0.2.3
App
AWS
Authentication
API key
Delivery
Polling source
Output
Events emitted by AWS.