AWS DynamoDB¶

AWS DynamoDB の表示指標には、スループットキャパシティユニット、レイテンシ、同時接続数、読み書きスループットなどが含まれ、これらの指標は DynamoDB が大規模なデータ保存とアクセスを処理する際のパフォーマンスとスケーラビリティを示します。

設定¶

Func のインストール¶

Guance の統合 - 拡張 - マネージド版 Func を有効化することを推奨します: 事前条件はすべて自動でインストールされます。続けてスクリプトのインストールを行ってください。

Func を自前でデプロイする場合は Func の自前デプロイを参照してください。

インストールスクリプト¶

ヒント: 要件を満たす Amazon AK を事前に用意してください（簡単のため、グローバル読み取り専用権限 ReadOnlyAccess を直接付与しても構いません）

マネージド版有効化スクリプト¶

Guance コンソールにログインします
【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
【クラウドアカウントを追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
【テスト】をクリックし、成功したら【保存】をクリックします。テストに失敗した場合は、関連する設定情報が正しいか確認してから再度テストしてください
【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当のクラウドアカウントをクリックして詳細ページに入ります
クラウドアカウント詳細ページの【統合】ボタンをクリックし、未インストール 一覧で AWS DynamoDB を見つけて【インストール】ボタンをクリックすると、インストール画面が表示されるのでインストールします。

手動有効化スクリプト¶

Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance スクリプトマーケットに入り、integration_aws_dynamodb を検索します
【インストール】をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します。
【デプロイして起動スクリプトを実行】をクリックすると、システムが自動的に Startup スクリプトセットを作成し、対応する起動スクリプトを自動で設定します。
有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。しばらくすると、実行タスクの記録と対応するログを確認できます。

検証¶

「管理 / 自動トリガー設定」で、対応するタスクに自動トリガー設定が存在するか確認し、同時にタスク記録とログを見て異常がないか確認します
Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
Guance の「メトリクス」で対応する監視データがあるか確認します

指標¶

Amazon CloudWatch を設定すると、デフォルトの指標セットは以下のとおりです。設定によってさらに多くの指標を収集できます Amazon CloudWatch 指標の詳細

ConditionalCheckFailedRequests¶

条件付き書き込みの試行失敗回数。

指標名	説明	単位	次元
ConditionalCheckFailedRequests_Average	エラーリクエストの平均数	Count	TableName
ConditionalCheckFailedRequests_Maximum	エラーリクエストの最大値	Count	TableName
ConditionalCheckFailedRequests_Minimum	エラーリクエストの最小値	Count	TableName
ConditionalCheckFailedRequests_SampleCount	エラーリクエスト数	Count	TableName
ConditionalCheckFailedRequests_Sum	エラーリクエストの合計数	Count	TableName

ConsumedReadCapacityUnits¶

指定期間内に消費された読み取りキャパシティユニット数で、プロビジョンドスループットの使用状況を追跡できます。

指標名	説明	単位	次元
ConsumedReadCapacityUnits_Average	各リクエストで消費された平均読み取りキャパシティ	Count	TableName
ConsumedReadCapacityUnits_Maximum	テーブルまたはインデックスへの任意のリクエストで消費された最大読み取りキャパシティユニット数	Count	TableName
ConsumedReadCapacityUnits_Minimum	テーブルまたはインデックスへの任意のリクエストで消費された最小読み取りキャパシティユニット数	Count	TableName
ConsumedReadCapacityUnits_SampleCount	読み取りキャパシティを消費しなかった場合も含む、DynamoDB への読み取りリクエスト数	Count	TableName
ConsumedReadCapacityUnits_Sum	消費された総読み取りキャパシティユニット数	Count	TableName

ConsumedWriteCapacityUnits¶

指定期間内に消費された書き込みキャパシティユニット数で、プロビジョンドスループットの使用状況を追跡できます。

指標名	説明	単位	次元
ConsumedWriteCapacityUnits_Average	各リクエストで消費された平均書き込みキャパシティ	Count	TableName
ConsumedWriteCapacityUnits_Maximum	テーブルまたはインデックスへの任意のリクエストで消費された最大書き込みキャパシティユニット数	Count	TableName
ConsumedWriteCapacityUnits_Minimum	テーブルまたはインデックスへの任意のリクエストで消費された最小書き込みキャパシティユニット数	Count	TableName
ConsumedWriteCapacityUnits_SampleCount	読み取りキャパシティを消費しなかった場合も含む、DynamoDB への書き込みリクエスト数	Count	TableName
ConsumedWriteCapacityUnits_Sum	消費された総書き込みキャパシティユニット数	Count	TableName

オブジェクト¶

収集された AWS DynamoDB オブジェクトデータ構造。オブジェクトデータは「インフラストラクチャ - カスタム」で確認できます

{
  "measurement": "aws_dynamodb",
  "tags": {
      "RegionId"        : "cn-north-1",
      "TableArn"        : "arn:aws-cn:dynamodb:cn-north-1:",
      "TableId"         : "0ce8d4f9b35",
      "TableName"       : "eks-tflock",
      "TableStatus"     : "ACTIVE",
      "name"            : "eks-tflock"
  },
  "fields": {
    "AttributeDefinitions"  : "[{\"AttributeName\": \"LockID\", \"AttributeType\": \"S\"}]",
    "BillingModeSummary"    : "{}",
    "CreationDateTime"      : "2023-03-22T23:39:42.352000+08:00",
    "ItemCount"             : "1",
    "KeySchema"             : "[{\"AttributeName\": \"LockID\", \"KeyType\": \"HASH\"}]",
    "LocalSecondaryIndexes" : "{}",
    "TableSizeBytes"        : "96",
    "message"               : "{インスタンス json 情報}"
  }
}

注意: tags、fields の中のフィールドは後続の更新により変更される場合があります

ヒント 1: tags.name の値はインスタンス ID であり、一意識別子として使用されます

ヒント 2: fields.message、fields.Endpoint はいずれも JSON シリアライズ後の文字列です