Collects security findings from AWS GuardDuty threat detection service to monitor malicious activity and unauthorized behavior across your AWS environment.
Sync Type: Incremental
Details
AWS GuardDuty is a threat detection service that continuously monitors your AWS accounts and workloads for malicious activity. This input connector retrieves security findings from all GuardDuty detectors in your AWS account.
Functionality
On each sync, Monad discovers all GuardDuty detectors in the specified region and, for each detector, retrieves findings at or above the configured minimum severity.
The input keeps a checkpoint per detector based on each finding's last-updated time (UpdatedAt), not its creation time.
On the first sync, if Backfill Start Time is not set, every finding GuardDuty still retains (up to 90 days) is fetched.
On later syncs, only findings updated after the checkpoint are collected.
Because GuardDuty updates a finding each time its activity recurs (incrementing Service.Count), the same finding can be emitted again with the same Id; deduplicate or upsert on Id downstream if you need one record per finding.
The checkpoint has no overlap window, so a finding whose UpdatedAt is at or before the checkpoint but becomes visible in GuardDuty only after a sync has run is not collected.
The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.
Settings
Setting
Type
Required
Default
Description
role_arn
string
No
-
The ARN of the IAM role to assume for accessing AWS resources.
Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs.
backfill_start_time
date
No
-
Date to start fetching findings from, in ISO 8601 format. If not specified, every finding GuardDuty still retains (up to 90 days) is fetched on the first sync. All syncs thereafter are incremental.
Secrets (Static Credentials Only)
Secret
Type
Required
Description
access_key
secret
No
The Access Key from AWS to authenticate with AWS
secret_key
secret
No
The Secret Key from AWS to authenticate with AWS
⚠️ Authentication: Choose either Role ARN (recommended) or static credentials. See AWS Authentication Guide for setup instructions.
By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes.
A cron schedule configured on the pipeline overrides this cadence.
See Input Sync Frequency for details.
Community transforms
The Monad Transforms Repository has ready-made transforms for this input.
Import one into your organization, then add it to a pipeline after this input.