Satellite のモニタリング

IBM Cloud Satellite® ロケーション、ホスト、クラスター、およびLinkエンドポイントの状態を監視するための組み込みツールを提供します。

Satellite の拠点およびその拠点で実行されている IBM Cloud サービスに対する監視には、個別の設定が必要です。ロケーションプラットフォームのメトリクスを収集するには、ロケーションを管理しているのと同じリージョンで Monitoring インスタンスを有効にしてください。 Satellite のロケーションにある Red Hat OpenShift on IBM Cloud クラスターからPodのメトリクスを収集するには、クラスター内にモニタリングエージェントをデプロイし、メトリクスを Monitoring インスタンスに転送するように設定します。 1つの Monitoring インスタンスで、 Satellite のロケーションと、そこで実行されているサービスの両方のメトリクスを収集します。

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

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

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

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 のリソースなど）の正常性を確認します。

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

IBM Cloud Satellite のロケーションホストを監視し、ステータスを報告します。「 IBM 」の監視アラートおよびロケーションの健全性のデバッグについては、こちらをご覧ください。

ホストの正常性は、 Satellite コンソールの「 ロケーション 」テーブルから確認するか、 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` 状態が報告される間、ワーカー・ノードはプロビジョニング状態、デプロイ状態へと遷移します。この状態のときにホストにログインして、ログを表示することができます。 Satellite ホストで SSH を有効にするを参照のこと。
`ready`	ホストは Satellite ロケーションに接続されていて、いつでも Satellite リソースに割り当てることができる状態です。
`normal`	ホストは Satellite リソース (ロケーション・コントロール・プレーンやクラスターなど) に割り当てられていて、いつでも使用できる状態です。
`reload-required`	ホストは Satellite ロケーションに接続されていますが、Satellite リソースに割り当てるためには再ロードする必要があります。たとえば、 Satellite クラスタを削除した場合、そのクラスタに属するすべてのホストで再読み込みが必要になります。ホストを再ロードするには、ロケーションからホストを削除し、基盤インフラストラクチャー・プロバイダーでオペレーティング・システムを再ロードしてから、再びロケーションにホストを接続する必要があります。
`unassigned`	ホストは Satellite ロケーションに接続されていて、いつでも Satellite リソースに割り当てることができる状態です。ホストの割り当ての試行に失敗した場合は、クラスターにホストを割り当てできない場合の対処を参照してください。
`unknown`	ホストの正常性が不明です。ホストが割り当て解除されている場合は、クラスターなどの Satellite リソースに対してホストの割り当てを試行します。ホストが割り当てられている場合は、ホストの正常性のデバッグの手順に従って、ホストのデバッグを試行してください。ホストにまだ問題がある場合は、ホストの削除、更新、および再接続を試行してください。
`unresponsive`	この 5 分間、ホストは Satellite ロケーション・コントロール・プレーンと通信していません。応答しないホストは割り当てることができません。ホストの正常性のデバッグを試し、特にネットワーク接続についてデバッグしてください。

Satellite コンソールで「 Hosts 」テーブルを表示すると、対応が必要なコントロールプレーンホストには、更新されたステータスラベルが表示されます。「 対応が必要 」というラベル（旧「警告」）は、そのホストに注意が必要であることを示しています。「 交換が必要 」というラベルは、そのホストが著しく古くなっており、交換が必要であることを示しています。どちらのステータスにも、ホストの更新手順へのリンクが記載されたツールチップが表示されます。詳細については、「更新が必要なコントロールプレーンホストの特定」を参照してください。

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

Satellite のクラスタの状態を確認するには、『 Red Hat OpenShift on IBM Cloud 』のドキュメントを参照してください。

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

Satellite 構成に追加されたクラスターについては、その Kubernetes リソースが自動的にインベントリ登録され、確認が可能になります。

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

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

Satellite Config が有効になっているクラスター（パブリッククラウドのロケーションにあるものを含む）の登録状況を確認します。

Satellite Config に登録されているクラスターをリストします。 Status 列と Location 列の出力をメモします。
```
ibmcloud sat cluster ls
```
以下の 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 のセットアップ

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

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

Monitoring インスタンスを作成するか、既存のものを選択します。
- Monitoring ロケーションの管理元と同じ IBM Cloud リージョンに Satellite インスタンスが既に存在しており、Monitoring インスタンスがプラットフォーム・メトリックを収集するよう構成されている場合、Satellite ロケーションに対して生成されるメトリックは、この Monitoring インスタンスに自動的に転送されます。
- それ以外の場合は、Monitoring ロケーション用に Satellite をセットアップします。
  1. Satellite のロケーションが管理されているのと同じ IBM Cloud リージョンに、 IBM Cloud Monitoring インスタンスをプロビジョニングします。
  2. プラットフォーム・レベルのメトリック収集を有効化します。 1つのリージョン内では、プラットフォームメトリクスの収集が有効になっている Monitoring インスタンスは、一度に1つだけです。
**「モニタリング」ダッシュボードで、Monitoring インスタンスに対して「ダッシュボードを開く」**をクリックします。
「 Monitoring 」ダッシュボードで、[ ダッシュボード ] > IBM > [ Satellite Link- 概要 ] をクリックします。 Satellite Link メトリック用の事前定義済みダッシュボードが開きます。新しく作成された Monitoring インスタンスでは、 IBM ダッシュボードが利用可能になるまで、最大2時間かかります。

このダッシュボードのコピーを作成して、表示されているメトリックをカスタマイズできます。 IBM Cloud Satellite に対して有効なメトリックを追加するには、ibm_satellite_link 接頭部を検索します。
使用可能なメトリックおよびセグメント化の属性を確認します。
プラットフォーム・メトリックを処理できる方法をさらに検討します。

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

使用可能なメトリック

Satellite のロケーション制御プレーンでは、以下のメトリクスを確認できます。

ロケーション・トンネルの数

エンドポイントに存在する、Satellite Link トンネル・サーバーの総数。ロケーションの 3 つのアベイラビリティー・ゾーン間の冗長性をサポートするために、トンネル・サーバーとコネクターの間に 3 つのトンネルが作成されます。

「ロケーション・トンネル番号」メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_location_tunnel_count`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

