Amazon CloudWatch Agent
The Amazon CloudWatch Agent is software developed for the CloudWatch Agent
The Amazon CloudWatch Agent enables you to do the following:
- Collect more system-level metrics from Amazon EC2 instances across operating systems. The metrics can include in-guest metrics, in addition to the metrics for EC2 instances. The additional metrics that can be collected are listed in Metrics Collected by the CloudWatch Agent.
- Collect system-level metrics from on-premises servers. These can include servers in a hybrid environment as well as servers not managed by AWS.
- Retrieve custom metrics from your applications or services using the StatsD and collectd protocols. StatsD is supported on both Linux servers and servers running Windows Server. collectd is supported only on Linux servers.
- Collect logs from Amazon EC2 instances and on-premises servers, running either Linux or Windows Server.
Amazon CloudWatch Agent uses the open-source project telegraf as its dependency. It operates by starting a telegraf agent with some original plugins and some customized plugins.
Building and Running from source
Install go. For more information, see Getting started
The agent uses go modules for dependency management. For more information, see Go Modules
sudo yum install -y rpmdevtools rpm-build
make buildto build the CloudWatch Agent for Linux, Debian, Windows environment.
make releaseto build the agent. This also packages it into a RPM, DEB and ZIP package.
The following folders are generated when the build completes:
build/bin/linux/arm64/amazon-cloudwatch-agent.rpm build/bin/linux/amd64/amazon-cloudwatch-agent.rpm build/bin/linux/arm64/amazon-cloudwatch-agent.deb build/bin/linux/amd64/amazon-cloudwatch-agent.deb build/bin/windows/amd64/amazon-cloudwatch-agent.zip build/bin/darwin/amd64/amazon-cloudwatch-agent.tar.gz
Install your own build of the agent
rpm -Uvh amazon-cloudwatch-agent.rpm
dpkg -i -E ./amazon-cloudwatch-agent.deb
tar -xvf amazon-cloudwatch-agent.tar.gz
cp -rf ./opt/aws /opt
cp -rf ./Library/LaunchDaemons/com.amazon.cloudwatch.agent.plist /Library/LaunchDaemons/
Building and running container
The following targets are available. Each may be run with
||build using docker container without local go environment|
It is using Semantic versioning
You can download the official release from S3, refer to link
Nightly s3 release are not production ready and should be used at own risk
- Download Binaries
- Download Packages
Copyright (c) 2015-2019 InfluxData Inc. Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.