IBM Cloud Docs
Satellite のモニタリング

Satellite のモニタリング

IBM Cloud Satellite® には、ロケーションとホストの正常性の確認など、Satellite リソースの正常性を管理するのに役立つ基本的なツールが付属しています。 さらに、Satellite およびその他の IBM Cloud リソースを IBM Cloud® Monitoring と統合して、すべてのリソースを管理するための包括的なビューとツールを取得できます。

Satellite ロケーションのモニタリングとご使用のロケーションで実行される IBM Cloud サービスのモニタリングは、個別にセットアップする必要があります。 例えば、Satellite ロケーション・セットアップのメトリックを収集するには、Monitoring インスタンスにより、ロケーションの管理元と同じリージョンでプラットフォーム・メトリックを収集できるようにします。 次に、Red Hat OpenShift on IBM Cloud ロケーションで実行される Satellite クラスターのメトリックを収集するために、クラスター内にモニタリング・エージェントを作成し、ポッド・メトリックが自動的に収集されて Monitoring インスタンスに転送されるようにします。 同じ Monitoring インスタンスを使用して、Satellite ロケーションと Satellite ロケーションで実行されるサービスの両方のメトリックを収集できることに注意してください。

デフォルトでログに記録されてモニターされる項目について

デフォルトで、Satellite は特定のアクティビティー・イベントを生成し、ロケーションとホストのリソースの状態をモニターします。

Satellite アクションのイベントの監査

Satellite の監査イベントを参照してください。

ロケーション・アラートを解決して報告するための IBM モニタリング

Satellite ロケーションを作成してロケーション・コントロール・プレーンをセットアップすると、IBM により、ロケーション・セットアップとホスト・インフラストラクチャーに関する問題の特定のアラートが自動的にモニターされて解決されます。 次の表は、さまざまなシナリオおよびそれらのシナリオに対処するために IBM が実行するアクションを示しています。

さらに、Satellite ロケーションをセットアップしてログを IBM Cloud Logs に転送する場合は、IBM Monitoring コンポーネントからのメッセージと詳細情報が収集され、IBM Cloud Logs インスタンスに保管されます。

特定のシナリオに対処するためのIBM モニター・アクション。
シナリオ アクション
ロケーション・コントロール・プレーンの 3 つの個別ゾーンに、ホストがありません。 ロケーション内の接続された未割り当てホストを確認します。 ホストが使用可能である場合、欠落しているゾーンのロケーション・コントロール・プレーンにそのホストを割り当てて、ラベルがゾーンと一致するホストを優先します。
ゾーン内のクラスター容量が 80% を超えています。 Red Hat OpenShift クラスターの作成を防止または許可します。 コンピュート・リソースを増加させるために、使用可能なホストをロケーション・コントロール・プレーンに割り当てます。
Red Hat OpenShift クラスターの状態が異常です。 Red Hat OpenShift クラスターでの特定の正常性に関する問題を解決します。
Prometheus などのデフォルトのモニタリング・ツールが機能しません。 IBM Cloud Logs インスタンスにアラートを送信し、詳細なトラブルシューティング情報を含む状況メッセージを返します。
Ingress サブドメインの登録が失敗します。 IBM エンジニアに、さらに問題をトラブルシューティングするようアラートし、詳細なトラブルシューティング情報を含む状況メッセージを返します。

ロケーション、ホスト、およびクラスターの正常性の表示

クラスター内で実行される Satellite リソース (ロケーション、ホスト、クラスター Kubernetes リソースなど) の正常性を確認できます。

ロケーションの正常性の表示

Satellite ロケーションをセットアップすると、IBM Cloud によりホストがモニターされ、ロケーションを正常に保つために使用可能な状況が報告されます。 詳しくは、ロケーション・アラートを解決して報告するための IBM モニタリングを参照してください。 トラブルシューティングのヘルプについては、ロケーションの正常性のデバッグを参照してください。

ホストの健全性は、 Satellite コンソールの Locations テーブルから、または ibmcloud sat location ls を実行して確認できます。

