Monitoring Amazon OpenSearch 服務

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

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

感應器 (資料收集)

追蹤配置

OpenSearch 詳細資料

  • 網域陣列
  • 網域名稱
  • 分組區域 (地區)

度量值

  • 叢集狀態: 綠色、黃色、紅色
  • 節點數目
  • 可搜尋及已刪除的文件數
  • 用於叢集中資料節點的 CPU 資源百分比上限
  • 叢集的可用儲存體
  • 叢集已用空間
  • 接受或封鎖送入寫入要求的叢集指示器 (cluster_index_writes_blocked)
  • JVM 記憶體壓力
  • 自動化 Snapshot 失敗度量
  • 具有 HTTP 狀態碼的要求數
  • 搜尋延遲， Shard 完成搜尋作業所花費的平均時間
  • 叢集中資料節點可用的剩餘 CPU 額度

如需相關資訊，請參閱 Amazon OpenSearch 度量值及維度。

必要許可權

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • es:ListDomainNames
  • es:ListTags
  • es:DescribeElasticsearchDomain

配置

OpenSearch 的度量值每 5 分鐘取回一次，可以透過 <agent_install_dir>/etc/instana/configuration.yml 檔案中的代理程式配置來變更:

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

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

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

Proxy 配置

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

com.instana.plugin.aws.es:
  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 具名設定檔方法

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

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

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

AWS STS 方法

若要置換用來監視 OpenSearch的 IAM 角色，請使用下列配置:

com.instana.plugin.aws.es:
  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 配置內容之 AWS 標籤資源的頻率 (預設為 300 秒)。

附註: 標籤僅適用於 AWS 代理程式。

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

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

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

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

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

com.instana.plugin.aws.es:
  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.es:
  include_untagged: false # True value by default

Instana 代理程式標籤

請注意，標籤僅適用於 AWS 代理程式。 如需使用標籤的詳細資料，請參閱 這裡說明。