4.3. リモートヘルスレポート
クラスターの健全性と使用状況データのレポートを オプトイン (有効化) または オプトアウト (無効化) することができます。
4.3.1. リモートヘルスレポートの有効化 リンクのコピーリンクがクリップボードにコピーされました!
組織がリモートヘルスレポートを無効にしている場合は、この機能を再度有効にできます。OpenShift Container Platform Web コンソールの Overview ページの Status タイルに表示される Insights not available
というメッセージから、リモートヘルスレポートが無効になっていることを確認できます。
リモートヘルスレポートを有効にするには、新しい認可トークンを使用してグローバルクラスタープルシークレットを変更する必要があります。リモートヘルスレポートを有効にすると、Insights Operator と Telemetry の両方が有効になります。
4.3.2. グローバルクラスタープルシークレットの変更によるリモートヘルスレポートの有効化 リンクのコピーリンクがクリップボードにコピーされました!
既存のグローバルクラスタープルシークレットを変更して、リモートヘルスレポートを有効にすることができます。リモートヘルスモニタリングを無効にしている場合は、Red Hat OpenShift Cluster Manager から console.openshift.com
アクセストークンを使用して新しいプルシークレットをダウンロードする必要があります。
前提条件
-
cluster-admin
ロールを持つユーザーとしてクラスターにアクセスできる。 - OpenShift Cluster Manager へのアクセス。
手順
- Red Hat Hybrid Cloud Console の ダウンロード ページに移動します。
Tokens
Pull secret から、Download ボタンをクリックします。 pull-secret
ファイルには、JSON 形式のcloud.openshift.com
アクセストークンが含まれています。Copy to Clipboard Copied! Toggle word wrap Toggle overflow グローバルクラスタープルシークレットをローカルファイルシステムにダウンロードします。
oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ > pull-secret
$ oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ > pull-secret
Copy to Clipboard Copied! Toggle word wrap Toggle overflow プルシークレットのバックアップコピーを作成します。
cp pull-secret pull-secret-backup
$ cp pull-secret pull-secret-backup
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
テキストエディターで
プルシークレット
を開きます。 -
先ほどダウンロードした
pull-secret
ファイルのcloud.openshift.com
JSON エントリーをauths
ファイルに追加します。 - ファイルを保存します。
次のコマンドを実行して、クラスター内のシークレットを更新します。
oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=pull-secret
$ oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=pull-secret
Copy to Clipboard Copied! Toggle word wrap Toggle overflow シークレットが更新され、クラスターがレポートを開始するまで、数分間待つ必要がある場合があります。
検証
OpenShift Container Platform Web コンソールから検証チェックを行うには、次の手順を実行します。
- OpenShift Container Platform Web コンソールの Overview ページに移動します。
- Status タイルの Insights セクションを確認します。このセクションに、検出された問題の件数が表示されます。
OpenShift CLI (
oc
) から検証チェックを行うには、次のコマンドを入力し、status
パラメーターの値がfalse
になっていることを確認します。oc get co insights -o jsonpath='{.status.conditions[?(@.type=="Disabled")]}'
$ oc get co insights -o jsonpath='{.status.conditions[?(@.type=="Disabled")]}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3.3. リモートヘルスレポートを無効した場合の影響 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform では、お客様は使用状況情報のレポートを無効にできます。
リモートヘルスレポートを無効にする前に、接続クラスターの次の利点をご確認ください。
- Red Hat による問題への対応が迅速化し、カスタマーサポートが強化されます。
- 製品のアップグレードがクラスターに与える影響を Red Hat が把握できます。
- 接続クラスターは、サブスクリプションとエンタイトルメントのプロセスを簡素化するのに役立ちます。
- 接続クラスターにより、OpenShift Cluster Manager サービスがクラスターの概要とサブスクリプションステータスを提供できるようになります。
実稼働前、テスト、および実稼働クラスターでは、健全性および使用状況のレポートを有効にしておくことを検討してください。これにより、Red Hat がお客様の環境における OpenShift Container Platform の適格性評価に参加し、製品の問題に対してより迅速に対応できるようになります。
接続クラスターでリモートヘルスレポートを無効にした場合の結果を以下に示します。
- サポートケースが作成されていない場合、Red Hat が製品のアップグレードの成功やクラスターの健全性を確認することができなくなります。
- Red Hat が、設定データを使用してカスタマーサポートケースの優先順位付けを改善することや、お客様にとって重要な設定を特定することができなくなります。
- OpenShift Cluster Manager が、健全性や使用状況の情報など、クラスターに関するデータを表示できなくなります。
-
使用状況の自動レポート機能を利用できないため、お客様が
console.redhat.com
Web コンソールにサブスクリプション情報を手動で入力する必要があります。
ネットワークが制限された環境でも、プロキシーの適切な設定により Telemetry と Insights のデータは収集されます。
4.3.4. リモートヘルスレポートの無効化 リンクのコピーリンクがクリップボードにコピーされました!
既存のグローバルクラスタープルシークレットを変更して、リモートヘルスレポートを無効にすることができます。この設定により、Telemetry と Insights Operator の両方が無効になります。
前提条件
-
cluster-admin
ロールを持つユーザーとしてクラスターにアクセスできる。
手順
グローバルクラスタープルシークレットをローカルファイルシステムにダウンロードします。
oc extract secret/pull-secret -n openshift-config --to=.
$ oc extract secret/pull-secret -n openshift-config --to=.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow テキストエディターで、ダウンロードした
.dockerconfigjson
ファイルを編集し、cloud.openshift.com
JSON エントリーを削除します。"cloud.openshift.com":{"auth":"<hash>","email":"<email_address>"}
"cloud.openshift.com":{"auth":"<hash>","email":"<email_address>"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ファイルを保存します。
クラスターのシークレットを更新します。詳細は、「グローバルクラスタープルシークレットの更新」を参照してください。
クラスター内のシークレットが更新されるまで、数分間待つ必要がある場合があります。
4.3.5. 非接続クラスターの登録 リンクのコピーリンクがクリップボードにコピーされました!
切断された OpenShift Container Platform クラスターを Red Hat Hybrid Cloud Console に登録し、リモートヘルスレポートを無効にすることでクラスターが影響を受けないようにします。詳細は、「リモートヘルスレポートを無効にした場合の影響」を参照してください。
お客様は非接続クラスターを登録することで、引き続きサブスクリプションの使用状況を Red Hat に報告できます。そうすることで、Red Hat はサブスクリプションに関連する正確な使用状況と容量の傾向を返せるようになります。その結果、お客様はその返された情報を使用して、すべてのリソースに対するサブスクリプションの割り当てをより適切に管理できるようになります。
前提条件
-
OpenShift Container Platform Web コンソールに
cluster-admin
ロールとしてログインしている。 - Red Hat Hybrid Cloud Console にログインできる。
手順
- Red Hat Hybrid Cloud Console の Register disconnected cluster Web ページに移動します。
- オプション: Red Hat Hybrid Cloud Console のホームページから Register disconnected cluster Web ページにアクセスするには、ナビゲーションメニュー項目の Cluster List に移動し、Register cluster ボタンを選択します。
- Register disconnected cluster ページの指定されたフィールドにクラスターの詳細を入力します。
- このページの Subscription settings セクションから、ご使用の Red Hat サブスクリプションオファリングに適用するサブスクリプション設定を選択します。
- 非接続クラスターを登録するには、Register cluster ボタンを選択します。
- サブスクリプションサービスでのサブスクリプションデータの表示方法 (サブスクリプションサービスのスタートガイド)
4.3.6. グローバルクラスタープルシークレットの更新 リンクのコピーリンクがクリップボードにコピーされました!
現在のプルシークレットを置き換えるか、新しいプルシークレットを追加することで、クラスターのグローバルプルシークレットを更新できます。
この手順は、インストール時に使用したレジストリーとは別のレジストリーにイメージを保存する必要がある場合に使用してください。
前提条件
-
cluster-admin
ロールを持つユーザーとしてクラスターにアクセスできる。
手順
オプション: 既存のプルシークレットに新しいプルシークレットを追加するには、以下の手順を実行します。
以下のコマンドを入力してプルシークレットをダウンロードします。
oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ <pull_secret_location>
$ oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ <pull_secret_location>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- プルシークレットファイルへのパスを含めます。
以下のコマンドを実行して、新しいプルシークレットを追加します。
oc registry login --registry="<registry>" \ --auth-basic="<username>:<password>" \ --to=<pull_secret_location>
$ oc registry login --registry="<registry>" \
1 --auth-basic="<username>:<password>" \
2 --to=<pull_secret_location>
3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow プルシークレットファイルを手動で更新することもできます。
以下のコマンドを実行して、クラスターのグローバルプルシークレットを更新します。
oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=<pull_secret_location>
$ oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=<pull_secret_location>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 新しいプルシークレットファイルへのパスを含めます。
この更新はすべてのノードにロールアウトされます。これには、クラスターのサイズに応じて多少時間がかかる場合があります。
注記OpenShift Container Platform 4.7.4 の時点で、グローバルプルシークレットへの変更によってノードドレインまたは再起動がトリガーされなくなりました。
関連情報