第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
oc label namespace <fuse-online-namespace> monitoring-key=middlewareCopy to Clipboard Copied! Toggle word wrap Toggle overflow Fuse Online インストールでアプリケーション監視設定リソースが OpenShift クラスターに追加されたことを確認します。
-
OpenShift Web コンソールで、
application-monitoringプロジェクトに移動し、prometheus-routeURL を開きます。 Prometheus コンソールで、Status
Targets ページに移動します。 Syndesisターゲットがリストされている場合は、Fuse Online が監視用に設定されているため、ステップ 4 に進みます。Syndesisターゲットがリストにない場合は、ステップ 3 に進みます。
-
OpenShift Web コンソールで、
別の OpenShift プロジェクトにインストールされた Prometheus インスタンスで監視するために Fuse Online を公開するには、
syndesisカスタムリソースでopsアドオンを有効にします。Fuse Online の namespace に移動します。
Expand 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: truespec: addons: ops: enabled: trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow - ファイルを保存します。
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/ を参照してください。