Agent Controlで既存の計装を管理

Kubernetesへの移行

KubernetesクラスタがすでにNew Relicでインストゥルメントされている場合は、エージェントをAgent Controlで管理されるように移行して、その管理機能を使用できます。 移行プロセスでは、既存のエージェントインストールを削除し、Fleet Control を通じて一元的に構成された Agent Control 管理のインストールに置き換えます。

ステップ1. 既存の設定を取得します

まず、既存のエージェントのうち、どのエージェントが Agent Control で管理できるかを特定します。

Agent Control 、 Agent Controlタイプにマッピングされた、 nri-bundle Helmチャートから次のエージェントをデプロイして管理できます。

• newrelic-infrastructure、 nri-kube-events 、 kube-state-metrics 、およびnri-kube-events : New Relic Infrastructureタイプとして管理
• newrelic-prometheus-configurator: New Relic Prometheus エージェント タイプとして管理
• newrelic-logging： Fluent Bitエージェントタイプとして管理
• nr-k8s-otel-collector: New Relic OpenTelemetry Collectorエージェント タイプとして管理

Helmを使用してエージェントをインストールした場合は、次のコマンドを実行してクラスタからインストレーション構成を取得します。

$
# Find releases in a namespace (adjust as needed)
$
helm list --namespace <namespace-name>
$

$
# Get the values for a specific release
$
$ helm get values <release-name> --namespace <namespace-name>

インストレーションから保存したオリジナルの設定ファイルがある場合は、それを直接使用できます。 Kubernetesマニフェスト (kubectl または KusTOMize) 経由でクラスタをインストゥルメントした場合は、各エージェントに設定されたオプションに注目してください。それらをFleet Controlリモート設定として再作成します。

ステップ2. 古いエージェントをアンインストールします

Agent Controlをインストールする前に、クラスターから古いエージェントを削除してください。

Helmの場合は、 helm uninstallコマンドを使用します。

$
$ helm uninstall <release-name> -n <namespace>

例えば、 nri-bundleをアンインストールするには、次のようにします。

$
$ helm uninstall nri-bundle -n newrelic

ステップ3. Agent Controlをインストールする

Agent Controlガイド付きインストレーションを開始し、生成されたvalues.yamlをダウンロードします。 このファイルには、 Agent Controlスーパーバイザの設定 (認証情報、フリート ID、および管理するエージェント タイプ) のみが含まれています。ここにエージェント固有のチャート値を追加しないでください。 それらはFleet Controlリモート設定に属します。

Helmの場合、通常は次を実行します。

$
$ helm upgrade --install agent-control-bootstrap -n newrelic newrelic/agent-control-bootstrap --create-namespace --values my_values.yaml

ステップ 4. Fleet Controlでエージェント設定を再作成する

Agent Controlがインストールされ、 Fleet Controlに接続されたら、以前の設定でフリートのリモート設定を作成または更新して、エージェントをデプロイします。 ここは、すべてのエージェント設定に関する公式な場所です。

例: nri-bundle インストレーションの移行

以下は、既存のnri-bundle Helm値をFleet Controlリモート設定に変換する方法を示しています。

既存のnri-bundle設定:

global:
  cluster: test-migration
  licenseKey: ***
kube-state-metrics:
  enabled: false
newrelic-prometheus-agent:
  enabled: true
newrelic-infrastructure:
  enabled: true
  kubelet:
    tolerations:
      - operator: "Exists"
        effect: "NoSchedule"
      - operator: "Exists"
        effect: "NoExecute"
      - operator: "Exists"
        key: "MyToleration"
  ksm:
    enabled: false
  common:
    config:
      interval: 29s
newrelic-logging:
  enabled: true
  image:
    tag: "latest"
  resources:
    limits:
      cpu: 200m
    requests:
      cpu: 200m
nri-kube-events:
  enabled: true
  customAttributes:
    test_tag_label: test_tag_value

同等のFleet Controlリモート設定:

