Windows用インフラストラクチャ・エージェントのカスタム・インストール・プロセスでは、インストールのすべての側面をカスタマイズすることができます。ファイルシステム上の好きな場所にファイルやフォルダを置くことができます。
この方法では、 インストールを完全に制御することができます 。適切なフォルダにファイルを配置し、適切な設定値を提供し、エージェントにすべての適切な権限を持たせる責任があります。
インストールする前に、 互換性と要件を確認してください 。
エージェントのインストール
エージェントをインストールするには
パッケージ化されたエージェントファイル のダウンロード 。
ファイルを解凍します。
ファイルが以下のような構造で解凍されることを確認してください。
オプションで 、できます。
重要
バージョン 1.4.0 の時点で、インフラストラクチャエージェントパッケージには、実行中のエージェントのトラブルシューティングに役立つ newrelic-infra-ctl
バイナリが追加されています。このバイナリは、エージェントの実行には必要ありませんが、パスに追加することをお勧めします。詳細については、 troubleshooting a running infrastructure agent に関するドキュメントを参照してください。
サービススクリプトのインストール
インストールを進めるためには、サービスを作成する必要があります。ZIPファイルに同梱されているファイルを参考に確認してください。
C:\Program Files\New Relic\newrelic-infra\installer.ps1
設定ファイル
インフラストラクチャエージェントは、エージェントの動作を設定するために、通常 newrelic-infra.yml
という名前の設定ファイルに依存します。このファイルは、エージェントと同じフォルダに置かれます。
コンフィグファイルのテンプレート に基づいて、新しいコンフィグファイルを作成することができます。詳細については、 エージェントの設定方法 を参照してください。
設定ファイルの保存場所の変更
デフォルトでは、設定ファイルは C:GRAM FILES\New Relic-infra\newrelic-infra.yml
にあります。
設定ファイルの場所を変更するには
コマンドを実行する
regedit.exe
.Computer_HKEY_LOCAL_MACHINE_SYSTEM#CurrentControlSet#Services#newrelic-infra#ImagePath
のフォルダーを参照してください。ImagePath
キーを取得します。エージェントのバイナリがデフォルトのパスにある場合は、C:Program Files\New Relic\Newrelic-infra.exe
からキーを探します。-config
フラグを使用して、設定ファイルの新しい場所をキーに追加します。C:\Program Files\New Relic\newrelic-infra\newrelic-infra.exe -config c:\config.yaml
プラグインディレクトリの設定
インフラストラクチャエージェントでは、Kubernetes、AWS、MySQL、Redis、Kafkaなどの一般的なサービスからのデータを監視・報告する インテグレーション をインストールすることができます。各インテグレーションには独自の設定ファイルがあり、デフォルトでは integration-name-config.yml
という名前になっています。
この設定ファイルは、あらかじめ定義された場所 C:Program Files\New Relic\Newrelic-infra\integrations.d
に置かれます。初期化時には、エージェントはこの設定ファイルを読み込みます。
統合設定ファイルの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
- その場所を
NRIA_PLUGIN_DIR
環境変数に設定します。 newrelic-infra.yml
設定ファイルのplugin_dir
フィールドを使ってカスタムパスを設定します。newrelic-infra
のバイナリを実行する際に-plugin_dir
を使って、コマンドライン引数として渡します。
エージェントディレクトリの設定
エージェントは、インストールされた インテグレーション 、キャッシングデータ(インベントリ)などを実行するために、独自に定義されたディレクトリを必要とします。デフォルトの場所は C:Program Files\New Relic\newrelic-infra\
です。
エージェントディレクトリは、以下のような構造と内容になっています。
LICENSE
: New Relic インフラストラクチャエージェントのライセンスを含むテキストファイル。custom-integrations
: インストールされた custom integrations を格納するディレクトリ。newrelic-integrations
: New Relic official integrations を格納するディレクトリ.
また、エージェントはデータを保存するために app_data_dir
という別のフォルダを使用します。デフォルトでは、 C:ProgramData\New Relic\newrelic-infra\
を指しています。
エージェントディレクトリの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
- その場所を
NRIA_AGENT_DIR
環境変数に設定します。 newrelic-infra.yml
設定ファイルのagent_dir
フィールドを使ってカスタムパスを設定します。newrelic-infra
のバイナリを実行する際に-agent_dir
を使ってコマンドライン引数として渡します。
ログファイルの設定
デフォルトでは、エージェントは C:Program Files\New Relic\newrelic-infra\newrelic-infra.log
にログファイルを保存します。
ログファイルの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
- 場所は
NRIA_LOG_FILE
環境変数に設定します。 newrelic-infra.yml
設定ファイルのlog_file
フィールドを使ってカスタムパスを設定します。newrelic-infra
のバイナリを実行する際に、-log_file
を使って、コマンドライン引数として渡します。
次のステップ
次の設定も可能です。
- カスタムアトリビュート を追加して、インフラストラクチャデータに注釈を付けます。
- サーバーがAmazon EC2でホストされている場合は、AWSアカウントを接続します。
- その他 New Relic のインフラ統合 を追加して、外部サービスからデータを収集する。
- 手動で 起動、停止、再起動、またはエージェントの状態を確認.