AWS DocumentDB¶
AWS DocumentDB の表示メトリクスには、読み取りおよび書き込みスループット、クエリレイテンシー、スケーラビリティなどが含まれます。
設定¶
Func のインストール¶
Guance統合 - 拡張 - マネージド版 Func を有効にすることを推奨します。前提条件はすべて自動でインストールされるので、そのままスクリプトをインストールしてください
自分でデプロイする場合はFunc を自分でデプロイする
インストールスクリプト¶
ヒント:要件を満たす Amazon AK を事前に用意してください(簡単のため、グローバル読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版有効化スクリプト¶
- Guanceコンソールにログインする
- 【統合】メニューをクリックし、【クラウドアカウント管理】を選択する
- 【クラウドアカウントを追加】をクリックし、【AWS】を選択して、画面に必要な情報を入力する。すでにクラウドアカウント情報を設定済みの場合は、この手順をスキップする
- 【テスト】をクリックし、テスト成功後に【保存】をクリックする。テストに失敗した場合は、関連する設定情報が正しいか確認してから再度テストする
- 【クラウドアカウント管理】一覧で追加済みのクラウドアカウントを確認できる。該当のクラウドアカウントをクリックして詳細ページに入る
- クラウドアカウント詳細ページの【統合】ボタンをクリックし、
未インストール一覧でAWS DocumentDBを見つけて、【インストール】ボタンをクリックし、表示されたインストール画面でインストールする
手動有効化スクリプト¶
-
Func コンソールにログインし、【スクリプト市場】をクリックして Guance スクリプト市場に入り、
integration_aws_documentdbを検索する -
【インストール】をクリックし、必要なパラメータとして AWS AK ID、AK Secret、およびアカウント名を入力する
-
【起動スクリプトをデプロイ】をクリックすると、システムが自動的に
Startupスクリプトセットを作成し、対応する起動スクリプトを自動で設定する -
有効化後は「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できる。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できる。少し待ってから、実行タスクの記録と対応するログを確認できる
検証¶
- 「管理 / 自動トリガー設定」で、該当タスクに対応する自動トリガー設定が存在するか確認し、あわせてタスク記録とログを確認して異常がないかチェックする
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認する
- Guance の「メトリクス」で対応する監視データがあるか確認する
メトリクス¶
Amazon CloudWatch を設定すると、デフォルトのメトリクスセットは次のとおりです。設定によりさらに多くのメトリクスを収集できます Amazon CloudWatch メトリクスの詳細
| メトリクス | 説明 |
|---|---|
CPUUtilization |
インスタンスが使用している CPU の割合。 |
FreeableMemory |
RAM の利用可能量(バイト単位)。 |
FreeLocalStorage |
このメトリクスは、各インスタンスで一時テーブルとログに使用できるストレージ量を示します。この値はインスタンスクラスによって異なります。インスタンスにより大きなインスタンスクラスを選択すると、利用可能なストレージ容量を増やせます。 |
SwapUsage |
インスタンス上で使用されているスワップ領域のサイズ。 |
DatabaseConnections |
1 分あたりの頻度でインスタンス上に開かれた接続数。 |
DatabaseConnectionsMax |
1 分間にインスタンス上で開かれた最大データベース接続数。 |
DatabaseCursors |
1 分あたりの頻度でインスタンス上に開かれたカーソル数。 |
DatabaseCursorsMax |
1 分間にインスタンス上で開かれた最大カーソル数。 |
DatabaseCursorsTimedOut |
1 分間にタイムアウトしたカーソル数。 |
LowMemThrottleQueueDepth |
利用可能メモリ不足により制限されたリクエストのキュー深度。頻度は 1 分。 |
LowMemThrottleMaxQueueDepth |
1 分間に、利用可能メモリ不足により制限されたリクエストの最大キュー深度。 |
LowMemNumOperationsThrottled |
1 分間に、利用可能メモリ不足により制限されたリクエスト数。 |
ReadThroughput |
1 秒あたりにディスクから読み取られる平均バイト数。 |
WriteThroughput |
1 秒あたりにディスクへ書き込まれる平均バイト数。 |
ReadIOPS |
1 秒あたりの平均ディスク読み取り I/O 操作数。Amazon DocumentDB は読み取りおよび書き込み IOPS を 1 分ごとに個別に報告します。 |
NetworkThroughput |
Amazon DocumentDB クラスター内の各インスタンスがクライアントから受信し、クライアントへ送信するネットワークスループット。単位は 1 秒あたりのバイト数です。このスループットには、クラスター内のインスタンスとクラスター ボリューム間のネットワークトラフィックは含まれません。 |
NetworkReceiveThroughput |
クラスター内の各インスタンスがクライアントから受信するネットワークスループット(1 秒あたりのバイト数)。このスループットには、クラスター内のインスタンスとクラスター ボリューム間のネットワークトラフィックは含まれません。 |
NetworkTransmitThroughput |
クラスター内の各インスタンスがクライアントへ送信するネットワークスループット(1 秒あたりのバイト数)。このスループットには、クラスター内のインスタンスとクラスター ボリューム間のネットワークトラフィックは含まれません。 |
WriteIOPS |
1 秒あたりの平均ディスク書き込み I/O 操作数。クラスター レベルで WriteIOPs を使用すると、クラスター内のすべてのインスタンスで評価されます。読み取りおよび書き込み IOPS は 1 分ごとに個別に報告されます。 |
ReadLatency |
各ディスク I/O 操作に要する平均時間。 |
WriteLatency |
各ディスク I/O 操作に要する平均時間(ミリ秒単位)。 |
DBInstanceReplicaLag |
主インスタンスからレプリカインスタンスへ更新を複製する際の遅延の合計量(ミリ秒単位)。 |
OpcountersQuery |
1 分間に発行されたクエリ数。 |
OpcountersCommand |
1 分間に発行されたコマンド数。 |
OpcountersDelete |
1 分間に発行された削除操作数。 |
OpcountersGetmore |
1 分間に発行された get more の数。 |
OpcountersInsert |
1 分間に発行された挿入操作数。 |
OpcountersUpdate |
1 分間に発行された更新操作数。 |
DocumentsDeleted |
1 分間に削除されたドキュメント数。 |
DocumentsInserted |
1 分間に挿入されたドキュメント数。 |
DocumentsReturned |
1 分間に返されたドキュメント数。 |
DocumentsUpdated |
1 分間に更新されたドキュメント数。 |
TTLDeletedDocuments |
TTLMonitor によって 1 分間に削除されたドキュメント数。 |
IndexBufferCacheHitRatio |
キャッシュによって提供されたインデックス要求の割合。インデックス、コレクション、またはデータベースを削除した直後に、このメトリクスが 100% を超えるスパイクとして表示される場合があります。これは 60 秒後に自動的に修正されます。この制限は今後のパッチ更新で修正されます。 |
BufferCacheHitRatio |
バッファキャッシュによって提供された要求の割合。 |
DiskQueueDepth |
分散ストレージボリュームの同時書き込みリクエスト数。 |
EngineUptime |
インスタンスが稼働していた時間の長さ(秒単位)。 |
オブジェクト¶
収集された AWS DocumentDB オブジェクトのデータ構造です。オブジェクトデータは「インフラストラクチャ - カスタム」で確認できます
{
"measurement": "aws_documentdb",
"tags": {
"AvailabilityZone" : "cn-north-1a",
"CACertificateIdentifier" : "rds-ca-2019",
"DBClusterIdentifier" : "docdb-2023-06",
"DBInstanceArn" : "arn:aws-cn:rds:cn-north-1:",
"DBInstanceClass" : "db.t3.medium",
"DBInstanceIdentifier" : "docdb-2023-07",
"DBInstanceStatus" : "available",
"DbiResourceId" : "db-CKJQ",
"Engine" : "docdb",
"EngineVersion" : "3.6.0",
"KmsKeyId" : "arn:aws-cn:kms:cn-north-1:",
"cloud_provider" : "aws",
"name" : "docdb-2023-07"
},
"fields": {
"DBSubnetGroup": "{}",
"Endpoint": "{\"Address\": \".docdb.cn-north-1.amazonaws.com.cn\", \"HostedZoneId\": \"Z010911BG9\", \"Port\": 27017}",
"InstanceCreateTime": "2023-07-28T05:45:10.004000Z",
"PendingModifiedValues": "{}",
"PubliclyAccessible": "False",
"StatusInfos": "{}",
"VpcSecurityGroups": "[{\"Status\": \"active\", \"VpcSecurityGroupId\": \"sg-08895f59\"}]",
"message": "{インスタンス JSON 情報}"
}
}
注意:
tags、fieldsの中のフィールドは、今後の更新に伴って変更される可能性があります