Appearance

AWSインテグレーション - EC2 ​

MackerelはAWSインテグレーションにてAmazon Elastic Compute Cloud (Amazon EC2)のメトリック取得や監視に対応しています。 AWSインテグレーションで連携をおこなった場合、課金対象として 1インスタンス = 1スタンダードホスト と換算します。 AWSインテグレーションとmackerel-agentの併用も可能です。その場合、システムメトリックとカスタムメトリックはひとつのホストに統合されます（重複課金はされません）。

AWSインテグレーションの設定方法や対応AWSサービス一覧についてはこちらのページをご確認ください。 AWSインテグレーション

取得メトリック ​

AWSインテグレーションのEC2対応で取得できるメトリックは以下の通りです。 メトリック の説明に関してはAWSのヘルプをご確認ください。

最大で21個のメトリックが取得されます。

グラフ名メトリックMackerel上のメトリック名単位Statistics
CPUCPUUtilizationec2.cpu.usedpercentageAverage
CPU CreditCPUCreditUsage
CPUCreditBalance
CPUSurplusCreditBalance
CPUSurplusCreditsCharged		ec2.cpu_credit.used
ec2.cpu_credit.balance
ec2.cpu_credit.surplus_balance
ec2.cpu_credit.surplus_charged		floatAverage
Disk OPSDiskReadOps
DiskWriteOps		ec2.disk_ops.read
ec2.disk_ops.write		floatAverage
Disk IODiskReadBytes
DiskWriteBytes		ec2.disk_io.read
ec2.disk_io.write		bytesAverage
Network TrafficNetworkIn
NetworkOut		ec2.network.in
ec2.network.out		bytesAverage
Network PacketsNetworkPacketsIn
NetworkPacketsOut		ec2.network_packets.in
ec2.network_packets.out		floatAverage
Status Check FailedStatusCheckFailed_Instance
StatusCheckFailed_System
StatusCheckFailed		ec2.status_check_failed.instance
ec2.status_check_failed.system
ec2.status_check_failed.total		floatAverage
EBS OperationEBSReadOps *1
EBSWriteOps *1		ec2.ebs_operation.read
ec2.ebs_operation.write		integerSum
EBS Bytes UsedEBSReadBytes *1
EBSWriteBytes *1		ec2.ebs_bytes_used.read
ec2.ebs_bytes_used.write		bytesSum
EBS Burst Bucket BalanceEBSIOBalance% *1
EBSByteBalance% *1		ec2.ebs_burst_bucket_balance.io
ec2.ebs_burst_bucket_balance.throughput		percentageAverage
*1 Nitroベースのインスタンスで発生します。対象は[こちら](https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)をご確認ください。

注意事項

AWSインテグレーションにより取得可能な上記のグラフ・メトリックのうち、下記のグラフに含まれるメトリックについては、通常、5分間隔粒度でのメトリックが取得されます。

  • CPU
  • CPU Credit
  • Disk OPS
  • Disk IO
  • Network Traffic
  • Network Packets
  • EBS Operation
  • EBS Bytes Used
  • EBS Burst Bucket Balance

詳細モニタリングを有効化することで、下記のグラフに含まれるメトリックについては1分間隔粒度でのメトリックが取得されます。

  • CPU
  • Disk OPS
  • Disk IO
  • Network Traffic
  • EBS Operation
  • EBS Bytes Used

これは、AWS CloudWatch API の仕様です。

mackerel-agent との併用について ​

インテグレーションの対象となっているEC2インスタンスにmackerel-agentが導入されている場合、Mackerel上でホスト情報は自動的に統合され、ひとつのホストとして登録されます。課金対象ホストとして重複カウントされることはありません。

EC2の場合、AWSインテグレーションで簡易的な監視をおこない、より詳細な監視をおこないたい場合に、mackerel-agentを導入するのがおすすめです。