ホストのATPを構成する

あなたが始める前に

以下のものを用意してください:

• 既存の NRDOT Collectorバージョン1.11.0以降
• あなたのNew Relicライセンスキー
• ルート権限またはsudo権限
• 現在の設定のバックアップ

現在の設定をバックアップ

続行する前に、現在の設定を保護してください。

$
sudo cp /etc/nrdot-collector/config.yaml /etc/nrdot-collector/config.yaml.bak

NRDOT コレクターのアップグレード

NRDOT コレクターを ATP サポートを備えた最新バージョンに更新するには、最新バージョンのインストレーション コマンドを再実行します。 これにより、既存の設定ファイルを保持しながら古いバイナリが上書きされます。

ATPを構成する

アップグレードでは以前の設定が保持されるため、 config.yamlにはまだ新しい ATP 設定が含まれていません。手動で追加する必要があります。

設定ファイルを編集するには:

1. root または sudo 権限を使用して、テキスト エディターで設定ファイル (config.yaml) を開きます。

   • DEB/RPM インストレーションの場合:
   bash

   コピー

   $
   sudo nano /etc/nrdot-collector/config.yaml

   • 手動バイナリインストールの場合:
   bash

   コピー

   $
   nano config.yaml

2. プロセス メトリクスを収集するには、 hostmetricsレシーバーのscrapersセクションに次のprocess設定を追加します。

   processes:
   process:
     metrics:
       process.cpu.utilization:
         enabled: true
       process.memory.utilization:
         enabled: true
     mute_process_name_error: true
     mute_process_exe_error: true
     mute_process_io_error: true
     mute_process_user_error: true

   コピー

3. ATP を有効にするには、既存のprocessorsセクションを見つけて、その下にadaptivetelemetry設定を追加します。

   processors:
     # Your existing processors...
     adaptivetelemetry:
       enable_storage: true
       retention_minutes: 30
       include_process_list:
         - "/usr/bin/postgres"
         - "/usr/sbin/nginx" # Replace with your target processes
       metric_thresholds:
         process.cpu.utilization: 0.05     # 5% CPU
         process.memory.utilization: 0.05  # 5% memory

   コピー

4. ATP プロセッサをメトリクス パイプラインのserviceセクションに追加します。

   service:
     pipelines:
       metrics/host:
         receivers: [hostmetrics]
         processors:
           - memory_limiter
           - adaptivetelemetry  # ADD THIS LINE
           - metricstransform
           - filter/exclude_cpu_utilization
           - filter/exclude_memory_utilization

   コピー

5. (オプション)必要に応じて、メトリクス閾値などの ATP 設定を更新します。 設定オプションの詳細については、 「設定」を参照してください。

6. 設定ファイルを保存します。

7. 変更を適用するには、NRDOT コレクターを再起動します。

   bash

   コピー

   $
   sudo systemctl restart nrdot-collector

New RelicでATPデータにアクセスする

ATP が設定されると、Linux ホストからのデータの収集が開始されます。このデータには New Relic OpenTelemetry UI からアクセスできます。New Relic OpenTelemetry UI の詳細については、 OpenTelemetry APM UIを参照してください。

New Relicで ATP プロセスのメトリクス データを表示するには:

1. one.newrelic.com > All Entitiesへ移動します。

   また

   one.newrelic.com > Catalogs > Infrastructureに移動します。

2. ATP を使用して NRDOT コレクターをインストールしたエンティティを検索します。

3. エンティティを選択し、左側のペインでProcessをクリックします。

   Processページでは、ホスト上で実行されているすべてのプロセスと、その ID、CPU およびメモリ使用率のメトリクスを表示できます。 また、プロセスが他のプロセスを生成する場合、プロセス間の親子関係も表示されます。

   

あなたが始める前に

以下のものを用意してください:

• あなたのNew Relicライセンスキー
• ルート権限またはsudo権限
• サービスの中断を最小限に抑える計画

ネイティブエージェントを停止して無効にする

1. データの競合を防ぐために既存のインフラストラクチャエージェントを停止するには、次のコマンドを実行します。

   bash

   コピー

   $
   # Stop the service
   $
   sudo systemctl stop newrelic-infra

