設定の管理

重要

Agent Control と New Relic Control が Kubernetes で一般提供されました。Linux ホストと Windows ホストのサポートも、弊社のプレリリースポリシーに従ってパブリックプレビュープログラムで提供されます。

Agent Control 、展開されている環境に依存しない設定のためのシームレスなアプローチを提供します。エージェント設定の管理には 2 つの方法があります。

ローカル設定:初期Helmインストレーション中に使用される包括的なvalues.yamlファイル。
リモート設定: New Relic Control で作成する集中型の YAML ベースの設定で、フリート全体にリモートで展開されます。

日常の管理にはリモート設定が推奨されます。これにより、環境全体で一貫したエージェントの動作が保証され、変更管理が簡素化され、各ホスト上のローカル YAML ファイルを手動で更新することなくスケーリングが可能になります。

ヒント

従来New Relicエージェント設定を定義していたvalues-newrelic.yamlファイルには、 Agent Controlの設定も含まれるようになりました。このファイルで定義する問題により、 Agent Controlとその管理対象エージェントの両方がどのように動作するかが決まります。このファイルはローカル設定と呼ばれます。

設定の 2 つの層を理解する

Agent Controlの設定は 2 つの層で構成されています。

Agent Controlのコア設定:これらは、 New Relicへの接続、ID、フリート管理の詳細など、 Agent Control動作を制御する最上位の設定です。
管理エージェントの設定:これらは、 Agent Controlコントロールデプロイが管理する各サブエージェント (インフラストラクチャエージェント、 Fluent Bitなど) の個別のchart_valuesです。

ローカル設定とリモート設定の両方が存在する場合、 Agent Control次のロジックを適用します。

リモート設定が優先されます。 New Relic Control からのリモート構成で定義された設定は、ローカルvalues.yamlファイル内の対応する設定を上書きします。
リモート設定をローカル設定で意図的にオーバーライドするには、 New Relic Control を介して空のリモート設定をデプロイできます。この変更は、選択したフリート内のすべてのクラスターに適用されます。

Kubernetes設定

これらの手順と例は、 Kubernetesクラスタ上で実行されているAgent Controlに適用されます。

Kubernetesのローカル`values.yaml`設定

インストール中に使用されるKubernetesのローカル設定ファイルには、 Agent Controlとその管理対象エージェントのすべての設定が含まれています。

この例では、1 つのファイル内に 2 つの設定レイヤーを示します。

# Layer 1: Agent Control's Core Configuration
global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# Values related to the Agent Control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"

      # Layer 2: Managed Agents' Configurations
      # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
      agents:
        infrastructure:
          agent_type: newrelic/com.newrelic.infrastructure:0.1.0
        logs:
          agent_type: newrelic/io.fluentbit:0.1.0
        agent-operator:
          agent_type: com.newrelic.k8s_agent_operator:0.1.0

    agentsConfig:
      infrastructure:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"
        chart_values:
          newrelic-infrastructure:
          enableProcessMetrics: true
      logs:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"
        chart_values:
          newrelic-logging:
            sendMetrics: true
      agent-operator:
        chart_version: "*"

このサンプルでは、Agent Control インフラストラクチャエージェントと転送ログ用の 2 つのマネージドエージェントとともにKubernetes Fluent Bitを構成する方法を示します。たとえば、 Fluent Bit Collector にヘルスメトリクスを送信したくない場合は、インストールコマンドを実行する前に YAML ファイルにsendMetrics: falseを設定するだけです。

Kubernetesのリモート設定

リモート設定により、環境全体でエージェントの一貫した動作が保証され、変更管理が簡素化され、ローカル YAML ファイルを手動で管理することなく監視を拡張できるようになります。

プロイ設定をクラスタ全体で一元的に展開するには、の Configurations [設定]Fleet Control セクションでこれと同じ YAML コンテンツを定義します。その後、その設定をリモート展開の一部としてクラスタのフリート全体に適用できます。これはリモート設定ファイルと呼ばれます。

