4.2. 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 をデプロイ済みである必要があります。

手順

  1. Fuse Online namespace で以下のコマンドを使用して monitoring-key=middleware ラベルを設定します。

    oc label namespace <fuse-online-namespace> monitoring-key=middleware
  2. Fuse Online インストールでアプリケーション監視設定リソースが OpenShift クラスターに追加されたことを確認します。

    1. OpenShift Web コンソールで、application-monitoring プロジェクトに移動し、prometheus-route URL を開きます。
    2. Prometheus コンソールで、StatusTargets ページに移動します。

      Syndesis ターゲットがリストされている場合は、Fuse Online が監視用に設定されているため、ステップ 4 に進みます。

      Syndesis ターゲットが一覧にない場合は、ステップ 3 に進みます。

  3. 別の OpenShift プロジェクトにインストールされた Prometheus インスタンスで監視するために Fuse Online を公開するには、syndesis カスタムリソースで ops アドオンを有効にします。

    1. Fuse Online の namespace に移動します。

      OpenShift 4.xOpenShift 3.11
      1. OpenShift Web コンソールで、Fuse Online (syndesis) プロジェクトに移動します。
      2. Catalog > Installed Operators の順に選択し、Fuse Online Operator をクリックします。
      3. Syndesis CRD をクリックし、app をクリックします。
      4. Yaml をクリックし、エディターで yaml ファイルを開きます。
      1. Resources > Other Resources の順に選択します。
      2. ドロップダウンメニューから、Syndesis リソースタイプを選択します。
      3. app リソースの Actions をクリックし、Edit YAML を選択してエディターで yaml ファイルを開きます。
    2. yaml ファイルを編集し、以下の行を追加して Syndesis.Spec.Addons.Ops.Enable 値を true に設定します。

      spec:
        addons:
          ops:
            enabled: true
    3. ファイルを保存します。
    4. Pod が再起動するまで待機します。

      注記

      Fuse Online インフラストラクチャーリソースは、インストールコマンドの実行直後には使用できません。Prometheus Targets ページに Fuse Online (Syndesis) ターゲットが表示されるまで待機する必要がある場合があります。

  4. Prometheus にアクセスするには、以下を実行します。

    1. アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートの一覧を開きます。
    2. prometheus-route エントリーの横にあるホスト名 URL をクリックし、Prometheus コンソールを開きます。
    3. Fuse Online インフラストラクチャーコンポーネントに設定されたアラートルールの一覧を表示するには、Alerts メニュー項目をクリックします。
  5. Grafana ダッシュボードにアクセスするには、以下を実行します。

    1. アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートの一覧を開きます。
    2. grafana-route エントリーの横にあるホスト名 URL をクリックし、Grafana コンソールを開きます。
    3. 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 ドロップダウンリストから、監視するアプリケーションを選択します。
  6. Prometheus Alertmanager にアクセスするには、以下を実行します。

    1. アプリケーション監視 Operator がインストールされているプロジェクトの OpenShift コンソールで、ルートの一覧を開きます。
    2. alertmanager-route エントリーの横にあるホスト名 URL をクリックし、Alertmanager コンソールを開きます。

      Fuse Online インフラストラクチャーが正常である場合、デフォルトのビューは空になります。

      インフラストラクチャーコンポーネントのいずれかが正常でない場合は、生成されたアクティブなアラートとそれらのアラートの通知を無効にするオプションが表示されます。

その他のリソース

Prometheus を初めて使用する場合は、https://prometheus.io/docs/prometheus/latest/getting_started/ を参照してください。