Pipeline Controlゲートウェイのセットアップとデプロイ

Pipeline Controlゲートウェイをセットアップして展開し、モニターエンティティからNew Relicへのデータフローを管理します。

Restricted cluster-admin access

This guide covers a full-management installation that requires cluster-admin permissions. If your organizational security policies restrict this level of access, see Install Pipeline Control gateway without Flux.

In that configuration, New Relic still delivers all pipeline configurations through the UI, but you will be responsible for manually managing gateway scaling and version upgrades.

ゲートウェイの使用に関する考慮事項

ゲートウェイコンポーネントを統合して使用する場合、次の重要な考慮事項に留意してください。

属性とデータ管理

プロパティのサポート:ゲートウェイは、プロパティに対してOpenTelemetryセマンティック規則を使用します。サポートされている属性の詳細については、ゲートウェイのドキュメントを参照してください。
データ/プロパティの処理:ゲートウェイは、メトリクスタイムスライスデータ、トレース、およびトレースのデータまたはプロパティを削除するrequestsを変更せずにNew Relicに直接転送します。

解析とデータ統合

ログ解析:ゲートウェイにはログの Grok 解析は含まれません。Grok 解析は、事前定義されたパターンと正規表現を使用して、非構造化ログメッセージから構造化データを抽出するために使用される方法です。クエリや視覚化のためにログデータを構造化するには、別の方法が必要になる場合があります。
Prometheus 統合:ゲートウェイはメトリクスの Prometheus リモート書き込みをサポートしていないため、Prometheus ベースのシステムとの統合に影響を与える可能性があります。

ライセンスとコンプライアンス

ライセンスキーの管理: OpenTelemetryゲートウェイは、エージェントコレクターやAPM SDK などのネイティブ Protocol (OTLP) ソースからの複数のライセンスキーには対応しません。ライセンスを管理するときはこれを考慮してください。
コンプライアンス標準:ゲートウェイは FedRAMP に準拠していないため、連邦セキュリティ標準を満たす必要がある場合は使用に影響する可能性があります。

前提条件

Kubernetes permissions: This installation mode requires cluster-admin permissions for Flux controllers to manage gateway lifecycle (installation, upgrades, scaling).
Required tools:
- Helm v3.x or higher (verify with helm version)
- kubectl CLI with access to your Kubernetes cluster
New Relic infrastructure agent (optional): Pipeline Control gateway no longer bundles the New Relic infrastructure agent. To view cluster health metrics (CPU usage, memory, and region) in the gateway health dashboard, install the infrastructure agent separately. Refer to Install the Kubernetes integration for installation instructions.

What happens without infrastructure agent:

Gateway health table will show "N/A" for: CPU usage, memory usage, and region.
Pipeline configuration and data processing continues to work normally.

重要

If you installed gateway before this change, your infrastructure agent remains in place and continues to work. This requirement only affects new gateway installations.

Pipeline Controlゲートウェイを設定する

Screenshot of the button to start Pipeline Control gateway installation

To set up gateway:

New Relic アカウントの [Integrations & Agents] で、Set up Pipeline Control [Pipeline Control の設定] をクリックするか、gateway [ゲートウェイ] を検索して Pipeline Control gateway [Pipeline Control ゲートウェイ] を選択します。
選択したアカウントが Pipeline Control に使用するアカウントであることを確認します。そうでない場合は、 Select an account [アカウントを選択]をクリックし、希望するアカウントを選択して、 Continue [続行]をクリックします。
資格情報を入力するには、既存のライセンスキーを入力するか、新しいキーを作成します。新しいキーを作成する場合は、キーをコピーします。次に、 Continue [続行]をクリックします。
ゲートウェイフリートを選択または作成します：
- 新しいゲートウェイで、組織内の他のゲートウェイと既存の設定（サンプリング、フィルタリング、および変換ルール）を共有する場合は、既存のフリートを選択します。
- 特定の環境またはビジネスユニット用に新規の分離された設定が必要な場合は、一意のゲートウェイフリート名を入力してください。
Select Full management (with Flux).
Configure the gateway:
- Enter your cluster name.
- Enter the dedicated Kubernetes namespace where the core gateway infrastructure and manager services will reside. Default is newrelic-agent-control.
- Enter the specific namespace where individual collection agents will run. Default is newrelic.
設定ファイルvalues-newrelic-gateway.yamlディレクトリにダウンロードします。
画面に表示されているインストールコマンドを実行します。
bash
```
$helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-bootstrap -n newrelic-agent-control newrelic/agent-control-bootstrap --create-namespace --values values-newrelic-gateway.yaml
```
ヒント
The UI wizard provides the complete value file, values-newrelic-gateway.yaml, with your specific configuration. Download the file and use it with the Helm command.
Click Continue.
Test connection [接続テスト]をクリックし、接続が成功するまで待ちます。

ゲートウェイ設定の詳細を表示するには、New Relic Control に移動し、 Gatewayをクリックします。

複数のフリートを使用するのはなぜですか？

Imagine a corporation (The Corp) has two divisions: OrgA (needs 100% of data for audit reasons) and OrgB (needs 1% sampling to control high-volume costs).

With only one fleet, The Corp is stuck. If OrgB applies 1% sampling to save money, OrgA loses 99% of its performance data. One team's cost-control breaks the other team's mission-critical monitoring.

複数のフリートを使用することで、The Corpは自社の"頭脳"を分離できます：

ミッションクリティカルフリート: OrgAは、100％のデータ保持期間を確保するためにこのフリートに参加します。
High-volume fleet: OrgB joins this fleet for 1% sampling and personal data redaction.

その結果、組織の他の部分に影響を与えることなく、個別のチームが独自のサンプリング、セキュリティ、コンプライアンスルールを管理できるようになりました。

クラスターを追加する

ゲートウェイ設定に新しいクラスターを追加するには、

New Relic Control を開き、 Gatewayを選択します。
クラスタ表で、 Add a cluster [クラスタの追加]をクリックします。
ゲートウェイセットアップの指示に従ってください。
ゲートウェイの概要ページに戻ります。新しく追加されたクラスターが表示されます。

ゲートウェイクラスタを作成したら、YAML 設定を使用してパイプライン処理を構成します。ゲートウェイ設定を参照してください。