AWS Config Inventory
Fetches a full inventory snapshot of AWS resource configurations using AWS Config's SelectResourceConfig API.
Sync Type: Full Synchronisation
Details
AWS Config continuously records the configuration state of your AWS resources. This input queries AWS Config to retrieve a full snapshot of resource configurations for one or more resource types. Each record includes the resource's ID, type, ARN, account, region, configuration details, tags, and relationships.
Use this input to build an up-to-date asset inventory or to detect configuration drift in the AWS account and region you configure. The input queries the configuration recorder of the authenticated account in the selected region only. It does not query AWS Config aggregators, so to cover several accounts or regions, create one input per account and region.
Functionality
On each run, Monad sends a single AWS Config query covering every resource type listed in Resource Types, pages through the combined results, and emits one record per resource.
Resources with a configurationItemStatus of ResourceNotRecorded are skipped.
Every run is a full snapshot: all matching resources are emitted again on each sync.
If AWS Config rejects a page token as invalid partway through a run, the input restarts the query from the first page, so some resources can be emitted more than once in that run.
Requirements
- AWS Config must be enabled with an active configuration recorder in the target region.
- IAM Role Assumption / Static Credentials
- The authenticated principal must have the following IAM permission:
Code
Configuration
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
region | string | Yes | - | The AWS region to query AWS Config in. Allowed values: us-east-1, us-east-2, us-west-1, us-west-2, af-south-1, ap-east-1, ap-south-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-southeast-1, ap-southeast-2, ca-central-1, ca-west-1, cn-north-1, cn-northwest-1, eu-central-1, eu-west-1, eu-west-2, eu-west-3, eu-north-1, eu-south-1, me-south-1, sa-east-1, us-gov-east-1, us-gov-west-1. |
auth_config | one of | Yes | - | Authentication method for accessing AWS Config. |
resource_types | array of string | Yes | [] | AWS Config resource type strings to query (e.g. "AWS::EC2::Instance", "AWS::S3::Bucket"). At least one is required. |
cron | string (cron) | Yes | 0 * * * * | Cron string for scheduling the ingest of your input. eg: 0 0 * * * - Daily at midnight, or */15 * * * * - Every 15 minutes. Defaults to an hour. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
IAM Role (recommended)
| Field | Type | Required | Description |
|---|---|---|---|
| Role ARN | string | Yes | ARN of the IAM role to assume (e.g. arn:aws:iam::123456789012:role/MyRole). |
Static Credentials
| Field | Type | Required | Description |
|---|---|---|---|
| Access Key | secret | Yes | AWS access key ID. |
| Secret Key | secret | Yes | AWS secret access key. |
Authentication: Choose either Role ARN (recommended) or static credentials. See AWS Authentication Guide for setup instructions.
Resource Types
The Resource Types field accepts AWS Config resource type strings of the form AWS::<Service>::<ResourceType> (for example AWS::EC2::Instance).
Values in any other form are rejected when you save the input.
The full list of supported resource types is maintained by AWS:
Common examples:
| Resource Type | Description |
|---|---|
AWS::EC2::Instance | EC2 instances |
AWS::EC2::SecurityGroup | EC2 security groups |
AWS::EC2::VPC | VPCs |
AWS::S3::Bucket | S3 buckets |
AWS::IAM::Role | IAM roles |
AWS::IAM::User | IAM users |
AWS::IAM::Policy | IAM policies |
AWS::RDS::DBInstance | RDS database instances |
AWS::Lambda::Function | Lambda functions |
AWS::EKS::Cluster | EKS clusters |
AWS::KMS::Key | KMS keys |
AWS::CloudTrail::Trail | CloudTrail trails |
Related Articles
Sample Record
Code
Sync frequency
This input runs on a cron schedule (default hourly, 0 * * * *), which you can configure on the pipeline.
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.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | AWS Config Resource Inventory to OCSF v1.9.0 |
| ECS v9.5.0 | AWS Config Resource Inventory to ECS v9.5.0 |
| CEF | AWS Config Resource Inventory to CEF |
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.