ヒント

New Relic Control UIで設定を定義する場合、YAML 構造は異なります。単一のエージェントのcontentブロックに対応する YAML のみを提供します。

サンプル設定: KubernetesでのAgent Control

設定: Kubernetes上のAgent Control次の例は、さまざまなエージェントセットを管理するようにAgent Controlを構成する方法を示しています。これらの設定は、初期導入中、またはFleet Controlのリモート設定の一部として使用できます。

利用可能なすべての構成設定を確認するには、 values-newrelic.yamlを参照してください。

次の例は、ローカルvalues.yamlファイルを使用してサブエージェントのセットでAgent Controlを構成する方法を示しています。

New Relic InfrastructureとFluent BitによるAgent Control

この例では、インフラストラクチャ監視とログ収集用の備えたデプロイAgent Control Fluent Bit使用します。

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# See `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"
      agents:
        infrastructure:
          agent_type: newrelic/com.newrelic.infrastructure:0.1.0
        logs:
          agent_type: newrelic/io.fluentbit:0.1.0
        agent-operator:
          agent_type: com.newrelic.k8s_agent_operator:0.1.0
    agentsConfig:
      infrastructure:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"

        #chart_values:
        #  newrelic-infrastructure:
        #    enableProcessMetrics: true
      logs:
        # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
        # Recommended: check and define an explicit chart version (latest stable)
        chart_version: "*"

        #chart_values:
        #  newrelic-logging:
        #    sendMetrics: true
      agent-operator:
        chart_version: "*"

OpenTelemetryおよびカスタムコレクター設定を使用したAgent Control

OpenTelemetry とカスタムコレクター設定を使用した例この例では、New Relic ディストリビューションの OpenTelemetry (NRDOT) コレクターを使用して Agent Control をデプロイし、管理対象のnr-k8s-otel-collector Helm チャートでfilelogレシーバーを無効にします。

重要

セキュリティのベストプラクティス: ライセンスキーなどの機密性の高い値を設定に直接保存しないでください。 Kubernetes シークレットの使用をお勧めします。Agent Control 、実行時にシークレットからこれらの値を安全に取得できます。

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"
# Values related to the Agent Control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "****"
      parentIdentity:
        clientId: "****"
        clientSecret: "****"
    config:
      fleet_control:
        # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
        fleet_id: "****"

      # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
      agents:
        nr-otel-collector:
          agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"
    # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
    agentsConfig:
      nr-otel-collector:
        chart_version: "*"
        chart_values:
          nr-k8s-otel-collector: {}
          global: {}

サンプル設定: Kubernetesでのリモートエージェント設定

次の例は、New Relic Control UI から個々のエージェントをリモートで構成する方法を示しています。

リモート設定: New Relicインフラストラクチャ

この例では、New Relic Kubernetesを使用しての Infrastructure エージェントをリモートで設定する方法を示します。Fleet ControlenableProcessMetrics: true設定することでプロセスメトリクス収集を有効にします。

リモート設定: Fluent Bit

この例では、Fleet Control を介して Fluent Bit をリモートで構成しました。sendMetrics: true設定すると、ログコレクターからのヘルスメトリクスレポートが有効になります。

リモート設定: Prometheus

この例では、Fleet Control を使用して Prometheus エージェントをリモートで構成します。これにより、 low-data modeテレメトリーの音量を下げ、デフォルトの統合を無効にすることができます。

リモート設定: OpenTelemetry

この例では、New Relic OpenTelemetry コレクターを設定し、 lowDataMode有効なオプションとして有効にします。

重要

Kubernetesシークレットを作成してNew Relicライセンスキーを安全に保存し、それをlicenseKey値の代わりにchart_valuesで使用します。

customSecretName: "your-secret-name"
customSecretLicenseKey: "your-secret-key"

