Help Center/ Auto Scaling/ User Guide (ME-Abu Dhabi Region)/ FAQs/ AS Policy/ How Can I Install the Agent Plug-in on the Instances in an AS Group to Use Agent Monitoring Metrics?
Updated on 2022-02-22 GMT+08:00

How Can I Install the Agent Plug-in on the Instances in an AS Group to Use Agent Monitoring Metrics?

Scenarios

When the scaling policy of an AS group is alarm-triggered, you can use Agent monitoring metrics to trigger scaling actions. Compared with basic monitoring, Agent monitoring provides system-level, proactive, and fine-grained monitoring services for instances. Before using Agent monitoring metrics, make sure that the Agent plug-in has been installed on the instances in the AS group. For details, see this section.

Procedure

  1. Log in to the management console and click Elastic Cloud Server under Computing.

    The Elastic Cloud Server page is displayed.

  2. Create an ECS and install the Agent plug-in.

    To install the plug-in, see .

  3. After installing the Agent plug-in, log in to the Cloud Eye console, choose Server Monitoring > Elastic Cloud Server, and ensure that the plug-in is running and that the Agent monitoring metrics can be collected.
    Figure 1 Checking the plug-in status
    Figure 2 Viewing Agent monitoring metrics
  4. Add the AK/SK to the ECS conf.json configuration file.
    1. Click the username, choose My Credentials > Access Keys, obtain the AK/SK.
      • If you have obtained the access key, obtain the AK/SK in the credentials.csv file saved when you created Access Keys.
      • If Access Keys is not available, click Create Access Key to create one. Then, save the credentials.csv file and obtain the AK/SK in it.
    2. Log in to the ECS and run the cd /usr/local/telescope/bin command to go to the Agent installation directory.
    3. Run the vi conf.json command to open the configuration file and enter the obtained AK/SK.

      If the Agent has been installed during ECS creation, the AK/SK has been added during user data injection. You only need to check the AK/SK in this step.

    4. Press Esc and enter :wq to save and exit the configuration file.
  5. Go to the Image Management Service page and use this ECS to create a private image. For details, see Creating a Private Image.
    Figure 3 Creating a private image
  6. Go to the Auto Scaling page and use the private image created in step 5 to create an AS configuration.
    Figure 4 Selecting the private image

    Click Private image for Image, select ces-agent-test from the drop-down list, and set other parameters as required.

  7. Create an AS group and associate the AS configuration created in step 6 with the AS group.
  8. Add an AS policy for the AS group: Set Policy Type to Alarm and Trigger Condition to an Agent monitoring metric, such as (Agent) Memory Usage.
    Figure 5 Selecting a trigger condition
  9. Manually add the ECS created in step 2 to the AS group.
  10. Perform the following operations to check whether the Agent monitoring metric takes effect:
    • Verify that the Agent monitoring metric is displayed on the Monitoring tab of the page providing details about the AS group.
    • When the alarm threshold is reached, verify that the alarm policy is triggered on the Scaling Actions tab of the page providing details about the AS group and that instances are added for capacity expansion.
    • The Agent monitoring data is available for all instances that are automatically added to the AS group.