ロケーションの正常性の状態
正常性の状態 説明
action required ロケーションに注意が必要です。 状況およびメッセージで詳細を確認し、ロケーションのデバッグを試行します。
completed Satellite により、コントロール・プレーンに割り当てたホスト上で、ロケーション・コントロール・プレーン・コンポーネントのセットアップが完了しました。 間もなく、ロケーションを使用する準備が整います。
completing Satellite により、コントロール・プレーンに割り当てたホスト上で、ロケーション・コントロール・プレーン・コンポーネントのセットアップが進行中です。 しばらくしてからもう一度確認してください。
critical Satellite ロケーション・コントロール・プレーンに注意が必要です。 状況およびメッセージで詳細を確認し、ロケーション・コントロール・プレーンのデバッグを試行します。
failed Satellite により、ロケーションでの問題が正常に解決されませんでした。 詳しくは、状況メッセージを参照してください。
host required Satellite ロケーションは作成されましたが、ロケーション・コントロール・プレーンにホストを割り当てる必要があります。 6、9、12 など、3 の倍数でホストを割り当てます。
normal Satellite ロケーションを使用する準備が整いました。
provisioning Satellite のコントロール・プレーンはプロビジョニング中です。 コントロール・プレーンの準備が整うまで、ロケーション内のその他の Satellite リソース (クラスターなど) に、ホストを割り当てることはできません。
resolving Satellite により、使用可能なホストをコントロール・プレーンに割り当てて容量の問題を軽減するなどして、問題の解決が試行されています。 詳しくは、状況メッセージを参照してください。

ホストの正常性の表示

ホストを Satellite ロケーションに接続すると、IBM Cloud によりホストがモニターされ、ホストを正常に保つために使用可能な状況が報告されます。 詳しくは、ロケーション・アラートを解決して報告するための IBM モニタリングを参照してください。 トラブルシューティングのヘルプについては、ホストの正常性のデバッグを参照してください。

ホストの健全性は、 Satellite コンソールの Hosts テーブルから、または ibmcloud sat host ls --location <location_name_or_ID> を実行して確認できます。

ホストの正常性の状態。
正常性の状態 説明
assigned ホストは Satellite リソース (ロケーション・コントロール・プレーンやクラスターなど) に割り当てられています。 詳細については、状況 (「Status」) を確認してください。 状況が - の場合、ホストは Satellite リソースになるためのブートストラッピング・プロセスを完了していません。 ホストを割り当てて間もない場合は、プロセスが完了するまで 1 時間ほど待ってください。 それでもこの状況が表示される場合は、 ホストにログインしてデバッグを続けてください
health-pending このホストはクラスターに割り当てられ、プロビジョンとデプロイが完了したワーカー・ノードとしてブートストラップされています。 ただし、このホストに IBM がセットアップした正常性コンポーネントから、IBM Cloud に状況を報告することができません。 ホストがホストおよびネットワークの最小接続要件を満たしていること、また、ホストがインフラストラクチャー・プロバイダーのファイアウォールでブロックされていないことを確認してください。
provisioning ホストは Satellite ロケーションに接続されていて、Satellite リソースの一部 (Red Hat OpenShift on IBM Cloud クラスターのワーカー・ノードなど) になるためのブートストラッピングの処理中です。 ホストから provisioning 状態が報告される間、ワーカー・ノードはプロビジョニング状態、デプロイ状態へと遷移します。 この状態のときにホストにログインして、ログを表示することができます。 デバッグするための RHEL ホスト・マシンへのログイン および デバッグするための RHCOS ホスト・マシンへのログイン を参照してください。
ready ホストは Satellite ロケーションに接続されていて、いつでも Satellite リソースに割り当てることができる状態です。
normal ホストは Satellite リソース (ロケーション・コントロール・プレーンやクラスターなど) に割り当てられていて、いつでも使用できる状態です。
reload-required ホストは Satellite ロケーションに接続されていますが、Satellite リソースに割り当てるためには再ロードする必要があります。 例えば、Satellite クラスターを削除し、そのクラスターのすべてのホストを再ロードする必要があるとします。 ホストを再ロードするには、ロケーションからホストを削除し、基盤インフラストラクチャー・プロバイダーでオペレーティング・システムを再ロードしてから、再びロケーションに ホストを接続する必要があります。
unassigned ホストは Satellite ロケーションに接続されていて、いつでも Satellite リソースに割り当てることができる状態です。 ホストの割り当ての試行に失敗した場合は、クラスターにホストを割り当てできない場合の対処を参照してください。
unknown ホストの正常性が不明です。 ホストが割り当て解除されている場合は、クラスターなどの Satellite リソースに対して ホストの割り当て を試行します。 ホストが割り当てられている場合は、ホストの正常性のデバッグの手順に従って、ホストのデバッグを試行してください。 ホストにまだ問題がある場合は、ホストの削除、更新、および再接続を試行してください。
unresponsive この 5 分間、ホストは Satellite ロケーション・コントロール・プレーンと通信していません。 応答しないホストは割り当てることができません。 ホストの正常性のデバッグを試し、特にネットワーク接続についてデバッグしてください。

