Agent Controlでシステムを計装します

クリーンなシステムの計装

ヒント

Agent Controlはスーパーバイザーサービスであり、それ自体でテレメトリーを収集または送信することはありません。New Relicでデータを確認するには、Agent Controlをインストールした後、Fleet Controlを通じてエージェント（infrastructureエージェントやNRDOTなど）をデプロイする必要があります。

Kubernetes

Fleet ControlでKubernetesクラスタタイプのフリートを作成します。詳細な手順については、「最初のフリートの作成」を参照してください。
Agent Controlをインストールしてください。Kubernetesインストレーションガイドに従い、ステップ1で作成したフリートを選択してください。
各エージェントに対して、Fleet Controlで設定を作成します。Agent ControlがFleet Controlに接続したら、各エージェントの設定を作成します。Fleet Controlはすべてのエージェント設定の信頼できる情報源です。ローカルのvalues.yamlにエージェント固有の値を追加しないでください。

カスタム設定でinfrastructureエージェント、Fluent Bit、Prometheus、およびNRDOTを追加する例。これらの各設定は、Fleet Controlで個別のリモート設定として作成する必要があります：

カスタムのtolerationと30秒の収集間隔でNew Relic infrastructureエージェントを有効にします。

chart_values:
  newrelic-infrastructure:
    kubelet:
      tolerations:
        - operator: "Exists"
          effect: "NoSchedule"
        - operator: "Exists"
          effect: "NoExecute"
    common:
      config:
        interval: 30s

制限されたCPUリソースでFluent Bitログフォワーダーをデプロイします。

chart_values:
  newrelic-logging:
    resources:
      limits:
        cpu: 200m
      requests:
        cpu: 200m

テレメトリーのボリュームを減らすために、低データモードでPrometheusエージェントをデプロイします。

chart_values:
  newrelic-prometheus-agent:
    lowDataMode: true
    config:
      kubernetes:
        integrations_filter:
          enabled: false

OpenTelemetryコレクターのNew Relicディストリビューションをデプロイします。ここではfilelogレシーバーは無効になっています — ログ収集が必要な場合は有効にしてください。

chart_values:
  nr-k8s-otel-collector:
    receivers:
      filelog:
        enabled: false

作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をクラスタに自動的に適用します。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Kubernetesに移動します。リモート設定が適用されてから1～2分以内にクラスタが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

Linux

Fleet ControlでLinux Hostタイプのフリートを作成します。詳細な手順については、最初のフリートの作成を参照してください。
Agent Controlをインストールしてください。Linuxインストレーションガイドに従い、ステップ1で作成したフリートを選択します。
Fleet Controlで各エージェントの設定を作成します。Agent ControlがFleet Controlに接続した後、各エージェントの設定を作成します。

infrastructureエージェント、nri-mysql、nri-flex、fluentbit、およびnrdotを追加する例。これらの各設定は、Fleet Controlで個別のリモート設定として作成する必要があります：

config_agent 最小限の必須設定が含まれています。license_keyは、nr-env値プロバイダーを使用してNEW_RELIC_LICENSE_KEY環境変数から実行時に解決されます；custom_attributesはオプションですが、フィルタリングのために推奨されます。config_loggingは、システムsyslogをNew Relic Logsに転送します。

config_agent:
  license_key: '${nr-env:NEW_RELIC_LICENSE_KEY}'
  custom_attributes:
    env: production
config_logging:
  logging.yml:
    logs:
      - name: syslog
        file: /var/log/syslog
        attributes:
          logtype: linux_syslog

localhostで実行されているMySQLインスタンスをモニターします。パスワードは、nr-env値プロバイダーを使用してMYSQL_PASSWORD環境変数から実行時に解決されます — 認証情報をハードコードしないでください。

config:
  integrations:
    - name: nri-mysql
      env:
        HOSTNAME: localhost
        PORT: 3306
        USERNAME: newrelic
        PASSWORD: ${nr-env:MYSQL_PASSWORD}
        REMOTE_MONITORING: true
      interval: 30s

dfを使用して、ルートファイルシステムからディスク使用量の統計を収集します。この例では、任意のシェルコマンドを実行し、その出力をNew Relicイベントとして解析する方法を示します。

config:
  integrations:
    - name: nri-flex
      config:
        name: diskUsage
        apis:
          - event_type: DiskUsageSample
            commands:
              - run: df -kP /
                split: horizontal
                split_by: \s+
                set_header: [filesystem, blocks, used, available, usePercent, mountpoint]
                row_start: 1

