Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

サポート

Red Hat build of MicroShift 4.19

MicroShift のサポートツールの使用

Red Hat OpenShift Documentation Team

概要

このドキュメントでは、MicroShift のサポートツールの使用方法を説明します。

第1章 etcd サービス
リンクのコピー

etcd サービスは、Red Hat build of MicroShift の RPM の一部として提供されます。etcd サービスは別のプロセスとして実行され、etcd ライフサイクルは MicroShift によって自動的に管理されます。

1.1. MicroShift etcd サーバーを観察してデバッグする
リンクのコピー

journalctl ログを収集して、etcd サーバーログを観察およびデバッグできます。

前提条件

  • MicroShift サービスが実行されている。

手順

  • etcd のログを取得するには、次のコマンドを実行します。 

    $ sudo journalctl -u microshift-etcd.scope
    Copy to Clipboard Toggle word wrap
    注記

    MicroShift ログは、journalctl -u microshift コマンドを使用して etcd ログとは別にアクセスできます。

1.2. etcd のバージョンの確認
リンクのコピー

必要な情報のレベルに応じて、次のいずれかまたは両方の方法を使用して、MicroShift に含まれている etcd データベースのバージョン情報を取得できます。

手順

  • ベースデータベースのバージョン情報を表示するには、次のコマンドを実行します。 

    $ microshift-etcd version
    Copy to Clipboard Toggle word wrap

    出力例

    microshift-etcd Version: 4.17.1
Base etcd Version: 3.5.13
    Copy to Clipboard Toggle word wrap

  • データベースの完全なバージョン情報を表示するには、次のコマンドを実行します。 

    $ microshift-etcd version -o json
    Copy to Clipboard Toggle word wrap

    出力例

    {
  "major": "4",
  "minor": "16",
  "gitVersion": "4.17.1~rc.1",
  "gitCommit": "140777711962eb4e0b765c39dfd325fb0abb3622",
  "gitTreeState": "clean",
  "buildDate": "2024-05-10T16:37:53Z",
  "goVersion": "go1.21.9"
  "compiler": "gc",
  "platform": "linux/amd64",
  "patch": "",
  "etcdVersion": "3.5.13"
}
    Copy to Clipboard Toggle word wrap

1.3. etcd のトラブルシューティング
リンクのコピー

etcd のトラブルシューティングを行い、パフォーマンスを向上させるには、サービスのメモリー許容量を設定します。

1.4. etcd サーバーのパラメーターを設定するための memoryLimitMB 値の設定
リンクのコピー

デフォルトでは、etcd はシステムの負荷を処理するために必要な量のメモリーを使用します。メモリーに制約のあるシステムでは、etcd が使用するメモリーの量を制限する必要がある場合があります。

手順

  • /etc/microshift/config.yaml ファイルを編集して、memoryLimitMB 値を設定します。 

    etcd:
  memoryLimitMB: 128
    Copy to Clipboard Toggle word wrap
    注記

    MicroShift の memoryLimitMB に必要な最小値は 128 MB です。最小値に近い値は、etcd のパフォーマンスに影響を与える可能性が高くなります。制限が低いほど、etcd がクエリーに応答するまでにかかる時間が長くなります。制限が低すぎる場合、または etcd の使用量が多い場合、クエリーはタイムアウトになります。

検証

  1. /etc/microshift/config.yaml の memoryLimitMB 値を変更した後、次のコマンドを実行して MicroShift を再起動します。 

    $ sudo systemctl restart microshift
    Copy to Clipboard Toggle word wrap

  2. 次のコマンドを実行して、新しい memoryLimitMB 値が使用されていることを確認します。 

    $ systemctl show --property=MemoryHigh microshift-etcd.scope
    Copy to Clipboard Toggle word wrap

第2章 sos レポートの使用
リンクのコピー

sos ツールを使用して、ホストに関するトラブルシューティング情報を収集できます。sos report コマンドは、システム内のさまざまなコンポーネントやアプリケーションから有効なプラグインとデータをすべて表示する詳細なレポートを生成します。

2.1. sos レポートについて
リンクのコピー

sos ツールは、さまざまなアプリケーションから情報を収集するのに役立つさまざまなプラグインで構成されています。MicroShift 固有のプラグインが sos バージョン 4.5.1 から追加されました。このプラグインは次のデータを収集できます。

  • MicroShift の設定およびバージョン
  • クラスター全体およびシステム namespace リソースの YAML 出力
  • OVN-Kubernetes 情報

2.2. sos レポートからのデータの収集
リンクのコピー

前提条件

  • sos パッケージがインストールされている。

手順

  1. 障害が発生したホストに root ユーザーとしてログインします。

  2. 次のコマンドを実行して、デバッグレポートの作成手順を実行します。 

    $ microshift-sos-report
    Copy to Clipboard Toggle word wrap

    出力例

    sosreport (version 4.5.1)

