AWS EC2¶

Use the "TrueWatch Cloud Sync" script package in the script market to synchronize cloud monitoring and cloud asset data to TrueWatch

Configuration¶

Install Func¶

It is recommended to activate the TrueWatch Integration - Extensions - DataFlux Func (Automata): All prerequisites are automatically installed, please proceed with the script installation.

If you are deploying Func manually, refer to Manual Deployment of Func

Activate Script¶

Note: Please prepare the required Amazon AK in advance (for simplicity, you can directly grant global read-only permissions ReadOnlyAccess)

Activate Script in DataFlux Func (Automata)¶

1. Log in to the TrueWatch console
2. Click the 【Integration】 menu and select 【Cloud Account Management】
3. Click 【Add Cloud Account】, select 【AWS】, and fill in the required information on the interface. If you have already configured the cloud account information before, ignore this step
4. Click 【Test】, and after a successful test, click 【Save】. If the test fails, please check if the relevant configuration information is correct and test again
5. Click 【Cloud Account Management】, and you can see the added cloud account in the list. Click the corresponding cloud account to enter the details page
6. Click the 【Integration】 button on the cloud account details page, find AWS EC2 under the Not Installed list, and click the 【Install】 button to install it in the pop-up installation interface.

Activate Script Manually¶

1. Log in to the Func console, click on 【Script Market】, enter the TrueWatch script market, and search for: integration_aws_ec2

2. Click on 【Install】, and enter the corresponding parameters: AWS AK ID, AK Secret, and account name.

3. Click on 【Deploy Startup Script】, the system will automatically create a Startup script set and automatically configure the corresponding startup script.

4. After activation, you can see the corresponding automatic trigger configuration in 「Management / Automatic Trigger Configuration」. Click on 【Execute】 to execute it immediately without waiting for the scheduled time. After a while, you can view the execution task records and corresponding logs.

Verification¶

1. In 「Management / Automatic Trigger Configuration」, confirm whether the corresponding task has the corresponding automatic trigger configuration, and you can also check the corresponding task records and logs to see if there are any exceptions.
2. In TrueWatch, check whether the asset information exists in 「Infrastructure / Custom」.
3. In TrueWatch, check whether there is corresponding monitoring data in 「Metrics」.

Metrics¶

After configuring Amazon Cloud Monitoring, the default Measurement is as follows, and more Metrics can be collected through configuration Amazon Cloud Monitoring Metrics Details

Note: If you find that memory and disk Metrics are not reported, go to the AWS console to manually enable collection.

Instance Metrics¶

The AWS/EC2 namespace includes the following instance Metrics.

CPU Metrics¶

The AWS/EC2 namespace includes the following CPU credit Metrics for Burstable Performance Instances.

Status Check Metrics¶

The AWS/EC2 namespace includes the following status check Metrics. By default, status check Metrics are provided free of charge at a 1-minute frequency. For newly launched instances, status check Metric data is only provided after the instance completes the initialization state (a few minutes after the instance enters the running state). For more information on EC2 status checks, see Status Checks for Your Instances. | Metric | Description | | :----------------------------- | :----------------------------------------------------------- | |StatusCheckFailed|Reports whether the instance passed the instance status check and the system status check in the last minute. This Metric can be 0 (passed) or 1 (failed). By default, this Metric is provided free of charge at a 1-minute frequency. Unit: Count| |StatusCheckFailed_Instance|Reports whether the instance passed the instance status check in the last 1 minute. This Metric can be 0 (passed) or 1 (failed). By default, this Metric is provided free of charge at a 1-minute frequency. Unit: Count| |StatusCheckFailed_System|Reports whether the instance passed the system status check in the last minute. This Metric can be 0 (passed) or 1 (failed). By default, this Metric is provided free of charge at a 1-minute frequency. Unit: Count|

Objects¶

The collected AWS EC2 object data structure can be seen in 「Infrastructure - Custom」

{
  "measurement": "aws_ec2",
  "tags": {
    "name"           : "i-0d7620xxxxxxx",
    "InstanceId"     : "i-0d7620xxxxxxx",
    "InstanceType"   : "c6g.xlarge",
    "PlatformDetails": "Linux/UNIX",
    "RegionId"       : "cn-northwest-1",
    "InstanceName"   : "test",
    "State"          : "running",
    "StateReason_Code"   : "Client.UserInitiatedHibernate",
    "AvailabilityZone": "cn-northwest-1",
  },
  "fields": {
    "BlockDeviceMappings": "{Device JSON Data}",
    "LaunchTime"         : "2021-10-26T07:00:44Z",
    "NetworkInterfaces"  : "{Network JSON Data}",
    "Placement"          : "{Availability Zone JSON Data}",
    "message"            : "{Instance JSON Data}"
  }
}

Note: The fields in tags and fields may change with subsequent updates.

Tip 1: The value of tags.name is the instance ID, which is used as a unique identifier Tip 2: fields.message, fields.NetworkInterfaces, fields.BlockDeviceMappings are JSON serialized strings