New Relic eBPF エージェントをKubernetesクラスタにインストールして、システム全体の健全性を監視できます。 eBPF エージェントは、コードの変更やデプロイ言語固有のエージェントを必要とせずに、アプリケーションのパフォーマンスを詳細に可視化します。
New Relic eBPF エージェントをインストールする
あなたが始める前に
KubernetesクラスタのeBPF 互換性と要件のドキュメントに記載されている前提条件を満たす必要があります。
eBPF エージェントをインストールする
eBPF エージェントをインストールするには:
New Relic のアカウントにログインします。
左側のナビゲーション ペイン > + Integration & Agents > eBPF Agentに移動します。
Select [アカウントの選択] 画面で、eBPF エージェントをインストールするアカウントを選択し、 Continue [続行]をクリックします。
Select [インストール方法の選択] ページで、 Kubernetesを選択し、 Continue [続行]をクリックします。
「ユーザー キーを入力」画面で、次のいずれかのオプションを選択し、Continue [続行]をクリックします。
- 既存のキーを使用する: すでにユーザー キーがある場合は、そのユーザー キーを指定します。 詳細については、 「ユーザー キー」を参照してください。
- 新しいキーを作成する: ユーザー キーがない場合は、 Create a new key [新しいキーの作成]をクリックして作成します。
Kubernetesインテグレーションの構成] 画面で:
- Kubernetes のデプロイメント名を入力します。
- (オプション) 統合のネームスペースを入力します。 デフォルトのネームスペースは
newrelicです。 - Click Continue.
ヒント
New Relic計装にカスタムのネームスペースを選択した場合(デフォルトの
newrelicの代わりに)、そのネームスペースをdropDataForNamespaces設定に追加して監視から除外することをお勧めします。 これにより、eBPF エージェントは計装ポッド自体を監視できなくなります。 たとえば、ネームスペースとしてnewrelic-monを使用する場合は、dropDataForNamespaces: ["kube-system", "newrelic-mon"]を設定します。Kubernetesインテグレーションのインストール] 画面で:
表示されたコマンドをコピーして貼り付け、 Helmを使用してKubernetesクラスタに eBPF エージェントをインストールします。
(オプション)
values.yaml設定ファイルをダウンロードするには、 Download [ダウンロード]をクリックします。 設定の問題の詳細については、 「K8s 設定の問題」を参照してください。(オプション)必要に応じて
values.yamlファイルを更新し、保存します。(オプション)設定の変更を適用するには、次のコマンドを実行します。
bash$helm repo update ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent -n newrelic --values values.yamlインストールを確認するには、次のコマンドを実行します。
bash$kubectl get pods -n newrelic
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として設定します。
/* アプリがインストルメントされ、データをNew Relicにエクスポートするように設定されると、 New Relic UIでデータを見つけることができるようになります。 * <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 エージェントをアップグレードする
KubernetesクラスタでeBPFエージェントをアップグレードするには:
- 標準アップグレードの場合: 次の Helm コマンドを使用して最新バージョンにアップグレードします。
$KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic- 特定のバージョンへのアップグレードの場合:特定のバージョンにアップグレードするには、
--versionフラグを使用します。
$KSM_IMAGE_VERSION="v2.13.0" && helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && kubectl create namespace "newrelic" ; helm upgrade --install nr-ebpf-agent newrelic/nr-ebpf-agent --set licenseKey=<key> --set cluster="<cluster-name>" --namespace=newrelic --version=0.2.5<key> New Relicライセンスキーに置き換え、 <cluster-name>クラスタ名に置き換えます。
設定パラメーター
values.yamlファイルには、次の設定セクションが含まれています。
eBPF エージェントをアンインストールする
Kubernetesクラスタから eBPF エージェントをアンインストールするには:
$helm uninstall nr-ebpf-agent -n newrelicヒント
このコマンドは、クラスターからすべての eBPF エージェント コンポーネントを削除します。ネームスペースは明示的に削除しない限り残ります。