AWS RDS MySQL¶
スクリプトマーケットの「Guanceクラウド同期」シリーズスクリプトパッケージを使って、クラウド監視・クラウド資産のデータをGuanceに同期します
設定¶
Func のインストール¶
Guance統合 - 拡張 - マネージド版 Func を有効化することを推奨します。前提条件はすべて自動でインストールされるので、そのままスクリプトのインストールに進んでください
Func を自前でデプロイする場合はFunc を自前でデプロイするを参照してください
スクリプトのインストール¶
ヒント:要件を満たす Amazon AK を事前に用意してください(簡単のため、グローバル読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版の有効化スクリプト¶
- Guanceコンソールにログインする
- [統合] メニューをクリックし、[クラウドアカウント管理] を選択する
- [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力する。すでにクラウドアカウント情報を設定済みの場合は、この手順を省略する
- [テスト] をクリックし、テスト成功後に [保存] をクリックする。テストに失敗した場合は、関連する設定情報が正しいか確認してから再度テストする
- [クラウドアカウント管理] の一覧で追加済みのクラウドアカウントを確認し、該当のクラウドアカウントをクリックして詳細ページに入る
- クラウドアカウント詳細ページの [統合] ボタンをクリックし、
未インストール一覧からAWS RDS MySQLを見つけて [インストール] ボタンをクリックすると、インストール画面が表示されるのでインストールする
手動での有効化スクリプト¶
-
Func コンソールにログインし、[スクリプトマーケット] をクリックして Guanceスクリプトマーケットに入り、
integration_aws_rdsを検索する -
[インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力する
-
[デプロイしてスクリプトを起動] をクリックすると、システムが自動で
Startupスクリプトセットを作成し、対応する起動スクリプトを自動設定する -
有効化後は「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できる。[実行] をクリックすると、定期実行を待たずに即時で 1 回実行できる。少し待ってから、実行タスクの記録と対応するログを確認できる
検証¶
- 「管理 / 自動トリガー設定」で該当タスクの自動トリガー設定が存在するか確認し、あわせてタスク記録とログを確認して異常がないかチェックする
- Guance の「基盤 / カスタム」で資産情報が存在するか確認する
- Guance の「メトリクス」で対応する監視データがあるか確認する
メトリクス¶
Amazon CloudWatch の設定後、デフォルトのメトリクスセットは以下のとおりです。設定により、さらに多くのメトリクスを収集できます。Amazon CloudWatch メトリクスの詳細
Amazon RDS の Amazon CloudWatch インスタンスレベルメトリクス¶
Amazon CloudWatch の AWS/RDS 名前空間には、以下のインスタンスレベルメトリクスが含まれます。
注意:
Amazon RDS コンソールでは、Amazon CloudWatch に送信される単位とは異なる単位でメトリクスが表示される場合があります。たとえば、Amazon RDS コンソールではあるメトリクスをメガバイト (MB) で表示し、Amazon CloudWatch にはバイトで送信することがあります。
以下の表は AWS 公式ドキュメントに基づいて整理したもので、MySQL に適用されるもの、またはすべてのインスタンスに適用されるメトリクスのみを残しています。
| メトリクス | 適用対象 | 説明 | 単位 |
|---|---|---|---|
BinLogDiskUsage |
MySQL | バイナリログが使用するディスク容量。MySQL および MariaDB インスタンス(読み取り専用レプリカを含む)で自動バックアップが有効になっている場合、バイナリログが作成されます。 | バイト |
BurstBalance |
すべて | 利用可能な汎用 SSD (GP2) のバーストバケット I/O クレジットの割合。 | パーセント |
ConnectionAttempts |
MySQL | 成功・失敗を問わず、インスタンスへの接続試行回数。 | カウント |
CPUUtilization |
すべて | CPU 使用率。 | パーセント |
CPUCreditUsage |
すべて | インスタンスが CPU 使用率を維持するために消費した CPU クレジット数。1 CPU クレジットは、1 vCPU を 100% の使用率で 1 分間実行するか、同等の vCPU・使用率・時間の組み合わせに相当します。このメトリクスは db.t2、db.t3、db.t4g インスタンスにのみ適用されます。CPU クレジットメトリクスは 5 分ごとにのみ提供されます。5 分を超える期間を指定する場合は、Sum 統計値の使用を推奨します。 |
クレジット(vCPU 分) |
CPUCreditBalance |
すべて | インスタンス起動後に累積された CPU クレジット数。T2 Standard では、CPUCreditBalance に累積起動クレジットも含まれます。このメトリクスは db.t2、db.t3、db.t4g インスタンスにのみ適用されます。 |
クレジット(vCPU 分) |
CPUSurplusCreditBalance |
すべて | CPUCreditBalance が 0 のときにバースト可能インスタンスで消費された超過クレジット数。 |
クレジット(vCPU 分) |
CPUSurplusCreditsCharged |
すべて | 獲得済みの CPU クレジットで支払われず、追加料金の対象となる超過クレジット消費量。 | クレジット(vCPU 分) |
DatabaseConnections |
すべて | データベースインスタンスに接続しているクライアントのネットワーク接続数。ネットワークが切断されたがまだクリーンアップされていないセッション、DB 内部セッション、並列実行セッション、タスクスケジューラセッション、Amazon RDS 接続は含まれないため、データベースセッション数の方がこのメトリクス値より多くなることがあります。 | カウント |
DiskQueueDepth |
すべて | ディスクへのアクセスを待機している未完了 I/O(読み取り/書き込み要求)の数。 | カウント |
DiskQueueDepthLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリュームディスクへのアクセスを待機している未完了 I/O(読み取り/書き込み要求)の数。 | カウント |
EBSByteBalance% |
すべて | RDS データベースバーストバケットに残っているスループットクレジットの割合。このメトリクスは基本監視でのみ利用できます。 | パーセント |
EBSIOBalance% |
すべて | RDS データベースバーストバケットに残っている I/O クレジットの割合。このメトリクスは基本監視でのみ利用できます。 | パーセント |
FreeableMemory |
すべて | 使用可能な RAM 容量。MariaDB、MySQL、Oracle、PostgreSQL の各データベースインスタンスでは、このメトリクスは /proc/meminfo の MemAvailable フィールド値を報告します。 |
バイト |
FreeLocalStorage |
すべて | 空きローカルストレージ容量。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | バイト |
FreeLocalStoragePercent |
すべて | 空きローカルストレージ容量の割合。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | パーセント |
FreeStorageSpace |
すべて | 空きストレージ容量。 | バイト |
FreeStorageSpaceLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリューム上の空きストレージ容量。 | バイト |
IamDbAuthConnectionRequests |
すべて | IAM 認証を使用してデータベースインスタンスにアクセスする接続リクエスト数。 | カウント |
NetworkReceiveThroughput |
すべて | データベースインスタンスへの受信ネットワークトラフィック。監視およびレプリケーション用の顧客データベーストラフィックと Amazon RDS トラフィックを含みます。 | バイト/秒 |
NetworkTransmitThroughput |
すべて | データベースインスタンスからの送信ネットワークトラフィック。監視およびレプリケーション用の顧客データベーストラフィックと Amazon RDS トラフィックを含みます。 | バイト/秒 |
ReadIOPS |
すべて | 1 秒あたりの平均ディスク読み取り I/O 操作数。 | カウント/秒 |
ReadIOPSLocalStorage |
すべて | ローカルストレージへの 1 秒あたりの平均ディスク読み取り I/O 操作数。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | カウント/秒 |
ReadIOPSLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリュームへの 1 秒あたりの平均ディスク読み取り I/O 操作数。 | カウント/秒 |
ReadLatency |
すべて | 各ディスク I/O 操作に要する平均時間。 | 秒 |
ReadLatencyLocalStorage |
すべて | ローカルストレージへの各ディスク入出力操作に要する平均時間。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | 秒 |
ReadLatencyLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリュームへの各ディスク I/O 操作に要する平均時間。 | 秒 |
ReadThroughput |
すべて | 1 秒あたりにディスクから読み取られる平均バイト数。 | バイト/秒 |
ReadThroughputLocalStorage |
すべて | 1 秒あたりにディスクからローカルストレージへ読み取られる平均バイト数。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | バイト/秒 |
ReadThroughputLogVolume |
専用ログボリュームが有効なデータベースインスタンス | 1 秒あたりにディスクからログボリュームへ読み取られる平均バイト数。 | バイト/秒 |
ReplicaLag |
すべて | 読み取り専用レプリカ構成では、読み取り専用レプリカデータベースインスタンスがソースデータベースインスタンスに遅延している時間。マルチ AZ データベースクラスターでは、ライターインスタンス上の最新トランザクションとリーダーインスタンス上の最新適用トランザクションの時間差を表します。 | 秒 |
ReplicationChannelLag |
MySQL | マルチソースレプリカ構成では、マルチソースレプリカ上の特定チャネルがソースデータベースインスタンスに遅延している時間。 | 秒 |
SwapUsage |
MySQL | データベースインスタンス上で使用されているスワップ領域のサイズ。 | バイト |
WriteIOPS |
すべて | 1 秒あたりの平均ディスク書き込み I/O 操作数。 | カウント/秒 |
WriteIOPSLocalStorage |
すべて | ローカルストレージ上の 1 秒あたりの平均ディスク書き込み I/O 操作数。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | カウント/秒 |
WriteIOPSLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリュームへの 1 秒あたりの平均ディスク書き込み I/O 操作数。 | カウント/秒 |
WriteLatency |
すべて | 各ディスク I/O 操作に要する平均時間。 | 秒 |
WriteLatencyLocalStorage |
すべて | ローカルストレージ上の各ディスク I/O 操作に要する平均時間。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | 秒 |
WriteLatencyLogVolume |
専用ログボリュームが有効なデータベースインスタンス | ログボリュームへの各ディスク I/O 操作に要する平均時間。 | 秒 |
WriteThroughput |
すべて | 1 秒あたりにディスクへ書き込まれる平均バイト数。 | バイト/秒 |
WriteThroughputLogVolume |
専用ログボリュームが有効なデータベースインスタンス | 1 秒あたりにログボリュームへディスク書き込みされる平均バイト数。 | バイト/秒 |
WriteThroughputLocalStorage |
すべて | ローカルストレージへの 1 秒あたりの平均ディスク書き込みバイト数。このメトリクスは NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスにのみ適用されます。 | バイト/秒 |
Amazon RDS の Amazon CloudWatch 使用量メトリクス¶
Amazon CloudWatch の AWS/Usage 名前空間には、Amazon RDS サービスクォータのアカウントレベル使用量メトリクスが含まれます。CloudWatch はすべての AWS リージョンの使用量メトリクスを自動収集します。
詳細については、『Amazon CloudWatch ユーザーガイド』の CloudWatch 使用量メトリクス を参照してください。クォータの詳細については、『Service Quotas ユーザーガイド』の Amazon RDS のクォータと制限 および クォータ増加のリクエスト を参照してください。
| メトリクス | 説明 | 単位* |
|---|---|---|
AllocatedStorage |
すべてのデータベースインスタンスの合計ストレージ容量。合計には一時移行インスタンスは含まれません。 | ギガバイト |
AuthorizationsPerDBSecurityGroup |
AWS アカウント内の各データベースセキュリティグループのインバウンドルール数。使用値はアカウント内のデータベースセキュリティグループにおけるインバウンドルールの最大数です。 | カウント |
CustomEndpointsPerDBCluster |
AWS アカウント内の各データベースクラスターのカスタムエンドポイント数。使用値はアカウント内のデータベースクラスターにおけるカスタムエンドポイントの最大数です。 | カウント |
CustomEngineVersions |
AWS アカウント内の Amazon RDS Custom のカスタムエンジンバージョン(CEV)数。 | カウント |
DBClusterParameterGroups |
AWS アカウント内のデータベースクラスター・パラメータグループ数。デフォルトのパラメータグループは含まれません。 | カウント |
DBClusterRoles |
AWS アカウント内の各データベースクラスターに関連付けられた AWS Identity and Access Management(IAM)ロール数。使用値はアカウント内のデータベースクラスターに関連付けられた IAM ロールの最大数です。 | カウント |
DBClusters |
AWS アカウント内の Amazon Aurora データベースクラスター数。 | カウント |
DBInstanceRoles |
AWS アカウント内の各データベースインスタンスに関連付けられた AWS Identity and Access Management(IAM)ロール数。使用値はアカウント内のデータベースインスタンスに関連付けられた IAM ロールの最大数です。 | カウント |
DBInstances |
AWS アカウント内のデータベースインスタンス数。 | カウント |
DBParameterGroups |
AWS アカウント内のデータベースパラメータグループ数。デフォルトのデータベースパラメータグループは含まれません。 | カウント |
DBSecurityGroups |
AWS アカウント内のセキュリティグループ数。デフォルトのセキュリティグループとデフォルト VPC セキュリティグループは含まれません。 | カウント |
DBSubnetGroups |
AWS アカウント内のデータベースサブネットグループ数。デフォルトのサブネットグループは含まれません。 | カウント |
EventSubscriptions |
AWS アカウント内のイベント通知サブスクリプション数。 | カウント |
Integrations |
AWS アカウント内の Amazon Redshift との Zero-ETL 統合数。 | カウント |
ManualClusterSnapshots |
AWS アカウント内で手動作成されたデータベースクラスターのスナップショット数。無効なスナップショットは含まれません。 | カウント |
ManualSnapshots |
AWS アカウント内で手動作成されたデータベーススナップショット数。無効なスナップショットは含まれません。 | カウント |
OptionGroups |
AWS アカウント内のオプショングループ数。デフォルトのオプショングループは含まれません。 | カウント |
Proxies |
AWS アカウント内の RDS プロキシ数。 | カウント |
ReadReplicasPerMaster |
アカウント内の各データベースインスタンスの読み取り専用レプリカ数。使用値はアカウント内のデータベースインスタンスの読み取り専用レプリカ最大数です。 | カウント |
ReservedDBInstances |
AWS アカウント内の予約済みデータベースインスタンス数。停止または拒否されたインスタンスは含まれません。 | カウント |
SubnetsPerDBSubnetGroup |
AWS アカウント内の各データベースサブネットグループのサブネット数。使用値はアカウント内のデータベースサブネットグループ内のサブネット最大数です。 | カウント |
* Amazon RDS は使用量メトリクスの単位を CloudWatch に公開しません。これらの単位はドキュメントにのみ表示されます。
オブジェクト¶
収集された AWS RDS MySQL オブジェクトデータ構造。オブジェクトデータは「基盤 - カスタム」から確認できます
{
"measurement": "aws_rds",
"tags": {
"name" : "xxxxx",
"RegionId" : "cn-northwest-1",
"Engine" : "mysql",
"DBInstanceClass" : "db.t3.medium",
"DBInstanceIdentifier" : "xxxxxx",
"AvailabilityZone" : "cn-northwest-1c",
"SecondaryAvailabilityZone": "cn-northwest-1d"
},
"fields": {
"InstanceCreateTime" : "2018-03-28T19:54:07.871Z",
"LatestRestorableTime": "2018-03-28T19:54:07.871Z",
"Endpoint" : "{接続アドレス JSON データ}",
"AllocatedStorage" : 100,
"message" : "{インスタンス JSON データ}",
}
}
注意:
tags、fieldsのフィールドは後続の更新により変更される場合がありますヒント 1:
tags.nameの値はインスタンス ID で、一意識別子として使用されますヒント 2:
fields.message、fields.Endpointはいずれも JSON シリアライズ後の文字列です