|
この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。 |
APIキー（廃止予定）
APIキーは、SUSE® Observabilityに対して認証を行い、SUSE® Observabilityにテレメトリデータを送信するために使用されました。Helmエージェントのインストールでは、`stackstate.apiKey`のhelm変数を設定することでこれが行われました。
APIキーおよびインジェスチョンAPIキーは廃止予定であり、2026年第4四半期に削除される予定です。サービストークンは、テレメトリデータを送信するための認証メカニズムとして推奨されています。
StackPackインストールフローにおけるSUSE® Observabilityへの新しいクラスターを追加するフローには、Rancher RBAC用のRBACエージェントと互換性のあるクラスター固有のトークンの作成が含まれます。
APIキーからサービストークンへの移行
テレメトリデータのために単一のAPIキーからサービストークンに移行するための2つのオプションがあります。
-
クラスターごとにサービストークンに移行します。これは設定に少し手間がかかりますが、Rancher RBACをサポートしています。
-
すべてのKubernetesクラスターとOTelコレクターから使用する単一のサービストークンに移行します。これはRancher RBACをサポートしていません。
すべてのエージェントとOpen Telemetryコレクターをサービストークンに移行した後、SUSE® ObservabilityをインストールするためのHelm値から`global.receiverApiKey`または`stackstate.apiKey`を削除し、変更を適用するために`helm upgrade`を実行できます。
クラスターごとにサービストークンに移行します。
-
UIでKubernetes Stackpackを開きます。
-
移行しているクラスターを開きます。
-
「新しいサービストークンを作成」ボタンをクリックして、クラスター固有のサービストークンを取得し、そのトークンをコピーします。
-
エージェントをサービストークンをAPIキーとして使用してクラスターに再デプロイするために、スタックパックのエージェントインストール/アップグレード手順に従ってください。
UIを使用する代わりに、CLIを使用してトークンを生成することもできますこちらに記載されています。移行しているクラスターにスコープされた`update-scoped-permissions`も割り当てることを確認してください。他の手順はUIと同じままです。
単一のサービストークンに移行します。
CLIを使用してサービストークンを生成します こちらに記載されています。
> sts rbac create-subject --subject my-agent
✅ Created subject 'my-agent'
> sts rbac grant --subject my-agent --permission update-metrics
✅ Granted permission 'update-metrics' on 'system' to subject 'my-agent'
PERMISSION | RESOURCE
update-metrics | system複数のクラスターから使用されるトークンには、`update-scoped-permissions`の権限を追加しないでください。機能しません。
Kubernetes StackPackのUIにある指示に従って、エージェントとOpen Telemetryコレクターを再デプロイしてください。また、Open Telemetryコレクターのドキュメントも参照してください。生成されたサービストークンをAPIキーとして使用してください。
インジェスションAPIキーからの移行
インジェスションAPIキーは、外部ツールがデータ（メトリクス、イベント、トレースなど）をSUSE Observabilityクラスターに送信するために使用されていました。 これらのツールには、STSエージェントまたはOTelコレクターが含まれます。サービストークンは同じ機能を持ち、さらに多くの機能があります。APIキー（前のセクション）の場合と同じ手順に従って、クラスターごとのサービストークンまたは単一のサービストークンに移行してください。