New Relic eBPF エージェントを Linux ホストにインストールして、システム全体の健全性を監視できます。 eBPF エージェントは、コードの変更やデプロイ言語固有のエージェントを必要とせずに、アプリケーションのパフォーマンスを詳細に可視化します。
New Relic eBPF エージェントのインストール
あなたが始める前に
Linux ホストのeBPF 互換性と要件のドキュメントに記載されている前提条件を満たす必要があります。
eBPF エージェントをインストールする
eBPF エージェントをインストールするには:
New Relic のアカウントにログインします。
左側のナビゲーション ペイン > + Integration & Agents > eBPF Agentに移動します。
Select [アカウントの選択] 画面で、eBPF エージェントをインストールするアカウントを選択し、 Continue [続行]をクリックします。
Select an installation method [インストール方法の選択] ページで、 On a host [ホスト上] を選択し、 Continue [続行]をクリックします。
「ユーザー キーを入力」画面で、次のいずれかのオプションを選択し、Continue [続行]をクリックします。
- 既存のキーを使用する: すでにユーザー キーがある場合は、そのユーザー キーを指定します。 詳細については、 「ユーザー キー」を参照してください。
- 新しいキーを作成する: ユーザー キーがない場合は、 Create a new key [新しいキーの作成]をクリックして作成します。
Configure the host integration [ホスト統合の構成] 画面で、ホストのデプロイメント名を入力し、 Continue [続行]をクリックします。
「エージェントのインストール」画面で、ターミナルで提供されたコマンドを実行し、Debian パッケージ経由で eBPF エージェントをインストールします。
表示されたコマンドをコピーして貼り付け、Debian ホストに eBPF エージェントをインストールします。
インストールを確認するには、次のコマンドを実行します。
eBPF エージェントの場合:
bash$sudo systemctl status newrelic-ebpf-agenteBPF クライアントの場合:
bash$sudo systemctl status newrelic-ebpf-agent-client
インストールが成功すると、これらのサービスのステータスがアクティブ (実行中) として表示されます。
ヒント
/etc/newrelic-ebpf-agent/newrelic-ebpf-agent.confで入手可能なnewrelic-ebpf-agent.confファイルを編集することで、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として設定します。
/* * <DNT>**すべてのエンティティ > サービス - OpenTelemetry</DNT> でエンティティを見つけます。 エンティティ名はアプリの `service.name` の値に設定されますリソース属性。New Relicサービス エンティティがOpenTelemetryリソースのプロパティからどのように派生するかについて詳しくは、[Services](/docs/OpenTelemetry/ベストプラクティス/OpenTelemetry-ベストプラクティス-resources/#services) を参照してください。 * [ NRQL ](/docs/ NRQL /get-started/introduction-NRQL(New Relic 書き込み言語)/) を使用して、直接書きます[トレース](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0) aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnXXSI6IkZST00gU3BhbiBTRUxFQ1QgY291bnQoKikgd2hlcmU gbmV3cmVsaWMuc291cmNlPSclb3RscCUnIFRJTUVTRVJJRVMifV0sImluaXRpYWxDaGFydFNldHRpbmdzIjp7ImNoYXJ0VHlwZSI6IkNIQVJUX0xJTkUiLCJsaW1pdCI6NzU0MiwibGlua2VkRW50aXR5R3VpZCI6bnVsbCwibGlua2VkRGFzaGJvYXJkSWQiOm51bGwsInlTY2FsZSI6eyJzdGF0aWMiOmZhbHNlLCJkb21haW4iOltudWxsLG51bGxdfSwieVplcm8iOnRydWV9fQo=)、 [メトリクス](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTWV0cmljIFNFTEVDVCBjb3VudCgqKSB3aGVyZS BuZXdyZWxpYy5zb3VyY2UgTElLRSAnJW90bHAlJyBUSU1FU0VSSUVTIn1dLCJpbml0aWFsQ2hhcnRTZXR0aW5ncyI6eyJjaGFydFR5cGUiOiJDSEFSVF9MSU5FIiwibGltaXQiOjc1NDIsImxpbmtlZEVudGl0eUd1aWQiOm51bGwsImxpbmtlZERhc2hib2FyZElkIjpudWxsLCJ5U2NhbGUiOnsic3RhdGljIjpmYWxzZSwiZG9tYWluIjpbbnVsbCxudWxsXX0sInlaZXJvIjp0cnVlfX0K)、および[ログ](https\://one.newrelic.com/launcher/nr1-core.explorer?overlay=eyJuZXJkbGV0SWQiOiJkYXRhLWV4cGxvcmF0aW9uLnF1ZXJ5LWJ1aWxkZXIiLCJpbml0aWFsQWN0aXZlSW50ZXJmYWNlIjoibnJxbEVkaXRvciIsImluaXRpYWxOcnFsVmFsdWUiOiIiLCJpbml0aWFsUXVlcmllcyI6W3sibnJxbCI6IkZST00gTG9nIFNFTEVDVCBjb3VudCgqKSB3aGVyZSB uZXdyZWxpYy5zb3VyY2U9JyVvdGxwJScgVElNRVNFUklFUyJ9XSwiaW5pdGlhbENoYXJ0U2V0dGluZ3MiOnsiY2hhcnRUeXBlIjoiQ0hBUlRfTElORSIsImxpbWl0Ijo3NTQyLCJsaW5rZWRFbnRpdHlHdWlkIjpudWxsLCJsaW5rZWREYXNoYm9hcmRJZCI6bnVsbCwieVNjYWxlIjp7InN0YXRpYyI6ZmFsc2UsImRvbWFpbiI6W251bGwsbnVsbF19LCJ5WmVybyI6dHJ1ZX19Cg==)。* 詳細については、[ OpenTelemetry APM UI ](/docs/OpenTelemetry/get-started/APM-監視/OpenTelemetry-APM-UI) を参照してください。 エンティティが見つからず、 NRQLでデータが表示されない場合は、[OTLP トラブルシューティング](/docs/OpenTelemetry/ベストプラクティス/OpenTelemetry-otlp-トラブルシューティング) を参照してください。 eBPF エージェントによって収集されたデータは、New Relic Opentelementry UI で確認できます。 */
eBPF エージェントをアップグレードする
Linux ホストで eBPF エージェントをアップグレードするには、 New Relic UIからインストール コマンドを再実行します。 このプロセスでは、新しいエージェント バージョンがインストールされ、古いバージョンは自動的に削除されます。
重要
パッケージマネージャによるアップグレードはサポートされていません。 アップグレードを成功させるには、 New Relic UIから インストレーション コマンドを使用する必要があります。
最新のインストール コマンドを取得するには:
- one.newrelic.com > + Integration & Agents > eBPF Agentに移動します。
- インストレーション フローに従って更新されたコマンドを取得します
- ホスト上でコマンドを実行してエージェントをアップグレードします
設定パラメーター
newrelic-ebpf-agent.confファイルには次の設定が含まれています:
eBPF エージェントをアンインストールする
Linux ホストから eBPF エージェントをアンインストールするには、システムのパッケージ管理ツールを使用します。
$sudo apt-get remove newrelic-ebpf-agentヒント
アンインストール コマンドを実行する前にサービスを停止する必要はありません。