2. 起動時にインフラストラクチャエージェントが起動しないようにするには、次のコマンドを実行します。

   bash

   コピー

   $
   # Disable from starting on boot
   $
   sudo systemctl disable newrelic-infra

NRDOT コレクター ホストをインストールする

ATP は、NRDOT コレクター ディストリビューションにあらかじめパッケージ化されています。OS に基づいて、インストール方法を選択します。

ATPを構成する

NRDOT コレクターをインストールしたら、コレクターの設定ファイルを編集して ATP を有効にしてカスタマイズします。 設定ファイルのパスは導入方法によって異なります。

• DEB/RPM インストールの場合、構成ファイルは/etc/nrdot-collector/config.yamlにあります。

• 手動バイナリ インストレーションの場合、設定ファイルは抽出されたフォルダー内にあります。

  設定ファイルを編集するには:

1. 設定ファイル (config.yaml) をテキスト エディターで開きます。

   • DEB/RPM インストレーションの場合:
   bash

   コピー

   $
   sudo nano /etc/nrdot-collector/config.yaml

   • 手動バイナリインストールの場合:
   bash

   コピー

   $
   nano config.yaml

2. プロセス メトリクスを収集するには、 hostmetricsレシーバーのscrapersセクションに次のprocess設定を追加します。

   receivers:
     hostmetrics:
       scrapers:
         # Your existing scrapers...
         process:
           metrics:
             process.cpu.utilization:
               enabled: true
             process.memory.utilization:
               enabled: true
           mute_process_name_error: true
           mute_process_exe_error: true
           mute_process_io_error: true
           mute_process_user_error: true

   コピー

3. ATP を有効にするには、既存のprocessorsセクションを見つけて、その下にadaptivetelemetry設定を追加します。

   processors:
     adaptivetelemetry:
       enable_storage: true
       retention_minutes: 30
       include_process_list:
         - "/usr/bin/postgres"
         - "/usr/sbin/nginx" # Replace with your target processes
       metric_thresholds:
         process.cpu.utilization: 0.05     # 5% CPU
         process.memory.utilization: 0.05  # 5% memory

   コピー

4. ATP プロセッサをメトリクス パイプラインのserviceセクションに追加します。

   service:
     pipelines:
       metrics/host:
         receivers: [hostmetrics]
         processors:
           - memory_limiter
           - adaptivetelemetry  # ADD THIS LINE
           - metricstransform
           - filter/exclude_cpu_utilization
           - filter/exclude_memory_utilization

   コピー

5. (オプション)必要に応じて、メトリクス閾値などの ATP 設定を更新します。 設定オプションの詳細については、 「設定」を参照してください。

6. 設定ファイルを保存します。

7. 変更を適用するには、NRDOT コレクターを再起動します。

   bash

   コピー

   $
   sudo systemctl restart nrdot-collector

移行を確認する

インストールが成功したら、データがNew Relicに流れていることを確認します。

1. サービスのステータスを確認するには、次のコマンドを実行します。

   bash

   コピー

   $
   sudo systemctl status nrdot-collector

2. ログを確認するには、次のコマンドを実行します。

   bash

   コピー

   $
   sudo journalctl -u nrdot-collector -f

New RelicでATPデータにアクセスする

ATP が設定されると、Linux ホストからのデータの収集が開始されます。このデータには New Relic OpenTelemetry UI からアクセスできます。New Relic OpenTelemetry UI の詳細については、 OpenTelemetry APM UIを参照してください。

New Relicで ATP プロセスのメトリクス データを表示するには:

1. one.newrelic.com > All Entitiesへ移動します。

   また

   one.newrelic.com > Catalogs > Infrastructureに移動します。

2. ATP を使用して NRDOT コレクターをインストールしたエンティティを検索します。

3. エンティティを選択し、左側のペインでProcessをクリックします。

   Processページでは、ホスト上で実行されているすべてのプロセスと、その ID、CPU およびメモリ使用率のメトリクスを表示できます。 また、プロセスが他のプロセスを生成する場合、プロセス間の親子関係も表示されます。