AWS CloudFront の監視

「 Instana 」エージェントをインストールすると、「 AWS CloudFront 」センサーが自動的に展開およびインストールされます。 このセンサーは、 AWS CloudFront のディストリビューションおよびそれに関連する機能を監視します。

その他のサポート対象の AWS サービスについては、「 AWS 」のトピックを参照してください。

前提条件

  • AWS CloudFront の監視を有効にするには、 us-east-1 リージョンにエージェントをデプロイしてください。

  • Cache hit rate および Origin latency のメトリックをモニターするには、 AWS コンソールで追加の CloudFront 配布メトリックを有効にします。 追加のメトリクスを有効にする方法については、『 AWS 』のドキュメントを参照してください。

CloudFront ディストリビューションの詳細とメトリクスを表示する

Instana CloudFront ディストリビューションの詳細情報とメトリクスを収集します。

CloudFront 配布の詳細

AWS CloudFront センサーは、以下の CloudFront 詳細情報を収集します。

CloudFront 配布の詳細 説明
ARN CloudFront ディストリビューションの Amazon リソース名 (ARN)。
名前 配布の CloudFront ドメイン・ネーム。
リージョン 配布の場所 (領域)。
配布 ID ディストリビューションの固有 ID。
状況 配布のデプロイメントの状況。
最終変更時刻 配布が最後に変更された日付および時刻。

メトリック

Instana CloudFront ディストリビューションおよび関連機能に関するメトリクスを収集します。

分布

名前 説明
要求 CloudFront, が、すべての HTTP メソッドおよび HTTP と HTTPS の両方のリクエストに対して受け取ったリクエストの総数。
アップロードしたバイト数 POST および PUT リクエストを使用して、 CloudFront, 経由で視聴者がオリジンにアップロードしたバイト数の合計。
ダウンロードされたバイト数 GET、HEAD、および OPTIONS 要求のためにビューアーによってダウンロードされた合計バイト数。
4xx エラー率 すべてのビューアー要求のうち、応答の HTTP 状況コードが 4xxである要求の割合。
5xx エラー率 すべてのビューアー要求のうち、応答の HTTP 状況コードが 5xxである要求の割合。
合計エラー率 すべてのビューアー要求のうち、応答の HTTP 状況コードが 4xx または 5xxである要求の割合。
キャッシュ・ヒット率 キャッシュに入れることができるすべての要求のうち、 CloudFront がそのキャッシュからコンテンツを提供した要求の割合。 HTTP POST また、PUTリクエストやエラーはキャッシュされません。
オリジンの待ち時間 CloudFront が要求のためにネットワークに応答を送信するのに要した合計時間 (ミリ秒)。 この待ち時間の値は、発信元から処理される要求のみを対象とします。つまり、 CloudFront キャッシュから処理されることはありません。

関連する関数

名前 説明
呼び出し 指定された期間内に機能が開始 (呼び出さ) された回数。
使用率の計算 関数の実行にかかった時間 (0 から 100 までの時間、最大許容時間に対する割合)。
スロットル 指定された期間内に機能がスロットルされた回数。
検証エラー 特定の期間内に関数によって生成された検証エラーの数。 関数が正常に実行されると検証エラーが発生しますが、無効なデータ (無効なイベント・オブジェクト) が返されます。
実行エラー数 指定された期間内に発生した実行エラーの数。 関数が正常に完了しないと、実行エラーが発生します。

必要なアクセス権

以下のアクセス権が必要です。

  • cloudfront:GetDistribution
  • cloudfront:ListDistributions
  • cloudfront:ListTagsForResource

AWS CloudFront センサーの設定

AWS CloudFront センサーの設定を変更するには、ファイル <agent_install_dir>/etc/instana/configuration.yml 内のエージェント設定のプロパティを com.instana.plugin.aws.cloudfront 編集してください。

AWS CloudFront センサーは、5分ごとに CloudFront のメトリクスを取得します。 この頻度を変更するには、 cloudwatch_period プロパティーを使用します。

com.instana.plugin.aws.cloudfront:
  cloudwatch_period: 60
注: 機能モニタリングを有効にすると、収集される CloudWatch メトリクスの量が増えるため、追加の費用が発生します。

CloudFront 関数のモニターを有効にするには、 enable_function_monitoring: true プロパティーを設定します。

com.instana.plugin.aws.cloudfront:
   enable_function_monitoring: true

CloudFront ディストリビューションのモニターを無効にするには、 enabled: false プロパティーを設定します。

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

AWS CloudFront センサーでプロキシを使用するように設定する

AWS CloudFront センサーでプロキシを使用するには、ファイル <agent_install_dir>/etc/instana/configuration.yml 内のエージェント設定に以下のプロパティを追加してください:

com.instana.plugin.aws.cloudfront:
  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 アカウントのモニター のトピックを参照してください。

CloudFront の監視に使用される AWS プロファイルを上書きする

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

com.instana.plugin.aws.cloudfront:
  profile_names:
    - 'profile2'
    - 'profile3'
注: サービスレベルでプロファイルを定義した場合、 AWS のグローバルなプロファイル設定は上書きされます。

CloudFront の監視に使用されるIAMロールの上書き

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

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

フィルタリング

ディスカバリーにサービスを組み込むため、またはディスカバリーからサービスを除外するために使用するタグを定義できます。 サービスをフィルタリングする必要がない場合は、タグを定義する必要はありません。

複数のタグをコンマで区切って定義することができます。 各タグをキーと値のペアとして定義します。 構成を容易にするために、ディスカバリーに含めるタグまたはディスカバリーから除外するタグを定義できます。 両方のリスト (includeexclude) に同じタグを定義すると、 exclude リストの優先順位が高くなります。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。

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

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

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

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

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

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

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

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