インフラストラクチャエージェントの設定

New Relic アカウントのライセンスキーを指定します。 エージェントはこのキーを使用して、サーバーのメトリクスを New Relic アカウントに関連付けます。 この設定は、標準のインストレーション プロセスの一部として作成されます。

例：

license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234

FedRAMP エンドポイントを使用するかどうかを指定します。

エージェントが使用できる論理プロセッサの数を指定します。この値を増やすことで、異なるコア間で負荷を分散することができます。

-1に設定されている場合、エージェントは環境変数GOMAXPROCSを読み取ろうとします。この変数が設定されていない場合、デフォルト値はホストで使用可能なコアの総数になります。

バージョン1.0.804以降では、エージェントから送信されるデータはデフォルトで圧縮されています。ペイロードの圧縮を無効にするには、 payload_compression_levelを0に設定します。

起動時にNew Relicのプラットフォームの可用性を確認するために、エージェントがエラーを投げる前にリクエストを再試行する回数。

negative valueに設定すると、エージェントは成功するまで接続をチェックし続けます。

リクエストがタイムアウトした後、エージェントがリクエストの再試行を待つ時間は、起動時にNew Relicのプラットフォームの可用性をチェックするためのものです。

起動時にNew Relicのプラットフォームの可用性を確認するリクエストがタイムアウトしたとみなされるまで、エージェントが待機する時間。

エージェントのセルフ インストルメンテーションを有効にします。

組み込みの Fluentbit ログ フォワーダーを介したログ送信のエージェントの再試行を有効にします。整数値は、意図された再試行の回数を表します。その他の可能な値には、再試行回数を無限に設定するFalseや、再試行機能を完全にオフにするno_retriesがあります。

クラウドの検出に失敗した場合に、エージェントが接続を再試行する回数を設定します。

エージェントの初期化中にクラウド検出が失敗した場合、エージェントはCloudRetryBackOffSec秒待機した後に再試行します。

エージェントがメタデータを破棄するまでの待ち時間を秒単位で設定します。この時間が経過すると、メタデータは失効し、エージェントは再びメタデータを取得します。

クラウドの検出に失敗した場合に、エージェントがクラウドディテクションの再試行を行うまでの時間を秒単位で設定します。

エージェントの初期化中にクラウド検出が失敗した場合、エージェントはCloudMaxRetryCount回再試行します。

エージェントが実行されているクラウド プロバイダーを指定します。これがデフォルトとは異なる値に設定されている場合、エージェントは、データをバックエンドに送信する前に、クラウド プロバイダーからメタデータ (インスタンス ID) を正常に取得するまで待機します。

デフォルトの動作では、エージェントはクラウド プロバイダーの検出とメタデータの取得も試みますが、エージェントをブロックすることはありません。

許可された値: ""、 "aws"、 "azure"、 "gcp"、 "alibaba"

DisableCloudMetadataに似ていますが、ホストエイリアスプラグインのクラウドメタデータの収集のみを無効にします。

クラウドメタデータの収集を無効にします。

キャッシュされたコンテナのメタデータが期限切れになり、エージェントが再度取得する必要が生じるまでの時間（秒単位）。

DockerクライアントのAPIバージョンを指定します。

エージェントがサポートしているファイルシステムの種類のリストです。この値は、デフォルトのリストのサブセットである必要があり、デフォルトのリストにない項目は破棄されます。

StorageSampleデータを収集するときにエージェントが無視するストレージデバイスのリスト。

YAML属性の例。

file_devices_ignored:
  - sda1
  - sda2

環境変数としての例

FILE_DEVICES_IGNORED="sda1,sda2"

レポート用に自動生成されたホスト名を上書きします。これは、同じ名前のホストが複数ある場合に便利です。インフラストラクチャモニタリングでは、ホスト名を各ホストの一意の識別子として使用します。この値は、エンティティ名のループバックアドレスの置換にも使用されることに注意してください。

詳しくは、 エンティティ名解決の仕組み についてのドキュメントをご覧ください。

例：

display_name: teslaOne

trueの場合、ホストのアドレスの逆引き参照を実行することにより、完全なホスト名が解決されます。それ以外の場合は、Linuxではhostnameコマンドを使用して、WindowsではレジストリのTCP/IPパラメータから取得されます。

