第3章 OCP 上の Fuse Online の管理
オンサイトで Fuse Online を OpenShift Container Platform (OCP) にインストールしたら、Prometheus を使用してインテグレーションアクティビティーを監視し、Fuse Online 環境の復元に使用できる Fuse Online の定期的なバックアップを設定できます。必要に応じて、Fuse Online のアップグレード、Fuse Online のアンインストール、または Fuse Online が含まれる OCP プロジェクトの削除を行うことができます。
詳細は以下のトピックを参照してください。
3.1. Prometheus での Fuse Online インテグレーションおよびインフラストラクチャーコンポーネントの監視
Prometheus を使用して Fuse Online インフラストラクチャーコンポーネントおよび Fuse Online インテグレーションを監視できます。Grafana ダッシュボードを使用して、Prometheus によって収集されるメトリックを可視化することもできます。
Prometheus に対する Red Hat のサポートは、Red Hat 製品ドキュメントに記載されているセットアップと推奨設定に限定されます。
Grafana はコミュニティーがサポートする機能です。Grafana をデプロイして Red Hat Fuse 製品を監視する設定は、Red Hat の実稼働環境におけるサービスレベルアグリーメント (SLA) の対象外です。
Fuse Online インテグレーションを監視する他に、Prometheus を使用して以下の Fuse Online インフラストラクチャーコンポーネントによって公開されるメトリックを監視できます。
- Syndesis Server
-
syndesis-server
コンポーネントは Micrometer でインストルメント化され、デフォルトですべての JVM Micrometer メトリックを自動的に公開します。さらに、syndesis-server
は要求レート、エラーレート、レイテンシーなどの REST API エンドポイントに関するメトリックを公開します。 - Syndesis Meta
-
syndesis-meta
コンポーネントは Micrometer でインストルメント化され、デフォルトですべての JVM Micrometer メトリックを自動的に公開します。また、REST API エンドポイントについてのメトリックも公開します。 - Syndesis DB
- Fuse Online Postgres データベースのメトリックは、サードパーティーの Prometheus エクスポーター を使用してエクスポートされます。
- インテグレーション
-
integration
メトリックは、インテグレーションが作成され、デフォルトで複数の JVM メトリックを公開する公式の JMX エクスポーターを使用してエクスポートされた後に表示されます。さらに、integration メトリックは、メッセージレートやエラーレートなどの Apache Camel 固有のメトリックを公開します。
前提条件
- オンサイトで Fuse Online が OCP にインストールされ、稼働している必要があります。
-
oc
クライアントツールがインストール済みであり、Fuse Online がインストールされている OCP クラスターに接続されている。 -
Fuse Online の namespace にアクセスできる
admin
権限が必要です。 -
ユーザー名とパスワードを知っている Red Hat Developer のアカウントが必要です。
https://developers.redhat.com
に対して認証できるよう、インストールスクリプトから認証情報を求められます。アカウントの作成に関する詳細は、Red Hat レジストリーへのアクセスおよびその設定 を参照してください。 -
cluster admin
権限のあるユーザーが、これらのインストール手順 にしたがって、Application Monitoring Operator (具体的にはタグv1.1.6
) を使用して Prometheus および Grafana をデプロイ済みである必要があります。
手順
Fuse Online namespace で以下のコマンドを使用して
monitoring-key=middleware
ラベルを設定します。oc label namespace <fuse-online-namespace> monitoring-key=middleware
Fuse Online インストールでアプリケーション監視設定リソースが OpenShift クラスターに追加されたことを確認します。
-
OpenShift Web コンソールで、
application-monitoring
プロジェクトに移動し、prometheus-route
URL を開きます。 Prometheus コンソールで、Status
Targets ページに移動します。 Syndesis
ターゲットがリストされている場合は、Fuse Online が監視用に設定されているため、ステップ 4 に進みます。Syndesis
ターゲットがリストにない場合は、ステップ 3 に進みます。
-
OpenShift Web コンソールで、
別の OpenShift プロジェクトにインストールされた Prometheus インスタンスで監視するために Fuse Online を公開するには、
syndesis
カスタムリソースでops
アドオンを有効にします。Fuse Online の namespace に移動します。
OpenShift 4.x OpenShift 3.11 -
OpenShift Web コンソールで、Fuse Online (
syndesis
) プロジェクトに移動します。 - Catalog > Installed Operators の順に選択し、Fuse Online Operator をクリックします。
- Syndesis CRD をクリックし、app をクリックします。
-
Yaml をクリックし、エディターで
yaml
ファイルを開きます。
- Resources > Other Resources の順に選択します。
- ドロップダウンメニューから、Syndesis リソースタイプを選択します。
-
app リソースの Actions をクリックし、Edit YAML を選択してエディターで
yaml
ファイルを開きます。
-
OpenShift Web コンソールで、Fuse Online (
yaml
ファイルを編集し、以下の行を追加してSyndesis.Spec.Addons.Ops.Enable
値を true に設定します。spec: addons: ops: enabled: true
- ファイルを保存します。
Pod が再起動するまで待機します。
注記Fuse Online インフラストラクチャーリソースは、インストールコマンドの実行直後には使用できません。Prometheus Targets ページに Fuse Online (Syndesis) ターゲットが表示されるまで待機する必要がある場合があります。
Prometheus にアクセスするには、以下を実行します。
- アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートのリストを開きます。
- prometheus-route エントリーの横にあるホスト名 URL をクリックし、Prometheus コンソールを開きます。
- Fuse Online インフラストラクチャーコンポーネントに設定されたアラートルールのリストを表示するには、Alerts メニュー項目をクリックします。
Grafana ダッシュボードにアクセスするには、以下を実行します。
- アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートのリストを開きます。
- grafana-route エントリーの横にあるホスト名 URL をクリックし、Grafana コンソールを開きます。
Grafana コンソールの上部で、ダッシュボードセレクターをクリックします。
- Fuse Online インテグレーションでは、Integration - Camel を選択します。このダッシュボードには、Apache Camel インテグレーションアプリケーションによって公開される標準メトリックが表示されます。
Fuse Online インフラストラクチャーコンポーネントでは、以下のインフラストラクチャーダッシュボードのいずれかを選択します。
- Infrastructure - DB
- Fuse Online の Postgres インスタンスに関連するメトリックを表示します。
- Infrastructure - JVM
-
syndesis-meta
またはsyndesis-server
アプリケーションの実行中の JVM に関するメトリックを表示します。ダッシュボードの上部にある Application ドロップダウンリストから、監視するアプリケーションを選択します。 - Infrastructure - REST APIs
-
request throughput
およびlatency
などの Fuse Online インフラストラクチャー API エンドポイントに関連するメトリックを表示します。ダッシュボードの上部にある Application ドロップダウンリストから、監視するアプリケーションを選択します。
Prometheus Alertmanager にアクセスするには、以下を実行します。
- アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートのリストを開きます。
alertmanager-route エントリーの横にあるホスト名 URL をクリックし、Alertmanager コンソールを開きます。
Fuse Online インフラストラクチャーが正常である場合、デフォルトのビューは空になります。
インフラストラクチャーコンポーネントのいずれかが正常でない場合は、生成されたアクティブなアラートとそれらのアラートの通知を無効にするオプションが表示されます。
その他のリソース
Prometheus を初めて使用する場合は、https://prometheus.io/docs/prometheus/latest/getting_started/ を参照してください。