Monitoring Amazon Web Services (AWS) 與 Amazon Web Services (AWS) 代理程式

在 EC2

您可以在 Windows 上安裝 AWS 代理程式，或在 EC2上安裝 Linux 。 最好在執行 Linux®的 Current Generation General Purpose 機器上執行 Instana AWS 代理程式。 例如， m5.large 實例很理想。

附註: 如果您在 Windows 上安裝 AWS 代理程式，即使 Windows 機器是在 AWS中管理，您仍需要完成 在 AWS 基礎架構外部安裝 區段中的配置。

1. 在 Instana 使用者介面中，按一下 其他 > 代理程式 > 安裝代理程式 > AWS 。

2. 從 技術 清單中，選取 Instana AWS 感應器。

3. 從 執行 AWS 代理程式於 清單中，選取 Elastic Cloud Compute (EC2) (預設值)。

   您的代理程式金鑰及位置會預先移入 Script 中，以在 EC2上用作 User Data 。 複製所顯示的 Script。 除了提供所有必要的資訊之外， Script 如下所示:

   #!/bin/bash
   
   curl -o setup_agent.sh https://setup.instana.io/agent
   chmod 700 ./setup_agent.sh
   sudo ./setup_agent.sh -y -a <your-agent-key> -m aws -t dynamic -e <location> -s
   

4. 啟動專用 EC2 虛擬機器，並使用複製的 Script 作為 User Data。 如需如何在 EC2上使用 User Data 的相關資訊，請參閱 啟動時在 Linux 實例上執行指令 文件。

5. 將 IAM 角色 主題的程式碼區塊中的配置複製到 configuration.json 檔案。 這些配置用於執行 Instana AWS 代理程式並讓 AWS 代理程式探索及監視 AWS 資源的 EC2 虛擬機器所需的 IAM 角色。 然後，使用 configuration.json 檔案建立 IAM 角色。 如需相關資訊，請參閱 建立角色以將許可權委派給 IAM 使用者。

6. 若要讓 IAM 角色執行 AssumedRole 動作，請編輯 Trust Relationship ，如下所示:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ec2.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   

   如果您的 EC2 實例位於中國的其中一個地區，請編輯 Trust Relationship ，如下所示:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ec2.amazonaws.com.cn"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   

   如需其他必要配置，請參閱中國區域監視的 特性

在 ECS 上 Fargate 上安裝

您可以在 Windows 上安裝 AWS 代理程式，或在 ECS 上的 Fargate 上安裝 Linux 。

附註: 如果您在 Windows 上安裝 AWS 代理程式，即使 Windows 機器是在 AWS中管理，您仍需要完成 在 AWS 基礎架構外部安裝 區段中的配置。

1. 在 Instana 使用者介面中，按一下 其他 > 代理程式 > 安裝代理程式 > AWS 。

2. 從 技術 清單中，選取 Instana AWS 感應器。

3. 從 執行 AWS 代理程式於 清單中，選取 Elastic Container Service (ECS)。

   作業定義的 JSON 會在 作業定義 JSON 範本中預先產生。 下載 JSON 檔案，並將它與「作業定義」使用者介面的 使用 JSON 來配置 功能搭配使用。

4. 下載 IAM 許可權 JSON 檔案，並將至少包含所下載 JSON 檔案中所列許可權的 IAM 角色指派給新的作業定義。

5. 使用新建立作業定義的一個實例來建立 ECS 服務。

在 AWS 基礎架構外部安裝

您也可以指定任何在 AWS 基礎架構外部執行的代理程式專用。 若要達到此目標，您需要在 /opt/instana/agent/bin/setenv 檔案內指定下列環境變數:

• 您要監視的地區:

  INSTANA_AWS_REGION_CONFIG=
  

• 用來存取 AWS 資源的認證。 這些認證應該屬於使用者，容許該使用者存取 Amazon Web Services IAM 配置 小節中已說明的資源。

  AWS_ACCESS_KEY_ID=
  AWS_SECRET_ACCESS_KEY=
  

Proxy 配置

export HTTP_PROXY=
export HTTPS_PROXY=

com.instana.plugin.aws:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password
  tagging: # proxy setup for AWS Tagging API, used for AWS resource monitoring filtering
    proxy_host: 'example.com' # proxy host name or ip address
    proxy_port: 3128 # proxy port
    proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
    proxy_username: 'username' # OPTIONAL: proxy username
    proxy_password: 'password' # OPTIONAL: proxy password

中國地區特性

依預設， Instana 代理程式會從 EC2 實例聯絡廣域 STS 端點，以收集實例設定檔認證。 因為此方法在 CN 區域中無法運作，所以 STS 區域端點需要顯示為環境變數，這會告知 Instana 代理程式使用區域 (CN) STS 端點。

安裝 Instana 代理程式之後，請在 <instana-agent-dir>/bin/setenv內指定下列環境變數:

export AWS_STS_REGIONAL_ENDPOINTS=regional

啟用特定服務的監視

對於每一個服務，您需要在個別服務頁面上新增所需的許可權，從 受監視服務 區段鏈結至。 若要從監視中排除服務，請排除個別的許可權。