Fleet Controlを使用して、フリート全体でOpenTelemetry設定を定義およびデプロイすることをお勧めします。 OpenTelemetryリモートで構成するには、以下に示す構造でFleet Controlに設定を作成します。必要に応じて、 lowDataModeやreceivers.filelog.enabledなどの値を調整し、その他の関連する Helm チャート設定を含めることができます。

chart_version: "*"
chart_values:
  nr-k8s-otel-collector:
    lowDataMode: true

Kubernetesのプロキシ設定

Agent Control 、トラフィックを企業プロキシ経由でルーティングするためのプロキシ設定をサポートします。プロキシ設定は、環境変数を通じて、または構成ファイルで直接設定できます。

プロキシの優先順位

Agent Control次の優先順位でプロキシ設定を使用します。

proxy Agent Control設定の設定フィールド
HTTP_PROXY 環境変数
HTTPS_PROXY 環境変数

自己署名証明書を使用したプロキシ設定

自己署名証明書による HTTPS 認証を使用するプロキシ設定の場合、CA 証明書バンドルを提供し、プロキシ認証を構成する必要があります。

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

agentControlDeployment:
  proxy:
    url: https://proxy-service:8080

  # Mount CA certificate bundle to Agent Control
  extraVolumeMounts:
    - mountPath: /etc/ssl/certs/
      name: ca-certs
  extraVolumes:
    - name: ca-certs
      secret:
        secretName: ca-certs

# Configure Flux components to use proxy
agentControlCd:
  flux2:
    sourceController:
      extraEnv:
        # Configure Flux source-controller to proxy all requests
        - name: HTTPS_PROXY
          value: https://proxy-service:8080
        # Except for in-cluster requests
        - name: "NO_PROXY"
          value: ".cluster.local.,.cluster.local,cluster.local,.svc,127.0.0.0/8,10.0.0.0/8"
      volumeMounts:
        # Mount CA certificate bundle to source-controller trust root store. The bundle should contain the
        # proxy CA cert.
        - mountPath: /etc/ssl/certs/
          name: ca-certs
      volumes:
        - name: ca-certs
          secret:
            secretName: ca-certs

マネージドエージェント用プロキシ設定

注意

Agent Controlでプロキシを構成しても、管理するエージェントに対して同じプロキシ設定が自動的に構成されるわけではありません。各エージェントには独自のプロキシ設定があり、そのエージェント固有の設定形式と要件に従って個別に設定する必要があります。

プロキシを使用する場合は、管理対象エージェントごとにプロキシ設定を個別に構成する必要があります。プロキシ設定オプションについては、各エージェントの固有のドキュメントを参照してください。

秘密管理

Agent Control provides a robust mechanism for managing sensitive data, such as passwords and API keys, by retrieving them from dedicated secret providers. This ensures that sensitive information is not hard-coded directly into configuration files. The system currently supports the providers described in Value providers.

プライベートリポジトリ設定

Agent Control は、Agent Control 自体と管理対象エージェントの両方をデプロイするためのプライベート Helm リポジトリの構成をサポートしています。これにより、New Relic Helm チャートに直接アクセスできない環境が可能になります。

注意

プライベート Helm リポジトリを使用する場合、チャートは互換性があり、チャート内の参照イメージにアクセスできる必要があります。そうしないと、エージェントは期待どおりに動作しません。

1. エージェントのプライベートリポジトリを有効にする

セキュリティ上の理由から、リモート設定では明示的に有効化されたリポジトリのみが許可されます。特定のリポジトリを有効にするには、次のようにAgent Control設定を更新します。

# values-newrelic.yaml

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

# ...

agentControlDeployment:
  config:
    allowedChartRepositoryUrl:
      - https://my-private-repository-1
      - https://my-private-repository-2
    # ...

許可されたリポジトリ設定は、 New Relic Control 内のリモート設定で使用できるようになります。例：

chart_version: "1.2.3"
chart_repository:
  url: "https://my-private-repository-1"
  name: "my-chart-name" # Optional: use only if the chart name doesn't match New Relic's chart name

