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 - Hosted Func: all prerequisites are automatically installed. Please proceed with the script installation.

If you deploy Func yourself, refer to Self-deploy Func

Enable Script¶

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

Hosted Version Script Activation¶

1. Log in to Guance Console
2. Click on the 【Integration】 menu, select 【Cloud Account Management】
3. Click 【Add Cloud Account】, choose 【AWS】, fill in the required information on the interface; if cloud account information has been configured before, skip this step
4. Click 【Test】, after the test is successful, click 【Save】. If the test fails, check whether the related configuration information is correct and retest.
5. In the 【Cloud Account Management】 list, you can see the added cloud accounts. Click on 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 from the pop-up installation interface.

Manual Script Activation¶

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 Startup Script】, the system will automatically create a Startup script set and configure the corresponding startup script automatically.
4. After enabling, you can see the corresponding automatic trigger configuration under 「Management / Automatic Trigger Configuration」. Click 【Execute】 to run 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 there is an automatic trigger configuration corresponding to the task. You can also check the task records and logs for any abnormalities.
2. In Guance, 「Infrastructure / Custom」, check if there is any asset information.
3. In Guance, 「Metrics」, check if there are corresponding monitoring data.

Metrics¶

After configuring Amazon-CloudWatch, the default measurement sets are as follows. You can collect more metrics through configuration Amazon CloudWatch 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 available free of charge at a frequency of 1 minute. For newly launched instances, status check metric data is only available 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 available free of charge at a frequency of 1 minute. Units: 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 available free of charge at a frequency of 1 minute. Units: 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 available free of charge at a frequency of 1 minute. Units: Count|

Objects¶

The collected AWS EC2 object data structure can be viewed 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 for unique identification. Tip 2: fields.message, fields.NetworkInterfaces, fields.BlockDeviceMappings are JSON serialized strings.