Fleet Controlで、これをフリートのリモート設定として設定してください。 Agent Controlが自動的に適用します。

logs:
  chart_version: "1.25.1"
  chart_values:
    newrelic-logging:
      image:
        tag: "latest"
      resources:
        limits:
          cpu: 200m
        requests:
          cpu: 200m
infrastructure:
  chart_version: "5.0.109"
  chart_values:
    newrelic-infrastructure:
      kubelet:
        tolerations:
          - operator: "Exists"
            effect: "NoSchedule"
          - operator: "Exists"
            effect: "NoExecute"
          - operator: "Exists"
            key: "MyToleration"
      ksm:
        enabled: false
      common:
        config:
          interval: 29s
    nri-kube-events:
      customAttributes:
        test_tag_label: test_tag_value
prometheus:
  chart_version: "1.15.4"

Linuxへの移行

Linux 上のスタンドアロン インフラストラクチャエージェント インストレーションからAgent Controlに移行するには、次の手順を実行します。

1. 現在の設定をメモしておいてください。アンインストールする前に、エージェント設定のコピーを/etc/newrelic-infra/newrelic-infra.ymlに保存し、オンホストインテグレーション構成を/etc/newrelic-infra/integrations.d/に保存します。 Agent Controlをインストールした後、これらをFleet Controlリモート設定として再作成する必要があります。

2. 既存のインフラストラクチャエージェントをアンインストールします。 お使いのディストリビューションに応じたアンインストール手順に従ってください。

   Debian、Ubuntu SLES、 Amazon Linux、CentOS、RHEL

   bash

   コピー

   $
   sudo apt-get remove newrelic-infra -y

   bash

   コピー

   $
   sudo zypper -n remove newrelic-infra

   bash

   コピー

   $
   sudo yum remove newrelic-infra -y

3. Agent Controlをインストールしてください。 ガイド付きインストールを使用してLinux のインストール手順に従い、 「Host - Linux」タイプのフリートを選択または作成していることを確認します。

4. Fleet Controlでエージェントの設定を再作成してください。Agent Controlインストールして接続したら、 Fleet Controlを通じてインフラストラクチャ エージェントをデプロイし、リモート設定を通じて以前の設定を適用します。 設定フォーマットについては、 Linuxの設定に関するドキュメントを参照してください。

インフラストラクチャエージェントからのデータを参照するカスタムダッシュボードとアラートは、同じアカウントとホスト名を使用している限り引き続き機能します。

Windowsへの移行

Windows上のスタンドアロン インフラストラクチャエージェント インストレーションからAgent Controlに移行するには、次の手順を実行します。

1. 既存のインフラストラクチャエージェントをアンインストールします。 Add or Remove Programs [プログラムの追加と削除]を開き (または PowerShell を使用)、 New Relic Infrastructureエージェントをアンインストールします。 または、アンインストーラーを実行してください。

   # Example using the MSI uninstaller
   msiexec /x {PRODUCT_CODE} /quiet

   コピー

2. 現在の設定をメモしておいてください。アンインストールする前に、エージェント設定のコピー (通常はC:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml) とオンホストインテグレーション構成のコピーをC:\Program Files\New Relic\newrelic-infra\integrations.d\に保存します。 Agent Controlをインストールした後、これらをFleet Controlリモート設定として再作成する必要があります。

3. Agent Controlをインストールしてください。 ガイド付きインストールを使用してWindowsレーションの手順に従い、 「Host - Windows 」タイプのフリートを選択または作成していることを確認します。

4. Fleet Controlでエージェントの設定を再作成してください。Agent Controlインストールして接続したら、 Fleet Controlを通じてインフラストラクチャ エージェントをデプロイし、リモート設定を通じて以前の設定を適用します。 設定形式については、 Windowsの設定を参照してください。

インフラストラクチャエージェントからのデータを参照するカスタムダッシュボードとアラートは、同じアカウントとホスト名を使用している限り引き続き機能します。