• /
  • EnglishEspañolFrançais日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

Kubernetes 用に ATP を構成する

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリース ポリシーに従ってプレビューの一部として提供されています。

Kubernetes環境で NRDOT Collector使用して Adaptive telemory Processor (ATP) をインストールおよび構成する方法を学習します。 ATP は、アプリケーションに対する重要な可視性を維持しながら、テレメトリーデータのボリュームを削減します。

重要

ATP for Kubernetes は実験的なビルドを使用します。このビルド全体は、プレビュー中の ATP 機能だけでなく、 Kubernetesインストレーションの実験的なものです。

インストレーションの方法

Helm (推奨) または Kubernetes マニフェストを使用して、ATP で OpenTelemetry Collector をインストールできます。

Helmメソッドは、 Kubernetesのデプロイ ATP 対応コレクターに推奨されるアプローチです。

あなたが始める前に

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

  • あなたのNew Relicライセンスキー
  • クラスターにアクセスできるように構成された kubectl
  • Cluster管理者の権限

values.yaml をダウンロードしてカスタマイズする

  1. Helm チャートvalues.yamlファイルをダウンロードします:

    bash
    $
    curl -o values.yaml https://raw.githubusercontent.com/newrelic/helm-charts/master/charts/nr-k8s-otel-collector/values.yaml
  2. 特定の設定を使用してvalues.yamlファイルを編集します。

    # Required: Set your cluster name and license key
    cluster: "YOUR_CLUSTER_NAME"
    licenseKey: "YOUR_NEW_RELIC_LICENSE_KEY"
    # Enable ATP
    enable_atp: true
    # IMPORTANT: Use experimental collector image for ATP
    images:
    collector:
    repository: "newrelic/nrdot-collector" # Changed from nrdot-collector-k8s
    tag: "<NRDOT_COLLECTOR_LATEST_VERSION>" # Use latest version from releases page
  3. リリース ページで最新の NRDOT Collector バージョンを見つけて、 tag値を更新します。

  4. 追加の設定オプションについては、 「設定の問題」を参照してください。

Helmチャートをインストールする

  1. New Relic Helm リポジトリを追加します。

    bash
    $
    helm repo add newrelic https://helm-charts.newrelic.com
    $
    helm repo update
  2. カスタマイズしたvalues.yamlファイルを使用してチャートをインストールします。

    bash
    $
    helm upgrade nr-k8s-otel-collector newrelic/nr-k8s-otel-collector \
    >
    -f values.yaml \
    >
    -n newrelic \
    >
    --create-namespace \
    >
    --install

インストレーションを確認する

  1. ポッドが実行されていることを確認します。

    bash
    $
    kubectl get pods -n newrelic --watch

    newrelicネームスペースに、 nr-k8s-otel-collector-<hash>のような名前のポッドが表示されるはずです。

  2. 書き込みビルダーで次の書き込みを実行して、 New Relicプロセス データを受信していることを確認します。

    FROM Metric SELECT *
    WHERE k8s.cluster.name='YOUR_CLUSTER_NAME'
    AND metricName LIKE 'process.%'
    LIMIT 100
    FROM Metric SELECT uniqueCount(metricName)
    WHERE k8s.cluster.name='YOUR_CLUSTER_NAME'
    AND metricName LIKE 'process.%'

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

ATP が構成されると、 Kubernetesクラスタからのデータの収集が開始されます。 このデータには 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 およびメモリ使用率のメトリクスを表示できます。 また、プロセスが他のプロセスを生成する場合、プロセス間の親子関係も表示されます。

    ATP process metrics in New Relic OpenTelemetry UI

マニフェスト インストレーション メソッドは、 Helmを使用せずにKubernetes用にOpenTelemetryセットアップする方法を提供します。 この方法は、より実践的なアプローチを好むユーザーや、手動設定を必要とする特定の要件を持つユーザーに適しています。

あなたが始める前に

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

  • あなたのNew Relicライセンスキー
  • クラスターにアクセスできるように構成された kubectl
  • Cluster管理者の権限

マニフェストファイルをダウンロードして準備する

  1. nr-k8s-otel-collectorのレンダリングされたサンプル ディレクトリの内容をローカル ワークスペースにコピーします。

    bash
    $
    git clone https://github.com/newrelic/helm-charts.git
    $
    cd helm-charts/charts/nr-k8s-otel-collector/examples/k8s-with-atp/rendered
  2. daemonset.yamldeployment.yamlファイルの両方でコレクター イメージを更新します。

    変更前:

    image: docker.io/newrelic/nrdot-collector-k8s

    に:

    image: docker.io/newrelic/nrdot-collector:<NRDOT_COLLECTOR_LATEST_VERSION>

    重要

    これはKubernetesインストレーションの実験用ビルドです。 最新バージョンはリリース ページからご確認ください。