This command will collect diagnostic and configuration information from
this Red Hat Enterprise Linux system and installed applications.

An archive containing the collected information will be generated in
/var/tmp/sos.o0sznf_8 and may be provided to a Red Hat support
representative.

Any information provided to Red Hat will be treated in accordance with
the published support policies at:

        Distribution Website : https://www.redhat.com/
        Commercial Support   : https://www.access.redhat.com/

The generated archive may contain data considered sensitive and its
content should be reviewed by the originating organization before being
passed to any third party.

No changes will be made to system configuration.


 Setting up archive ...
 Setting up plugins ...
 Running plugins. Please wait ...

  Starting 1/2   microshift      [Running: microshift]
  Starting 2/2   microshift_ovn  [Running: microshift microshift_ovn]
  Finishing plugins              [Running: microshift]

  Finished running plugins

Found 1 total reports to obfuscate, processing up to 4 concurrently

sosreport-microshift-rhel9-2023-03-31-axjbyxw :    Beginning obfuscation...
sosreport-microshift-rhel9-2023-03-31-axjbyxw :    Obfuscation completed

Successfully obfuscated 1 report(s)

Creating compressed archive...

A mapping of obfuscated elements is available at
	/var/tmp/sosreport-microshift-rhel9-2023-03-31-axjbyxw-private_map

Your sosreport has been generated and saved in:
	/var/tmp/sosreport-microshift-rhel9-2023-03-31-axjbyxw-obfuscated.tar.xz

 Size	444.14KiB
 Owner	root
 sha256	922e5ff2db25014585b7c6c749d2c44c8492756d619df5e9838ce863f83d4269

Please send this file to your support representative.
    Copy to Clipboard Toggle word wrap

第3章 クラスター ID の取得
リンクのコピー

Red Hat サポートに情報を提供する際には、クラスターに固有の識別子を提供していただくと役に立ちます。MicroShift の場合は、OpenShift CLI (oc) を使用するか、ファイルから ID を取得して、クラスター ID を手動で取得できます。

注記

クラスター ID は、インストール後に MicroShift サービスが初めて実行された後にのみ作成されます。

3.1. 実行中のクラスターのクラスター ID 取得
リンクのコピー

実行中のクラスターの ID を取得するには、以下のいずれかの手順を使用します。

手順

  • 次のコマンドを入力して、oc get を使用して実行中のクラスターの ID を取得します。 

    $ oc get namespaces kube-system -o jsonpath={.metadata.uid}
    Copy to Clipboard Toggle word wrap

    出力例

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

  • 次のコマンドを入力して、cluster-id ファイルからクラスター ID を取得して、稼働中のクラスターの ID を取得します。 

    $ sudo cat /var/lib/microshift/cluster-id
    Copy to Clipboard Toggle word wrap

    出力例

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

3.2. 停止したクラスターのクラスター ID 取得
リンクのコピー

以前は実行されていたが現在は実行されていないクラスターの場合は、/var/lib/microshift ディレクトリーの cluster-id ファイルからクラスター ID を取得できます。

手順

  • 次のコマンドを入力して、停止したクラスターの ID を cluster-id ファイルから取得します。 

    $ sudo cat /var/lib/microshift/cluster-id
    Copy to Clipboard Toggle word wrap

    出力例

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

第4章 サポートを受ける
リンクのコピー

Red Hat build of MicroShift や Red Hat Enterprise Linux for Edge (RHEL for Edge) など、Red Hat Device Edge に関する詳細な内容は、以下の情報を参照してください。

4.1. サポートを受ける
リンクのコピー

このドキュメントで説明されている手順、または Red Hat build of MicroShift 全般に問題がある場合は、Red Hat カスタマーポータル にアクセスしてください。

カスタマーポータルでは、以下を行うことができます。

  • Red Hat 製品に関するアーティクルおよびソリューションを対象とした Red Hat ナレッジベースの検索またはブラウズ。
  • Red Hat サポートに対するサポートケースの送信。
  • その他の製品ドキュメントへのアクセス。

4.3. Red Hat ナレッジベースについて
リンクのコピー

Red Hat ナレッジベース は、お客様が Red Hat の製品やテクノロジーを最大限に活用できるようにするための豊富なコンテンツを提供します。Red Hat ナレッジベースは、Red Hat 製品のインストール、設定、および使用に関する記事、製品ドキュメント、および動画で構成されています。さらに、既知の問題に対する解決策を検索でき、それぞれに根本原因の簡潔な説明と修復手順が記載されています。

4.4. Red Hat ナレッジベースの検索
リンクのコピー

