This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.16.4. サービスを関しするための Cluster Observability Operator 設定
Cluster Observability Operator はテクノロジープレビュー機能としてのみ使用できます。テクノロジープレビュー機能は、Red Hat 製品サポートのサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではない場合があります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
Cluster Observability Operator (COO) で管理されるモニタリングスタックを設定することで、サービスのメトリクスを監視できます。
サービスのモニタリングをテストするには、次の手順に従います。
- サービスエンドポイントを定義するサンプルサービスをデプロイします。
-
COO によるサービスのモニタリング方法を指定する
ServiceMonitorオブジェクトを作成します。 -
ServiceMonitorオブジェクトを検出するためのMonitoringStackオブジェクトを作成します。
16.4.1. Cluster Observability Operator のサンプルサービスをデプロイする リンクのコピーリンクがクリップボードにコピーされました!
この設定では、ユーザー定義の ns1-coo プロジェクトに prometheus-coo-example-app という名前のサンプルサービスをデプロイします。このサービスは、カスタム version メトリクスを公開します。
前提条件
-
cluster-adminクラスターロールを持つユーザーとして、または namespace の管理権限を持つユーザーとして、クラスターにアクセスできる。
手順
prometheus-coo-example-app.yamlという名前の YAML ファイルを作成します。このファイルには、namespace、デプロイメント、およびサービスに関する次の設定の詳細が含まれます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ファイルを保存します。
次のコマンドを実行して、設定をクラスターに適用します。
oc apply -f prometheus-coo-example-app.yaml
$ oc apply -f prometheus-coo-example-app.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して出力を確認し、Pod が実行されていることを確認します。
oc -n -ns1-coo get pod
$ oc -n -ns1-coo get podCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME READY STATUS RESTARTS AGE prometheus-coo-example-app-0927545cb7-anskj 1/1 Running 0 81m
NAME READY STATUS RESTARTS AGE prometheus-coo-example-app-0927545cb7-anskj 1/1 Running 0 81mCopy to Clipboard Copied! Toggle word wrap Toggle overflow
16.4.2. Cluster Observability Operator によるサービスのモニタリング方法を指定する リンクのコピーリンクがクリップボードにコピーされました!
「Cluster Observability Operator のサンプルサービスをデプロイする」セクションで作成したサンプルサービスが公開するメトリクスを使用するには、/metrics エンドポイントからメトリクスを取得するようにモニタリングコンポーネントを設定する必要があります。
この設定は、サービスのモニタリング方法を指定する ServiceMonitor オブジェクト、または Pod のモニタリング方法を指定する PodMonitor オブジェクトを使用して作成できます。ServiceMonitor オブジェクトには Service オブジェクトが必要です。PodMonitor オブジェクトには必要ないため、MonitoringStack オブジェクトは Pod が公開するメトリクスエンドポイントから直接メトリクスを取得できます。
この手順は、ns1-coo namespace に prometheus-coo-example-app という名前のサンプルサービスの ServiceMonitor オブジェクトを作成する方法を示しています。
前提条件
-
cluster-adminクラスターロールを持つユーザーとして、または namespace の管理権限を持つユーザーとして、クラスターにアクセスできる。 - Cluster Observability Operator がインストールされている。
prometheus-coo-example-appサンプルサービスをns1-coonamespace にデプロイしている。注記prometheus-example-appサンプルサービスは、TLS 認証をサポートしていません。
手順
次の
ServiceMonitorオブジェクト設定の詳細を含む YAML ファイルを、example-coo-app-service-monitor.yamlという名前で作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow この設定は、
prometheus-coo-example-appサンプルサービスが公開するメトリクスデータを収集するためにMonitoringStackオブジェクトが参照するServiceMonitorオブジェクトを定義します。次のコマンドを実行して、設定をクラスターに適用します。
oc apply -f example-app-service-monitor.yaml
$ oc apply -f example-app-service-monitor.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して出力を観察し、
ServiceMonitorリソースが作成されたことを確認します。oc -n ns1-coo get servicemonitor
$ oc -n ns1-coo get servicemonitorCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME AGE prometheus-coo-example-monitor 81m
NAME AGE prometheus-coo-example-monitor 81mCopy to Clipboard Copied! Toggle word wrap Toggle overflow
16.4.3. Cluster Observability Operator の MonitoringStack オブジェクトを作成する リンクのコピーリンクがクリップボードにコピーされました!
ターゲット prometheus-coo-example-app サービスが公開するメトリクスデータを収集するには、「Cluster Observability Operator でサービスを監視する方法を指定する」セクションで作成した ServiceMonitor オブジェクトを参照する MonitoringStack オブジェクトを作成します。この MonitoringStack オブジェクトはサービスを検出し、そこから公開されているメトリクスデータを収集できます。
前提条件
-
cluster-adminクラスターロールを持つユーザーとして、または namespace の管理権限を持つユーザーとして、クラスターにアクセスできる。 - Cluster Observability Operator がインストールされている。
-
prometheus-coo-example-appサンプルサービスをns1-coonamespace にデプロイしている。 -
ns1-coonamespace に、prometheus-coo-example-monitorという名前のServiceMonitorオブジェクトを作成している。
手順
-
MonitoringStackオブジェクト設定の YAML ファイルを作成します。この例では、ファイル名をexample-coo-monitoring-stack.yamlにします。 以下の
MonitoringStackオブジェクト設定の詳細を追加します。MonitoringStackオブジェクトの例Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、
MonitoringStackオブジェクトを適用します。oc apply -f example-coo-monitoring-stack.yaml
$ oc apply -f example-coo-monitoring-stack.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行し、出力で
MonitoringStackオブジェクトが利用可能であることを確認します。oc -n ns1-coo get monitoringstack
$ oc -n ns1-coo get monitoringstackCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME AGE example-coo-monitoring-stack 81m
NAME AGE example-coo-monitoring-stack 81mCopy to Clipboard Copied! Toggle word wrap Toggle overflow