手順

1. 管理者権限で OpenShift にログインします。

   $ oc login -u system:admin

2. Prometheus Operator の実行に必要なカスタムリソース定義をインストールします。{$templates-base-url} は Fuse on OpenShift テンプレートファイルの場所に置き換えます。

   $ oc create -f {$templates-base-url}\fuse-prometheus-crd.yml

   Prometheus Operator がクラスターのすべての namespace で利用できるようになります。

3. 以下のコマンド構文を使用して、Prometheus Operator を namespace にインストールします。

   $ oc process -f {$templates-base-url}/fuse-prometheus-operator.yml -p NAMESPACE=<YOUR NAMESPACE> | oc create -f -

   たとえば、myproject という名前のプロジェクト (namespace) には、以下のコマンドを使用します。

   oc process -f {$templates-base-url}/fuse-prometheus-operator.yml -p NAMESPACE=myproject | oc create -f -

   注記

   Prometheus Operator を namespace に初めてインストールする場合、Prometheus リソース Pod が起動するまでに数分の時間がかかる場合があります。その後、Prometheus Operator をクラスターの他の namespace にインストールすると、Prometheus リソース Pod の起動ははるかに速くなります。

4. 以下のコマンド構文を使用して、Prometheus Operator を指示し、プロジェクトの Fuse アプリケーションを監視します。

   $ oc process -f {$templates-base-url}/fuse-servicemonitor.yml -p NAMESPACE=<YOUR NAMESPACE> -p FUSE_SERVICE_NAME=<YOUR FUSE SERVICE> | oc apply -f -

   たとえば、myfuseapp という名前の Fuse アプリケーションが含まれる myproject という名前の OpenShift プロジェクト (namespace) には、次のコマンドを使用します。

   oc process -f {$templates-base-url}/fuse-servicemonitor.yml -p NAMESPACE=myproject -p FUSE_SERVICE_NAME=myfuseapp | oc apply -f -

5. Prometheus ダッシュボードを開くには、以下を実行します。

   1. OpenShift コンソールにログインします。
   2. Prometheus を追加したプロジェクトを開きます。

   3. 左側のペインで、Applications → Routes と選択します。

      

   4. Prometheus Hostname URL をクリックし、新しいブラウザータブまたはウインドウで Prometheus ダッシュボードを開きます。

      

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

1. カスタム Prometheus 設定ファイルを作成します。デフォルトファイルのコンテンツ (prometheus-config.yml https://raw.githubusercontent.com/jboss-fuse/application-templates/master/prometheus/prometheus-config.yml) を形式の目安として使用できます。

   カスタム設定ファイルには任意の名前を使用できます (例: my-prometheus-config.yml など)。

2. prometheus 設定ファイル（例： my-prometheus-config.yml）をアプリケーションの src/main/fabric8-includes ディレクトリーに追加します。

3. アプリケーション内に src/main/fabric8/deployment.xml ファイルを作成し、設定ファイルに設定された値で AB_JMX_EXPORTER_CONFIG 環境変数のエントリーを追加します。以下に例を示します。

   spec:
     template:
       spec:
         containers:
           -
             resources:
               requests:
                 cpu: "0.2"
               limits:
                 cpu: "1.0"
             env:
             - name: SPRING_APPLICATION_JSON
               value: '{"server":{"tomcat":{"max-threads":1}}}'
             - name: AB_JMX_EXPORTER_CONFIG
               value: "my-prometheus-config.yml"

   この環境変数は、Pod レベルでアプリケーションに適用されます。

4. アプリケーションの再構築およびデプロイ

手順

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

   oc label namespace <fuse-online-namespace> monitoring-key=middleware

2. Fuse Online インストールでアプリケーション監視設定リソースが OpenShift クラスターに追加されたことを確認します。

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

   2. Prometheus コンソールで、Status → Targets ページに移動します。

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

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

3. インフラストラクチャーリソースが OpenShift クラスターにない場合、Prometheus モニタリングを有効にするには、以下を実行します。

   1. 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 ファイルを開きます。

   2. yaml ファイルを編集し、以下の行を追加して Syndesis.Spec.Addons.Ops.Enable 値を true に設定します。

      spec:
        addons:
          ops:
            enabled: "true"

   3. ファイルを保存します。

   4. Pod が再起動するまで待機します。

      注記

      インフラストラクチャーリソースは、インストールコマンドの実行直後には使用できません。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 コンソールの上部で、ダッシュボードセレクターをクリックし、以下のインフラストラクチャーダッシュボードのいずれかを選択します。

      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 インフラストラクチャーが正常である場合、デフォルトのビューは空になります。

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

手順

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

   oc label namespace <fuse-online-namespace> monitoring-key=middleware

2. Fuse Online インストールでアプリケーション監視設定リソースが OpenShift クラスターに追加されたことを確認します。

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

   2. Prometheus コンソールで、Status > Targets ページに移動します。

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

      Syndesis ターゲットがリストされていない場合は、ステップ 3 に進みます。

3. インフラストラクチャーリソースが OpenShift クラスターにない場合、Prometheus モニタリングを有効にするには、以下を実行します。

   1. 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 ファイルを開きます。

   2. yaml ファイルを編集し、以下の行を追加して Syndesis.Spec.Addons.Ops.Enable 値を true に設定します。

      spec:
        addons:
          ops:
            enabled: "true"

   3. ファイルを保存します。

   4. Pod が再起動するまで待機します。

      注記

      インフラストラクチャーリソースは、インストールコマンドの実行直後には使用できません。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 コンソールの上部で、ダッシュボードセレクターをクリックし、Integration - Camel を選択します。

      このダッシュボードには、Apache Camel インテグレーションアプリケーションによって公開される標準メトリクスが表示されます。