監視 AWS SQS

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

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

感應器 (資料收集)

追蹤配置

  • 端點位址
  • ARN
  • 地區
  • 建立時間
  • 訊息保留期
  • 訊息大小上限
  • 可見性逾時
  • 前次修改時間戳記

度量值

  • 已延遲的訊息數
  • 不可見的訊息數
  • 可見的訊息數
  • 空接收訊息數
  • 接收的訊息數
  • 已傳送的訊息數
  • 最舊訊息的經歷時間
  • 已送訊息大小

必要許可權

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • sqs:ListQueues
  • sqs:GetQueueAttributes
  • sqs:ListQueueTags

配置

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

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

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

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

Proxy 配置

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

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

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

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

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

AWS STS 方法

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

com.instana.plugin.aws.sqs:
  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.sqs:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

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

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

輪詢率

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

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

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