紹介

1. 概要

exemone-cloud-agentは、AWS、Azureクラウドリソースをモニタリングするエージェントです。

1.2. 主要機能​

• AWS CloudWatch及びAzure Monitorベースのパフォーマンス指標収集
• クラウドアカウントのリソース一覧の自動照会及び更新
• 管理型データベースの状態・セッション・SQL・待機・ストレージなど詳細指標の収集
• AWS CloudWatch Alarm、CloudWatch Logs、Live Tail及びEnhanced Monitoringデータ収集
• AWS Cost Explorerベースのコストデータ収集
• Receiverから伝達された設定及びコマンドの照会処理
• エージェント状態報告、時刻補正、設定更新及び接続障害復旧
• 収集周期、タイムアウト、DBコネクションプール、gRPCメッセージサイズ、ログローテーション設定サポート

2. パッケージ

2.1. binaryパッケージ​

• パッケージ名: exemone-cloud-agent-{version}.tar.gz
• binaryパッケージを解凍すると生成されるパッケージ構造

1.3.1. conf​

• agentのconfigを設定するためのファイル

1.3.2. license​

• agentのライセンスファイル

1.3.3. logs​

• agentログファイルが配置されます
  • agent.log : 基本ログファイル
  • panic.log : panic発生時に生成されるログファイル

1.3.4. history.txt​

• script実行履歴を保存します。

1.3.5. .env​

• install時に使用するバージョン情報を入力するファイルです。

1.3.6. setup.sh, start.sh, stop.sh, version.sh​

• エージェント起動に使用するスクリプトです。

2.2. Containerイメージ​

• Linux AMD64及びARM64用のコンテナイメージを提供します。
• 実行バイナリはコンテナの/usr/local/bin/exemone-cloud-agentに配置されます。
• 基本設定テンプレートは/opt/exemone/configsに含まれ、ユーザー設定とログは/home/exemoneボリュームを通じて管理します。
• コンテナは基本的にexemone一般ユーザー権限で実行されます。

3. 動作

1. cloud-agentがagent_id、access_token、Receiverアドレスと実行環境情報を使用してReceiverに登録を要求します。
2. Receiverからクラウドアカウント、認証情報、モニタリング対象、収集指標及び周期設定を伝達されます。
3. アカウント別にAWSまたはAzureリソース一覧を照会し、インスタンス別の収集作業を生成します。
4. AWS API・CloudWatch・CloudWatch Logs・Cost Explorer、Azure Resource Manager・Azure Monitorまたは管理型DBエンドポイントからデータを収集します。
5. 収集データとエージェント状態をgRPCストリーム及び同期要求を通じてReceiverに送信します。
6. 設定変更やReceiver接続状態を検知すると、収集作業と通信を自動的に更新または復旧します。

4. サポート環境

4.1. 実行環境​

Goランタイムは実行バイナリに含まれるため、運用サーバーにGoを別途インストールする必要はありません。

4.2. AWS​

現在cloud-agentの収集モジュールは次のAWSサービスをサポートします。

• Amazon EC2及びVPC
• Amazon RDS及びAmazon Aurora
• Amazon ElastiCache
• Amazon DocumentDB
• Amazon Redshift
• Amazon DynamoDB
• AWS Lambda
• Amazon S3
• AWS Database Migration Service (DMS)
• Amazon Elastic Container Service (ECS) [正式モニタリング対象外]

付加機能としてCloudWatch Alarm・Logs・Enhanced MonitoringとCost Explorerコストデータ収集をサポートします。実際に収集可能な項目は、サービス設定、リージョン、エンジン種類、CloudWatch指標の有効化有無及びIAM権限によって異なる場合があります。

4.3. Microsoft Azure​

現在cloud-agentの収集モジュールは次のAzureサービスをサポートします。

• Azure Virtual Machines
• Azure Functions
• Azure Blob Storage
• Azure SQL Database
• Azure Cache for Redis
• Azure Managed Redis(旧Azure Cache for Redis Enterprise)
• Azure Cosmos DB

実際に収集可能な項目は、サブスクリプション・リソースグループ・リソースプロバイダー設定、Azure Monitor指標の提供有無及びサービスプリンシパルに付与された権限によって異なる場合があります。

5. 参考事項

• サービス別の詳細収集データと必要な権限は、本文書の関連下位ページを参照します。
• パッケージ構成、サポートサービス及び実行環境はバージョンによって変更される場合があるため、配布前に該当バージョンのRelease Noteを併せて確認します。
• 本紹介はexemone-cloud-agentの現在のソースコード及び配布パイプラインを基準に作成されています。