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スクリプトセットが作成され、対応する起動スクリプトが自動設定されます。 -
有効にすると「管理 / 自動トリガー設定」に対応する設定が表示されます。[実行]でスケジュールを待たずに実行できます。しばらくすると実行履歴とログを確認できます。
検証¶
- [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
- Guance の[インフラストラクチャ / カスタム]で、アセット情報が存在するか確認します。
- Guance の[メトリクス]で、対応する監視データが存在するか確認します。
メトリクス¶
Amazon のクラウド監視を設定すると、以下のメトリクスがデフォルトで収集されます。設定により追加のメトリクスも収集できます。 Amazon クラウド監視メトリクスの詳細
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 |
ProvisionedReadCapacityUnits¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
ProvisionedReadCapacityUnits_Average |
テーブルまたはグローバルセカンダリインデックスの平均プロビジョニング読み取りキャパシティー。 | Count | TableName;インデックスには次も含む GlobalSecondaryIndexName |
ProvisionedWriteCapacityUnits¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
ProvisionedWriteCapacityUnits_Average |
テーブルまたはグローバルセカンダリインデックスの平均プロビジョニング書き込みキャパシティー。 | Count | TableName;インデックスには次も含む GlobalSecondaryIndexName |
ReadThrottleEvents¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
ReadThrottleEvents_Sum |
プロビジョニングされたキャパシティー超過でスロットリングされた読み取りイベント数。 | Count | TableName;インデックスには次も含む GlobalSecondaryIndexName |
SuccessfulRequestLatency¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
SuccessfulRequestLatency_Average |
成功リクエストのサーバー側平均処理時間です。ネットワークとクライアントの時間は含みません。 | ms | TableName, Operation;ストリームリクエストには次も含む StreamLabel |
ThrottledRequests¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
ThrottledRequests_Sum |
スループット上限の超過でスロットリングされたリクエスト数。 | Count | TableName, Operation |
UserErrors¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
UserErrors_Sum |
現在のアカウントとリージョンの HTTP 400 エラー数です。スループット超過と条件チェック失敗は含みません。 | Count | - |
WriteThrottleEvents¶
| メトリクス名前 | 説明 | 単位 | ディメンション |
|---|---|---|---|
WriteThrottleEvents_Sum |
プロビジョニングされたキャパシティー超過でスロットリングされた書き込みイベント数。 | Count | TableName;インデックスには次も含む GlobalSecondaryIndexName |
オブジェクト¶
収集した 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 シリアライズ後の文字列です