さらに、 agent-control-bootstrapチャート自体がプライベートリポジトリにある場合は、プライベートリポジトリを使用するようにAgent ControlのHelmを構成する必要があります。マネージドエージェントの設定とは別のものです。 agent-control-bootstrap Helm チャートvalues.yamlを参照して、 installationJobセクションを次のように構成します。

chartRepositoryUrl: リポジトリの場所を含む URL。
chartName: 別のチャート名を使用している場合はチャート名。
repositorySecretReferenceName およびrepositoryCertificateSecretReferenceName : リポジトリへの認証に必要なシークレット。詳細については、以下の認証セクションを参照してください。

2. プライベートリポジトリの認証を設定する

プライベートリポジトリにアクセスするための認証を有効にするには、次のように追加のリソースを設定する必要があります。

基本認証 (ユーザー名とパスワード) を使用して認証するには、 Agent Controlネームスペースに、 data.usernameおよびdata.passwordの予想される値を含むシークレットを作成する必要があります。

例：

apiVersion: v1
kind: Secret
metadata:
  name: my-secret
stringData:
  username: "myUser"
  password: "myPassword"

詳細については、 Flux のドキュメントを参照してください。

基本認証を使用する場合、リモート設定は次のように構成する必要があります。

chart_repository:
  url: "https://my-private-repository-1"
  secret_reference:
    name: my-secret

TLS を使用して認証するには、次の内容を含むシークレットを作成する必要があります。

tls.crt およびtls.key : TLSクライアント認証に使用されるクライアント証明書と秘密鍵
ca.crt: サーバーの検証に使用される CA 証明書 (サーバーが自己署名証明書を使用する場合に必要)
Secret のタイプはOpaqueまたはkubernetes.io/tlsである必要があります。Secret 内のすべてのファイルは PEM でエンコードされている必要があります。
例：
```
apiVersion: v1
kind: Secret
metadata:
  name: my-secret
  namespace: newrelic-agent-control
type: kubernetes.io/tls # or Opaque
data:
  tls.crt: <BASE64>
  tls.key: <BASE64>
  # NOTE: Can be supplied without the above values
  ca.crt: <BASE64>
```
詳細については、 Flux のドキュメントを参照してください。
TLS 証明書認証を使用する場合、リモート設定は次のように構成する必要があります。
```
chart_repository:
  url: "https://my-private-repository-1"
  certificate_secret_reference:
    name: my-secret
```

Linuxの設定

Agent Control設定のデフォルトパスは次のとおりです。

Local 設定ファイル: /etc/newrelic-agent-control/config.yaml
Remote 設定ファイル: /var/lib/newrelic-agent-control/config.yaml ( Fleet Controlデプロイメント経由で有効な場合)
サービス定義: /lib/systemd/system/newrelic-agent-control.service
サービス環境ファイル: /etc/newrelic-agent-control/newrelic-agent-control.conf

デフォルトでは、エージェントはインフラストラクチャエージェントとOpenTelemetryを調整します。

# Configures the integration with Fleet Control
fleet_control:
  # EU region? Use: https://opamp.service.eu.newrelic.com/v1/opamp
  # JP region? Use: https://opamp.service.jp.newrelic.com/v1/opamp
  endpoint: https://opamp.service.newrelic.com/v1/opamp
  headers:
    api-key: YOUR_INGEST_KEY
  auth_config:
    # EU region? Use: https://system-identity-oauth.service.eu.newrelic.com/oauth2/token
    # JP region? Use: https://system-identity-oauth.service.jp.newrelic.com/oauth2/token
    token_url: "https://system-identity-oauth.service.newrelic.com/oauth2/token"
    client_id: "YOUR_CLIENT_ID
    provider: "local"
    private_key_path: "path/to/key"

# Configures the agents to be supervised by Agent Control
agents:
  # Agent name (RFC-1035 valid label)
  nr-infra-agent:
    # The supported agent type and agent type version
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  nr-otel-collector:
    agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

