• ログイン

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

Amazon API Gatewayのモニタリング統合

重要

AWS CloudWatch Metric Streams統合を有効にして、カスタムネームスペースを含むAWSサービスからのすべてのCloudWatchメトリクスをモニターします。個別の統合は、もはや推奨されるオプションではありません。

New Relic infrastructure integrations には、Amazon API Gateway のデータを New Relic にレポートするための統合があります。このドキュメントでは、この統合を有効にする方法と、レポート可能なデータについて説明します。

機能

AmazonのAPI Gateway は、あらゆる規模のAPIを作成、公開、維持、監視、保護することができるフルマネージドサービスです。New Relic API Gatewayの統合により、APIレイヤーが舞台裏でどのように機能しているか、より多くのデータを得ることができます。APIコールの数、処理されたリクエスト、エラーの数、レイテンシーカウントなどの指標データを受け取ることができます。

API ゲートウェイのデータを New Relic から直接監視したり、アラートを出したりすることができ、データの照会やダッシュボードの作成も可能です。

要件

API Gateway は、CloudWatch の詳細メトリクスを明示的に有効にしていない限り、"Call count by resource" 、"4xx error by resource" 、"5xx errors by resource" のメトリクスを送信しません。

ヒント

これらのメトリクスを有効にすると、 Amazon CloudWatchアカウントの価格設定に追加料金が発生する場合があります

CloudWatchメトリクスを有効にするには、以下のいずれかのオプションを使用します。

  • AWS Management Consoleにアクセスし、CloudWatchの Settings オプションを選択し、CloudWatchの詳細なメトリクスを有効にするオプションを選択します。
  • Amazon API Gateway REST APIのstage:updateアクションを呼び出して、 metricsEnabledプロパティをtrueに更新します。

統合をアクティブ化する

このインテグレーションを有効にするには、標準手順に従い、AWSサービスをNew Relicに接続します

構成とポーリング

設定オプションを使用し、ポーリングの頻度を変更し、データを絞り込むことができます。

デフォルト ポーリング Amazon APIゲートウェイ統合のための情報です。

  • New Relicのポーリング間隔:5分
  • Amazon CloudWatchデータ間隔:1分

データを見つけて使用する

インフラストラクチャーで統合データを見つけるには、 one.newrelic.com > インフラストラクチャー> AWS にアクセスし、API Gateway統合リンクの1つを選択します。

ApiGatewaySampleイベントタイプを使用してデータをクエリおよび探索できます。

データの利用方法については、 統合データの理解と利用 を参照してください。

メトリックデータ

このNew Relicインフラストラクチャ統合は、以下のAmazon API Gatewayデータを収集します。

メトリック

説明

4XXError

クライアント側で捕捉されたエラーの数

5XXError

捕捉されたサーバー側のエラーの数です。

CacheHitCount

APIキャッシュから提供されたリクエストの数です。

CacheMissCount

APIキャッシングが有効な場合に、バックエンドから提供されたリクエストの数です。

Count

APIメソッドの呼び出し回数です。

IntegrationLatency

API Gatewayがバックエンドにリクエストを中継してから、バックエンドからレスポンスを受信するまでの時間(ミリ秒)です。

Latency

API Gatewayがクライアントからのリクエストを受信してから、クライアントにレスポンスを返すまでの時間(ミリ秒)。レイテンシーには、統合レイテンシーとその他のAPI Gatewayのオーバーヘッドが含まれます。

ディメンション

次の表の ディメンション を使って、API Gateway のメトリクスをフィルタリングすることができます。

ディメンション

説明

ApiName

指定されたAPI名のAPIに対するAPI Gatewayメトリクスをフィルタリングします。

ApiNameMethodResourceStage

指定されたAPI、ステージ、リソース、メソッドのAPIメソッドに対するAPI Gatewayメトリクスをフィルタリングします。

ApiName, Stage

指定されたAPIとステージのAPIステージのAPI Gatewayメトリクスをフィルタリングします。

Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.