Skip to main content

Atlas Agent Configuration

agent

agent attributes

NameRequiredValue
cloud_urlfalsestring
tokenfalsestring

agent blocks

agent.log

agent.log attributes
NameRequiredValue
formatfalse

enum (TEXT, JSON)

levelfalse

enum (DEBUG, INFO, WARN, ERROR)

instance

instance attributes

Name and descriptionRequiredValue
drivertrue

enum (azuresql, clickhouse, databricks, docker, docker+clickhouse, docker+maria, docker+mariadb, docker+mysql, docker+oracle, docker+postgres, docker+spanner, docker+sqlserver, libsql, libsql+file, libsql+ws, libsql+wss, maria, maria+unix, mariadb, mariadb+unix, mssql, mysql, mysql+unix, oracle, postgres, postgresql, redshift, redshift+http, resource+dev, resource+docker, snowflake, spanner, sqlite, sqlite3, sqlserver, aurora-mysql, aurora-postgresql)

name

Human friendly name for the instance.

falsestring

slug

Unique identifier for the instance.

falsestring

instance blocks

instance.connection

instance.connection attributes
NameRequiredValue
databasefalsestring
hosttruestring
portfalseint
queryfalsemap
usertruestring
instance.connection blocks

instance.connection.auth

instance.connection.auth blocks

instance.connection.auth.aws_iam

instance.connection.auth.aws_iam attributes
NameRequiredValue
assume_rolefalsestring
endpointtruestring
regiontruestring

instance.connection.auth.env_var

instance.connection.auth.env_var constraints
ConstraintValue
Requiredfalse
Require Name (e.g., instance.connection.auth.env_var "name" )true
instance.connection.auth constraints
ConstraintValue
Requiredtrue
Require Namefalse
Mutually exclusive sets[env_var, aws_iam]
One of required sets[env_var, aws_iam]
instance.connection constraints
ConstraintValue
Requiredtrue
Require Namefalse

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 descriptionRequiredValue
databasefalsestring
excludefalse

List of strings

exclude_databases

List of databases to exclude from monitoring, e.g. 'rdsadmin' for RDS instances.

false

List of strings

includefalse

List of strings

schemasfalse

List of strings

snapshot_interval

The interval at which snapshots are taken, e.g. 1h, 1d, etc.Minimum allowed value is 1m (1 minute).

falsestring
instance.default_monitor blocks

instance.default_monitor.statistics

instance.default_monitor.statistics attributes
NameRequiredValue
enabledtruebool
instance.default_monitor constraints
ConstraintValue
Requiredfalse
Require Name (e.g., instance.default_monitor "name" )true

instance.monitor

instance.monitor attributes
NameRequiredValue
databasefalsestring
excludefalse

List of strings

includefalse

List of strings

schemasfalse

List of strings

snapshot_intervalfalsestring
instance.monitor blocks

instance.monitor.statistics

instance.monitor.statistics attributes
NameRequiredValue
enabledtruebool
instance.monitor constraints
ConstraintValue
Requiredfalse
Require Name (e.g., instance.monitor "name" )true

instance constraints

ConstraintValue
Requiredfalse
Require Namefalse
Repeatabletrue
One of required sets[monitor, default_monitor]