New Relic eBPF エージェントを Linux ホストにインストールして、システム全体の健全性を監視できます。 eBPF エージェントは、コードの変更やデプロイ言語固有のエージェントを必要とせずに、アプリケーションのパフォーマンスを詳細に可視化します。
New Relic eBPF エージェントのインストール
あなたが始める前に
Linux ホストのeBPF 互換性と要件のドキュメントに記載されている前提条件を満たす必要があります。
eBPF エージェントをインストールする
eBPF エージェントをインストールするには:
New Relic のアカウントにログインします。
left navigation pane > + Integration & Agents > eBPF Agentに移動します。
Select an account画面で、eBPF エージェントをインストールするアカウントを選択し、 Continueをクリックします。
Select an installation methodページでOn a hostを選択し、 Continueをクリックします。
Enter your user key画面で、以下のオプションのいずれかを選択し、 Continueをクリックしてください。
- Use an existing keyユーザーキーを既にお持ちの場合は、そのユーザーキーを入力してください。詳細については、 「ユーザーキー」を参照してください。
- Create a new keyユーザーキーをお持ちでない場合は、 Create a new keyをクリックして作成してください。
Configure the host integration画面でホストのデプロイメント名を入力し、 Continueをクリックします。
Install the agent画面で、ターミナルで提供されたコマンドを実行して、Debian パッケージ経由で eBPF エージェントをインストールします。
表示されたコマンドをコピーして貼り付け、Debian ホストに eBPF エージェントをインストールします。
インストールを確認するには、次のコマンドを実行します。
bash$sudo systemctl status newrelic-ebpf-agent
インストールが成功すると、これらのサービスのステータスがアクティブ (実行中) として表示されます。
ヒント
/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.yamlで入手可能なnewrelic-ebpf-agent.yamlファイルを編集することで、eBPF エージェント設定をカスタマイズできます。 設定の問題の詳細については、設定の問題を参照してください。
New RelicでeBPFデータにアクセスする
eBPF エージェントがインストールされると、Linux ホストからのデータの収集が自動的に開始されます。このデータには、New Relic の OpenTelemetry UI からアクセスできます。New Relic OpenTelemetry UI の詳細については、 OpenTelemetry APM UI を参照してください。
New Relic で eBPF データを表示するには:
- one.newrelic.com > APM & Servicesに移動します。
- 検索バナーで、検索条件を
instrumentation.name = nr_ebpfとして設定します。
eBPF エージェントをアップグレードする
Linux ホストで eBPF エージェントをアップグレードするには、 New Relic UIからインストール コマンドを再実行します。 このプロセスでは、新しいエージェント バージョンがインストールされ、古いバージョンは自動的に削除されます。
重要
パッケージマネージャによるアップグレードはサポートされていません。 アップグレードを成功させるには、 New Relic UIから インストレーション コマンドを使用する必要があります。
最新のインストール コマンドを取得するには:
one.newrelic.com > + Integration & Agents > eBPF Agentに移動します。
インストール フローに従って、更新されたコマンドを取得します。
ホスト上でコマンドを実行してエージェントをアップグレードしてください。
以下のコマンドを使用して、ebpf エージェント サービスを再起動します。
bash$sudo systemctl restart newrelic-ebpf-agent
設定パラメーター
newrelic-ebpf-agent.yamlファイルには次の設定が含まれています:
ヒント
eBPF エージェントは、環境に応じて異なるエンティティ名を自動的に生成します。
ホストまたは Docker では、これらの名前はプロセス名、そのディレクトリまたはコンテナ ID、およびリスニング ポートの組み合わせです。たとえば、
ruby:/home/ubuntu/app:[5678]またはjava:f4aead533895:[8080]。Kubernetes では、これらの名前はサービス名から派生されます (例:
mysql-database-service)。アプリケーションにカスタム名を割り当てる:
Kubernetesとオンホスト アプリケーションの両方に
NEW_RELIC_APP_NAME環境変数を設定することで、アプリケーションにカスタム名を割り当てることができます。
eBPF エージェントをアンインストールする
Linux ホストから eBPF エージェントをアンインストールするには、システムのパッケージ管理ツールを使用します。
$sudo apt-get purge newrelic-ebpf-agentヒント
アンインストール コマンドを実行する前にサービスを停止する必要はありません。