Amazon OpenSearch サービスのモニター
Instana エージェントをインストールすると、Amazon OpenSearch Serviceのセンサーが自動的にデプロイおよびインストールされます。
センサー (データ収集)
追跡対象の構成
Amazon OpenSearch Serviceのセンサーは、以下の OpenSearch の詳細を追跡します:
- ドメイン ARN
- ドメイン名
- グループ化ゾーン (リージョン)
メトリック
- クラスター状況: 緑、黄、赤
- ノード数
- 検索可能なドキュメントまたは削除されたドキュメントの数
- クラスター内でデータ・ソースに使用される CPU リソースの最大パーセンテージ
- クラスターの空きストレージ
- クラスター使用スペース
- 着信書き込み要求を受け入れるかブロックするかを示すクラスター標識 (cluster_index_writes_blocked)
- JVM メモリー負荷
- 自動スナップショット失敗メトリック
- HTTP 状況コードを持つ要求の数
- シャードが検索操作を完了するのにかかる、検索待ち時間の平均時間
- クラスター内でデータノードに使用可能な残りの CPU クレジット
詳細については、 「Amazon OpenSearch のメトリクスとディメンション」 を参照してください。
必要なアクセス権
cloudwatch:GetMetricDatacloudwatch:GetMetricStatisticscloudwatch:GetMetricDataes:ListDomainNameses:ListTagses: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 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>'
フィルタリング
複数のタグを定義するには、コンマで区切ります。 タグは、以下のように区切られたキーと値のペアとして提供されます。構成を容易にするために、ディスカバリーに含めるタグまたはディスカバリーから除外するタグを定義できます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義する必要はありません。
ユーザーは、tagged-services-poll-rate構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。
タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。
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
Instana エージェント・タグ
なお、タグ機能は AWS エージェントでのみ利用可能です。 タグの使用方法の詳細については、こちらをご覧ください。