Red Hat build of MicroShift の問題が発生した場合には、初期検索を実行して、Red Hat ナレッジベースにソリューションがすでに存在しているかどうかを確認できます。

前提条件

  • Red Hat カスタマーポータルのアカウントがある。

手順

  1. Red Hat カスタマーポータル にログインします。
  2. Search をクリックします。

  3. 検索フィールドに、問題に関連する次のようなキーワードと文字列を入力します。

    • Red Hat build of MicroShift のコンポーネント (etcd など)
    • 関連する手順 (installation など)
    • 明示的な失敗に関連する警告、エラーメッセージ、およびその他の出力
  4. Enter キーをクリックします。
  5. オプション: 製品フィルターの Red Hat build of MicroShift を選択します。
  6. オプション: Documentation コンテンツタイプフィルターを選択します。

4.5. サポートケースの送信
リンクのコピー

前提条件

  • MicroShift サービスが実行されている。
  • OpenShift CLI (oc) がインストールされている。
  • Red Hat カスタマーポータルのアカウントがある。
  • Red Hat の Standard または Premium サブスクリプションがある。

手順

  1. Red Hat カスタマーポータルの Customer Support ページ にログインします。
  2. Get support をクリックします。

  3. Customer Support ページの Cases タブで、以下を行います。

    1. オプション: 必要に応じて、事前に入力されたアカウントと所有者の詳細を変更します。
    2. 問題に該当するカテゴリー (Bug、Defect など) を選択し、Continue をクリックします。

  4. 以下の情報を入力します。

    1. Summary フィールドには､問題の簡潔で説明的な概要と、確認されている現象および予想される動作の詳細情報を入力します。
    2. Product ドロップダウンメニューから Red Hat Device Edge を選択します。
    3. Version ドロップダウンから 4 を選択します。
  5. Red Hat ナレッジベースで推奨されるソリューション一覧を確認してください。この一覧に上げられているソリューションは、報告しようとしている問題に適用される可能性があります。提案されている記事が問題に対応していない場合は、Continue をクリックします。
  6. 報告している問題に対する一致に基づいて推奨される Red Hat ナレッジベースソリューションの一覧が更新されることを確認してください。ケース作成プロセスでより多くの情報を提供すると、このリストの絞り込みが行われます。提案されている記事が問題に対応していない場合は、Continue をクリックします。
  7. アカウント情報が予想通りに表示されていることを確認し、そうでない場合は適宜修正します。

  8. プロンプトが表示されたら、次の質問に回答します。使用しているインストールタイプ (RPM または埋め込みイメージ) も記載してください。Continue をクリックします。

    • What are you experiencing? What are you expecting to happen?
    • Define the value or impact to you or the business.
    • Where are you experiencing this behavior? What environment?
    • When does this behavior occur? Frequency? 繰り返し発生するのか。At certain times?
  9. 関連する診断データファイルをアップロードし、Continue をクリックします。sos ツールや etcd を使用して解決の手がかりとして収集したデータに加えて、それらのログに収集されなかった問題固有のデータも含めてください。
  10. 関連するケース管理の詳細情報を追加し、Continue をクリックします。
  11. ケースの詳細をプレビューし、Submit をクリックします。

第5章 接続されたクラスターによるリモートヘルスモニタリング
リンクのコピー

クラスターに関する Telemetry および設定データを収集し、Red Hat に報告できます。

5.1. MicroShift によるリモートヘルスモニタリングについて
リンクのコピー

MicroShift では、Telemeter API を使用して Red Hat に報告されるクラスターに関するテレメトリーと設定データを収集することで、リモートヘルスモニタリングが実行されます。Red Hat に Telemetry を報告するクラスターは、接続されたクラスター とみなされます。

Telemetry とは、MicroShift Telemeter API によって Red Hat に送信される情報を説明するために Red Hat が使用する用語です。軽量属性は、接続されたクラスターから Red Hat に送信され、クラスターの健全性を監視します。

Telemetry の利点

Telemetry には次のような利点があります。

  • 問題の特定および解決の強化。エンドユーザーにとっては正常と思われるイベントも、Red Hat ではより広い視点から観察できます。この視点により、一部の問題はより迅速に特定され、エンドユーザーがサポートケースを作成したり、Jira 問題 を作成しなくても解決することが可能です。
  • 新機能の明確な優先順位付け。収集されたデータは、システムの機能と使用特性に関する情報を提供します。この情報により、Red Hat はお客様に最も大きな影響を与える新機能の開発に重点的に取り組むことができます。

Telemetry は厳選されたクラスターモニタリングメトリクスのサブセットを Red Hat に送信します。Telemeter API は、1 時間ごとにメトリクス値を取得し、そのデータを Red Hat にアップロードします。このデータストリームは、Red Hat によって長期にわたってクラスターを監視するために使用されます。

