Amazon OpenSearch サービスのモニター

Instana エージェントをインストールすると、Amazon OpenSearch Serviceのセンサーが自動的にデプロイおよびインストールされます。

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

センサー (データ収集)

追跡対象の構成

Amazon OpenSearch Serviceのセンサーは、以下の OpenSearch の詳細を追跡します:

  • ドメイン ARN
  • ドメイン名
  • グループ化ゾーン (リージョン)

メトリック

  • クラスター状況: 緑、黄、赤
  • ノード数
  • 検索可能なドキュメントまたは削除されたドキュメントの数
  • クラスター内でデータ・ソースに使用される CPU リソースの最大パーセンテージ
  • クラスターの空きストレージ
  • クラスター使用スペース
  • 着信書き込み要求を受け入れるかブロックするかを示すクラスター標識 (cluster_index_writes_blocked)
  • JVM メモリー負荷
  • 自動スナップショット失敗メトリック
  • HTTP 状況コードを持つ要求の数
  • シャードが検索操作を完了するのにかかる、検索待ち時間の平均時間
  • クラスター内でデータノードに使用可能な残りの CPU クレジット

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

必要なアクセス権

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • es:ListDomainNames
  • es:ListTags
  • es:DescribeElasticsearchDomain

構成

OpenSearch のメトリックは 5 分ごとにプルされます。これは、 <agent_install_dir>/etc/instana/configuration.yml ファイル内のエージェント構成を使用して変更できます。

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

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

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

プロキシー構成

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

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

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

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

AWS STS を使用する方法

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

com.instana.plugin.aws.es:
  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ロール設定が上書きされます。

フィルタリング

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

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

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

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

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

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

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

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

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