Amazon Simple Notification Service (SNS) のモニター

Instana を使用して Amazon SNS サービスを監視し、サービスパフォーマンスに関するエンドツーエンドの可視性とリアルタイムのインサイトを得ましょう。

詳細については、 Amazon SNS を参照してください。

Amazon SNS を監視するには、お使いの環境に Instana エージェントをインストールしてください。エージェントは自動的にAmazon SNSセンサーをインストールして有効化し、Amazon SNSに関連するメトリクスを収集します。これらの指標は、 Instana のUIで確認できます。

その他のサポート対象の AWS サービスに関する詳細については、『 AWS 』のドキュメントを参照してください。

必要なIAM権限の追加

オンラインで編集する

「 Instana 」エージェントが AWS SNS インスタンスを検出および監視できるように、 Instana エージェントを実行しているホストに以下のIAMロールの権限を追加してください：

cloudwatch:GetMetricStatistics
cloudwatch:GetMetricData
sns:ListTopics
sns:ListTagsForResource
sns:GetTopicAttributes

Amazon SNSセンサーの設定

オンラインで編集する

Instana エージェントのインストール後、Amazon SNSセンサーはデフォルトで有効になります。

Amazon SNSセンサーを無効にする

オンラインで編集する

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

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

メトリクスの収集間隔の設定

オンラインで編集する

デフォルトでは、SNS のメトリックは 5 分ごとにプルされます。この頻度を変更するには、以下の例に示すように、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yml の cloudwatch_period 値を編集します。

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

プロキシ設定の設定

オンラインで編集する

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

com.instana.plugin.aws.sns:
  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 アカウントにわたるAmazon SNSの監視設定

オンラインで編集する

同じリージョン内の 1 つの AWS エージェントを使用して、複数の AWS アカウントのモニタリングをセットアップできます。詳しくは、複数の AWS アカウントのモニターを参照してください。

複数の AWS アカウントにわたるAmazon SNSを監視するように Instana エージェントを設定するには、以下のいずれかの方法を使用してください：

AWS 名前付きプロファイルを使用する方法

オンラインで編集する

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

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

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

AWS セキュリティ・トークン・サービス（STS）のアプローチ

オンラインで編集する

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

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

タグを定義してAmazon SNSサービスをフィルタリングする

オンラインで編集する

注：フィルタリングを行わずにすべてのAmazon SNSサービスを監視したい場合は、設定を一切定義しないでください。

Instana デフォルトでは、すべてのAmazon SNSサービスを監視します。ただし、すべてのサービスをモニターする必要がない場合は、エージェントの configuration.yaml ファイルで、ディスカバリーに含めるタグまたはディスカバリーから除外するタグを定義します。両方のリスト (包含および除外) でタグまたはリソース・グループを定義すると、除外リストが優先されます。

複数のタグを定義するには、それらをコンマで区切ります。タグは、コロン (:) で区切られたキーと値のペアとして定義します。フィルタリングを有効にするためにすべての値を定義する必要はありません。

タグによってサービスをディスカバリーに組み込むには、以下の例に示すように、configuration.yaml ファイルを更新します。

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

タグによってサービスをディスカバリーから除外するには、以下の例に示すように configuration.yaml ファイルを更新します。

com.instana.plugin.aws.sns:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

タグのない Amazon SNS サービスは、デフォルトでモニターされますが、以下の例に示すように、 include_untagged フィールドを false に設定することで除外できます。

com.instana.plugin.aws.sns:
  include_untagged: false # True value by default

ポーリングレートの設定

オンラインで編集する

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

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

タグ付けされたリソースをセンサーがポーリングする頻度を定義するには、以下の例に示すように configuration.yaml ファイルを更新します。

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

メトリックの表示

オンラインで編集する

メトリックを表示するには、以下のステップを実行します。

Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 をクリックします。
指定したホストをクリックします。

収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。メトリックは 5 分ごとにプルされます。

追跡対象の構成

オンラインで編集する

次の表は、センサーがAmazon SNSインスタンスから収集する設定データの概要を示しています：


SNS トピック詳細	説明
ARN	トピックに割り当てられた、修飾されていない Amazon リソース名 (ARN)。
アベイラビリティー・ゾーン	インスタンスの場所。
トピック名	トピック名。
表示名	ユーザー定義のトピック名。
確認されたサブスクリプション数	確認されたサブスクリプションの数。
再試行回数	通知再試行限度の数。
最小遅延目標	ターゲット・サブスクリプションに対する最小遅延。
最大遅延目標	ターゲット・サブスクリプションに対する最大遅延。

メトリック

オンラインで編集する

次の表は、センサーがAmazon SNSインスタンスから収集するメトリクスの概要を示しています：


トピック・メトリック	説明
NumberOfMessagesPublished	Amazon SNS トピックに公開されているメッセージの数。
NumberOfNotificationsFailedToRedriveToDlq	送達不能キューに移動されていないメッセージの数。
NumberOfNotificationsDelivered	サブスクライブしているエンドポイントに Amazon SNS トピックから正常に配信されたメッセージの数。
PublishSize	パブリッシュされたメッセージのサイズ。
NumberOfNotificationsRedrivenToDlq	デッド・レター・キューに移動されたメッセージの数。
NumberOfNotificationsFailed	Amazon SNS が配信に失敗したメッセージの数。
NumberOfNotificationsFilteredOut	サブスクリプション・フィルター・ポリシーによって拒否されたメッセージの数。フィルタポリシーは、メッセージの属性がポリシーの属性と一致しない場合、そのメッセージを拒否します。