AWS RDS のモニター
「 Instana 」エージェントをインストールすると、「 AWS RDS 」センサーが自動的に展開およびインストールされます。
「 AWS 」のドキュメントで、 AWS がサポートするその他のサービスについてご確認ください。
現在、 インフラストラクチャの相関関係は、単一インスタンスの AWS RDS データベース(またはAuroraクラスター)でのみサポートされています。 データベースに読み取りレプリカが設定されている場合、 Instana はどのインスタンスがデータベース呼び出しを実行したかを特定できないため、インフラストラクチャの相関付けは行えません。
センサー (データ収集)
追跡対象の構成
| RDS インスタンスの詳細 | 説明 |
|---|---|
| ARN | インスタンスに割り当てられている非修飾の Amazon リソース・ネーム (ARN)。 |
| エンドポイント | インスタンスのエンドポイント。 |
| ポート | インスタンスのポート。 |
| マスター・ユーザー | インスタンスのマスター・ユーザー。 |
| アベイラビリティー・ゾーン | インスタンスの場所。 |
| エンジン | インスタンス・エンジン。 |
| クラスター | クラスターのインスタンス。 |
メトリック
| RDS インスタンスのメトリック | 説明 |
|---|---|
| CPUUtilization | CPU 使用率 (%)。 |
| CPUCreditUsage | CPU 使用率に関してインスタンスによって消費される CPU クレジットの数。 |
| CPUCreditBalance | 起動または開始以降にインスタンスが発生した、獲得された CPU クレジットの数。 |
| BurstBalance | 使用可能な汎用 SSD (gp2) バースト・バケット入出力クレジットの割合 (%)。 |
| DatabaseConnections | 使用中のデータベース接続の数。 |
| DiskQueueDepth | ディスクへのアクセスを待機している未処理の入出力 (読み取り要求と書き込み要求) の数。 |
| FreeableMemory | 使用可能なランダム・アクセス・メモリーの量。 |
| FreeStorageSpace | 使用可能ストレージ・スペースの量。 |
| ReplicaLag | 読み取りレプリカ DB インスタンスがソース DBインスタンスより遅れている時間。 |
| SwapUsage | DB インスタンスで使用中のスワップ・スペースの量。 |
| ReadIOPS | ディスク読み取り入出力操作の 1 秒当たりの平均数。 |
| WriteIOPS | ディスク書き込み入出力操作の 1 秒当たりの平均数。 |
| ReadLatency | ディスク入出力操作当たりの平均所要時間。 |
| WriteLatency | ディスク入出力操作当たりの平均所要時間。 |
| ReadThroughput | ディスクから読み取られた 1 秒当たりの平均バイト数。 |
| WriteThroughput | ディスクに書き込まれた 1 秒当たりの平均バイト数。 |
| EBSIO残高% | RDS データベースのバースト・バケットに残っている I/O クレジットのパーセンテージ。 |
| NetworkReceiveThroughput | モニターおよび複製に使用される顧客データベース・トラフィックと Amazon RDS トラフィックの両方を含む、DB インスタンスでの着信ネットワーク・トラフィック。 |
| NetworkTransmitThroughput | モニターおよび複製に使用される顧客データベース・トラフィックと Amazon RDS トラフィックの両方を含む、DB インスタンスでの発信ネットワーク・トラフィック。 |
| VolumeBytesUsed (Aurora) | Aurora DB インスタンスによって使用中のストレージの量。 |
必要なアクセス権
cloudwatch:GetMetricStatisticscloudwatch:GetMetricDatards:DescribeDBInstancesrds:DescribeEventsrds:ListTagsForResource
構成
RDS のメトリックは 60 秒ごとにプルされます。これは、 <agent_install_dir>/etc/instana/configuration.ymlでのエージェント構成によって変更できます。
com.instana.plugin.aws.rds:
cloudwatch_period: 300
RDS インスタンスのモニターを無効にするには、以下の構成を使用します。
com.instana.plugin.aws.rds:
enabled: false
バッチ検出を有効にするにはRDSインスタンスは次の構成を使用します。
com.instana.plugin.aws.rds:
enable_batch_discovery: true # default false
プロキシー構成
プロキシー構成を使用するように特定の AWS センサーを構成するには、以下のエージェント構成設定を追加します。
com.instana.plugin.aws.rds:
proxy_host: 'example.com' # proxy host name or ip address
proxy_port: 3128 # proxy port
proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
proxy_username: 'username' # OPTIONAL: proxy username
proxy_password: 'password' # OPTIONAL: proxy password
複数の AWS アカウントのモニター
同じリージョン内の 1 つの AWS エージェントを使用して複数の AWS アカウントのモニターをセットアップするには、 複数の AWS アカウントのモニター の資料を参照してください。
AWS 名前付きプロファイルを使用する方法
RDS のモニターに使用するプロファイルをオーバーライドするには、以下の構成を使用します。
com.instana.plugin.aws.rds:
profile_names:
- 'profile2'
- 'profile3'
AWS STS を使用する方法
RDS のモニターに使用する IAM 役割をオーバーライドするには、以下の構成を使用します。
com.instana.plugin.aws.rds:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
フィルタリング
複数のタグを定義するには、コンマで区切ります。 タグは、「:」で区切られたキーと値のペアとして指定する必要があります。 構成を容易にするために、ディスカバリーに含めるタグを定義することも、ディスカバリーから除外するタグを定義することもできます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスのフィルタリングが不要な場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義する必要はありません。
ユーザーは、tagged-services-poll-rate 構成プロパティーを使用して、センサーが AWS タグ付きリソースをポーリングする頻度 (デフォルトは 300 秒) を指定できます。
センサーがタグ付きリソースをポーリングする頻度を定義するには、以下の構成を使用します。
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
RDS インスタンスのスロットルを減らすためにバッチ検出を有効にするには、次の構成を使用します。
com.instana.plugin.aws:
enable_batch_discovery: true #default false
タグごとのサービスをディスカバリーに含めるには、以下の構成を使用します。
com.instana.plugin.aws.rds:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
タグごとのサービスをディスカバリーから除外するには、以下の構成を使用します。
com.instana.plugin.aws.rds:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
タグなしの AWS サービスはデフォルトでモニターされますが、include_untagged フィールドを false に設定することによってモニター対象から除外できます。
com.instana.plugin.aws.rds:
include_untagged: false # True value by default
Instana エージェント・タグ
タグは、 AWS エージェントと一緒にのみ使用できます。 タグの使用方法の詳細については、こちらをご覧ください。