AWS System Manager Distributorの統合を介して、ワンクリックで New Relic のインフラストラクチャ エージェントを AWS EC2 インスタンスにインストールします。このドキュメントでは、統合機能、その有効化方法、およびレポートできるデータについて説明します。
特徴
ワンクリックでさまざまな AWS インスタンスからテレメトリ データを収集して New Relic に送信します。New Relic の AWS System Manager Distributor 統合により、当社のインフラストラクチャ エージェントが AWS インスタンスにインストールされ、サービスの迅速な監視、受信データのクエリ、およびダッシュボードの構築が可能になるため、システムを一目で確認できます。
前提条件
AWS Systems Manager のドキュメント で AWS が推奨するセットアップを完了して、ロール、ユーザー アカウント、アクセス許可、初期リソースを構成します。
統合をアクティブ化する
AWS Systems Manager コンソールを使用して、 New Relic infrastructure agentディストリビュータ パッケージを 1 回だけインストールまたは更新することも、インストール スケジュールを設定することもできます。
ワンタイム インストレーションを設定すると、
Distributor package
はAWS Systems Manager の機能である AWS Systems Manager Run Commandを使用してインストレーションを実行します。
パッケージのインストールまたは更新をスケジュールすると、ディストリビューターは AWS Systems Manager State Manager を使用してインストールまたは更新します。
New Relic は、EC2 を監視するための自動プロセスも提供します。 こちらからご覧いただけます。
エージェントをインストールまたは更新する
AWS Systems Managerコンソールを開きます。 ナビゲーション ペインで、 Distributorを選択し、 Third partyを選択して、 New Relic infrastructure agentタイルを選択します。
インストレーションモードを選択します。 New Relic infrastructure agentパッケージを 1 回だけインストールまたは更新することも、インストールをスケジュールすることもできます。 Distributor packagesのインストールの詳細については、 AWS Systems Manager ディストリビューターのドキュメントを参照してください。
Actionには、 Installを選択します。
Installation typeについては、 Uninstall and reinstallのいずれかを選択します。パッケージは完全にアンインストールされ、その後再インストールされます。 New Relic エージェントは、再インストールが完了するまで使用できませんIn-place update 。 アプリケーションは更新プロセス中も引き続き利用できます。
Additional Argumentsには、以下に紹介するコードを貼り付けます。 必ず
YOUR_NEWRELIC_LICENSE_KEYNew Relic API キーに置き換えてください。{"SSM_NR_LICENSE_KEY" : "YOUR_NEWRELIC_LICENSE_KEY"}以下に示すように、サンプル変数をAdditional Arguments [追加の引数]で指定することもできます。
{ "SSM_NR_LICENSE_KEY" : "YOUR_NEWRELIC_LICENSE_KEY","SSM_NRIA_METRICS_NETWORK_SAMPLE_RATE" : "SOME_INTEGER_VALUE","SSM_NRIA_METRICS_PROCESS_SAMPLE_RATE" : "SOME_INTEGER_VALUE","SSM_NRIA_METRICS_STORAGE_SAMPLE_RATE" : "SOME_INTEGER_VALUE","SSM_NRIA_METRICS_SYSTEM_SAMPLE_RATE" : "SOME_INTEGER_VALUE","SSM_NRIA_METRICS_NFS_SAMPLE_RATE" : "SOME_INTEGER_VALUE" }指定しない場合は、 デフォルト値が使用されます。
Targetsセクションで、タグを指定するか、インスタンスまたはデバイスを手動で選択するか、リソース グループを指定することにより、この操作を実行する管理対象ノードを選択します。 リストに管理対象ノードが表示されない場合は、 これらの AWS ドキュメント を参照してください。
ConcurrencyのRate Controlには、コマンドを同時に実行するターゲットの数または割合を指定します。
ヒント
タグまたはリソース グループを指定してターゲットを選択し、ターゲットにする管理対象ノードの数がわからない場合は、パーセンテージを指定して、ドキュメントを同時に実行できるターゲットの数を制限します。
Error thresholdには、管理対象ノードの数または割合でコマンドが失敗した後、他のターゲットでのコマンドの実行をいつ停止するかを指定します。 たとえば、3 つのエラーを指定した場合、Systems Manager は 4 番目のエラーを受信したときにコマンドの送信を停止します。 コマンドを処理中の管理対象ノードもエラーを送信する可能性があります。
Verify the installation。インストレーションを実行した後、コマンド ステータス領域で進行状況を確認します。 「成功」ステータスが表示されたら、インストールが成功したことを意味します。
UIでアプリのデータを調べます。
構成とポーリング
構成オプションを使用して、ポーリング頻度とフィルターデータを変更できます。
AWS 統合のデフォルトのポーリング情報:
- New Relicのポーリング間隔：5分
- Amazon CloudWatchのデータ間隔：1分または5分
データを見つけて使用する
New Relic Infrastructureエージェントをインストールした後、 インスタンスからのデータ フローを調整および調整できます。
データの検索方法の詳細については、 「AWS インテグレーションの概要」を参照してください。