Configuring Agent Properties

Setting AWS Connection (mandatory)

  • Region – The region for the AWS Hosts to be monitored. Region information for accounts and instances can be found through the AWS Console. NOTE: This differs from the Availability Zone, which will end in a letter. An explanation of these and related terms can be found here. An agent can only monitor instances in a single region, so additional agents will need to be created if multiple regions are used.
  • Access Key ID – Access Key ID of the IAM user created during pre-configuration or existing user with necessary attached policies.
  • Secret Access Key – Secret access key for the user described above.
  • EC2 Instances – List of EC2 Instances to monitor.
    • Instance ID – Unique identifier for an EC2 instance. It can be found through the EC2 Instances dashboard. Will be a single alphanumeric string prefixed with “i-.”
    • Display Name (optional) – An optional display name that will be associated with the EC2 instance and appear in Foglight dashboards. If one is not provided, the agent will find and use the value for the “Name” tag associated with the instance. If that does not exist, the instance ID will be used.
  • RDS Instances (non-Aurora) – List of non-Aurora RDS Instances to monitor.
    • DB Instance ID – Unique DB Identifier for an RDS instance. It can be found through the RDS Databases dashboard.
    • Display Name (optional) – An optional display name that will be associated with the RDS instance and appear in Foglight dashboards. If one is not provided, the agent will use the DB Instance ID.
  • RDS Aurora Clusters – List of Aurora RDS Clusters to monitor. Instances belonging to the cluster will be automatically discovered and do not need to be specified here.
    • DB Instance ID – Unique DB Identifier for an Aurora cluster. It can be found through the RDS Databases dashboard.
    • Display Name (optional) – An optional display name that will be associated with the Aurora cluster and appear in Foglight dashboards. If one is not provided, the agent will use the DB Instance ID.

Setting Collection Periods (optional)

The Collection Period fields in the agent properties are used to set the sample frequencies. CloudWatch metrics will always be collected in 5-minute segments.

  • EC2 – Period for EC2 instance using the EC2 API. Set to 300 seconds by default.
  • RDS – Period for RDS instance collections using the RDS API. Set to 300 seconds by default.
  • Aurora – Period for Aurora cluster collections using the RDS API. Set to 300 seconds by default.