Red Hat Support および Engineering チームは、サポートケースでレポートされるデータにアクセスする場合と同じ制限が適用された状態で、このデバッグ情報を使用できます。すべての 接続されたクラスター 情報は、MicroShift を改善するために Red Hat によって使用されます。

注記

MicroShift は Prometheus をサポートしていません。クラスターから収集された Telemetry を表示するには、Red Hat Support チームに連絡する必要があります。

5.2. MicroShift Telemetry API によって収集される情報
リンクのコピー

すべてのメトリクスを合計すると通常は 2 KB 未満となり、クラスターリソースを消費することは予想されません。

以下の情報は、Telemetry によって収集されます。

5.2.1. システム情報
リンクのコピー

システム情報には、MicroShift クラスターの基本設定とそれが実行されている場所が記述されます。次に例を示します。

  • MicroShift クラスターのバージョンを含むバージョン情報。
  • Red Hat Enterprise Linux (RHEL) バージョン。
  • RHEL のデプロイメントタイプ。

5.2.2. サイジング情報
リンクのコピー

サイジング情報には、クラスターの容量の詳細が示されます。次に例を示します。

  • MicroShift が使用できる CPU コア。
  • アーキテクチャー情報。
  • 使用可能なメモリーのバイト数。

5.2.3. 使用情報
リンクのコピー

使用状況情報には、クラスター内で何が起こっているかの概要が示されます。たとえば、次のようになります。

  • CPU 使用率 (パーセンテージ)。
  • メモリー使用率 (パーセンテージ)。
  • リソースタイプ (CRD) ごとの Kubernetes オブジェクトの数。
  • 実行中のコンテナー、namespace、および実行中の Pod の数。
  • ルート、Ingress、サービスの数。
注記

Telemetry は、ユーザー名やパスワードなどの識別情報を収集しません。Red Hat は、意図的な個人情報の収集は行いません。Red Hat は、個人情報が誤って受け取られたことを発見した場合、そのような情報を削除します。Telemetry データが個人データに該当する場合は、Red Hat プライバシーステートメント で Red Hat のプライバシー方針を確認してください。

5.2.4. リモートヘルスモニタリングデータの使用方法に関する追加情報
リンクのコピー

Red Hat は、サポートとトラブルシューティングの提供、サービスとユーザーエクスペリエンスの向上、問題への対応、該当する場合は請求などの目的で、Red Hat 製品の使用に関するデータを収集します。

収集における対策

Red Hat は、Telemetry データを保護するために設計された技術的および組織的な対策を採用しています。

共有

Red Hat は、ユーザーエクスペリエンスを向上させるために、Telemetry API を通じて収集したデータを Red Hat 内で共有する場合があります。Red Hat は、以下の目的で Red Hat のビジネスパートナーと、お客様を特定しない集約された形式で Telemetry およびデータを共有する場合があります。つまり、パートナーが市場およびお客様の Red Hat のオファリングの使用をより良く理解できるように支援することを目的とするか、それらのパートナーと共同でサポートしている製品の統合を効果的に行うことを目的としています。

サードパーティー

Red Hat は、Telemetry データの収集、分析、および保存を支援するために、特定のサードパーティーと連携する場合があります。

ユーザーコントロール: Telemetry データ収集の無効化

「MicroShift のリモートヘルスレポートのオプトアウト」セクションの手順に従って、MicroShift Telemetry を無効化できます。

5.3. MicroShift の Telemetry のオプトアウト
リンクのコピー

クラスターがネットワークに接続されていない場合、または Telemetry を収集したくない場合は、MicroShift 設定ファイルでパラメーターを無効にすることで、簡単に Telemetry をオプトアウトできます。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • クラスターへの root アクセス権限がある。

手順

  1. /etc/microshift/ ディレクトリーにある指定された config.yaml.default ファイルのコピーを作成し (まだ作成していない場合)、config.yaml という名前を付けます。

  2. 新しい MicroShift の config.yaml を /etc/microshift/ ディレクトリーに保持します。config.yaml ファイルは、MicroShift サービスが起動するたびに読み取られます。

    注記

    これを作成すると、config.yaml ファイルは組み込み設定よりも優先されます。

  3. オプション: 既存の MicroShift YAML を使用している場合は、設定スニペットを使用します。詳細は、関連情報 セクションの「設定スニペット」の使用を参照してください。

  4. MicroShift YAML の telemetry.status セクションを Disabled 値に設定します。

    無効にした Telemetry 設定の例

    apiServer:
# ...
telemetry:
    endpoint: https://infogw.api.openshift.com
    status: Disabled
# ...
    Copy to Clipboard Toggle word wrap

5.4. 関連情報
リンクのコピー

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat