第5章 Prometheus を使用した Fuse アプリケーションの監視

手順

1. ターミナルウインドウで、サービスモニターを Prometheus がインストールされた namespace (プロジェクト) に追加します。

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

2. OpenShift コンソールでプロジェクトを開き、Applications Services と選択します。
3. fuseonline サービスをクリックし、Actions Edit YAML と選択します。
4. エディターで、app: fuseonline を syndesis.io/type: integration に置き換えて YAML ファイルのセレクターセクションを変更します。
5. Save をクリックします。

手順

1. Prometheus 設定ファイル (prometheus-config.yml) を以下のように編集します。

   1. スクレープ間隔を 5 秒に設定します。

      global:
              scrape_interval:     5s
              evaluation_interval: 5s

   2. 通常は syndesis namespace である ${OPENSHIFT_PROJECT} で Pod をスクレープするよう設定する Kubernetes サービス検出設定とともに integration-pod という名前のスクレープ設定ジョブを追加します。

       - job_name: integration-pods
      
                kubernetes_sd_configs:
                - role: pod
                  namespaces:
                    names:
                      - ${OPENSHIFT_PROJECT}

   3. 以下のような relabel_configs セクションを追加します。

      • prometheus.io/scrape ラベルが true に設定されたインテグレーション Pod のみをスクレープする。
      • prometheus.io/path および prometheus.io/port ラベルから値を使用して、インテグレーション Pod で JMX エクスポーターをスクレープするのに使用される metrics_path および address ラベルを設定する。
      • Pod ラベルおよびアノテーションを Prometheus レベルとして追加する。

      • kubernetes_namespace および kubernetes_pod_name ラベルを作成する。

        以下は、relabel_configs セクションの例です。

        relabel_configs:
                  - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
                    action: keep
                    regex: true
                  - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
                    action: replace
                    target_label: __metrics_path__
                    regex: (.+)
                  - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
                    action: replace
                    regex: ([^:]+)(?::\d+)?;(\d+)
                    replacement: $1:$2
                    target_label: __address__
                  - action: labelmap
                    regex: __meta_kubernetes_pod_label_(.+)
                  - action: labelmap
                    regex: __meta_kubernetes_pod_annotation_(syndesis.+)
                  - source_labels: [__meta_kubernetes_namespace]
                    action: replace
                    target_label: kubernetes_namespace
                  - source_labels: [__meta_kubernetes_pod_name]
                    action: replace
                    target_label: kubernetes_pod_name

   4. Fuse Online インテグレーションは、JVM、Camel、および CXF から多数のメトリクスを公開します。メトリクスに必要なストレージの量を削減するには、以下の metric_relabel_configs セクションを追加し、Fuse Online コンソールに表示されないメトリクスを除外します。

       metric_relabel_configs:
                - source_labels: [__name__]
                  regex: jmx_(.+)
                  action: drop
                - source_labels: [__name__]
                  regex: jvm_(.+)
                  action: drop
                - source_labels: [__name__]
                  regex: process_(.+)
                  action: drop
                - source_labels: [type, __name__]
                  separator: ':'
                  regex: context:(org_apache_camel_ExchangesTotal|org_apache_camel_ExchangesFailed|io_syndesis_camel_StartTimestamp|io_syndesis_camel_LastExchangeCompletedTimestamp|io_syndesis_camel_LastExchangeFailureTimestamp)
                  action: keep

      注記

      最後の設定行は、Fuse Online web コンソールに表示される統計に不可欠な Prometheus メトリクスストアに追加するメトリクスを明示的にリストしています。Prometheus インスタンスは、他のメトリクスが除外された場合にこれらのメトリクスの収集を明示的に許可する必要があります。

2. 以下のように、Prometheus Pod 設定が 30 日分のメトリクスを保存するよう更新します。

   args:
               - '--config.file=/etc/prometheus/prometheus.yml'
               - '--storage.tsdb.retention=30d'