AWS RDS PostgreSQL
スクリプトマーケットの「Guanceクラウド同期」シリーズのスクリプトパッケージを使って、クラウド監視とクラウド資産のデータをGuanceに同期します
設定¶
Func をインストール¶
Guance統合 - 拡張 - マネージド版 Func の利用を推奨します。前提条件はすべて自動で整っているため、そのままスクリプトのインストールを続けてください
Func を自前でデプロイする場合はFunc を自前でデプロイ
スクリプトのインストール¶
ヒント: 要件を満たす Amazon AK を事前に用意してください(簡単にするため、グローバルの読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版のスクリプト有効化¶
- Guanceコンソールにログインします
- [統合] メニューをクリックし、[クラウドアカウント管理] を選択します
- [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
- [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
- [クラウドアカウント管理] の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
- クラウドアカウント詳細ページの [統合] ボタンをクリックし、
未インストール一覧からAWS RDS PostgreSQLを見つけて [インストール] をクリックすると、インストール画面が表示されるのでそのままインストールしてください
手動でのスクリプト有効化¶
-
Func コンソールにログインし、[スクリプトマーケット] をクリックして Guance スクリプトマーケットに入り、
integration_aws_rds_postgresqlを検索します -
[インストール] をクリックし、対応するパラメータとして 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 にはバイトで送信することがあります。
| メトリクス | コンソール名 | 説明 | 単位 |
|---|---|---|---|
BinLogDiskUsage |
バイナリログのディスク使用量 (MB) | バイナリログが占有しているディスク領域のサイズです。MySQL と MariaDB のインスタンス(読み取り専用レプリカを含む)で自動バックアップが有効になっている場合、バイナリログが作成されます。 | バイト |
BurstBalance |
バースト残高(%) | 利用可能な汎用 SSD (GP2) のバーストバケット I/O クレジットの割合です。 | パーセント |
CheckpointLag |
チェックポイント遅延(ミリ秒) | 直近のチェックポイントからの経過時間です。RDS for PostgreSQL にのみ適用されます。 | ミリ秒 |
ConnectionAttempts |
Connection Attempts (Count) [接続試行(カウント)] | インスタンスへの接続を試みた回数です。成功・失敗は問いません。 | カウント |
CPUUtilization |
CPU 使用率(%) | CPU の使用率です。 | パーセント |
CPUCreditUsage |
CPU クレジット使用量(カウント) | (T2 インスタンス)CPU 使用率を維持するためにインスタンスが消費した CPU クレジット数です。1 CPU クレジットは、1 vCPU を 100% の使用率で 1 分間実行した場合、または同等の vCPU・使用率・時間の組み合わせに相当します。たとえば、1 vCPU を 50% の使用率で 2 分間実行する、または 2 vCPU を 25% の使用率で 2 分間実行する、といった使い方ができます。CPU クレジットのメトリクスは 5 分ごとにのみ提供されます。5 分を超える期間を指定する場合は、Average ではなく Sum の統計を使用してください。 |
クレジット (vCPU 分) |
CPUCreditBalance |
CPU クレジット残高(カウント) | (T2 インスタンス)インスタンスの起動後に累積された CPU クレジット数です。T2 Standard では、CPUCreditBalance に起動クレジットの累積分も含まれます。クレジットを獲得すると、その分はクレジット残高に蓄積されます。クレジットを消費すると、その分が残高から差し引かれます。クレジット残高には上限があり、これはインスタンスサイズによって決まります。上限に達すると、新たに獲得したクレジットは破棄されます。T2 Standard では、起動クレジットは上限に含まれません。インスタンスは CPUCreditBalance のクレジットを消費して、ベースラインの CPU 使用率を超えてバーストできます。インスタンスの稼働中、CPUCreditBalance のクレジットは失効しません。インスタンス停止時には CPUCreditBalance は保持されず、蓄積されたクレジットはすべて失われます。CPU クレジットのメトリクスは 5 分ごとにのみ提供されます。起動クレジットの動作は、Amazon RDS でも Amazon EC2 でも同じです。詳細は、Linux インスタンス向け Amazon Elastic Compute Cloud ユーザーガイド の 起動クレジット を参照してください。 |
クレジット(vCPU 分) |
DatabaseConnections |
データベース接続(カウント) | データベースインスタンスに接続しているクライアントのネットワーク接続数です。データベースセッション数は、メトリクス値に次のものが含まれないため、これより多くなる場合があります。ネットワーク接続がなくなっているが、データベース側でまだクリーンアップされていないセッション、データベースエンジンが内部目的で作成したセッション、データベースエンジンの並列実行機能によって作成されたセッション、データベースエンジンのタスクスケジューラによって作成されたセッション、Amazon RDS 接続 | カウント |
DiskQueueDepth |
キュー深度(カウント) | ディスクへのアクセスを待機している未完了の I/O(読み取り/書き込み要求)の数です。 | カウント |
EBSByteBalance% |
EBS バイト残高(%) | RDS データベースのバーストバケットに残っているスループットクレジットの割合です。このメトリクスは基本モニタリングでのみ利用できます。このメトリクス値は、ルートボリュームを含むすべてのボリュームのスループットと IOPS に基づいており、データベースファイルを含むボリュームのみに基づくものではありません。このメトリクスをサポートするインスタンスサイズについては、Amazon EC2 ユーザーガイド(Linux インスタンス向け) のデフォルトで最適化された EBS 表にある、アスタリスク (*) が付いたインスタンスサイズを参照してください。Sum 統計はこのメトリクスでは使用できません。 |
パーセント |
EBSIOBalance% |
EBS IO 残高(%) | RDS データベースのバーストバケットに残っている I/O クレジットの割合です。このメトリクスは基本モニタリングでのみ利用できます。このメトリクス値は、ルートボリュームを含むすべてのボリュームのスループットと IOPS に基づいており、データベースファイルを含むボリュームのみに基づくものではありません。このメトリクスをサポートするインスタンスサイズについては、Amazon EC2 ユーザーガイド(Linux インスタンス向け) のデフォルトで最適化された EBS 表にある、アスタリスク (*) が付いたインスタンスサイズを参照してください。Sum 統計はこのメトリクスでは使用できません。このメトリクスは BurstBalance とは異なります。このメトリクスの使い方については、Amazon EBS 最適化インスタンスのバースト機能を活用してアプリケーションのパフォーマンスを向上させ、コストを削減する を参照してください。 |
パーセント |
FailedSQLServerAgentJobsCount |
Failed SQL Server Agent Jobs Count (Count/Minute) (失敗した SQL Server Agent ジョブ数(カウント/分)) | 過去 1 分間に失敗した Microsoft SQL Server Agent ジョブの数です。 | カウント/分 |
FreeableMemory |
利用可能メモリ (MB) | RAM の利用可能なサイズです。MariaDB、MySQL、Oracle、および PostgreSQL のデータベースインスタンスでは、このメトリクスは /proc/meminfo の MemAvailable フィールドの値を報告します。 |
バイト |
FreeLocalStorage |
Free Local Storage (MB)(利用可能ローカルストレージ (MB)) | 利用可能なローカルストレージ容量です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。(Aurora Serverless v2 には適用されません。) | バイト |
FreeStorageSpace |
利用可能ストレージ容量 (MB) | 利用可能なストレージ容量です。 | バイト |
MaximumUsedTransactionIDs |
最大使用済みトランザクション ID(カウント) | 使用されたトランザクション ID の最大値です。PostgreSQL にのみ適用されます。 | カウント |
NetworkReceiveThroughput |
ネットワーク受信スループット(MB/秒) | データベースインスタンスへの受信ネットワークトラフィックです。これには、監視とレプリケーションのための顧客データベーストラフィックと Amazon RDS のトラフィックが含まれます。 | バイト/秒 |
NetworkTransmitThroughput |
ネットワーク送信スループット(MB/秒) | データベースインスタンスからの送信ネットワークトラフィックです。これには、監視とレプリケーションのための顧客データベーストラフィックと Amazon RDS のトラフィックが含まれます。 | バイト/秒 |
OldestReplicationSlotLag |
最古のレプリケーションスロット遅延 (MB) | 先行書き込みログ (WAL) データの受信で最も遅れているレプリケーションの遅延量です。PostgreSQL に適用されます。 | バイト |
ReadIOPS |
読み取り IOPS(カウント/秒) | 1 秒あたりの平均ディスク読み取り I/O 操作数です。 | カウント/秒 |
ReadIOPSLocalStorage |
Read IOPS Local Storage (Count/Second)(読み取り IOPS ローカルストレージ(カウント/秒)) | ローカルストレージへの 1 秒あたりの平均ディスク読み取り I/O 操作数です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | カウント/秒 |
ReadLatency |
読み取り遅延(ミリ秒) | 各ディスク I/O 操作にかかる平均時間です。 | ミリ秒 |
ReadLatencyLocalStorage |
Read Latency Local Storage (Milliseconds)(読み取り遅延 ローカルストレージ(ミリ秒)) | ローカルストレージへの各ディスク I/O 操作にかかる平均時間です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | ミリ秒 |
ReadThroughput |
読み取りスループット(MB/秒) | 1 秒あたりにディスクから読み取られる平均バイト数です。 | バイト/秒 |
ReadThroughputLocalStorage |
Read Throughput Local Storage (MB/Second)(読み取りスループット ローカルストレージ(MB/秒)) | ローカルストレージへディスクから 1 秒あたりに読み取られる平均バイト数です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | バイト/秒 |
ReplicaLag |
レプリカ遅延(ミリ秒) | 読み取り専用レプリカ構成では、読み取り専用レプリカのデータベースインスタンスがソースデータベースインスタンスより遅れている時間です。MariaDB、Microsoft SQL Server、MySQL、Oracle、および PostgreSQL の読み取り専用レプリカに適用されます。マルチ AZ データベースクラスターでは、ライターデータベースインスタンス上の最新トランザクションとリーダーデータベースインスタンス上の最新適用済みトランザクションとの差分時間です。 | ミリ秒 |
ReplicationSlotDiskUsage |
レプリケーションスロットのディスク使用量 (MB) | レプリケーションスロットファイルが使用しているディスク領域です。PostgreSQL に適用されます。 | バイト |
SwapUsage |
スワップ使用量 (MB) | データベースインスタンスで使用されているスワップ領域のサイズです。このメトリクスは SQL Server では利用できません。 | バイト |
TransactionLogsDiskUsage |
トランザクションログのディスク使用量 (MB) | トランザクションログが使用しているディスク領域です。PostgreSQL に適用されます。 | バイト |
TransactionLogsGeneration |
トランザクションログ生成量(MB/秒) | 1 秒あたりに生成されるトランザクションログのサイズです。PostgreSQL に適用されます。 | バイト/秒 |
WriteIOPS |
書き込み IOPS(カウント/秒) | 1 秒あたりの平均ディスク書き込み I/O 操作数です。 | カウント/秒 |
WriteIOPSLocalStorage |
Write IOPS Local Storage (Count/Second)(書き込み IOPS ローカルストレージ(カウント/秒)) | ローカルストレージ上の 1 秒あたりの平均ディスク書き込み I/O 操作数です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | カウント/秒 |
WriteLatency |
書き込み遅延(ミリ秒) | 各ディスク I/O 操作にかかる平均時間です。 | ミリ秒 |
WriteLatencyLocalStorage |
Write Latency Local Storage (Milliseconds)(書き込み遅延 ローカルストレージ(ミリ秒)) | ローカルストレージ上の各ディスク I/O 操作にかかる平均時間です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | ミリ秒 |
WriteThroughput |
書き込みスループット(MB/秒) | 1 秒あたりにディスクへ書き込まれる平均バイト数です。 | バイト/秒 |
WriteThroughputLocalStorage |
Write Throughput Local Storage (MB/Second)(書き込みスループット ローカルストレージ(MB/秒)) | ローカルストレージへ 1 秒あたりにディスクへ書き込まれる平均バイト数です。このメトリクスは、NVMe SSD インスタンスストレージボリュームを持つデータベースインスタンスクラスでのみ利用できます。NVMe SSD インスタンスストレージボリュームを持つ Amazon EC2 インスタンスの詳細は、インスタンスストレージボリューム を参照してください。対応する RDS データベースインスタンスクラスは同じインスタンスストレージボリュームを持ちます。たとえば、db.m6gd と db.r6gd のデータベースインスタンスクラスには NVMe SSD インスタンスストレージボリュームがあります。 | バイト/秒 |
オブジェクト¶
収集された AWS RDS PostgreSQL オブジェクトのデータ構造です。オブジェクトデータは「インフラ - リソースディレクトリ」で確認できます。
{
"measurement": "aws_rds",
"tags": {
"name" : "xxxxx",
"RegionId" : "cn-northwest-1",
"Engine" : "postgres",
"DBInstanceClass" : "db.t3.medium",
"DBInstanceIdentifier" : "xxxxxx",
"AvailabilityZone" : "cn-northwest-1c",
"SecondaryAvailabilityZone": "ap-southeast-1c"
},
"fields": {
"InstanceCreateTime" : "2025-05-19T19:54:07.871Z",
"LatestRestorableTime": "2025-05-19T19:54:07.871Z",
"Endpoint" : "{接続先アドレスの JSON データ}",
"AllocatedStorage" : 100,
"message" : "{インスタンスの JSON データ}",
}
}
注意:
tags、fieldsのフィールドは今後の更新で変更される可能性がありますヒント 1:
tags.nameの値はインスタンス ID であり、一意識別子として使用しますヒント 2:
fields.message、fields.Endpointはいずれも JSON シリアライズ後の文字列です