重要
Agent ControlとNew Relic Controlは、Kubernetes向けに一般提供されています。LinuxおよびWindowsホストのサポートは、当社の プレリリースポリシー に基づき、 パブリックプレビュー プログラムとして提供されています。
Agent Control 、 Kubernetesクラスタ上で実行される軽量のエージェント スーパーバイザであり、 New Relicとオープンソース計装エージェントのライフサイクルを管理するホストです。 Fleet Controlと通信して、フリート全体の健全性をリモートで構成、更新、監視します。
概要
大規模な計装の管理は多大な労力を要し、エラーが発生しやすくなります。 複数のエージェント、バージョンの無秩序な拡散、設定のドリフトにより、テレメトリーの盲点、コンプライアンスのリスクが生じ、たとえ小さな変更であっても調整に数週間かかる可能性があります。
Agent Controlは、ホストまたはクラスタごとに一度インストールするだけで済む、拡張可能な単一のスーパーバイザーを提供します。すべてのNew Relicおよびオープンソース エージェントを健全かつ最新の状態に保ち、リモート設定を適用し、各エージェントに個別に触れることなく一貫した設定を適用します。
コストとデータ取り込みに関する注意事項
Agent Controlは、サポートされているあらゆる環境にインストールでき、有料ライセンスは必要ありません。スーパーバイザー自身は、新しいテレメトリーをNew Relicにプッシュしません。 取り込みコストは、マネージド エージェント (インフラストラクチャ、 APM 、ログ) で有効になっている計装によって異なります。
アーキテクチャー
Agent Controlは、宣言型でGitOpsに似たアプローチでエージェント管理を行います。Fleet Controlから受信したリモート設定を計装の望ましい状態として扱い、フリートにデプロイしたものがクラスタ上で実行されることを保証します。
宣言型エンジン: Kubernetes 上の Flux
Kubernetesでは、 Agent Control 、CNCF が卒業した継続的な配信ツールであるFlux を宣言型エンジンとして利用します。 Flux コントローラーは、 Agent Controlによって提供される設定に基づいて、エージェントを自動的にデプロイおよび更新します。
以下の図はAgent Control New Relic Control (バックエンドおよびUI ) および Flux (オンクラスタ エンジン) に接続してエージェントを管理する方法を示しています。
Agent Controlローカルまたはリモートの設定を使用できます。 ローカル設定は初期インストレーション ファイルで定義されますが、リモート設定はNew Relic Control から受信され、エージェントに直接レンダリングされます。 これにより、以下を含むすべてのものを一元的に管理できます。
- 認証情報: Agent Control 、Vault などの外部シークレット プロバイダーから機密認証情報を取得し、実行時にエージェントの設定に挿入できます。 これにより、認証情報が設定ファイル自体に含まれないようにすることで、セキュリティが強化されます。
- エージェント設定: Agent Control 、リモート設定を、基礎となるエージェントと互換性のある形式に自動的に変換します。 これはNew Relic Infrastructure エージェントやOpenTelemetryなど、さまざまなタイプのエージェントを単一の統合プロセスで管理できることを意味します。
各クラスタおよびホストにAgent Controlをインストールすると、監視の実践を拡張できます。
- フリート全体のアクション:設定を受け取り、エージェントのフリート全体にわたってライフサイクル操作を実行します。
- 双方向通信：エージェントとの認証済みかつ暗号化された通信により、リアルタイムのトラブルシューティングと診断を実現します。
- セキュリティ対策：シークレットプロバイダーから認証情報を取得する方法を標準化し、処理の一元化、ローテーションの自動化、リスクの低減を図る。
重要
このレベルの制御と通信を有効にするには、 Agent Control特定の権限が必要です。 設定をプルし、ローカル システムと対話してエージェントのライフサイクルを管理するために必要なアクセス権を設定する必要があります。 Agent Controlを使用する場合は、安全で機能的な環境を維持するために必要な権限を理解し、付与するようにしてください。 Agent Control権限については、次のセクションを参照してください。
Agent Control 、環境内で強力なアクションを実行する能力を必要とする計装を管理するためのスーパーバイザーとして設計されています。 必要な権限を理解し、付与することが非常に重要です。
重要な行動
- エージェントなしで起動： Agent Controlは、デフォルトでは管理対象エージェントが実行されない軽量スーパーバイザーとしてインストールされます。導入後にFleet Controlを通じてどのエージェントをデプロイするかを定義します。
- Linux 上でのリモートインストールとアップグレード: Linux ホストでは、Fleet Control を介してエージェントをリモートでインストール、構成、およびアップグレードできます。各ホストで手動で操作する必要はありません。
- エージェントの自動移行なし: Agent Control 、既存のエージェント インストレーションを自動的に移行したり置き換えたりしません。 Agent Controlをインストールする前に、既存のエージェントをすべてアンインストールし、Fleet Controlを通じて管理してください。「既存の計装の管理」を参照してください。
Agent Control権限
Kubernetesクラスタでエージェントをデプロイおよび管理するには、必要な権限を明確に理解する必要があります。 ここでは、 Agent Controlと Flux の両方の役割と、各エージェントが必要な権限のみを確実に持ちながら、エージェントを安全にインストール、更新、削除するためにどのように相互作用するかを説明します。
Kubernetes
Kubernetes環境では、 Agent Control継続的な配信エンジンとして Flux を使用してエージェントをインストール、更新、アンインストールします。 Agent ControlにはFluxリソースを作成および管理するための権限が必要であり、Fluxにはエージェントを実行するKubernetesリソースを作成および更新するための上位権限が必要です。
- Agent Controlの権限： Agent Controlには、
HelmReleaseやHelmRepositoryなどのFlux固有のカスタムリソースを作成、読み取り、更新、削除するための権限が必要です。 これにより、 Agent Control Agent Controlに何をすべきかを指示できるようになります。 - Flux の権限: Flux は、デプロイするエージェントの Helm チャートのライフサイクルを管理するために、通常は
cluster-adminロールを持つ、高い権限を必要とします。これには、ユーザーに代わってDeployments、DaemonSets、Services、ConfigMaps、Secrets、およびその他の Kubernetes リソースを作成することが含まれます。セキュリティの観点から、信頼され検証された設定のみがAgent Controlで使用されるようにすることがベストプラクティスです。
Linuxホスト
ホストベースのシステム（現在パブリックプレビュー版）では、 Agent Control権限が必要です。 次のようなライフサイクル タスクを実行するには、スーパーバイザは root、アドミニストレータ、または同等の権限で実行する必要があります。
- 新しいエージェントのインストール:エージェントのバイナリと設定ファイルをシステム ディレクトリにコピーします。
- エージェントプロセスの管理： systemdなどを使用して、サービスを開始、停止、再起動します。
- システム データの読み取り:健全性、インベントリ、ログやパフォーマンス メトリクスなどの診断に必要なシステム情報にアクセスします。
Kubernetesと同様に、 Agent Controlホスト上で宣言型モデルを採用しています。つまり、設定ファイルで望ましい状態を読み取り、その状態に到達するために必要なアクションのみを実行します。 これは、上司が取れる行動を制限するために設計されています。管理者権限は、エージェントの設定、インストール、更新、アンインストールに使用されるものであり、承認されていない任意の操作を実行するために使用されるものではありません。
エージェント固有の権限
エージェントのタイプとその設定が異なると、必要な権限も異なります。 たとえば、 Kubernetes APIからメトリクスを収集するエージェントには、ファイルからログを読み取るだけのエージェントよりも多くの権限が必要です。
Agent Control 、これらの権限を柔軟に管理できるように設計されています。 Fluxは機能するために高度なアクセス権限を必要としますが、当社の目標は、 Agent Control管理対象のエージェントの特定の組み合わせに対して、必要最低限の権限のみrequestsようにすることです。
各エージェントに必要な特定の権限の詳細については、 「サポートされているエージェントの種類」を参照してください。
要件と互換性
Kubernetes
Agent ControlKubernetesクラスタに対する を開始する前に、次の前提条件を満たしていることを確認してください。
- Helm 3:マシンに Helm バージョン 3 がインストールされている必要があります。インストール手順については、 Helmのインストール」を参照してください。
- New Relicライセンスキー: New Relicアカウントにテレメトリーを報告するにはライセンスキーが必要です。
- Kubernetesクラスタ名: Kubernetesクラスタの名前を用意します。 インストレーションプロセス中にこれを参照します。
- 認証ドメイン マネージャー: Agent ControlをセットアップしてFleet Controlに接続するには、認証ドメイン マネージャー ロールが必要です。 詳細については、 「ユーザー管理の概念」を参照してください。
重要: 既存の計装
Kubernetesクラスタが既にNew Relicでインストゥルメントされている場合は、 Agent Controlをインストールする前に既存の計装をアンインストールする必要があります。 Agent Controlをインストールした後、 New Relic Control を使用してクラスタ上のすべてのインフラストラクチャ エージェントをインストールおよび管理できます。 このプロセスのガイダンスについては、 Agent Controlによる既存の計画の管理」を参照してください。
警告
同じクラスタへのAgent Controlの複数のインスタンスのインストールはサポートされていません。
Agent Control次のものと互換性があります:
- Kubernetes の最後の 3 つのマイナーリリース
- Minikube、Kind、Amazon EKS、Azure AKS、Google GKE
New Relic KubernetesインフラストラクチャエージェントおよびNew Relic OpenTelemetry (NRDOT) コレクターに関連するシステム要件については、以下を参照してください。
Linuxホスト
Agent Controlをインストールする前に、New Relicアカウントをお持ちであること、およびシステムが以下の要件を満たしていることを確認してください。当社は、これらのOSをメーカーのサポート終了日までサポートします。
プロセッサアーキテクチャー | Agent Control次のプロセッサアーキテクチャーをサポートします。
|
オペレーティングシステム | Agent ControlこれらのOSを各メーカーのサポート終了日までサポートします。
|
OSの詳細を確認するには、次のコマンドを実行してください。
$cat /etc/os-releaseWindowsホスト
WindowsにAgent Controlをインストールする前に、New Relicアカウントをお持ちであること、およびシステムが以下の要件を満たしていることを確認してください。
プロセッサアーキテクチャー | Agent Control次のプロセッサアーキテクチャーをサポートします。
|
オペレーティングシステム | Agent Control以下のWindows OS をサポートしています:
|
前提条件 |
|
ネットワーク要件 | Agent Control 、以下の宛先へのHTTPSアウトバウンド接続を必要とします。
|
Windowsのバージョンを確認するには、PowerShellで次のコマンドを実行してください。
Get-ComputerInfo | Select-Object WindowsProductName, WindowsVersion, OsHardwareAbstractionLayerWindowsのサポート制限
サポートされているエージェント: Windowsホストでは、 Agent Control現在New Relic InfrastructureエージェントとNew Relic OpenTelemetry Collector (NRDOT)のみをサポートしています。 その他のエージェントタイプ（APMエージェント、Fluent Bit、Prometheus、eBPFなど）は、現時点ではサポートされていません。
最小バージョン要件: Windows上のAgent Control 、次の最小バージョンを満たすエージェントのみを管理できます。
インフラストラクチャエージェント: バージョン 1.71.0 以降
NRDOT（OpenTelemetry Collector）：バージョン1.5.0以上
古いバージョンをデプロイしようとすると失敗します。
設定の互換性: Linux またはKubernetes環境の設定、テンプレート、エージェント バージョンはWindowsと互換性がない可能性があります。 Windowsのサポートは、上記に記載されている最小バージョンから開始され、そのバージョンで利用可能な機能のみが含まれます。以前のバージョンや他の環境の設定を適用すると、デプロイメントが失敗する可能性があります。
自動移行はサポートされていません： Windows 版 Agent Control は、既存のアドホック エージェントの自動移行をサポートしていません。Windowsホストに既にエージェントがインストールされている場合は、まずそれらをアンインストールしてから、Agent ControlとFleet Controlを使用して管理する必要があります。
フリートタイプの要件: Windows で Agent Control を設定する場合、 「Host - Windows」タイプのフリートを作成または使用する必要があります。これは、Windows環境で正常に動作させるために必須です。
ログ収集: Windowsでのログ収集は、インフラストラクチャに統合されたFluent Bitを通じてサポートされています。 インフラストラクチャエージェント パッケージにはWindows用のFluent Bitバイナリが含まれており、
config_logging設定を通じて転送ログ機能を有効にします。
次のステップ
互換性を確認し、すべての前提条件を満たしたら、 Agent Control をインストールする準備が整います。