クラスターの正常性の表示

Red Hat OpenShift on IBM Cloud ロケーションで実行される Satellite クラスターの正常性を確認するには、Red Hat OpenShift on IBM Cloud の資料を参照してください。

クラスター内の Kubernetes リソースの表示

クラスターを Satellite 構成に追加すると、Kubernetes リソースは、ユーザーが確認可能なインベントリーに自動的に追加されます。 詳しくは、 Satellite 構成を使用したアプリの管理 を参照してください。

Satellite 構成にクラスターを追加しても、IBM Cloud Logs や IBM Cloud Monitoring など、ロギングおよびモニタリングのソリューションは自動的にはセットアップされません。

クラスターの Satellite Config 登録状況の表示

Satellite Config で使用可能なクラスターの登録状況を表示できます。 クラスタによっては、 Satellite の場所ではなく、パブリック・クラウドの場所にある可能性があることに留意してください。

  1. Satellite Config に登録されているクラスターをリストします。 Status 列と Location 列の出力をメモします。
    ibmcloud sat cluster ls
    
  2. 以下の Satellite Config 登録状況を確認します。
ホストの正常性の状態。
ステータス 説明
active ロケーション用の Satellite Config コンポーネントがクラスターにインストールされていて、少なくとも 1 つのリソースが監視されています。
inactive Satellite Config コンポーネントがクラスターから手動で削除されています。あるいは、インストールされてはいるものの Satellite Config に応答しなくなっています。 例えば、ネットワーク接続が切断されている可能性があります。 既存のリソースは実行され続けますが (ある場合)、更新を受け取ることはありません。 この問題を解決するには、Satellite ロケーションまたは クラスターをデバッグしてみてください。
registered Satellite Config コンポーネントがクラスターにインストールされていますが、現在監視されているリソースはありません。 Watch-keeper をセットアップするには、 Reviewing resources that are managed by Satellite Config を参照してください。

Monitoring ロケーション・プラットフォーム・メトリック用の Satellite のセットアップ

プラットフォーム・レベルのメトリックが有効になっている Satellite インスタンスに、IBM Cloud Monitoring の追加メトリックを転送して表示します。