監視要件に基づいて、いずれかのエージェントの名前を変更または削除できます。エージェント名は有効な RFC-1035ラベル名である必要があります。

環境変数を使用してエージェント設定を定義することもできます。

メインのAgent Control設定をターゲットにするには、 NR_ (単一のアンダースコア) プレフィックスを使用します。
Agent Controlで使用可能な設定を対象にするには、 __ (二重アンダースコア) を使用します。これは、アンダースコアを含む設定キーとの衝突を避けるために必要です。
環境変数はローカル設定ファイルよりも優先されます。リモート設定が有効になっている場合、環境変数は考慮されません。
たとえば、 fleet_control::endpoint動的な設定を定義するには、サービス定義ファイルにNR_FLEET_CONTROL__ENDPOINT=https://opamp.service.newrelic.com/v1/opampを追加します。

エージェントを構成する

Agent Control現在、次の事前定義されたオンホストエージェントタイプを管理できます。

New Relicインフラストラクチャエージェント: newrelic/com.newrelic.infrastructure 。 FluentBit に基づくオンホストインワーテグレーションやログフォダーインテグレーションのオーケストレーションなど、インフラストラクチャエージェントの既存の機能がすべてサポートされています。
OpenTelemetry の New Relic ディストリビューション: newrelic/com.newrelic.opentelemetry.collector

各エージェントタイプには、その動作に合わせてカスタマイズできるオプションの変数のセットが用意されています。エージェントのローカル設定をカスタマイズするには:

values.ymlファイルを作成します: このファイルには必要な設定値が含まれます。
values.ymlファイルを/etc/newrelic-agent-control/fleet/agents.d/YOUR-AGENT-NAME/values/ディレクトリに配置します。ここで、 YOUR-AGENT-NAMEエージェントの実際の名前です (例: nr-infra-agent )。

最新のエージェントタイプバージョンで使用可能な変数のリストは次のとおりです。

New Relicインフラストラクチャエージェント: 0.1.0
OpenTelemetry の New Relic ディストリビューション: 0.1.0

エージェントタイプ	変数	タイプ	デフォルト
`com.newrelic.infrastructure`	`config_agent`	インフラストラクチャエージェント設定を含む YAML	（空の）
`com.newrelic.infrastructure`	`config_integrations`	オンホストインテグレーション設定を含む YAML マップ (キーはファイル名)	（空の）
`com.newrelic.infrastructure`	`config_logging`	ログ転送設定を含む YAML マップ (キーはファイル名)	（空の）
`com.newrelic.infrastructure`	`health_port`	インフラストラクチャエージェントのローカルステータスサーバー用のポート	`/health/status`
`com.newrelic.opentelemetry.collector`	`config`	OpenTelemetryコレクター設定(YAML形式)	（空の）
`com.newrelic.opentelemetry.collector`	`health_check.path` `health_check.port`	OTel コレクターヘルスチェック拡張機能ローカル http エンドポイントのパスとポート	`localhost:13133/health/status`
すべての管理対象エージェント	`backoff_delay`	コレクターの起動に失敗した場合の次回の再試行までの時間 (秒単位)。	`20s`

ヒント

サポートされている設定に従って、必要に応じてインフラストラクチャエージェント設定とOpenTelemetry設定を構成できます。

サンプル設定

Fleet Controlによるリモート設定

次の例には、 Agent Controlおよびマネージドエージェントの有効な設定としてコピーアンドペーストできる一般的な使用例が含まれています。

FluentBit 統合のインフラストラクチャエージェント設定、 Redisインテグレーション設定、およびログ転送設定。有効なlicense_keyを持つconfig_agentは常に必須です。その他のセクションはオプションです (必要に応じて削除または更新します)。

config_agent:
  license_key: YOUR_LICENSE_KEY
  custom_attributes:
    env: demo
config_integrations:
  nri-redis-example.yml:
    integrations:
      - name: nri-redis
        env:
          hostname: localhost
          port: 6380
          keys: '{"0":["<KEY_1>"],"1":["<KEY_2>"]}'
          remote_monitoring: true
