監視 AWS S3
在安裝 Instana 代理程式之後，會自動部署並安裝 AWS S3 感應器。
附註: 請參閱我們的 AWS 說明文件，以瞭解其他受支援的 AWS 服務。
必要條件
若要讓 Instana 代理程式能夠從 S3 實例收集度量值，需要啟用付費 (要求及資料傳送) 度量值。 進一步瞭解此 主題。
感應器 (資料收集)
追蹤配置
- S3 儲存區詳細資料
- 儲存區名稱
- 儲存區擁有者 ID
- 儲存區擁有者名稱
- 儲存區建立時間
- 分組區域 (地區)
度量值
要求
| 度量 | 說明 |
|---|---|
| 全部 (要求) | 不論類型為何，對 Amazon S3 儲存區提出的 HTTP 要求總數。 如果您搭配使用度量值配置與過濾器，則此度量值只會傳回對儲存區中符合過濾器需求的物件所提出的 HTTP 要求。 |
| Get (要求) | 針對 Amazon S3 儲存區中的物件所提出的 HTTP GET 要求數。 這不包括清單作業。 |
| 放置 (要求) | 對 Amazon S3 儲存區中的物件提出的 HTTP PUT 要求數。 |
| 刪除 (要求) | 對 Amazon S3 儲存區中的物件提出的 HTTP DELETE 要求數。 這也包括「刪除多個物件」要求。 此度量顯示要求數，而非刪除的物件數。 |
| 標頭 (要求) | 對 Amazon S3 儲存區提出的 HTTP HEAD 要求數。 |
| 公佈 (要求) | 對 Amazon S3 儲存區提出的 HTTP POST 要求數。 |
| 清單 (要求) | 列出儲存區內容的 HTTP 要求數。 |
資料流量
| 度量 | 說明 |
|---|---|
| 已下載的位元組數 | 針對對 Amazon S3 儲存區提出的要求所下載的位元組數，其中回應包括內文。 |
| 已上傳位元組數 | 包含要求內文且已上傳至 Amazon S3 儲存區的位元組數。 |
錯誤
| 度量 | 說明 |
|---|---|
| 4xx 錯誤 | 對值為 0 或 1 的 Amazon S3 儲存區提出的 HTTP 4xx 用戶端錯誤狀態碼要求數。 平均統計資料會顯示錯誤率，而總和統計資料會顯示每一個期間內該類型錯誤的計數。 |
| 5xx 錯誤 | 對值為 0 或 1 的 Amazon S3 儲存區提出的 HTTP 5xx 伺服器錯誤狀態碼要求數。 平均統計資料會顯示錯誤率，而總和統計資料會顯示每一個期間內該類型錯誤的計數。 |
延遲
| 度量 | 說明 |
|---|---|
| 第一個位元組延遲時間 | 從 Amazon S3 儲存區接收完整要求到開始傳回回應的每個要求時間。 |
| 要求延遲時間總計 | 從接收的第一個位元組到傳送至 Amazon S3 儲存區的最後一個位元組的每個要求經歷時間。 這包括接收要求內文及傳送回應內文所花費的時間，該時間未包含在 FirstByte延遲中。 |
必要許可權
cloudwatch:GetMetricStatisticscloudwatch:GetMetricDatas3:GetBucketTaggings3:ListAllMyBucketss3:GetBucketLocation
為了具有公用儲存區的指示器，需要新增下列許可權:
s3:GetBucketPolicyStatus
也應該定義每一個特定 S3 儲存區的儲存區原則。 如需如何新增儲存區原則的相關資訊，請參閱 AWS 說明文件。
配置
S3 的度量每 60 秒取回一次，這可以透過 <agent_install_dir>/etc/instana/configuration.yml中的代理程式配置來變更:
com.instana.plugin.aws.s3:
cloudwatch_period: 300
若要停用 S3 實例的監視，請使用下列配置:
com.instana.plugin.aws.s3:
enabled: false
Proxy 配置
若要配置特定的 AWS 感應器以使用 Proxy 配置，請新增下列代理程式配置設定:
com.instana.plugin.aws.s3:
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 具名設定檔方法
若要置換應該用來監視 S3的設定檔，請使用下列配置:
com.instana.plugin.aws.s3:
profile_names:
- 'profile2'
- 'profile3'
附註: 在服務層次定義設定檔會置換廣域 AWS 設定檔配置。
AWS STS 方法
若要置換應該使用哪些 IAM 角色來監視 S3，請使用下列配置:
com.instana.plugin.aws.s3:
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.s3:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
若要從探索中排除依標籤的服務，請使用下列配置:
com.instana.plugin.aws.s3:
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.s3:
include_untagged: false # True value by default