AWS TRIGGER
New Records Returned by CloudWatch Logs Insights Query
- 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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "aws-new-records-returned-by-cloudwatch-logs-insights-query",
"webhook_url": "https://example.com/webhooks/aws",
"configured_props": {
"aws": { "authProvisionId": "apn_xxxxxxx" },
"region": "AWS Region",
"logGroupNames": ["CloudWatch Log Groups"]
}
}'MCP servers expose AWS actions as on-demand tools.
New Records Returned by CloudWatch Logs Insights Query is an event source, so your application deploys it
with the Connect SDK or API and then either receives each event at a
webhook URL or retrieves events on demand with the trigger events API.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.
| 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 |
LIFECYCLE
Event delivery
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.
REFERENCE
Trigger details
- 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.
- Source
- View on GitHub ↗