Atlas Agent Configuration

agent

agent attributes

Name and description	Required	Value
token Atlas Cloud bot token to authenticate.	false	string

agent blocks

agent.log

Logging configuration for the agent.

agent.log attributes

Name and description	Required	Value
format Log output format.	false	enum (TEXT, JSON)
level Log level for agent logs.	false	enum (DEBUG, INFO, WARN, ERROR)

agent.metrics

Configuration for metrics collection and reporting.

agent.metrics attributes

Name	Required	Value
enabled	false	bool
port	false	int

data rds_discovery

The rds_discovery data source calls the AWS RDS API to retrieve a list of available RDS instances and clusters.

data "rds_discovery" "prod" {
  region = "us-east-1"
  roles  = [
    "arn:aws:iam::123456789012:role/AtlasRDSRole", 
    "arn:aws:iam::123456789012:role/AnotherAtlasRDSRole",
  ]
  filter {
	tags = {
      Environment = "production"
    }
    name_regex = ".*-prod$"
  }
}

data.rds_discovery attributes

Name and description	Required	Value
region AWS region to query for RDS instances.	true	string
roles List of IAM role ARNs to assume when accessing AWS RDS API.	false	List of strings

data.rds_discovery blocks

data.filter

Filter to apply when discovering RDS instances.

data.filter attributes

Name and description	Required	Value
exclude_name_regex Regular expression to skip matching instance names.	false	string
exclude_tags Exclude instances matching these tags.	false	map
name_regex Regular expression to include mathing instance names.	false	string
tags Tags to filter by.	false	map

instance

Database instance configuration.

instance attributes

Name and description	Required	Value
driver Database driver name.	true	enum (azuresql, clickhouse, databricks, libsql, libsql+file, libsql+ws, libsql+wss, maria, maria+unix, mariadb, mariadb+unix, mssql, mysql, mysql+unix, oracle, postgres, postgresql, redshift, redshift+http, snowflake, spanner, sqlite, sqlite3, sqlserver, aurora-mysql, aurora-postgresql)
name Human friendly name for the instance.	false	string
slug Unique identifier for the instance.	false	string
tags Optional tags to organize and categorize instances.	false	map

instance blocks

instance.connection

Connection settings for the instance.

instance.connection attributes

Name and description	Required	Value
database Default database name.	false	string
host Database host address.	false	string
path the path for the database.	false	string
port Database port number.	false	int
query Connection query parameters.	false	map
user Database user name.	false	string

instance.connection blocks

instance.connection.auth

Authentication configuration for connections.

instance.connection.auth blocks

instance.connection.auth.aws_iam

AWS IAM authentication settings.

instance.connection.auth.aws_iam attributes

Name and description	Required	Value
assume_role IAM role to assume for token retrieval.	false	string
endpoint AWS RDS endpoint.	true	string
region AWS region for the RDS IAM endpoint.	true	string

instance.connection.auth.aws_secrets_manager

AWS Secrets Manager authentication settings.

instance.connection.auth.aws_secrets_manager attributes

Name and description	Required	Value
key Key in the secret JSON object that contains the password.	false	string
name Name of the secret in AWS Secrets Manager.	true	string
region AWS region where the secret is stored.	true	string

instance.connection.auth.env_var

Reading database password from an environment variable.

instance.connection.auth.env_var constraints

Constraint	Value
Required	false
Require Name (e.g., instance.connection.auth.env_var "name" )	true

instance.connection.auth constraints

Constraint	Value
Required	false
Require Name	false
Mutually exclusive sets	[env_var, aws_iam, aws_secrets_manager]
One of required sets	[env_var, aws_iam, aws_secrets_manager]

instance.connection constraints

Constraint	Value
Required	true
Require Name	false

instance.default_monitor

A default_monitor block configures the default monitoring settings for all databases and schemas in the instance. Individual monitor blocks can be used to override these settings for specific databases or schemas.

instance.default_monitor attributes

Name and description	Required	Value
database Default database for monitoring.	false	string
exclude List of exclusion patterns.	false	List of strings
exclude_databases List of databases to exclude from default monitoring.	false	List of strings
include List of inclusion patterns.	false	List of strings
initial_database Initial database to connect to in order to fetch a list of available databases.	false	string
schemas List of schemas to monitor.	false	List of strings
snapshot_interval The interval at which snapshots are taken, e.g. 1h, 1d. Minimum is 1m.	false	string

instance.default_monitor blocks

instance.default_monitor.statistics

Default statistics collection settings.

instance.default_monitor.statistics attributes

Name and description	Required	Value
enabled Enable or disable default statistics collection.	true	bool

instance.default_monitor constraints

Constraint	Value
Required	false
Require Name (e.g., instance.default_monitor "name" )	true

instance.monitor

Monitoring configuration for a specific database or schema.

instance.monitor attributes

Name and description	Required	Value
database Database to monitor.	false	string
exclude List of exclusion patterns.	false	List of strings
include List of inclusion patterns.	false	List of strings
schemas List of schemas to monitor.	false	List of strings
snapshot_interval The interval at which snapshots are taken, e.g. 1h, 1d. Minimum is 1m.	false	string

instance.monitor blocks

instance.monitor.statistics

Statistics collection settings.

instance.monitor.statistics attributes

Name and description	Required	Value
enabled Enable or disable statistics collection.	true	bool

instance.monitor constraints

Constraint	Value
Required	false
Require Name (e.g., instance.monitor "name" )	true

instance constraints

Constraint	Value
Required	false
Require Name	false
Repeatable	true
One of required sets	[monitor, default_monitor]