ロケーション待ち時間

その場所におけるデータの往復時間（RTT）の合計（単位：ミリ秒）。 RTTは、データパケットが特定の場所から IBM Cloud まで行き、戻ってくるのにかかる時間を測定します。

ロケーション待ち時間メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_location_rtt_second`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

クラウドへのロケーション・トラフィック

ロケーションのクラウドへの方向でのデータの合計速度 (バイト/秒)。

クラウドへのロケーション・トラフィック・メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_location_to_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

クラウドからのロケーション・トラフィック

ロケーションのクラウドからの方向でのデータの合計速度 (バイト/秒)。

クラウドからのロケーション・トラフィック・メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_location_from_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

ロケーション・トラフィック合計

ロケーションのクラウドに対する双方向でのデータの合計速度 (バイト/秒)。

「ロケーション・トラフィック合計」メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_location_total_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

エンドポイント接続数

エンドポイントに存在する接続の総数。

「エンドポイント接続数」メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_endpoint_connection_count`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

クラウドへのエンドポイント・トラフィック

エンドポイントのクラウドへの方向でのデータの速度 (バイト/秒)。

「クラウドへのエンドポイント・トラフィック」メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_endpoint_to_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

クラウドからのエンドポイント・トラフィック

エンドポイントのクラウドからの方向でのデータの速度 (バイト/秒)。

クラウドからのエンドポイント・トラフィックのメタデータ・メトリック
メタデータ	説明
`Metric Name`	`ibm_satellite_link_endpoint_from_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

エンドポイント・トラフィック合計

エンドポイントのクラウドに対する双方向でのデータの合計速度 (バイト/秒)。

「エンドポイント・トラフィック合計」メトリックのメタデータ
メタデータ	説明
`Metric Name`	`ibm_satellite_link_endpoint_total_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

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

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 リンク・エンドポイント・アドレスを使用して、新しいファイアウォール・ルールを開く必要がないようにすることができます。