ライセンスキーとクラスター名を設定する

  1. Base64 でエンコードされたNew Relicライセンスキーを使用してsecret.yamlファイルを更新します。

    data:
    licenseKey: <YOUR_BASE64_ENCODED_LICENSE_KEY>

    ライセンスキーをエンコードするには:

    • Linux / macOS: echo -n "<YOUR_LICENSE_KEY>" | base64
    • Windows (PowerShell): [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("<YOUR_LICENSE_KEY>"))
  2. daemonset-configmap.yamlファイルとdeployment-configmap.yamlファイルの両方でクラスター名を更新します。

    k8s.cluster.nameのインスタンスを探し、 <YOUR_CLUSTER_NAME>希望のクラスター名に置き換えます。

    - key: k8s.cluster.name
    action: upsert
    value: YOUR_CLUSTER_NAME # Replace with your cluster name

マニフェストをデプロイする

  1. newrelicネームスペースを作成し、マニフェストを適用します。

    bash
    $
    kubectl create namespace newrelic
    $
    kubectl apply -n newrelic -R -f .
  2. ポッドが実行されていることを確認します。

    bash
    $
    kubectl get pods -n newrelic --watch
  3. 書き込みビルダーで次の書き込みを実行して、 New Relicプロセス データを受信していることを確認します。

    FROM Metric SELECT *
    WHERE k8s.cluster.name='<YOUR_CLUSTER_NAME>'
    AND metricName LIKE 'process.%'
    LIMIT 100
    FROM Metric SELECT uniqueCount(metricName)
    WHERE k8s.cluster.name='<YOUR_CLUSTER_NAME>'
    AND metricName LIKE 'process.%'

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

ATP が構成されると、 Kubernetesクラスタからのデータの収集が開始されます。 このデータには 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 およびメモリ使用率のメトリクスを表示できます。 また、プロセスが他のプロセスを生成する場合、プロセス間の親子関係も表示されます。

    ATP process metrics in New Relic OpenTelemetry UI

ATP設定オプション

ATP を有効にすると、次の設定が自動的に適用されます。

パラメータ

説明

デフォルト値

enable_atp

ATP 機能を有効/無効にします。ATP を有効にするには

true

に設定します。

false

images.collector.repository

ATP を使用するには

newrelic/nrdot-collector

に変更する必要があります。

newrelic/nrdot-collector-k8s

images.collector.tag

ATP 対応コレクターのイメージタグ。

<TO_BE_CONFIRMED>

/* ## トラブルシューティング ATP [トラブルシューティング] ### ATP がメトリクスをフィルタリングしていません **問題**: すべてのプロセス メトリクスが送信されており、フィルタリングされていません。 **解決策**: 1. **ATP が有効であることを確認します**: ```bash kubectl get configmap -n newrelic nr-k8s-otel-コレクター-daemonset-config -o yaml | grepadaptivetelemetry ``` 2. **ATP がパイプラインにあることを確認します**: `Metriks/nr` パイプラインで `adaptivetelemetry` を探します。 3. **正しいコレクター イメージを使用していることを確認します**: ```bash kubectl get daemonset -n newrelic nr-k8s-otel-コレクター-daemonset -o yaml | grep "image:" ``` 期待されるもの: `newrelic/nrdot-collectors:1.11.0` (またはそれ以降) **NOT**: `newrelic/nrdot-collector-k8s:1.11.0` 4. **`values.yaml` または ConfigMap で `enable_atp``true` に設定されていることを確認します**。 ### ポッドが起動しない **問題**: Collectorが起動に失敗します。 **解決策**: 1. **ポッドログを確認します**: ```bash kubectl ログ -n newrelic -l app.kubernetes.io/name=nr-k8s-otel-collector ``` 2. **ライセンスキーが正しくエンコードされていることを確認します**: ```bash kubectl get secret -n newrelic nr-k8s-otel-コレクター-config -o yaml ``` 3. **リソース制限を確認します**: クラスタにコレクター ポッド用の十分なリソースがあることを確認してください。 ### New Relicにデータがない **問題**: 導入後にNew Relicにメトリクスが表示されません。 **解決策**: 1. **New Relic UI にデータが表示されるまで **2~5 分待ちます**。 2. **クラスター名** が設定で設定した名前と一致していることを確認します**。3. **コレクター ログ**で接続エラーを確認します: ```bash kubectl ログ -n newrelic -l app.kubernetes.io/name=nr-k8s-otel-コレクター | grep -i エラー ``` */

トラブルシューティング

ご使用の環境における ATP の問題をトラブルシューティングする方法を学びます。

データのクエリ

NRQL を使用して New Relic で ATP データをクエリする方法を学びます。

高度な機能

ATP デプロイメントの高度な機能を有効にする方法を学びます。

Copyright © 2026 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.