Monitoring Amazon MSK

在您安裝 Instana 代理程式之後，會自動部署並安裝 Amazon MSK 感應器。

附註: 請參閱我們的 AWS 說明文件，以瞭解其他受支援的 AWS 服務。

感應器 (資料收集)

MSK 分配管理系統-度量值集合

追蹤配置

MSK 實例詳細資料 說明
ID 特定 MSK 實例的 ID。
ARN 指派給實例的不完整 Amazon 資源名稱 (ARN)。
類型 MSK 實例類型。
實例類型 實例層級類型。
已新增至叢集 分配管理系統新增至叢集的時間。

效能度量

效能度量 說明
分割區 分割區數目。
低於抄寫的分割區計數 抄寫不足的分割區數目。

度量值

分配管理系統度量值 說明 監視層次
主導器計數 每個分配管理系統 (不包括抄本) 的分割區領導者總數。 DEFAULT
輸入的位元組數 每秒從用戶端接收的位元組數。 此度量適用於每個分配管理系統，也適用於每個主題。 DEFAULT
輸出的位元組數 每秒傳送至用戶端的位元組數。 此度量適用於每個分配管理系統，也適用於每個主題。 DEFAULT
輸入的訊息 分配管理系統每秒送入訊息數。 DEFAULT
要求位元組數 分配管理系統的平均要求位元組數。 DEFAULT
CPU 閒置 CPU 閒置時間百分比。 DEFAULT
CPU 使用者 使用者空間中的 CPU 百分比。 DEFAULT
CPU 系統 核心空間中 CPU 的百分比。 DEFAULT
可用記憶體 分配管理系統可用的可用記憶體大小 (以位元組為單位)。 DEFAULT
已用的記憶體 分配管理系統使用中的記憶體大小 (以位元組為單位)。 DEFAULT
快取記憶體 分配管理系統的快取記憶體大小 (以位元組為單位)。 DEFAULT
緩衝記憶體 分配管理系統的緩衝記憶體大小 (以位元組為單位)。 DEFAULT
可用的交換記憶體 分配管理系統可用的交換記憶體大小 (以位元組為單位)。 DEFAULT
已用的交換記憶體 分配管理系統使用中的交換記憶體大小 (以位元組為單位)。 DEFAULT
接收的網路 Rx 分配管理系統所接收的封包數。 DEFAULT
已捨棄網路 RX 捨棄的接收套件數目。 DEFAULT
網路 Rx 錯誤 分配管理系統的網路接收錯誤數。 DEFAULT
傳輸的網路 Tx 分配管理系統所傳輸的封包數。 DEFAULT
已捨棄網路 RX 捨棄的傳輸套件數目。 DEFAULT
網路 Rx 錯誤 分配管理系統的網路傳輸錯誤數。 DEFAULT
產生時間 平均產生時間 (毫秒)。 PER_BROKER
產生節流控制時間 平均產生節流控制時間 (毫秒)。 PER_BROKER
提取節流控制時間 平均提取節流控制時間 (毫秒)。 PER_BROKER
要求節流控制時間 平均要求節流控制時間 (毫秒)。 PER_BROKER
產生節流控制位元組速率 每秒節流控制的位元組數。 PER_BROKER
提取節流控制位元組速率 每秒節流控制的位元組數。 PER_BROKER
消費者提取時間 消費者從分配管理系統提取資料所花費的平均時間總計 (毫秒)。 PER_BROKER
追蹤者提取時間 追蹤者從分配管理系統提取資料所花費的平均時間總計 (毫秒)。 PER_BROKER
網路閒置時間 網路處理器閒置的平均時間百分比。 PER_BROKER
要求閒置時間 要求處理程式執行緒閒置的平均時間百分比。 PER_BROKER

MSK 叢集-度量收集

追蹤配置

MSK 叢集詳細資料 說明
名稱 MSK 叢集的名稱。
ARN 指派給實例的不完整 Amazon 資源名稱 (ARN)。
加強監視 監視層次。
Kafka 版本 Kafka 實例的版本。

效能度量

效能度量 說明
作用中的控制器 作用中控制器數目。
主題 主題數。

度量值

分配管理系統度量值 說明 監視層次
分割區計數 分割區總數。 DEFAULT
離線分割區 離線分割區總數。 DEFAULT
已用的磁碟 磁碟空間使用情形。 DEFAULT

必要許可權

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • kafka:ListClusters
  • kafka:ListNodes
  • kafka:ListTagsForResource
  • kafka:DescribeCluster

配置

Amazon MSK 的度量值每 5 分鐘取回一次，這可以透過代理程式配置 (<agent_install_dir>/etc/instana/configuration.yaml) 進行變更:

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

若要停用 MSK 實例的監視，請使用下列配置:

com.instana.plugin.aws.msk:
  enabled: false

Proxy 配置

若要配置特定的 AWS 感應器以使用 Proxy 配置，請新增下列代理程式配置設定:

com.instana.plugin.aws.msk:
  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

監視多個 AWS 帳戶

請參閱 監視多個 AWS 帳戶 文件，以設定監視相同區域中具有一個 AWS 代理程式的多個 AWS 帳戶。

AWS 具名設定檔方法

若要置換應該用來監視 MSK 的設定檔，請使用下列配置:

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

附註: 在服務層次定義設定檔會置換廣域 AWS 設定檔配置。

AWS STS 方法

若要置換應該使用哪些 IAM 角色來監視 MSK ，請使用下列配置:

com.instana.plugin.aws.msk:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

附註: 在服務層次上定義 IAM 角色會置換廣域 AWS IAM 角色配置。

過濾

可以定義多個標籤，以逗點區隔。 標籤應該提供為鍵值組，以: 區隔。 為了使配置更容易，可以定義您要在探索中併入或從探索中排除哪些標籤。 如果在兩個清單 (包括及排除) 中定義標籤，則排除清單具有較高的優先順序。 如果不需要過濾服務，則不應定義配置。 為了啟用過濾，不一定要定義所有值。

使用者可以使用 tagged-services-poll-rate 配置內容 (預設 300 秒) 來指定感應器輪詢 AWS 標籤資源的頻率。

附註: 標籤只能與 AWS 代理程式一起使用。

若要定義感應器輪詢已標記資源的頻率，請使用下列配置:

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

若要將依標籤的服務併入探索中，請使用下列配置:

com.instana.plugin.aws.msk:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

若要從探索中排除依標籤的服務，請使用下列配置:

com.instana.plugin.aws.msk:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

依預設會監視沒有標籤的 AWS 服務，但可以透過將 include_untagged 欄位設為 false來排除:

com.instana.plugin.aws.beanstalk:
  include_untagged: false # True value by default

Instana 代理程式標籤

請注意，標籤只能與 AWS 代理程式一起使用。 如需使用標籤的詳細資料，請參閱 這裡說明。