インフラストラクチャエージェントは、さまざまな方法で構成できます。デフォルトの方法は、 newrelic-infra.yml
ファイルの構成変数を編集することです。
設定ファイルのテンプレートは、 Infrastructure config file template にあります。また、 環境変数 を設定してコンフィグファイルを上書きしたり、 コンフィグ管理ツール (AnsibleやPuppetなど)を使用することもできます。
インフラストラクチャエージェントと連携するオンホスト統合を設定するには、 特定の統合のドキュメント を参照してください。
重要
設定を変更した後は、必ず エージェントを再起動してください 。統合構成の更新にはエージェントの再起動は必要ありません (ホットリロードがサポートされています)。
構成方法と優先順位
インフラストラクチャエージェントを構成するためのデフォルトの方法は、 newrelic-infra.yml
構成ファイルです。コンテナ化された環境に最適な環境変数を設定することで、構成ファイルをオーバーライドできます。
環境変数は、設定ファイルを上書きします。設定ファイルは、エージェントのデフォルト値を上書きします。
各構成方法の詳細な説明は次のとおりです。
インフラストラクチャエージェントを構成するには、 newrelic-infra.yml
ファイルを使用します。デフォルトの場所は次のとおりです。
Linux: /etc/newrelic-infra.yml
ウィンドウズ: C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml
macOS インテル: /usr/local/etc/newrelic-infra/newrelic-infra.yml
MacOS Appleシリコン: /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml
設定ファイルのサンプルは、 インフラストラクチャ設定ファイルのテンプレート をご覧ください。
環境変数を設定するには、構成ファイルの変数名をすべて大文字にし、接頭辞としてNRIA_
を付けて使用します。たとえば、 NRIA_LICENSE_KEY
。コンテナ化された環境では、環境変数を介してライセンス キーやタグなどの構成プロパティを設定します。
インフラストラクチャ構成ファイルテンプレートで説明されているオプションには、 Env var
というラベルの付いた対応する環境変数が含まれています。環境変数は、 インフラストラクチャ構成設定にも一覧表示されます。
二重中かっこ{{MY_ENV_VAR}}
を使用して、構成ファイルで環境変数を定義することもできます。例えば:
license_key: {{MY_LICENSE_KEY}}
環境変数を使用して、 オンホスト統合のコンフィグ設定を制御することができます。 その後、インフラストラクチャ・エージェントに渡すことができます。各ホスト上の統合で使用できる変数は、各統合のドキュメントに記載されており、以下のいずれかの方法で設定することができます。
passthrough_environment
オプションは、変数名の正規表現をサポートしています。
構成ファイル内から: インフラストラクチャ構成ファイルにエントリを追加して、エージェントが設定した環境変数を取得できるようにします。
コマンドラインから: 別の環境変数を使用してこれらの設定を渡します。
NRIA_PASSTHROUGH_ENVIRONMENT="HTTPS_PROXY,HTTP_PROXY"
各統合には、引数とまったく同じ名前の環境変数を定義して渡すことで上書きできる一連の変数があります(たとえば、 redis
ポート引数を置き換えるPORT環境変数)。
{{}}
表記を使用して、統合構成ファイルで環境変数を定義することもできます。例えば:
integration_name: com.newrelic.redis
password: {{MY_REDIS_PASSWORD}}
構成オプションを調べる
定義、デフォルト、および関連する環境変数を含む、構成できるすべての設定のリストについては、「 インフラストラクチャ構成設定」を参照してください。
設定ファイルの構成
エージェントまたは統合の YAML 構成ファイルを編集する場合:
- YAML フォーマット規則に従います。
- 設定オプションのケーシングを変更しないでください。YAMLのキーは大文字と小文字を区別します。
- インデントレベルを尊重してください。 すべてのインデントは同様の増分であり、通常は 2 つのスペース文字です。 ファイルの同じセクション内のデータは、同じレベルのインデントを使用する必要があります。 サブセクションは 2 つのスペースでインデントします ( カスタム属性とネットワーク インターフェイス フィルターの例を参照)。
- YAML 形式は数値と文字列を区別します。構成値を文字列として解析するには引用符を使用します。
newrelic-infra.yml
のテンプレートは、 インフラストラクチャエージェントリポジトリで利用できます。インフラストラクチャエージェントでファイルを使用する前に、バリデーターを使用して構文が正確であることを確認してください。
設定管理ツール
構成管理ツールを使用してインフラストラクチャ エージェントをインストールおよび管理するには、次のドキュメントを参照してください。
大規模なデプロイのその他のオプションについては、ワークフローの自動化を参照してください。