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 インスタンスに保管されます。
シナリオ | アクション |
---|---|
ロケーション・コントロール・プレーンの 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 の場所ではなく、パブリック・クラウドの場所にある可能性があることに留意してください。
- 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 のセットアップ
プラットフォーム・レベルのメトリックが有効になっている Satellite インスタンスに、IBM Cloud Monitoring の追加メトリックを転送して表示します。
ロケーションの Satellite Link コンポーネントのメトリックを使用して、特定の Link エンドポイントまたはそのロケーションのすべての Link エンドポイントのパフォーマンスをモニターできます。 例えば、作成した特定の Link エンドポイントの待ち時間またはスループットをモニターできます。
-
Monitoring インスタンスを作成するか、既存のものを選択します。
- Monitoring ロケーションの管理元と同じ IBM Cloud リージョンに Satellite インスタンスが既に存在しており、Monitoring インスタンスがプラットフォーム・メトリックを収集するよう構成されている場合、Satellite ロケーションに対して生成されるメトリックは、この Monitoring インスタンスに自動的に転送されます。
- それ以外の場合は、Monitoring ロケーション用に Satellite をセットアップします。
- Satellite ロケーションが管理されているのと同じ IBM Cloud リージョンに、 IBM Cloud Monitoring インスタンスをプロビジョニングします。
- プラットフォーム・レベルのメトリック収集を有効化します。 1 つのリージョン内で、プラットフォーム・メトリック収集用に有効化できる Monitoring インスタンスは 1 つのみであることに注意してください。
-
**「モニタリング」ダッシュボードで、Monitoring インスタンスに対して「ダッシュボードを開く」**をクリックします。
-
Monitoring ダッシュボードで、 Dashboards > > をクリックします。 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 |
ロケーション待ち時間
ロケーションのデータの合計往復時間 (ミリ秒)。
メタデータ | 説明 |
---|---|
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
リンク・エンドポイント・アドレスを使用して、新しいファイアウォール・ルールを開く必要がないようにすることができます。