或者，從監視中排除服務的另一種方法是在 <agent_install_dir>/etc/instana/configuration.yml 中新增適當的-enabled_ 旗標，如下列個別服務頁面上所述。

監視多個 AWS 帳戶

AWS Instana 代理程式支援監視相同區域中多個 AWS 帳戶的服務。 目前有兩種方法: 使用 AWS 具名設定檔，以及使用 AWS 安全記號服務 (STS)。

附註: 當您配置 Instana 代理程式來監視多個 AWS 帳戶時，應該只使用兩種可用方法之一。

[default]
aws_access_key_id = accessKey1
aws_secret_access_key = secretAccessKey1

[profile2]
aws_access_key_id = accessKey2
aws_secret_access_key = secretAccessKey2

[profile3]
aws_access_key_id = accessKey3
aws_secret_access_key = secretAccessKey3

com.instana.plugin.aws:
  profile_names:
    - 'profile2'
    - 'profile3'

com.instana.plugin.aws:
  role_arns:
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_3_id>:role/<role_3_name>'

過濾及標記

附註: 若要啟用過濾， IAM 許可權 tag:GetResources 應該包含在授與 AWS 代理程式的 IAM 許可權中。

在啟用服務的監視之後，可以透過修改 AWS 代理程式的代理程式配置檔 /opt/instana/agent/etc/instana/configuration.yaml ，來過濾 Instana 的哪些實例將根據 AWS 標籤進行監視。

配置檔中的可用選項如下:

com.instana.plugin.aws:
  # Comma-separated list of tags in key:value format.
  # Any AWS resource containing at least one of the specified tags is discovered.
  include_tags: ...
  # Comma-separated list of tags in key:value format.
  # Any AWS resource containing at least one of the specified tags is omitted from discovery.
  exclude_tags: ...
  # Exclude untagged AWS resources by setting the flag to `false`
  include_untagged: ...

可以定義多個標籤，以逗點區隔。 標籤應該是以 :區隔的鍵值組。 當您在兩個清單 (包括及排除) 中定義標籤時，排除清單具有較高的優先順序。 如果不需要過濾服務，則不應定義配置。

附註: Instana 代理程式會自動監視所有未指派標籤的 AWS 資源。 若要從監視中排除未標記的資源，請將 include_untagged 旗標設為 false。

也可以在服務層次上配置過濾。 在此情況下，會置換特定服務的預設配置。 如需依特定服務進行探索過濾的詳細資料，請參閱特定服務說明文件。

標籤輪詢率

若要指定 AWS 代理程式輪詢受監視 AWS 服務以取得相關聯標籤的頻率，請使用 tagged-services-poll-rate 配置內容。 預設值為 300 秒。 代理程式使用 AWS 服務用戶端來輪詢標籤。

已標記資源的輪詢率配置為:

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

輪詢間隔

輪詢間隔指出 AWS 代理程式呼叫 CloudWatch API 的頻率。 它在 configuration.yml 檔案中可配置為 cloudwatch_period 。 預設值為 300 秒。 最常見的情況是監視平台使用 5-10 分鐘的值。

輪詢間隔可在兩個層次上配置:

• 代理程式所監視所有 AWS 服務的代理程式層次:

  com.instana.plugin.aws:
    cloudwatch_period: 300
  

• 每個 AWS 服務:

  com.instana.plugin.aws.rds:
    cloudwatch_period: 300
  

單一服務的配置會置換代理程式層次配置。

CloudWatch 成本

若要深入瞭解 AWS 服務， Instana 這類監視平台必須使用 CloudWatch API。 此 API 由 AWS 搭配 消費型計價提供，本文件的目的是提供 Instana 如何使用 CloudWatch API 的透通性，讓使用者瞭解對其 AWS 帳單的影響。

CloudWatch 成本受下列項目影響:

• AWS 服務的受監視實例數
• 每個 AWS 代理程式所收集的度量數
• 輪詢間隔 (可配置)

每一個 AWS 代理程式都會呼叫 GetMetricData CloudWatch API 要求，以收集度量值，如果失敗，則會呼叫 GetMetricStatistics 作為撤回。 兩個端點每個度量都會產生相同的成本 (明確說明: GetMetricStatistics 的撤回使用不會產生額外成本)。 您可以找到這兩個 在 AWS CloudWatch 定價頁面上的詳細資料。

下表包含輪詢間隔為 5 分鐘且 Amazon 每 1000 CloudWatch 度量值為0.01 美元時，不同 AWS 代理程式的粗略預估每日成本:

請注意， CloudWatch 未用於 EC2 及 輪詢標籤，因此不會產生任何 CloudWatch 成本。

您可以透過增加輪詢間隔來減少 CloudWatch 成本。 增加輪詢間隔的缺點是您減少來自 CloudWatch的精度度量值。 每一個要求都提供單一度量值，因此輪詢間隔 60s 與 300s 之間的差異是五個度量值或 300s 期間的一個度量值。

由您決定預設輪詢間隔是否適合您的企業，還是自訂它以在成本與洞察品質之間取得平衡。