監視 AWS DynamoDB

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

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

度量值集合
必要權限

度量值集合

若要檢視度量值，請在「Instana 使用者」介面的資訊看板中選取 基礎架構 ，按一下特定的受監視主機，然後您可以看到包含所有已收集度量值及受監視處理程序的主機儀表板。

配置資料

表格陣列
表格名稱
表格狀態
表格項目計數
表格建立於
表格大小 (位元組)
表格串流陣列
表格串流標籤
分組區域 (地區)

效能度量

名稱
耗用的讀取容量
已佈建的讀取容量
耗用的寫入容量
已佈建的寫入容量
節流控制的讀取要求 (Get、Scan、Query、Batch Get)
節流控制的寫入要求 (放置、更新、刪除、批次寫入)
TTL 刪除的項目
條件式檢查失敗
使用者錯誤
系統錯誤讀取 (取得、掃描、查詢、批次取得)
系統錯誤寫入 (放置、更新、刪除、批次寫入)
傳回的查詢項目計數 (最小值、最大值、平均值、總和)
傳回的掃描項目計數 (最小值、最大值、平均值、總和)
Batch get 延遲時間 (最小值、最大值、平均值、總和、要求計數)
批次寫入延遲 (最小值、最大值、平均值、總和、要求計數)
Delete 延遲時間 (最小值、最大值、平均值、總和、要求計數)
Get 延遲時間 (最小值、最大值、平均值、總和、要求計數)
Put 延遲時間 (最小值、最大值、平均值、總和、要求計數)
Query 延遲時間 (最小值、最大值、平均值、總和、要求計數)
Scan 延遲時間 (最小值、最大值、平均值、總和、要求計數)
Update 延遲時間 (最小值、最大值、平均值、總和、要求計數)

如需相關資訊，請參閱 Amazon DynamoDB Metrics and Dimensions。

性能簽章

對於每一個感應器，有一個經過策劃的性能簽章知識庫，可根據送入的度量值持續評估，並用來提出取決於使用者影響的問題或發生事件。

內建事件 會根據實體上的性能簽章失敗來觸發問題或突發事件，而 自訂事件 會根據任何實體的個別度量值臨界值來觸發問題或突發事件。

如需 AWS DynamoDB 感應器建置事件的相關資訊，請參閱內建事件參照。

必要許可權

cloudwatch:GetMetricStatistics
cloudwatch:GetMetricData
dynamodb:ListTables
dynamodb:DescribeTable
dynamodb:ListTagsOfResource

配置

豆莖實例每 5 分鐘重新整理一次。由於偵測的非同步本質，實例度量可能會延遲。此延遲視指定的輪詢率 (cloudwatch_period) 而定，依預設，在儀表板上出現之前不會超過一分鐘。 DynamoDB 的度量每 5 分鐘取回一次，可以透過 /opt/instana/agent/etc/instana/configuration.yml中的代理程式配置來變更:

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

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

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

Proxy 配置

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

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

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

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

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

AWS STS 方法

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

com.instana.plugin.aws.dynamodb:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_3_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.dynamodb:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

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

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

輪詢率

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

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