AWS SQS のモニター

オンラインで編集する

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

注： その他のサポート対象の AWS サービスについては、「 AWS 」のドキュメントをご覧ください。

センサー (データ収集)

オンラインで編集する

追跡対象の構成

オンラインで編集する
  • エンドポイント・アドレス
  • ARN
  • リージョン
  • 作成時刻
  • メッセージ保存期間
  • 最大メッセージ・サイズ
  • 表示タイムアウト
  • 最終変更日時タイム・スタンプ

メトリック

オンラインで編集する
  • 遅延メッセージの数
  • 非表示メッセージの数
  • 表示メッセージの数
  • 空の受信メッセージの数
  • 受信メッセージの数
  • 送信メッセージの数
  • 最も古いメッセージの経過時間
  • 送信メッセージ・サイズ

必要なアクセス権

オンラインで編集する
  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • sqs:ListQueues
  • sqs:GetQueueAttributes
  • sqs:ListQueueTags

構成

オンラインで編集する

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

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

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

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

プロキシー構成

オンラインで編集する

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

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

オンラインで編集する

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

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

AWS STS を使用する方法

オンラインで編集する

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

com.instana.plugin.aws.sqs:
  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.sqs:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

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

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

ポーリング頻度

オンラインで編集する

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

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

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