ホストのメトリクスとシステムログを収集し、APMサービス用のOTLPレシーバーを開きます。ライセンスキーとOTLPエンドポイントは、Agent Controlによって自動的に挿入されます。

config:
  # Variables set automatically by Agent Control:
  # - NEW_RELIC_LICENSE_KEY: New Relic ingest license key.
  # - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint (see: https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/).

  extensions:
    health_check:

  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 60s
      scrapers:
        cpu:
          metrics:
            system.cpu.time:
              enabled: false
            system.cpu.utilization:
              enabled: true
        load:
        memory:
          metrics:
            system.memory.utilization:
              enabled: true
        paging:
          metrics:
            system.paging.utilization:
              enabled: false
            system.paging.faults:
              enabled: false
        filesystem:
          metrics:
            system.filesystem.utilization:
              enabled: true
        disk:
          metrics:
            system.disk.merged:
              enabled: false
            system.disk.pending_operations:
              enabled: false
            system.disk.weighted_io_time:
              enabled: false
        network:
          metrics:
            system.network.connections:
              enabled: false
        # Uncomment to enable process metrics, which can be noisy but valuable.
        # processes:
        # process:
        #  metrics:
        #    process.cpu.utilization:
        #      enabled: true
        #    process.cpu.time:
        #      enabled: false

    filelog:
      include:
        - /var/log/alternatives.log
        - /var/log/cloud-init.log
        - /var/log/auth.log
        - /var/log/dpkg.log
        - /var/log/syslog
        - /var/log/messages
        - /var/log/secure
        - /var/log/yum.log

  processors:
    metricstransform:
      transforms:
        - include: system.cpu.utilization
          action: update
          operations:
            - action: aggregate_labels
              label_set: [state]
              aggregation_type: mean
        - include: system.paging.operations
          action: update
          operations:
            - action: aggregate_labels
              label_set: [direction]
              aggregation_type: sum
    filter/exclude_cpu_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
    filter/exclude_memory_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
    filter/exclude_memory_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
    filter/exclude_filesystem_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
    filter/exclude_filesystem_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
    filter/exclude_filesystem_inodes_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
    filter/exclude_system_disk:
      metrics:
        datapoint:
          - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
    filter/exclude_system_paging:
      metrics:
        datapoint:
          - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
          - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
    filter/exclude_network:
      metrics:
        datapoint:
          - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
    attributes/exclude_system_paging:
      include:
        match_type: strict
        metric_names:
          - system.paging.operations
      actions:
        - key: type
          action: delete
    cumulativetodelta:
    transform/host:
      metric_statements:
        - context: metric
          statements:
            - set(description, "")
            - set(unit, "")
    transform:
      trace_statements:
        - context: span
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
      log_statements:
        - context: log
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
    memory_limiter:
      check_interval: 1s
      limit_mib: 100
    batch:
    resourcedetection:
      detectors: ["system"]
      system:
        hostname_sources: ["os"]
        resource_attributes:
          host.id:
            enabled: true
    resourcedetection/cloud:
      detectors: ["gcp", "ec2", "azure"]
      timeout: 2s
      ec2:
        resource_attributes:
          host.name:
            enabled: false
    resourcedetection/env:
      detectors: ["env"]
      timeout: 2s
      override: true

  exporters:
    otlphttp:
      endpoint: ${nr-env:OTEL_EXPORTER_OTLP_ENDPOINT}
      headers:
        api-key: ${nr-env:NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics/host:
        receivers: [hostmetrics]
        processors:
          - memory_limiter
          - metricstransform
          - filter/exclude_cpu_utilization
          - filter/exclude_memory_utilization
          - filter/exclude_memory_usage
          - filter/exclude_filesystem_utilization
          - filter/exclude_filesystem_usage
          - filter/exclude_filesystem_inodes_usage
          - filter/exclude_system_disk
          - filter/exclude_network
          - attributes/exclude_system_paging
          - transform/host
          - resourcedetection
          - resourcedetection/cloud
          - resourcedetection/env
          - cumulativetodelta
          - batch
        exporters: [otlphttp]
      logs/host:
        receivers: [filelog]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      traces:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      metrics:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      logs:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
    extensions: [health_check]

作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をホストに自動的に適用し、各エージェントのOCIパッケージをダウンロードしてインストールします。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Hostsに移動します。1～2分以内にホストが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

ウィンドウズ

Fleet ControlでWindows Hostタイプのフリートを作成します。詳細な手順については、「最初のフリートの作成」を参照してください。
Agent Controlをインストールしてください。Windowsのインストレーションガイドに従って、ステップ1で作成したフリートを選択します。
Fleet Controlで各エージェントの設定を作成します。Agent ControlがFleet Controlに接続した後、各エージェントの設定を作成します。

config_agent 最小限の必須設定が含まれています。license_keyは、nr-env値プロバイダーを使用してNEW_RELIC_LICENSE_KEY環境変数から実行時に解決されます；custom_attributesはオプションですが、フィルタリングのために推奨されます。config_loggingは、WindowsのイベントログをNew Relic Logsに転送します。

config_agent:
  license_key: '${nr-env:NEW_RELIC_LICENSE_KEY}'
  custom_attributes:
    env: production
config_logging:
  windows-event-log.yml:
    logs:
      - name: windows-event-log
        winevtlog:
          channel: System
        attributes:
          logtype: windows_event_log

localhostで実行されているMySQLインスタンスをモニターします。パスワードは、nr-env値プロバイダーを使用して、実行時にMYSQL_PASSWORD環境変数から解決されます。

config:
  integrations:
    - name: nri-mysql
      env:
        HOSTNAME: localhost
        PORT: 3306
        USERNAME: newrelic
        PASSWORD: ${nr-env:MYSQL_PASSWORD}
        REMOTE_MONITORING: true
      interval: 30s

PowerShell経由でGet-CimInstanceを使用して、論理ディスクのパフォーマンスメトリクスを収集します。この例では、nri-flexが任意のPowerShellコマンドを実行し、そのJSON出力をNew Relicイベントとして解析する方法を示します。PowerShell v3以降が必要です。

config:
  integrations:
    - name: nri-flex
      config:
        name: winDiskPerf
        apis:
          - event_type: WinDiskPerfSample
            shell: powershell
            commands:
              - run: >
                  Get-CimInstance -ClassName Win32_PerfFormattedData_PerfDisk_LogicalDisk |
                  Select-Object -Property Name, PercentFreeSpace, FreeMegabytes |
                  ConvertTo-Json

ホストメトリクスを収集し、APMサービス用のOTLPレシーバーを開きます。ライセンスキーとOTLPエンドポイントは、Agent Controlによって自動的に挿入されます。

config:
  # Variables set automatically by Agent Control:
  # - NEW_RELIC_LICENSE_KEY: New Relic ingest license key.
  # - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint (see: https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/).

  extensions:
    health_check:

  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 60s
      scrapers:
        cpu:
          metrics:
            system.cpu.time:
              enabled: false
            system.cpu.utilization:
              enabled: true
        load:
        memory:
          metrics:
            system.memory.utilization:
              enabled: true
        paging:
          metrics:
            system.paging.utilization:
              enabled: false
            system.paging.faults:
              enabled: false
        filesystem:
          metrics:
            system.filesystem.utilization:
              enabled: true
        disk:
          metrics:
            system.disk.merged:
              enabled: false
            system.disk.pending_operations:
              enabled: false
            system.disk.weighted_io_time:
              enabled: false
        network:
          metrics:
            system.network.connections:
              enabled: false

  processors:
    metricstransform:
      transforms:
        - include: system.cpu.utilization
          action: update
          operations:
            - action: aggregate_labels
              label_set: [state]
              aggregation_type: mean
        - include: system.paging.operations
          action: update
          operations:
            - action: aggregate_labels
              label_set: [direction]
              aggregation_type: sum
    filter/exclude_cpu_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
    filter/exclude_memory_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
    filter/exclude_memory_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
    filter/exclude_filesystem_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
    filter/exclude_filesystem_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
    filter/exclude_filesystem_inodes_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
    filter/exclude_system_disk:
      metrics:
        datapoint:
          - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
    filter/exclude_system_paging:
      metrics:
        datapoint:
          - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
          - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
    filter/exclude_network:
      metrics:
        datapoint:
          - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
    attributes/exclude_system_paging:
      include:
        match_type: strict
        metric_names:
          - system.paging.operations
      actions:
        - key: type
          action: delete
    cumulativetodelta:
    transform/host:
      metric_statements:
        - context: metric
          statements:
            - set(description, "")
            - set(unit, "")
    transform:
      trace_statements:
        - context: span
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
      log_statements:
        - context: log
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
    memory_limiter:
      check_interval: 1s
      limit_mib: 100
    batch:
    resourcedetection:
      detectors: ["system"]
      system:
        hostname_sources: ["os"]
        resource_attributes:
          host.id:
            enabled: true
    resourcedetection/cloud:
      detectors: ["gcp", "ec2", "azure"]
      timeout: 2s
      ec2:
        resource_attributes:
          host.name:
            enabled: false
    resourcedetection/env:
      detectors: ["env"]
      timeout: 2s
      override: true

  exporters:
    otlphttp:
      endpoint: ${nr-env:OTEL_EXPORTER_OTLP_ENDPOINT}
      headers:
        api-key: ${nr-env:NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics/host:
        receivers: [hostmetrics]
        processors:
          - memory_limiter
          - metricstransform
          - filter/exclude_cpu_utilization
          - filter/exclude_memory_utilization
          - filter/exclude_memory_usage
          - filter/exclude_filesystem_utilization
          - filter/exclude_filesystem_usage
          - filter/exclude_filesystem_inodes_usage
          - filter/exclude_system_disk
          - filter/exclude_network
          - attributes/exclude_system_paging
          - transform/host
          - resourcedetection
          - resourcedetection/cloud
          - resourcedetection/env
          - cumulativetodelta
          - batch
        exporters: [otlphttp]
      traces:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      metrics:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      logs:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
    extensions: [health_check]

作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をホストに自動的に適用し、各エージェントのOCIパッケージをダウンロードしてインストールします。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Hostsに移動します。1～2分以内にホストが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

以前にインストゥルメントされたシステムの移行

重要

Agent Controlは、既存のエージェントの自動移行をサポートしていません。移行は常に手動プロセスです：既存のエージェントをアンインストールし、Agent Controlをインストールしてから、Fleet Controlのリモート設定として設定を再作成します。

一般的な移行プロセス

プラットフォームに関係なく、移行は次の4つのステップに従います：

現在の設定をメモしておいてください。アンインストールする前に、すべてのエージェント設定ファイルとインテグレーション設定のコピーを保存してください。これらをFleet Controlリモート設定として再作成します。
既存のエージェントをアンインストールします。Agent Controlは、同じタイプのスタンドアロンエージェントのインストレーションと共存することはできません。
Agent Controlをインストールし、フリートに接続します。プラットフォーム固有のインストレーションガイドに従い、既存のフリートを選択するか、新しいフリートを作成します。
Fleet Controlで設定を再作成します。以前の設定を使用して、フリートのリモート設定を作成します。Agent Controlはそれを自動的に適用します。

リモート設定が常に優先される

Fleet Controlは、エージェント設定の信頼できるソースです。エージェントの設定、バージョン、チャート値、およびリソース制限はすべて、ローカルのインストレーションファイルではなく、Fleet Controlのリモート設定で定義する必要があります。両方が存在する場合、リモート設定が優先され、ローカルの値を上書きします。

ベストプラクティス

データの継続性を確保するために、Agent Controlのインストレーション中は同じエンティティ名（クラスタ名またはホスト名）と同じNew Relicアカウントを使用してください。Agent Controlでまだサポートされていないエージェントやコンポーネントは、サポートが利用可能になるまでそのままにしておくことができます。

Kubernetes

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

Agent Controlは、nri-bundle Helmチャートから以下のエージェントをデプロイおよび管理できます：

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

既存の設定を取得します。Helmを使用してエージェントをインストールした場合は、クラスタからインストレーション設定を取得します：

bash

$# Find releases in the namespace
$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のリモート設定として再作成します。

古いエージェントをアンインストールします。Agent Controlをインストールする前に、クラスタから古いエージェントを削除してください。Helmインストレーションの場合：

bash

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

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

bash

$helm uninstall nri-bundle -n newrelic

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

bash

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

Fleet Controlでエージェントの設定を再作成します。Agent ControlがFleet Controlに接続した後、以前の設定を使用して、古い各エージェントの設定を作成します。
作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をクラスタに自動的に適用します。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Kubernetesに移動します。リモート設定が適用されてから1～2分以内にクラスタが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

Linux

重要

Agent Controlは、Linux上の既存エージェントの自動移行をサポートしていません。Linux ホストにNew Relic Infrastructureエージェントが既にインストールされている場合は、 Agent Controlインストールする前に手動でアンインストールする必要があります。 Agent Control 、 Fleet Controlを介して OCI 準拠のパッケージを介してエージェントを配布します。既存のnewrelic-infraパッケージインストレーションを置き換えたり継承したりするものではありません。

現在の設定をメモしておいてください

アンインストールする前に、以下のコピーを保存してください：

エージェントの設定： /etc/newrelic-infra/newrelic-infra.yml
すべてのオンホストインテグレーションの設定： /etc/newrelic-infra/integrations.d/

ステップ4で、これらをFleet Controlリモート設定として再作成します。

既存のinfrastructureエージェントのアンインストール

bash

$sudo apt-get remove newrelic-infra -y

bash

$sudo zypper -n remove newrelic-infra

bash

$sudo yum remove newrelic-infra -y

Agent Controlをインストールしてください。Linuxへのインストレーションガイドに従ってください。Host - Linuxタイプのフリートを選択または作成してください。
Fleet Controlでエージェントの設定を再作成します。Agent ControlがFleet Controlに接続した後、以前の設定を使用して、古い各エージェントの設定を作成します。ステップ1で保存した設定ファイルを参考にしてください。
作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をホストに自動的に適用し、各エージェントのOCIパッケージをダウンロードしてインストールします。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Hostsに移動します。1～2分以内にホストが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

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

ウィンドウズ

重要

Agent Controlは、Windows上の既存のエージェントの自動移行をサポートしていません。WindowsホストにNew Relic infrastructureエージェントがすでにインストールされている場合は、Agent Controlをインストールする前に手動でアンインストールする必要があります。APMエージェントはAgent Controlによって管理されないため、インストールしたままにしておくことができます。

現在の設定をメモしておいてください

アンインストールする前に、以下のコピーを保存してください：

エージェントの設定： C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml
すべてのオンホストインテグレーションの設定： C:\Program Files\New Relic\newrelic-infra\integrations.d\

ステップ4で、これらをFleet Controlリモート設定として再作成します。

既存のinfrastructureエージェントのアンインストール

Add or Remove Programs [プログラムの追加と削除]を開き、New Relic infrastructureエージェントをアンインストールします。または、PowerShellからMSIアンインストーラーを使用してください：

# Replace {PRODUCT_CODE} with the GUID from Add/Remove Programs
msiexec /x {PRODUCT_CODE} /quiet

Agent Controlをインストールしてください。Windowsへのインストレーションガイドに従ってください。Host - Windowsタイプのフリートを選択または作成してください。
Fleet Controlでエージェントの設定を再作成します。Agent ControlがFleet Controlに接続した後、以前の設定を使用して、古い各エージェントの設定を作成します。ステップ1で保存した設定ファイルを参考にしてください。
作成したばかりのリモート設定をフリートに追加して、新しいデプロイメントを作成します。Agent Controlは、新しい設定をホストに自動的に適用し、各エージェントのOCIパッケージをダウンロードしてインストールします。「最初のデプロイメントの作成と実行」の手順に従ってください。
データが流れていることを確認します。New RelicのUIで、Infrastructure > Hostsに移動します。1～2分以内にホストが表示されます。表示されない場合は、Agent Controlのトラブルシューティングを参照してください。

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

Agent Controlでシステムを計装します

クリーンなシステムの計装

ヒント

Kubernetes

インフラストラクチャー・エージェント

Fluent Bit（ログ転送）

Prometheus

NRDOT（OpenTelemetryコレクター）

Linux

infrastructureエージェント（ベースライン）

nri-mysql（オンホストインテグレーション）

シェルコマンドを使用したnri-flex（オンホストインテグレーション）

NRDOT（OpenTelemetryコレクター）

ウィンドウズ

infrastructureエージェント（ベースライン）

nri-mysql（オンホストインテグレーション）

PowerShellコマンドを使用したnri-flex（オンホストインテグレーション）

NRDOT（OpenTelemetryコレクター）

以前にインストゥルメントされたシステムの移行

重要

一般的な移行プロセス

リモート設定が常に優先される

ベストプラクティス

Kubernetes

Linux

重要

ウィンドウズ

重要

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

Agent Controlでシステムを計装します

クリーンなシステムの計装.css-21sua1{background:none;border:none;width:0;padding:0;}

ヒント

Kubernetes

Fluent Bit（ログ転送）

Prometheus

NRDOT（OpenTelemetryコレクター）

Linux

infrastructureエージェント（ベースライン）

nri-mysql（オンホストインテグレーション）

シェルコマンドを使用したnri-flex（オンホストインテグレーション）

NRDOT（OpenTelemetryコレクター）

ウィンドウズ

infrastructureエージェント（ベースライン）

nri-mysql（オンホストインテグレーション）

PowerShellコマンドを使用したnri-flex（オンホストインテグレーション）

NRDOT（OpenTelemetryコレクター）

以前にインストゥルメントされたシステムの移行

重要

一般的な移行プロセス

リモート設定が常に優先される

ベストプラクティス

Kubernetes

Linux

重要

ウィンドウズ

重要

クリーンなシステムの計装