インフラストラクチャエージェントを構成する

インフラストラクチャエージェントを構成するには、 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オプションは、変数名の正規表現をサポートしています。

• 構成ファイル内から: インフラストラクチャ構成ファイルにエントリを追加して、エージェントが設定した環境変数を取得できるようにします。

  passthrough_environment:
    - HTTPS_PROXY
    - HTTP_PROXY
    - HTTP.*
    - .*

  コピー

• コマンドラインから: 別の環境変数を使用してこれらの設定を渡します。

  NRIA_PASSTHROUGH_ENVIRONMENT="HTTPS_PROXY,HTTP_PROXY"

  コピー

  各統合には、引数とまったく同じ名前の環境変数を定義して渡すことで上書きできる一連の変数があります（たとえば、 redisポート引数を置き換えるPORT環境変数）。

  {{}}表記を使用して、統合構成ファイルで環境変数を定義することもできます。例えば：

  integration_name: com.newrelic.redis
  instances:
    - name: redis-metrics
      command: metrics
      arguments:
        hostname: localhost
        port: 6379
        password: {{MY_REDIS_PASSWORD}}

  コピー

  ヒント

  newrelic-infraサービスが、ホストで定義されているカスタム環境変数を認識できることを確認してください。 systemdなどのサービスマネージャーは、デフォルトですべてのenv変数を設定するわけではなく、追加の手順が必要になる場合があります。