監視 AWS CloudFront
在安裝 Instana 代理程式之後，會自動部署並安裝 AWS CloudFront 感應器。 此感應器會監視 AWS CloudFront 發行套件及其相關聯的功能。
如需其他支援的 AWS 服務，請參閱 AWS 主題。
必要條件
若要啟用監視 AWS CloudFront，請將代理程式部署至 us-east-1 地區。
若要監視
Cache hit rate及Origin latency度量，請在 AWS 主控台中啟用其他 CloudFront 配送度量。 如需如何啟用其他度量值的指示，請參閱 AWS 說明文件。
檢視 CloudFront 發行套件的詳細資料和度量值
Instana 會收集 CloudFront 發行套件的詳細資料和度量值。
CloudFront 發行套件詳細資料
AWS CloudFront 感應器會收集下列 CloudFront 詳細資料:
| CloudFront 配送詳細資料 | 說明 |
|---|---|
| ARN | CloudFront 發行套件的 Amazon 資源名稱 (ARN)。 |
| 名稱 | 發行套件的 CloudFront 網域名稱。 |
| 地區 | 配送的位置 (區域)。 |
| 配送 ID | 配送的唯一 ID。 |
| 狀態 | 配送的部署狀態。 |
| 前次修改時間 | 前次修改配送的日期和時間。 |
度量值
Instana 會收集 CloudFront 發行套件及相關聯函數的度量值。
分佈
| 名稱 | 說明 |
|---|---|
| 要求 | CloudFront針對所有 HTTP 方法以及 HTTP 和 HTTP 要求所接收的檢視器要求總數。 |
| 已上傳位元組數 | 檢視者使用 POST 及 PUT 要求，透過 CloudFront上傳至原點的位元組總數。 |
| 已下載的位元組數 | 檢視器針對 GET、HEAD 及 OPTIONS 要求所下載的位元組總數。 |
| 4xx 錯誤率 | 回應的 HTTP 狀態碼為 4xx的所有檢視器要求百分比。 |
| 5xx 錯誤率 | 其回應 HTTP 狀態碼為 5xx的所有檢視器要求百分比。 |
| 錯誤率總計 | 其回應 HTTP 狀態碼為 4xx 或 5xx的所有檢視器要求百分比。 |
| 快取命中率 | 可以快取且 CloudFront 為其快取中的內容提供內容的所有要求百分比。 HTTP POST 和 PUT 要求及錯誤不會快取。 |
| 原點延遲 | CloudFront 將要求的回應傳送至網路所花費的時間總計 (毫秒)。 此延遲值僅適用於從原點提供的要求; 亦即，不是從 CloudFront 快取提供的要求。 |
相關聯的函數
| 名稱 | 說明 |
|---|---|
| 呼叫 | 在給定時段內啟動 (呼叫) 函數的次數。 |
| 計算使用率 | 函數執行所花費的時間量 (0-100 ，以容許時間上限的百分比表示)。 |
| 節流控制 | 在給定時段內節流控制函數的次數。 |
| 驗證錯誤 | 函數在給定時段內產生的驗證錯誤數。 當函數順利執行，但傳回無效資料 (無效事件物件) 時，會發生驗證錯誤。 |
| 執行錯誤 | 給定時段內發生的執行錯誤數。 當函數無法順利完成時，會發生執行錯誤。 |
必要許可權
需要下列許可權:
cloudfront:GetDistributioncloudfront:ListDistributionscloudfront:ListTagsForResource
配置 AWS CloudFront 感應器
若要變更 AWS CloudFront 感應器的配置，請在 <agent_install_dir>/etc/instana/configuration.yml 檔案中編輯代理程式配置的 com.instana.plugin.aws.cloudfront 內容。
AWS CloudFront 感應器每 5 分鐘提取一次 CloudFront 的度量值。 若要變更此頻率，請使用 cloudwatch_period 內容:
com.instana.plugin.aws.cloudfront:
cloudwatch_period: 60
附註: 由於收集的 CloudWatch 度量值增加，啟用功能監視會產生額外的財務成本。
若要啟用監視 CloudFront 功能，請設定 enable_function_monitoring: true 內容:
com.instana.plugin.aws.cloudfront:
enable_function_monitoring: true
若要停用監視 CloudFront 發行套件，請設定 enabled: false 內容:
com.instana.plugin.aws.cloudfront:
enabled: false
配置 AWS CloudFront 感應器以使用 Proxy
若要讓 AWS CloudFront 感應器使用 Proxy ，請將下列內容新增至 <agent_install_dir>/etc/instana/configuration.yml 檔中的代理程式配置:
com.instana.plugin.aws.cloudfront:
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 帳戶 主題。
置換用來監視 CloudFront 的 AWS 設定檔
若要置換用來監視 CloudFront的 AWS 設定檔，請使用下列配置:
com.instana.plugin.aws.cloudfront:
profile_names:
- 'profile2'
- 'profile3'
附註: 如果您在服務層次定義設定檔，則會置換廣域 AWS 設定檔配置。
置換用來監視 CloudFront 的 IAM 角色
若要置換用來監視 CloudFront的 IAM 角色，請使用下列配置:
com.instana.plugin.aws.cloudfront:
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 角色配置。
過濾
您可以定義標籤，用來在探索中併入服務或從探索中排除服務。 如果您不需要過濾服務，則不需要定義標籤。
您可以定義多個標籤，以逗點區隔。 將每一個標籤定義為鍵值組。 若要讓配置更容易，您可以定義要在探索中併入或從探索中排除哪些標籤。 如果您在兩個清單 (include 和 exclude) 中定義相同的標籤，則 exclude 清單具有較高的優先順序。 不一定要定義所有值以啟用過濾。
附註: 標籤僅適用於 AWS 代理程式。
您可以使用 tagged-services-poll-rate 配置內容來指定感應器輪詢 AWS 標籤資源的頻率。 依預設，此值為 300 秒。
若要定義感應器輪詢已標記資源的頻率，請使用下列配置:
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
若要將依標籤的服務併入探索中，請使用下列配置:
com.instana.plugin.aws.cloudfront:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
若要從探索中依標籤排除服務，請使用下列配置:
com.instana.plugin.aws.cloudfront:
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.cloudfront:
include_untagged: false # True value by default