Amazonの動向を監視する Timestream

Instana Amazon Timestream データベースを包括的に監視し、Amazon Timestream センサーを使用して環境の可視性を提供します。

Instana エージェントをインストールすると、Amazon Timestream センサーが自動的にデプロイおよびインストールされます。「 Instana 」のUIでは、Amazon Timestream データベースに関連するメトリクスを確認できます。

現在、Amazon Timestream の監視は、 LiveAnalytics でのみ利用可能です。 InfluxDB インスタンスの監視はサポートされていません。

Amazon Timestream for LiveAnalytics は、1日あたり数兆件の時系列データポイントを保存・分析する、高速でスケーラブルなフルマネージドの時系列専用データベースです。その他のサポート対象の AWS サービスに関する詳細については、「 AWS 」のトピックを参照してください。

必要な IAM 許可

オンラインで編集する

Amazon Timestream センサーがAmazon Timestream データベースを監視するには、以下の AWS IAM権限が必要です：

cloudwatch:GetMetricData
cloudwatch:GetMetricStatistics
timestream:ListDatabases
timestream:DescribeEndpoints
timestream:DescribeDatabase
timestream:ListTagsForResource

Amazon Timestream センサーの設定

オンラインで編集する

Instana エージェントのインストール後、Amazon Timestream センサーはデフォルトで有効になります。 Amazon Timestream データベースのメトリクスは、60秒ごとに取得されます。この設定は、<agent_install_dir>/etc/instana/configuration.ymlファイル：

com.instana.plugin.aws.timestream:
  cloudwatch_period: 60

プロキシ設定の有効化

オンラインで編集する

Amazon Timestream センサーでプロキシ設定を使用できるようにするには、以下のエージェント設定を追加してください：

com.instana.plugin.aws.timestream:
  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

Amazonの Timestream センサーを無効にする

オンラインで編集する

Amazon Timestream データベースの監視を無効にするには、以下の設定を使用してください：

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

複数の AWS アカウントにわたるAmazon Timestream の監視設定

オンラインで編集する

複数の監視を設定するにはAWS1つのアカウントAWS同じリージョンにエージェントが存在する場合、2 つのアプローチを使用できます。詳細については、複数の監視AWSアカウント。

AWS -命名済みプロファイル方式

オンラインで編集する

Amazon Timestream を監視するプロファイルを上書きするには、以下の設定を使用してください：

com.instana.plugin.aws.timestream:
  profile_names:
    - 'profile2'
    - 'profile3'

注：サービスレベルでプロファイルを定義した場合、グローバルな AWS プロファイルの設定は上書きされます。

AWS STS を使用する方法

オンラインで編集する

Amazon Timestream を監視するIAMロールを上書きするには、以下の設定を使用してください：

com.instana.plugin.aws.timestream:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

注：サービスレベルでIAMロールを定義した場合、グローバルな AWS のIAMロール設定は上書きされます。

タグを定義してフィルタリングする

オンラインで編集する

Instana デフォルトでは、すべてのAmazon Timestream データベースを監視します。また、 configuration.yaml ファイルにタグを定義することで、 Instana が監視するAmazon Timestream データベースを絞り込むこともできます。データベースをフィルタリングしたくない場合は、タグを定義する必要はありません。

複数のタグを定義するには、カンマで区切ります。タグをキーと値のペアとして定義します。構成を簡素化するために、検出に含めるタグや検出から除外するタグを定義できます。両方のリスト（含めるリストと除外リスト）でタグを定義した場合は、除外リストが優先されます。フィルタリングを有効にするためにすべての値を定義することは必須ではありません。

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

注：タグは「 AWS 」エージェントでのみ利用可能です。

センサーがタグ付けされたリソースをポーリングする頻度を定義するには、次の構成を使用します。

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

タグ付きのAmazon Timestream データベースをディスカバリーに含めるには、以下の設定を使用してください：

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

タグが付いたAmazon Timestream データベースをディスカバリの対象から除外するには、以下の設定を使用してください：

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

メトリックの表示

オンラインで編集する

メトリックを表示するには、次の手順を実行します。

Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
監視対象のAmazon Timestream データベースを1つ選択してください。

収集されたすべてのメトリクスが表示された、Amazonの Timestream データベースダッシュボードを確認できます。

構成データ

オンラインで編集する

Amazonの Timestream センサーは、以下の構成データを収集します：


名前	説明
ARN	Timestream データベースのAmazon Resource Name（ARN）。
データベース名	Timestream データベースの名前。
作成時刻	データベースの作成日時。
タイプ	LiveAnalytics利用可能です。 InfluxDB インスタンスの監視はサポートされていません。

メトリック

オンラインで編集する

Amazonの Timestream センサーは、以下のメトリクスを収集します：


名前	説明
要求遅延時間が成功	指定された期間における、 LiveAnalytics への Timestream への成功したリクエストのレイテンシ。このメトリックは次の統計で使用できます。`Minimum` 、`Maximum` 、`Average` 、そして`SampleCount`。
磁気ストア拒否レコード数	非同期的に拒否された磁気ストア書き込みレコードの数。
アクティブ磁気ストア・パーティション	特定の時間にアクティブにデータを取り込む磁気ストアパーティションの数。
磁気ストア保留レコードの遅延	クエリに使用できない磁気ストアへの最も古い書き込み。
マグネティック・ストアの拒否されたアップロード・ユーザーの失敗	ユーザーエラーによりアップロードされなかった磁気ストア拒否レコードレポートの数。
磁気ストアのアップロード拒否システムの障害	システムエラーが原因でアップロードされなかった磁気ストア拒否レコードレポートの数。