クラウドをインストールする

exemONEでAWS・Azureをモニタリングする前に、クラウドサービス側で準備すべきサポート環境、ネットワーク確認事項、必須権限を案内します。exemONE画面でアカウントを登録し、リソース・収集周期を管理する方法は設定するドキュメントを参照してください。

AWS​

サポート環境​

収集方式​

AWSが提供する各サービス別のパフォーマンス情報を AWS API Call (GetMetricData) 方式で収集します。

• 収集周期: 1分 / 10分 / 15分 / 30分 / 1時間 / 3時間 の中から設定可能
• 注意: AWS料金ポリシーによるAPI Call費用が別途発生します。
• 参考: https://aws.amazon.com/ko/cloudwatch/pricing/

ネットワーク確認​

exemONE収集サーバーから以下のAWS APIエンドポイントにアクセスできる必要があります。*.amazonaws.com ドメインと 443ポート が許可されているか確認してください。

rds.{region}.amazonaws.com          - RDSインスタンス情報
ec2.{region}.amazonaws.com          - インスタンスメタデータ
monitoring.{region}.amazonaws.com   - CloudWatchメトリック
logs.{region}.amazonaws.com         - CloudWatch Logs
sts.{region}.amazonaws.com          - 認証トークンサービス(STS)
ce.{region}.amazonaws.com           - Cost Explorer費用情報

AWSが使用するIPアドレス範囲は、以下のコマンドでダウンロードしてファイアウォールの許可リストに反映できます。

curl -O https://ip-ranges.amazonaws.com/ip-ranges.json

必須権限​

モニタリング対象のAWSアカウントにサービス別に以下のIAM権限を付与する必要があります。

認証準備​

exemONEアカウント登録画面の Credential Type で、以下5種類の方式のうち顧客環境に合った方式を選択します。各方式に必要な情報を事前に準備してください。

Token

• 一時的に発行されたTokenで認証する方式(Token期限切れに伴う自動更新管理が必要)

• 接続情報

  • Access Key ID

  • Secret Key

Assume Role

• exemONE収集サーバーをAWS内部(EC2)環境に構築する際に使用できる方式

  • Role Arn(例: arn:aws:iam::123456789012:role/MyRole)

  • Role Session Name(識別用の任意の値)

IAM Roles Anywhere

• exemONE収集サーバーをAWS外部(オンプレミスなど)環境に構築する際に使用できる方式

• IAM Role作成(IAMRoleAnywhere)および必要権限の付与

• Trust Anchor作成(CA証明書登録が必要)

• Profile作成およびIAM Role接続

  • 参考URL

• 接続情報

  • Certificate(証明書ファイル)

  • Private Key(秘密鍵ファイル)

  • Role ARN(例: arn:aws:iam::123456789012:role/MyRole)

  • Trust Anchor ARN

  • Profile ARN

Vault

• 主に内部セキュリティポリシー上、認証情報を直接保存できない場合に使用

• Vault Keyを通じてAccess Key(Access Key ID + Secret Access Key)を保存管理する場合に使用