config_logging:
  fluentbit-example.yml:
    logs:
      - name: syslog
        file: /var/log/syslog
        attributes:
          logtype: linux_syslog

OTel コレクター (プロセス監視は無効) と、 APMサービスからトレース、メトリクス、ログを受信するために有効になっている OTLP レシーバーを使用した基本的なホスト監視:

config:
  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 20s
      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

    filelog:
      include:
        - /var/log/syslog

  processors:
    # group system.cpu metrics by cpu
    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
    # remove system.cpu metrics for states
    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

    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)

    # used to prevent out of memory situations on the collector
    memory_limiter:
      check_interval: 1s
      limit_mib: 100

    batch:

    resourcedetection:
      detectors: ["env", "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

  exporters:
    otlp:
      endpoint: otlp.nr-data.net:4317
      headers:
        api-key: ${NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics:
        receivers: [otlp, 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
          - batch
          - resourcedetection
          - resourcedetection/cloud
        exporters: [otlp]
      traces:
        receivers: [otlp]
        processors: [transform, resourcedetection, resourcedetection/cloud, batch]
        exporters: [otlp]
      logs:
        receivers: [otlp, filelog]
        processors: [transform, resourcedetection, resourcedetection/cloud, batch]
        exporters: [otlp]

エージェント (OTel コレクターなど) を無効にする方法を示すAgent Control自体の有効な構成:

agents:
  nr-infra-agent:
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  #nr-otel-collector:
  #  agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Windowsの設定

Windows上のAgent Control設定のデフォルトパスは次のとおりです。

Local 設定ファイル: C:\Program Files\New Relic\newrelic-agent-control\local-data\agent-control\local_config.yaml
Remote 設定ファイル: C:\ProgramData\New Relic\newrelic-agent-control\fleet-data\agent-control\remote_config.yaml (Fleet Control から同期)
サービス実行可能ファイル: C:\Program Files\New Relic\newrelic-agent-control\newrelic-agent-control.exe
ログディレクトリ: C:\ProgramData\New Relic\newrelic-agent-control\logs\

デフォルトでは、 Windows上のAgent ControlインフラストラクチャエージェントとOpenTelemetryを調整できます。

# Configures the integration with Fleet Control
fleet_control:
  endpoint: https://opamp.service.newrelic.com/v1/opamp
  headers:
    api-key: YOUR_INGEST_KEY
  auth_config:
    token_url: "https://system-identity-oauth.service.newrelic.com/oauth2/token"
    client_id: "YOUR_CLIENT_ID"
    provider: "local"
    private_key_path: "path\\to\\key"

# Configures the agents to be supervised by Agent Control
agents:
  # Agent name (RFC-1035 valid label)
  nr-infra-agent:
    # The supported agent type and agent type version
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  nr-otel-collector:
    agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

ヒント

リージョンアカウントの場合は、適切なエンドポイントとtoken_urlを使用してください：

EU地域：https://opamp.service.eu.newrelic.com/v1/opampおよび https://system-identity-oauth.service.eu.newrelic.com/oauth2/token
JP地域：https://opamp.service.jp.newrelic.com/v1/opampおよび https://system-identity-oauth.service.jp.newrelic.com/oauth2/token

監視要件に基づいて、いずれかのエージェントの名前を変更または削除できます。エージェント名は有効な RFC-1035ラベル名である必要があります。

Windows固有の設定に関する注意事項

ファイルパスはバックスラッシュ（ \\ ）とWindowsスタイルのパス（例： C:\\ProgramData\\... ）を使用します。
エージェントバイナリは.exe拡張機能を使用します
サービスはLocalSystemとして実行されます。設定ファイルの書き込み権限が制限されていることを確認してください。
Linux 環境のテンプレートと設定では、 Windows互換性のためにパスの調整が必要になる場合があります。

エージェントの設定

Windows上のAgent Control現在、次のエージェントタイプを管理できます。

New Relicインフラストラクチャエージェント: newrelic/com.newrelic.infrastructure 。内蔵のFluent Bitによるオンホスト統合とログ転送をサポートします。
OpenTelemetry の New Relic ディストリビューション: newrelic/com.newrelic.opentelemetry.collector

エージェントのローカル設定をカスタマイズするには、エージェントの値ディレクトリにvalues.ymlファイルを配置します。使用可能な変数はLinux ホストの場合と同じです。

サンプル設定

Fleet Controlによるリモート設定

Windowsログ転送によるインフラストラクチャエージェント設定。有効なlicense_keyを持つconfig_agentは常に必須です。

config_agent:
  license_key: YOUR_LICENSE_KEY
  custom_attributes:
    env: production
config_logging:
  windows-event-log.yml:
    logs:
      - name: windows-security
        winlog:
          channel: Security
          collect-eventids:
            - 4624
            - 4625
        attributes:
          logtype: windows_security

Windows上のAgent Control自体の有効な設定。エージェントの管理方法を示します。

agents:
  nr-infra-agent:
    agent_type: "newrelic/com.newrelic.infrastructure:0.1.0"
  #nr-otel-collector:
  #  agent_type: "newrelic/com.newrelic.opentelemetry.collector:0.1.0"

Value providers

Value providers allow Agent Control resolve values from external sources when a configuration is rendered, so sensitive data such as license keys, tokens, or passwords doesn't need to be hard-coded in your configuration files.

Values are referenced with the ${NAMESPACE:NAME} placeholder syntax inside agent configurations. Agent Control resolves them every time a configuration is applied, including remote configuration updates, so rotated values are picked up without restarting Agent Control.

重要

If Agent Control fails to resolve a value, the configuration rendering fails and the agent isn't started. This prevents agents from running with incomplete or incorrect configurations.

After a successful resolution, Agent Control stores the rendered result in a Kubernetes secret or in a private configuration file for use by the corresponding agent.

Supported value providers

プロバイダー	Placeholder namespace	Requires configuration
環境変数	`nr-env`	いいえ
HashiCorp Vault	`nr-vault`	はい
Local files	`nr-file`	いいえ
Kubernetesの秘密	`nr-kubesec`	いいえ
Kubernetes ConfigMaps	`nr-kubecm`	いいえ

Configuring value providers

Only HashiCorp Vault requires explicit configuration. Define it under the value_providers key of the Agent Control configuration. The legacy key secrets_providers is still accepted as an alias.

value_providers:
  vault:
    sources:
      local-instance:
        url: http://localhost:8200/v1/
        token: root
        engine: kv2
      remote:
        url: http://my-remote-server:8200/v1/
        token: root
        engine: kv1
    client_timeout: 10s

fleet_control:
  ...

agents:
  ...

Each entry under sources defines a named Vault source with the following settings:

YAMLキー	必須	説明
`url`	はい	Full Vault URL, including the `/v1` path.
`token`	はい	Token used to authenticate against the endpoint.
`engine`	はい	Secrets engine version: `kv1` or `kv2`.
`client_timeout`	いいえ	HTTP timeout for Vault requests. Defaults to `30s`. Set at the `vault` level, not per source.

環境変数： `nr-env`

Reads a value from the host environment (available to Agent Control process).

config_agent:
  license_key: "${nr-env:NEW_RELIC_LICENSE_KEY}"

HashiCorp Vault: `nr-vault`

Reads a key from a Vault KV secret. Requires the value_providers.vault configuration described above.

The placeholder uses this format:

"${nr-vault:SOURCE_NAME:MOUNT:PATH:KEY}"

SOURCE_NAME: name of the Vault source defined in value_providers.
MOUNT: name of the secrets engine mount.
PATH: path to the secret.
KEY: key within the secret to retrieve.

例えば：

config_agent:
  enable_process_metrics: true
  custom_attributes:
    username: "${nr-vault:local-instance:secret:my_secret:username}"
    organization: "${nr-vault:remote:my_mount:my_path:organization}"

Here, ${nr-vault:local-instance:secret:my_secret:username} retrieves the value of the username key from the secret at secret/my_secret using the local-instance source, and ${nr-vault:remote:my_mount:my_path:organization} retrieves the organization key from the remote source.

Local files: `nr-file`

Reads the contents of a local file, trimming leading and trailing whitespace.

The placeholder takes the absolute path to the file:

config_agent:
  license_key: "${nr-file:/etc/newrelic/license.key}"

Kubernetes secrets: `nr-kubesec`

Reads a key from a Kubernetes secret. Available on Kubernetes only, and requires no additional configuration as long as the Agent Control pod has permissions, through a service account and RBAC, to access the required secrets and namespaces.

The placeholder uses this format:

"${nr-kubesec:NAMESPACE:SECRET_NAME:KEY}"

NAMESPACE: namespace where the secret is located.
SECRET_NAME: name of the Kubernetes secret object.
KEY: key within the secret to retrieve.

Kubernetes ConfigMaps: `nr-kubecm`

Reads a key from a Kubernetes ConfigMap. Available on Kubernetes only, and requires no additional configuration as long as the Agent Control pod has permissions to access the required ConfigMaps and namespaces.

The placeholder uses this format:

"${nr-kubecm:NAMESPACE:CONFIGMAP_NAME:KEY}"

NAMESPACE: namespace where the ConfigMap is located.
CONFIGMAP_NAME: name of the Kubernetes ConfigMap object.
KEY: key within the ConfigMap to retrieve.

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

重要

ヒント

設定の 2 つの層を理解する.css-21sua1{background:none;border:none;width:0;padding:0;}

Kubernetes設定

Kubernetesのローカルvalues.yaml設定

Kubernetesのリモート設定

ヒント

サンプル設定: KubernetesでのAgent Control

New Relic InfrastructureとFluent BitによるAgent Control

インフラストラクチャと Fluent Bit のローカル構成

OpenTelemetryおよびカスタム コレクター設定を使用したAgent Control

重要

OpenTelemetry設定

サンプル設定: Kubernetesでのリモートエージェント設定

リモート設定: New Relicインフラストラクチャ

インフラストラクチャリモート設定

リモート設定: Fluent Bit

Fluent Bit設定

リモート設定: Prometheus

プロメテウスの設定

リモート設定: OpenTelemetry

重要

OpenTelemetryリモート設定

Kubernetesのプロキシ設定

プロキシの優先順位

自己署名証明書を使用したプロキシ設定

Kubernetesプロキシ設定例

マネージドエージェント用プロキシ設定

注意

秘密管理

プライベートリポジトリ設定

注意

1. エージェントのプライベートリポジトリを有効にする

プライベートリポジトリを有効にする

2. プライベートリポジトリの認証を設定する

基本認証

TLS証明書認証

Linuxの設定

エージェントを構成する

ヒント

サンプル設定

Fleet Controlによるリモート設定

インフラエージェント、オンホストインテグレーション、ログフォワーダー (FluentBit 内蔵)

New Relic OTel コレクター

New Relic Agent Control

Windowsの設定

ヒント

Windows固有の設定に関する注意事項

エージェントの設定

サンプル設定

Fleet Controlによるリモート設定

ログ転送を使用したインフラストラクチャエージェント

Agent Control設定

Value providers

重要

Supported value providers

Configuring value providers

環境変数： nr-env

HashiCorp Vault: nr-vault

Local files: nr-file

Kubernetes secrets: nr-kubesec

Kubernetes ConfigMaps: nr-kubecm

設定の 2 つの層を理解する

Kubernetesのローカル`values.yaml`設定

OpenTelemetryおよびカスタムコレクター設定を使用したAgent Control

環境変数： `nr-env`

HashiCorp Vault: `nr-vault`

Local files: `nr-file`

Kubernetes secrets: `nr-kubesec`

Kubernetes ConfigMaps: `nr-kubecm`