ロケーションの Satellite Link コンポーネントのメトリックを使用して、特定の Link エンドポイントまたはそのロケーションのすべての Link エンドポイントのパフォーマンスをモニターできます。 例えば、作成した特定の Link エンドポイントの待ち時間またはスループットをモニターできます。

  1. Monitoring インスタンスを作成するか、既存のものを選択します。

    • Monitoring ロケーションの管理元と同じ IBM Cloud リージョンに Satellite インスタンスが既に存在しており、Monitoring インスタンスがプラットフォーム・メトリックを収集するよう構成されている場合、Satellite ロケーションに対して生成されるメトリックは、この Monitoring インスタンスに自動的に転送されます。
    • それ以外の場合は、Monitoring ロケーション用に Satellite をセットアップします。
      1. Satellite ロケーションが管理されているのと同じ IBM Cloud リージョンに、 IBM Cloud Monitoring インスタンスをプロビジョニングします。
      2. プラットフォーム・レベルのメトリック収集を有効化します。 1 つのリージョン内で、プラットフォーム・メトリック収集用に有効化できる Monitoring インスタンスは 1 つのみであることに注意してください。
  2. **「モニタリング」ダッシュボードで、Monitoring インスタンスに対して「ダッシュボードを開く」**をクリックします。

  3. Monitoring ダッシュボードで、 Dashboards > > をクリックします。 IBM > Satellite Link- 概要 ]をクリックします。 Satellite Link メトリック用の事前定義済みダッシュボードが開きます。 この Monitoring インスタンスを作成してから **IBM ** ダッシュボードが使用可能になるまでに最大で 2 時間ほどかかる場合があります。

    このダッシュボードのコピーを作成して、表示されているメトリックをカスタマイズできます。 IBM Cloud Satellite に対して有効なメトリックを追加するには、ibm_satellite_link 接頭部を検索します。

  4. 使用可能なメトリックおよびセグメント化の属性を確認します。

  5. プラットフォーム・メトリックを処理できる方法をさらに検討します。

Monitoring Link メトリック用に事前定義されているダッシュボードを Satellite でセットアップすると、Satellite ロケーションのコンソールの**「Link エンドポイント (Link endpoints)」タブから「モニタリングの起動」**をクリックして、そのダッシュボードに素早くアクセスできるようになります。

使用可能なメトリック

Satellite ロケーション・コントロール・プレーンでは、以下のメトリックを使用できます。

セグメント化のための属性

Satellite メトリックのセグメント化に使用可能な、以下のグローバル属性および追加属性を確認します。

グローバル属性

以下のグローバル属性は、すべての 使用可能なメトリックをセグメント化するために使用できます。

メトリック・セグメント化のグローバル属性
属性 属性名 属性の説明
Cloud Type ibm_ctype クラウド・タイプ。パブリック、専用、またはローカルに設定できます
Location ibm_location モニターされるリソースのロケーション。リージョン、データ・センター、またはグローバルに設定できます
Resource ibm_resource サービスで測定されているリソース。通常、識別名または GUID として報告されます
Resource Type ibm_resource_type サービスで測定されているリソースのタイプ
Resource group ibm_resource_group_name Satellite ロケーションが作成されたリソース・グループ
Scope ibm_scope メトリックに関連付けられるアカウント GUID
Service name ibm_service_name このメトリックを生成するサービスの名前

追加の属性

Satellite に固有の以下の追加属性は、1 つ以上の使用可能なメトリックのセグメント化に使用できます。 使用可能なセグメント化属性を判別するには、各メトリックの Segment By フィールドを参照してください。

メトリック・セグメント化の追加属性
属性 属性名 属性の説明
Endpoint ID ibm_satellite_link_endpoint_id エンドポイントの ID
Endpoint Name ibm_satellite_link_endpoint_name エンドポイントの名前
Location ID ibm_satellite_link_location_id ロケーションの ID
Service instance ibm_service_instance サービス・インスタンス・セグメントは、メトリックが関連付けられているインスタンスを示します
Service instance name ibm_service_instance_name サービス・インスタンスのユーザー提供の名前。アカウント内のリージョン全体で固有でない場合があります

クラスターのモニタリングのセットアップ

現在、 Red Hat OpenShift on IBM Cloud コンソールを使用して、 Satellite クラスタのモニタリングを有効にすることはできません。 メトリックを Monitoring に転送するには、モニタリング・エージェントをクラスターに手動でデプロイする必要があります。

Satellite ロケーションで実行される Red Hat OpenShift クラスターのモニタリングをセットアップするには、 Red Hat OpenShift クラスターへのモニター・エージェントのデプロイ を参照してください。 COLLECTOR_ENDPOINT のアドレスを指定する場合、 satellite-sysdig リンク・エンドポイント・アドレスを使用して、新しいファイアウォール・ルールを開く必要がないようにすることができます。