設定されている場合、これは完全なホスト名に対して報告される値であり、そうでない場合は、エージェントは通常の検索動作を行います。

例：

my.custom-hostname.co.org

設定されている場合、これはホスト名に対して報告される値です。そうでない場合、エージェントは通常の検索動作を行います。

例：

my.custom-hostname

エージェントがキャッシュ、インベントリ、統合などのファイルを保存するディレクトリ。

インテグレーションの設定ファイルを含むディレクトリ。

各統合には、デフォルトで<integration_name>-config.ymlという名前の独自の構成ファイルがあり、エージェントが初期化時にロードする事前定義された場所に配置されます。

統合をインストールするためのカスタムパスを指定します。これにより、統合をagent_dirの外部にインストールできます。エージェントがインストール済みの統合を探している場合は、これが優先されます。

すべての統合に渡される環境変数のリストです。インテグレーションに同じ名前の既存の設定オプションがある場合は、環境変数が優先されます。

インフラストラクチャエージェント1.24.1以降、 passthrough_environmentは変数名の正規表現をサポートします。

YAML属性としての例（エージェントの構成ファイル内、デフォルトでは/etc/newrelic-infra.ymlにあります）：

passthrough_environment:
  - HOST
  - PORT
  - NRIA_.*

環境変数としての例

NRIA_PASSTHROUGH_ENVIRONMENT="HOST,PORT,NRIA_.*"

Windows ホストの場合: PATHEXTは MS Windows 環境変数です。 この機能は、すべてのコマンドラインから実行可能なファイルにどの拡張子がマークされているかを判断することです。 これにより、一般的な Flex 統合で「... はコマンドレット、関数、スクリプト ファイルの名前として認識されません...」というエラーが報告され、すべて解決されます。

passthrough_environment:
  - PATHEXT

エージェントは、統合プロトコルのバージョン3に対して、エンティティ名（したがってキー）のループバックアドレス置換を自動的に有効にします。プロトコルのバージョン2を使用していて、この動作が必要な場合は、 entityname_integrations_v2_updateオプションを有効にします。

この構成パラメーターをtrueに設定すると、エージェントはHTTPポート（デフォルトでは8001 ）を開き、NewRelicStatsDバックエンドからデータを受信します。

この値を設定すると、エージェントはHTTPServerPortのリッスンを開始して、NewRelicStatsDバックエンドからデータを受信します。

New Relic StatsD バックエンドからデータを受信するための http サーバーのポートを設定します。

この期間に情報が報告されていないエンティティの削除処理を開始します。

有効な時間単位： s （秒）、 m （分）、およびh （時間）。

例：

1h

ホスト上に多数のプロセスがある場合、または統合全体で収集された大量のデータがある場合、エージェント キューがオーバーランする可能性があります。キューの深さを増やして、キューがいっぱいになることによるエラー メッセージを防ぎます。

統合 SDK 同期の永続ストレージとして使用される一時ディレクトリを定義します。

キャッシュされたインベントリがこの値よりも古くなった場合（エージェントがオフラインになった場合など）、エージェントは自動的にデルタストアを削除し、再作成します。

true に設定すると、インベントリの非同期処理が有効になり、より大きなインベントリ ペイロードを処理できるようになります。

エージェントが無視するインベントリパスのリストです。

YAML属性の例。

ignored_inventory:
  - files/config/stuff.bar
  - files/config/stuff.foo

環境変数としての例

NRIA_IGNORED_INVENTORY="files/config/stuff.bar,files/config/stuff.foo"

エージェントプロセスのpidファイルが作成されるLinux上の場所。起動時に、エージェントの他のインスタンスが実行されていないことを確認するために使用されます。

trueの場合、ホスト仮想メモリの定式化ではSReclaimableが使用可能なメモリと見なされます。それ以外の場合、 SReclaimableは使用済みメモリの一部と見なされます。

Log は、インフラストラクチャ エージェント ロガーの構成に使用されるキーと値のマップです。YAML 属性としての例:

log:
  file: '/var/log/newrelic-infra/newrelic-infra.log'
  level: debug
  forward: true
  stdout: false

環境変数としての例

NRIA_LOG_FILE='/var/log/newrelic-infra/newrelic-infra.log'
NRIA_LOG_LEVEL='smart'
NRIA_LOG_FORWARD='false'
NRIA_LOG_STDOUT='true'

log:
  level: info
  file: /var/log/newrelic-infra/newrelic-infra.log
  rotate:
    max_size_mb: 1000                        # Required
    max_files: 5                             # Optional
    compression_enabled: true                # Optional
    file_pattern: YYYY-MM-DD_hh-mm-ss.log    # Optional

カスタム属性は、インフラストラクチャ エージェントからのデータに注釈を付けるために使用されるキーと値のペア (他のツールのタグと同様) です。このメタデータを使用して、エンティティをフィルタリングし、結果をグループ化し、データに注釈を付けることができます。たとえば、マシンの環境 (ステージングまたは運用)、マシンがホストするサービス (ログイン サービスなど)、またはそのマシンを担当するチームを指定できます。

カスタム属性のリストを使用して、このエージェントインスタンスからのデータに注釈を付けます。 KEY: VALUEのように、キーと値をコロン:で区切り、各キーと値のペアを改行で区切ります。キーは、スラッシュ/を除く任意の有効なYAMLにすることができます。値は、スペースを含む任意のYAML文字列にすることができます。

YAML属性の例。

custom_attributes:
  environment: production
  service: login service
  team: alpha-team

環境変数としての例

NRIA_CUSTOM_ATTRIBUTES='{"customAttribute_1":"SOME_ATTRIBUTE","customAttribute_2": "SOME_ATTRIBUTE_2"}'

NRQL の例では、カスタム属性によるフィルタリングを行っています。

FROM SystemSample SELECT * WHERE environment = 'production'

プロセスメトリクス の New Relic への送信を有効にします。

デフォルトでは、インフラストラクチャエージェントはオペレーティングシステムのプロセスに関するデータを送信しません。 metrics_process_sample_rateが-1に設定されていない限り、エージェントは引き続きそのようなデータを収集します。

すべてのオペレーティングシステムのプロセスに関するメトリックデータをレポートするには、 enable_process_metricsをtrueに設定します。無効にするには、 falseに設定します。

すべてのプロセスデータを送信すると、NewRelicに送信されるデータの量が増える可能性があります。監視するプロセスを微調整するには、 include_matching_metricsを構成します。

デフォルトでは、低メモリを使用しているプロセスはサンプリングの対象から除外されます。詳しくは、 disable-zero-mem-process-filter をご覧ください。

include_matching_metricsを設定することで、New Relicに送信されるデータの量を制御できます。これにより、メトリック属性の値に基づいてメトリックデータの送信を制限できます。

メトリックの属性のいずれかにリテラル値または部分値を定義することにより、メトリックデータを含めます。たとえば、 process.nameが^java正規表現と一致するすべてのプロセスのhost.process.cpuPercentを送信するように選択できます。

この例では、実行ファイルと名前を使ってプロセスメトリクスを含めています。

include_matching_metrics:          # You can combine attributes from different metrics
  process.name:
    - regex "^java"                # Include all processes starting with "java"
  process.executable:
    - "/usr/bin/python2"           # Include the Python 2.x executable
    - regex "\\System32\\svchost"  # Include all svchost executables

いずれかの値にコマンドライン引数を含める必要がある場合は、 strip_command_lineをfalseに設定します（インフラストラクチャエージェントは、シークレットが漏洩しないように、デフォルトでCLI引数を削除します）。

include_matching_metrics Kubernetes 統合の環境変数として構成するには、それを env: オブジェクト内のマニフェストに追加します。

env:
  - name: NRIA_INCLUDE_MATCHING_METRICS
    value: |
      process.name:
        - regex "^java"
      process.executable:
        - "/usr/bin/python2"
        - regex "\\System32\\svchost"

デフォルト

ネットワーク・インターフェース・フィルター設定を使用すると、使用していないネットワーク・インターフェースや興味のないネットワーク・インターフェースをインフラストラクチャ・エージェントから隠すことができます。これにより、リソースの使用、作業、データのノイズを減らすことができます。

この設定では、シンプルなパターンマッチングメカニズムを使用しており、いずれかのパターンに続く特定の文字または数字のシーケンスで始まるインターフェースを探すことができます。

• {name}[other characters]、ここでprefixオプションを使用して名前を指定します

• [number]{name}[other characters]、ここでindex-1オプションを使用して名前を指定します

  New Relic のインフラでは、厳選されたデフォルトのフィルターリストが実装されており、 Linux と Windows の両方で利用でき、お客様が変更することも可能です。

  YMLオプション名	環境変数	タイプ	デフォルト	バージョン
  network_interface_filters	対応していません	マップ[文字列][]文字列		1.0.220

  Linux

  Linuxのデフォルトのネットワークインターフェイスフィルタ。

  • dummy 、 lo 、 vmnet 、 sit 、 tun 、 tap 、または veth

  • tunまたはを含むネットワークインターフェース tap

    次の例（構成ファイルに追加）は、デフォルトのフィルターをオーバーライドします。これは、 dummyまたはloで始まる、または一連の数字が前に続き、他の文字が続くtunを含むネットワークインターフェイスを無視します。

    network_interface_filters:
      prefix:
        - dummy
        - lo
      index-1:
        - tun

    コピー

  ウィンドウズ

  Windowsのデフォルトのネットワークインターフェイスフィルタ。

  • Loop 、 isatap 、またはで始まるネットワークインターフェイス Local

    次の例（構成ファイルに追加）は、デフォルトのフィルターをオーバーライドします。これは、 Loopで始まるネットワークインターフェースを無視します：

    network_interface_filters:
      prefix:
        - Loop

    コピー

ZeroRSSFilterは、メモリを使用していないプロセスをサンプリングから除外します。フィルタを無効にして、エージェントがこれらのプロセスをProcessSampleに含めるようにします。

すべてのプラグインを無効にするには、このオプションをtrueに設定します。

CloudSecurityGroupsプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。

Daemontoolsプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Dpkgプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。パラメータが設定ファイルで明示的に設定されていない場合は、 DisableAllPluginsをtrueに設定することで無効にできます。

Facterプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。

KernelModulesプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

NetworkInterfaceプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。

Rpmプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。

SELinuxプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。 SelinuxEnableSemoduleがfalseに設定されている場合、このオプションは無視されます。詳細については、 SELinuxモジュールの無効化に関するトラブルシューティングドキュメントを参照してください。

Sshdプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Supervisorプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Sysctlプラグインのサンプリング期間（秒単位）。最小値は30です。無効にするには、 -1に設定します。

Systemdプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

sysvプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Upstartプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Usersプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

スーパーバイザー のソケットの位置。

Puppet'sFacterのHOME環境変数を設定します。定義されていない場合、デフォルトで現在のユーザーのホームディレクトリになります。

お使いのシステムには、エージェントがプロキシを使用して New Relic と通信することを要求するファイアウォール ルールがある場合があります。その場合、プロキシ URL を https://user:password@hostname:port の形式で設定します。 HTTP または HTTPS にすることができます。

例：

https://proxy_user:access_10@proxy_01:1080

trueに設定すると、 HTTPS_PROXYおよびHTTP_PROXY環境変数は無視されます。これは、エージェントがメトリックコレクターに直接接続し、既存のシステムプロキシをスキップする必要がある場合に役立ちます。

HTTPS_PROXYオプションが自己署名証明書を持つプロキシを参照している場合、このオプションは、プロキシ証明書が使用可能なディレクトリへのパスを指定します。ディレクトリ内の証明書は、 .pem拡張子で終わる必要があります。

HTTPS_PROXYオプションが自己署名証明書を持つプロキシを参照している場合、このオプションは証明書ファイルへのパスを指定します。

trueに設定されている場合、プロキシがHTTPS接続を使用するように構成されていると、次の場合にのみ機能します。

• HTTPS プロキシに有効な認証局からの証明書がある場合。

• ca_bundle_fileまたはca_bundle_dir構成プロパティにHTTPSプロキシ証明書が含まれている場合。

  YMLオプション名	環境変数	タイプ	デフォルト	バージョン
  proxy_validate_certificates	NRIA_PROXY_VALIDATE_CERTIFICATES	ブール値	false	1.3.0

以下のプロキシ設定情報をインベントリとして送信します。

• HTTPS_PROXY

• HTTP_PROXY

• proxy ca_bundle_dir

• ca_bundle_file

• ignore_system_proxy

• proxy_validate_certificates

  YMLオプション名	環境変数	タイプ	デフォルト	バージョン
  proxy_config_plugin	NRIA_PROXY_CONFIG_PLUGIN	ブール値	true	1.3.0

ネットワークサンプルのサンプルレート（秒単位）。最小値は10です。無効にするには、 -1に設定します。

プロセスサンプルのサンプルレート（秒単位）。最小値は20です。プロセスサンプルを完全に無効にするには、 metrics_process_sample_rateを-1に設定します。

ストレージサンプルのサンプルレート（秒単位）。最小値は5です。無効にするには、 -1に設定します。

システムサンプルのサンプルレート（秒単位）。最小値は5です。無効にするには、 -1に設定します。

NFSストレージサンプルのサンプルレート（秒単位）。最小値は5です。無効にするには、 -1に設定します。

詳細な NFS メトリクス。有効にすると、エージェントは NFS メトリクスの完全なリストを提供します。

NTP オフセット メトリックを有効/無効にするフラグ。

照会する NTP ホストのリストを定義します。複数のホストが定義されている場合、それらすべてが照会され、レポートされるメトリックはそれらの間の平均値になります。

提供されたプールから NTP オフセットを要求する間隔を分単位で定義します。

NTP ホストに対する要求のタイムアウトを秒単位で定義します。

SEModule を使用してインストールされたポリシーモジュールのバージョンを取得します。無効にした場合、SELinuxプラグインはSEStatusを使ってステータスを取得するだけです。

trueの場合、エージェントはProcessSampleのcommandLine属性からコマンド引数を削除します。

ローカルの正常性情報を提供するエージェント上のステータス サーバーを有効にします。利用可能なエンドポイントは次のとおりです。

メイン ステータス エンドポイントの例 (エラーなし):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

メイン ステータス エンドポイント (エラーあり):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

エラーエンドポイントの例:

$
curl http://localhost:18003/v1/status/errors
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

これはメイン ステータス エンドポイントに似ていますが、エラーのあるエンドポイントのみをフィルターします。

エンティティエンドポイントの例:

$
curl http://localhost:8003/v1/status/entity
$
{
$
  "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy",
$
  "key":"your-host-name"
$
}

エージェント/ホスト エンティティに関する情報を返します。エージェントがエージェント/ホスト エンティティに関する情報をまだ持っていない場合、応答ステータス コード204 (「コンテンツなし」) が返されます。したがって、エージェントがエンティティ データを提供するまでに、いくつかのリクエストが必要になる場合があります。

ステータス サーバー エンドポイントのポートを定義します。

Windowsサービスプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

Windows Updateプラグインのサンプリング期間（秒単位）。最小値は10です。無効にするには、 -1に設定します。

データをプログラムファイルのディレクトリとは別のパスに格納することを定義します。

• %AppDir%/data：デルタデータの保存に使用されます

• %AppDir%/user_data：ユーザーが生成したJSONファイルの外部ディレクトリ

• %AppDir%/newrelic-infra.log：ログファイル設定オプションが定義されていない場合は、このディレクトリパスをデフォルトとして使用します。

  YMLオプション名	環境変数	タイプ	デフォルト	バージョン
  app_data_dir	NRIA_APP_DATA_DIR	ストリング	ウィンドウズ： env(ProgramData)\New Relic\newrelic-infra Linux: 適用されません	1.0.755

ホストにインストールされているHotfixの一覧を取得するWindows Updateプラグインを有効にします。

trueの場合、エージェントはWindows WMI（Windowsのメトリックを取得するためのエージェントのレガシーメソッド。たとえば、 StorageSampler ）を使用するように強制され、新しいメソッド（PDHライブラリを使用する）を無効にします。

この設定オプションを使用すると、 newrelic-infra.exeプロセスの優先度を次のいずれかの値に上げることができます。

• Normal

• Idle

• High

• RealTime

• BelowNormal

• AboveNormal

  YMLオプション名	環境変数	タイプ	デフォルト	バージョン
  win_process_priority_class	NRIA_WIN_PROCESS_PRIORITY_CLASS	ストリング		1.0.989

  例：

  Normal

  コピー

リムーバブルドライブとしてマップされている場合、WindowsエージェントがドライブA:およびB:を報告できるようにします。

true に設定すると、WMI からプロセス情報を取得し、制限された環境でのクエリ アクセス チェックをスキップします。

New Relic バックエンドへのすべてのリクエストに含めるカスタム HTTP ヘッダー。

http:
  headers:
    "Proxy-Authorization": "myToken"