AWS EC2¶

Use the script package series of 「Guance Cloud Sync」in the script market to synchronize cloud monitoring and cloud asset data to Guance

Configuration¶

Install Func¶

It is recommended to enable Guance Integration - Extension - Managed Func: All prerequisites are automatically installed. Please proceed with script installation.

If you deploy Func on your own, refer to Self-deployed Func

Enable Script¶

Note: Please prepare an Alibaba Cloud AK in advance that meets the requirements (for simplicity, you can directly assign the global read-only permission ReadOnlyAccess).

Enable Script for Managed Version¶

1. Log in to Guance Console.
2. Click the 【Manage】 menu and select 【Cloud Account Management】.
3. Click 【Add Cloud Account】, select 【AWS】, and fill in the required information on the interface. If cloud account information has already been configured, skip this step.
4. Click 【Test】. After a successful test, click 【Save】. If the test fails, check whether the relevant configuration information is correct and retest.
5. In the 【Cloud Account Management】 list, you can see the added cloud accounts. Click the corresponding cloud account to enter the details page.
6. Click the 【Integration】 button on the cloud account details page. Under the Not Installed list, find AWS EC2, click the 【Install】 button, and install it via the pop-up installation interface.

Manually Enable Script¶

1. Log in to the Func Console, click 【Script Market】, enter the official script market, and search for: guance_aws_ec2.
2. After clicking 【Install】, input the corresponding parameters: AWS AK ID, AK Secret, and account name.
3. Click 【Deploy Start Script】, and the system will automatically create a Startup script set and configure the corresponding start scripts.
4. After enabling, you can see the corresponding automatic trigger configuration in "Management / Automatic Trigger Configuration". Click 【Execute】 to immediately execute once without waiting for the scheduled time. After a short while, you can view the execution task records and corresponding logs.

Verification¶

1. In "Management / Automatic Trigger Configuration", confirm whether the corresponding task has an automatic trigger configuration. You can also check the corresponding task records and logs for any abnormalities.
2. In Guance, under "Infrastructure / Custom", check if there is asset information.
3. In Guance, under "Metrics", check if there are corresponding monitoring data.

Metrics¶

After configuring Amazon-CloudWatch, the default metric sets are as follows. More metrics can be collected through configuration. Amazon Cloud Monitoring Metrics Details

Note: If you find that memory or disk metrics are not reported, go to the AWS console and 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 freely provided at a 1-minute frequency. For newly launched instances, status check metric data is only provided after the instance completes initialization (within a few minutes of entering the running state). For more information about EC2 status checks, see Instance Status Checks. | Metric | Description | | :----------------------------- | :----------------------------------------------------------- | |StatusCheckFailed|Reports whether the instance passed both 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 freely provided at a 1-minute frequency. Unit: Count| |StatusCheckFailed_Instance|Reports whether the instance passed the instance status check in the last minute. This metric can be 0 (passed) or 1 (failed). By default, this metric is freely provided 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 freely provided at a 1-minute frequency. Unit: Count|

Objects¶

The structure of the AWS EC2 object data collected 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: Fields in tags and fields may change with subsequent updates.

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