設定の管理

重要

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

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"
  userKey: "YOUR_USER_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`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
      fleet_id: ""
      auth:
        # New Relic organization ID where agent will connect to.
        organizationId: "YOUR_ORGANIZATION_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.
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # 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:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # 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:
        type: com.newrelic.k8s_agent_operator:0.1.0
        content:
          chart_version: "*"

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

Kubernetesのリモート設定

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

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

callout.warning

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"
  userKey: "YOUR_USER_KEY"

# See `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control-bootstrap/values.yaml`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional
      # fleet_id: YOUR_FLEET_ENTITY_GUID
      auth:
        organizationId: "YOUR_ORGANIZATION_ID"
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # 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:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # 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:
        type: com.newrelic.k8s_agent_operator:0.1.0
        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`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
      fleet_id: ""
      auth:
        # New Relic organization ID where agent will connect to.
        organizationId: "YOUR_ORGANIZATION_ID"

    # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle%60
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"
      agent-operator:
        type: newrelic/com.newrelic.k8s_agent_operator:0.1.0
        content:
          chart_version: "*"
      fluentbit:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # 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:
            global:
              lowDataMode: true
      prometheus:
        type: newrelic/com.newrelic.prometheus:0.1.0
        content:
          chart_version: "*"
          chart_values:
            global:
              lowDataMode: true
            newrelic-prometheus-agent:
              config:
                kubernetes:
                  integrations_filter:
                    enabled: false

サンプル設定: 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:
  newrelic-prometheus-agent:
    lowDataMode: true

Kubernetesのプロキシ設定

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

プロキシの優先順位

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

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

重要

プロキシ設定は現在、署名検証用の証明書の取得と互換性がありません。プロキシを設定する必要がある場合は、次のオプションがあります。

ファイアウォール例外をhttps://newrelic.comに追加して、そのエンドポイントへのrequestsプロキシをスキップできるようにします (推奨)
fleet_control.signature_validation.certificate_pem_file_pathを通じてローカル証明書を使用します (証明書のローテーションは手動で処理する必要があります)
fleet_control.signature_validation.enabled: falseを設定して署名検証を無効にします (セキュリティ上の理由から強く推奨されません)

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

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

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

agent-control-deployment:
  config:
    agentControl:
      content:
        proxy:
          url: https://proxy-service:8080
    subAgents: {}

  # 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
agent-control-cd:
  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専用のシークレットプロバイダーからパスワードやAPIキーなどの機密データを取得して管理するための堅牢なメカニズムを提供します。これにより、機密情報が設定ファイルに直接ハードコードされなくなります。システムは現在、次のシークレットプロバイダーをサポートしています。

HashiCorp Vault: 設定ではnr-vaultと呼ばれます。
Kubernetes Secrets: 設定ではnr-kubesecと呼ばれます。

設定でシークレットを定義する

シークレットを利用するには、次の手順に従って、エージェントコントロール設定 YAML ファイル内でシークレットを定義します。

secrets_providersセクションを定義します。このセクションでシークレットプロバイダーを集中的に構成します。各エントリがサポートされているプロバイダーに対応していることを確認します。
シークレットソースを構成する:プロバイダーごとに、1 つ以上のソースを指定します。ソースには、エージェント制御がシークレットのグループに接続して取得するために必要な設定の詳細 (例: URL、VPN) が含まれています。
エージェント設定でプレースホルダーを使用する:実際の機密データの代わりに、エージェントの設定内でプレースホルダー文字列を使用します。エージェントコントロールは、レンダリングプロセス中にこれらのプレースホルダーを取得したシークレットに自動的に置き換えます。

重要

エージェントコントロールがシークレットの取得に失敗した場合、設定のレンダリングは失敗し、エージェントは実行されません。これは、エージェントが不完全または間違った設定で実行されるのを防ぐための重要なセキュリティ機能です。

次のエージェント制御設定例は、 secrets_providersセクション内の 2 つの Vault ソースからシークレットを取得するように設定する方法を示しています。

secrets_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

fleet_control:
  ...

agents:
  ...

エージェント設定でのシークレットの使用

ソースを定義した後、エージェント設定で、正しいパスを持つ特定のプレースホルダー構文を使用してボールトを参照できます。エージェントコントロールはシークレットを取得し、それを使用してエージェントが使用する最終設定ファイルをレンダリングします。

vault プレースホルダーを使用したエージェント設定の例:

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}"

この例では

プレースホルダー${nr-vault:local-instance:secret:my_secret:username}は、ローカルインスタンスボールトソースを使用してパスsecret/my_secretのシークレットからキーユーザー名に関連付けられた値を取得するようにエージェントコントロールに指示します。プレースホルダー${nr-vault:remote:my_mount:my_path:organization}も同様に、リモートソースから組織キーの値を取得します。

取得が成功すると、エージェントコントロールは指定されたソースとパスからこれらのシークレットをレンダリングし、対応するエージェントが使用できるように結果を K8s シークレットまたはプライベート構成ファイルに保存します。

ヴォールトの秘密

次の設定で Vault ソースを設定します。

YAMLキー	説明
`url`	データを要求するURL
`token`	エンドポイントへの認証に使用されます。
`engine`	`kv1`または`kv2`を指定します。

構成ファイルでは、次のプレースホルダーを設定することで、Vault に保存されている各シークレットにアクセスできます。

source_name : secrets_providersで定義された Vault ソースの名前。
mount [マウント]: シークレットエンジンマウントの名前。
path : シークレットへの特定のパス。
specific key [特定のキー]: 取得するシークレット内の特定のキー。

完全なプレースホルダー形式の例:

"${nr-vault:source_name:my_mount:my_path:my_value}"

Kubernetesの秘密

エージェントコントロールのポッドが、サービスアカウントやロールベースのアクセス制御 (RBAC) などを介して、必要なシークレットとネームスペースにアクセスする権限を持っている場合、エージェントコントロールは、別のソース設定を必要とせずに、 Kubernetes APIからシークレットに直接アクセスできます。

エージェント設定ファイルで、次を指定するプレースホルダーを使用して各シークレット値を取得します。

namespace [ネームスペース]: シークレットが存在するKubernetesネームスペース。
name : Kubernetes シークレットオブジェクトの名前。
specific key [特定のキー]: 値を取得するシークレット内の特定のキー。

たとえば、次のプレースホルダー形式を使用します。

"${nr-kubesec:my_namespace:my_secret:my_value}"

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

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

注意

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

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

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

# values-newrelic.yaml

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

# ...

agent-control-deployment:
  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を構成する必要があります。マネージドエージェントの設定とは別のものです。 installationJobセクションを設定するには、 agent-control-bootstrap Helm チャートvalues.yamlを参照してください。具体的には：

chartRepositoryUrl リポジトリのURLを含む
name 別のチャート名を使用する場合
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
  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
    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/io.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を追加します。

エージェントの設定

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/io.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/io.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`	インフラストラクチャエージェント設定を含むファイル	（空の）
`com.newrelic.infrastructure`	`config_integrations`	オンホストインテグレーション設定を含む文字列マップ	（空の）
`com.newrelic.infrastructure`	`config_logging`	ログ転送設定を含む文字列マップ	（空の）
`com.newrelic.infrastructure`	`health_port`	インフラストラクチャエージェントのローカルステータスサーバー用のポート	`/health/status`
`io.opentelemetry.collector`	`config`	OpenTelemetryコレクター設定(yaml形式)	（空の）
`io.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/io.opentelemetry.collector:0.1.0"

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

重要

ヒント

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

Kubernetes設定

Kubernetesのローカルvalues.yaml設定

Kubernetesのリモート設定

callout.warning

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

New Relic InfrastructureとFluent BitによるAgent Control

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

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

重要

OpenTelemetry設定

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

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

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

リモート設定: Fluent Bit

Fluent Bit設定