• 接続情報

  • Vault Token(例: https://vault.example.com/v1/aws/creds/my-role)

  • Namespace(例: my-namespace)

  • Request URL(例: https://vault.example.com/v1/aws/creds/my-role)

Server

• EC2に接続されたIAM Roleを使用するため、別途の準備項目はありません。

Azure​

サポート環境​

収集方式​

Azureが提供する各サービス別のパフォーマンス情報も Azure Monitor REST API (Metrics API) 方式で収集します。

• 収集周期: 1分 / 10分 / 15分 / 30分 / 1時間 / 3時間 の中から設定可能
• 注意: Azure料金ポリシーによるMetrics API呼び出し費用が別途発生します。
• 参考: https://azure.microsoft.com/ko-kr/pricing/details/monitor/

ネットワーク確認​

exemONE収集サーバーから以下のドメインの 443ポート にアクセスできる必要があります。

必須権限​

モニタリング対象リソースの種類によって以下のロール(Role)権限が必要です。

Microsoft.DBforMySQL/flexibleServers/read
Microsoft.DBforMariaDB/servers/read
Microsoft.DBforPostgreSQL/flexibleServers/read
Microsoft.Sql/servers/databases/read
Microsoft.Cache/Redis/read

Microsoft.Insights/Metrics/Read
Microsoft.Compute/skus/read
Microsoft.AlertsManagement/alerts/read
Microsoft.Resources/subscriptions/read

認証準備​

exemONEアカウント(テナント)登録画面では Tenant ID、Client ID、Client Secret の3つの情報を入力します。Client IDとClient SecretはAzure Portalでアプリ登録を通じて発行を受ける必要があります。

1. Azure Portalで アプリの登録 をクリックします。

2. + 新規登録 をクリックしてアプリを登録します。

3. Cloud Shell を実行し、以下のコマンドを入力します。

   az ad sp create-for-rbac -n (アプリ登録名) --role Contributor --scopes /subscriptions/(Subscription Id)
   

4. 出力結果のうち、appId は Client ID、password は Client Secret の値なので、確認して登録画面に入力します。

エージェントのインストール​

AWS・Azure共通で、クラウドリソースを収集するには exemone-cloud-agent をサーバーにインストールする必要があります。

モジュールの説明​

exemone-cloud-agent は、AWS・Azureクラウド環境のリソースをモニタリングするためのエージェントです。binファイルを使用してサーバーに単独でインストールします。

エージェントを登録する​

サーバーにCloud Agentをインストールする前に、exemONE Web UIでエージェントを先に登録する必要があります。登録時に発行される Agent ID と Access Token は、インストール後の agent.yaml 設定に必要です。

左側メニュー下部の Profile > 環境設定 で Management > Agent を選択してください。

1. Agent List & Management タブで [Add Agent] をクリックします。
2. Agent Type を Cloud に選択し、Agent Name を入力します。
3. [Regenerate] をクリックして Agent ID と Access Token の発行を受け、併せて記録しておきます。
4. [Save] をクリックします。

エージェントをインストールする​

binファイルでインストールする

1. 実行権限を付与します。

   chmod +x setup_exemone-cloud-agent_{version}.bin
   

2. インストールファイルを実行し、新規インストールの可否を確認するプロンプトで y を入力します。

   ./setup_exemone-cloud-agent_{version}.bin
   

   =====================================================
   exemone-cloud-agent Install
   =====================================================
   new install start
   Would you like to do a new install? (y/n)
   y
   xmSuccess(0): Installation is complete.
   

3. インストール完了後、conf/agent.yaml ファイルを開き、上記で発行を受けたエージェント情報を入力します。

   agent_id: <エージェントID>
   access_token: <アクセストークン>
   receiver_addr: <Receiver IP>:9009
   
   注記

   agent_id: などキーの後のコロン(:)の次には必ず1文字分のスペースを空ける必要があります。

4. エージェントを起動します。

   ./start.sh
   

Docker binファイルでインストールする

1. 実行権限を付与します。

   chmod +x setup_exemone-cloud-agent_{version}_docker.bin
   

2. インストールファイルを実行し、プロンプトで y を入力します。

   ./setup_exemone-cloud-agent_{version}_docker.bin
   

   =====================================================
   exemone-cloud-agent Install
   =====================================================
   new install start
   Would you like to do a new install? (y/n)
   y
   Loaded image: maxgauge/exemone-cloud-agent:{version}
   xmSuccess(0): Installation is complete.
   

3. インストール完了後、conf/agent.yaml ファイルを開き、上記で発行を受けたエージェント情報を入力します。

   agent_id: <エージェントID>
   access_token: <アクセストークン>
   receiver_addr: <Receiver IP>:9009
   
   注記

   agent_id: などキーの後のコロン(:)の次には必ず1文字分のスペースを空ける必要があります。

4. エージェントを起動し、コンテナの状態を確認します。

   ./start.sh
   docker ps