AWS DynamoDB のモニター

「 Instana 」エージェントをインストールすると、「 AWS DynamoDB 」センサーが自動的に展開およびインストールされます。

注: サポートされるその他の AWS サービスについては、AWS の資料を使用してください。

メトリック収集

メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。

構成データ

  • 表の ARN
  • テーブル名
  • 表の状況
  • 表の項目数
  • 表の作成時刻
  • 表のサイズ (バイト)
  • 表のストリーム ARN
  • 表のストリーム・ラベル
  • グループ化ゾーン (リージョン)

パフォーマンス・メトリック

名前
消費された読み取りキャパシティー
プロビジョニングされた読み取りキャパシティー
消費された書き込みキャパシティー
プロビジョニングされた書き込みキャパシティー
スロットルされた読み取り要求 (Get、Scan、Query、Batch Get)
スロットルされた書き込み要求 (Put、Update、Delete、Batch Write)
TTL で削除された項目
失敗した条件付きチェック
ユーザー・エラー
システム・エラーの読み取り (Get、Scan、Query、Batch get)
システム・エラーの書き込み (Put、Update、Delete、Batch Write)
返された照会項目の数 (最小、最大、平均、合計)
返されたスキャン項目の数 (最小、最大、平均、合計)
Batch Get 待ち時間 (最小、最大、平均、合計、要求数)
Batch Write 待ち時間 (最小、最大、平均、合計、要求数)
Delete 待ち時間 (最小、最大、平均、合計、要求数)  
Get 待ち時間 (最小、最大、平均、合計、要求数)
Put 待ち時間 (最小、最大、平均、合計、要求数)
Query 待ち時間 (最小、最大、平均、合計、要求数)
Scan 待ち時間 (最小、最大、平均、合計、要求数)
Update 待ち時間 (最小、最大、平均、合計、要求数)

詳細については、 「 Amazon DynamoDB のメトリクスとディメンション」 を参照してください。

正常性シグニチャー

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーの影響に依存する問題またはインシデントを発生させるために使用される、キュレートされたヘルス・シグニチャーの知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

AWS DynamoDB センサーのビルド・イベントについては、組み込みイベントのリファレンスを参照してください。

必要なアクセス権

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • dynamodb:ListTables
  • dynamodb:DescribeTable
  • dynamodb:ListTagsOfResource

構成

Beanstalk インスタンスは 5 分ごとに最新表示されます。 検出の非同期的な性質のため、インスタンス・メトリックが遅くなる可能性があります。 この遅延は、指定されたポーリング・レート (cloudwatch_period) によって異なり、デフォルトでは、ダッシュボードに表示されるまでに 1 分を超えることはありません。 DynamoDB のメトリックは 5 分ごとにプルされます。これは、/opt/instana/agent/etc/instana/configuration.ymlのエージェント構成を使用して変更できます。

com.instana.plugin.aws.dynamodb:
  cloudwatch_period: 300

DynamoDB インスタンスのモニターを無効にするには、以下の構成を使用します。

com.instana.plugin.aws.dynamodb:
  enabled: false

プロキシー構成

プロキシー構成を使用するように特定の AWS センサーを構成するには、以下のエージェント構成設定を追加します。

com.instana.plugin.aws.dynamodb:
  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 名前付きプロファイルを使用する方法

DynamoDB のモニターに使用できるプロファイルをオーバーライドするには、以下の構成を使用します。

com.instana.plugin.aws.dynamodb:
  profile_names:
    - 'profile2'
    - 'profile3'
注: サービスレベルでプロファイルを定義すると、 AWS のプロファイルに関するグローバル設定が上書きされます。

AWS STS を使用する方法

DynamoDB のモニターに使用できる IAM 役割をオーバーライドするには、以下の構成を使用します。

com.instana.plugin.aws.dynamodb:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_3_name>'
注: サービスレベルでIAMロールを定義すると、グローバルな AWS のIAMロール設定が上書きされます。

フィルタリング

複数のタグを定義するには、コンマで区切ります。 タグは、:文字で区切られたキーと値のペアとして提供されます。 構成を向上させるために、ディスカバリーに含めるタグまたはディスカバリーから除外するタグを定義できます。 両方のリスト (包含と除外) にタグが定義されている場合は、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義する必要はありません。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。

ユーザーは、tagged-services-poll-rate構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。

注: タグは、AWS エージェントでのみ使用可能です。

タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

タグによってサービスをディスカバリーに組み込むには、以下の構成を使用します。

com.instana.plugin.aws.dynamodb:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

タグによってサービスをディスカバリーから除外するには、以下の構成を使用します。

com.instana.plugin.aws.dynamodb:
  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.dynamodb:
  include_untagged: false # True value by default

ポーリング頻度

タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300