第3章 PCP パッケージのインストール

手順

1. Satellite プロセスに関するデータを収集するように PCP を設定するには、/var/lib/pcp/pmdas/proc/hotproc.conf ファイルを作成して、以下のコンテンツを追加してください。

   #pmdahotproc
   Version 1.0
   
   # processes with load 0.9 or 1GB RSS memory
   (cpuburn > 0.9 || residentsize > 1000000) &&
   (
     fname == "java" ||
     fname == "qdrouterd" ||
     fname == "qpidd" ||
     (fname == "postgres" && psargs ~ /-D/) ||
     fname == "mongod" ||
     fname == "dynflow_executor" ||
     fname == "dynflow_executor_monitor" ||
     fname ~ /smart_proxy_dynflow_core/ ||
     psargs ~ /Passenger RackApp/ ||
     psargs ~ /celery beat/ ||
     psargs ~ /celery worker/ ||
     psargs ~ /pulp/ ||
     psargs ~ /smart-proxy/ ||
     psargs ~ /squid.conf/
   )

   デフォルトでは、PCP は基本的なシステムメトリクスを収集します。このステップを実行すると、以下の Satellite プロセスの詳細なメトリクスが収集されるようになります。

   • Java
   • PostgreSQL
   • MongoDB
   • Dynflow
   • Passenger
   • Pulp
   • Qpid

2. PCP が収集しているプロセスのメトリクスをログ記録するように設定します。

   # mkdir -p /var/lib/pcp/config/pmlogconf/foreman-hotproc
   # cat >/var/lib/pcp/config/pmlogconf/foreman-hotproc/summary << EOF
   #pmlogconf-setup 2.0
   ident   foreman hotproc metrics
   probe   hotproc.control.config != "" ? include : exclude
           hotproc.psinfo.psargs
           hotproc.psinfo.cnswap
           hotproc.psinfo.nswap
           hotproc.psinfo.rss
           hotproc.psinfo.vsize
           hotproc.psinfo.cstime
           hotproc.psinfo.cutime
           hotproc.psinfo.stime
           hotproc.psinfo.utime
           hotproc.io.write_bytes
           hotproc.io.read_bytes
           hotproc.schedstat.cpu_time
           hotproc.fd.count
   EOF

3. PMDA をモニタリングするプロセスをインストールします。

   # cd /var/lib/pcp/pmdas/proc
   # ./Install

4. PCP が Apache HTTP サーバーからメトリクスを収集するように設定します。

   1. Apache HTTP サーバーの拡張ステータスモジュールを有効にします。

      #cat >/etc/httpd/conf.d/01-status.conf <<EOF
      ExtendedStatus On
      LoadModule status_module modules/mod_status.so
      
      <Location "/server-status">
      PassengerEnabled off
      SetHandler server-status
      Order deny,allow
      Deny from all
      Allow from localhost
      </Location>
      EOF

   2. Apache HTTP サーバー PMDA を有効にします。

      # cd /var/lib/pcp/pmdas/apache
      # ./Install

   3. Satellite インストーラーが拡張ステータスモジュールの設定ファイルを上書きしないようにします。

      次の行を /etc/foreman-installer/custom-hiera.yaml 設定ファイルに追加します。

      apache::purge_configs: false

5. PCP が PostgreSQL からメトリクスを収集するように設定します。

   1. /var/lib/pcp/pmdas/postgresql ディレクトリーに切り替えます。

      # cd /var/lib/pcp/pmdas/postgresql

   2. インストーラーを実行します。

      # ./Install

   3. PCP データベースインターフェイスが PostgreSQL データベースにアクセスできるようにします。

      /etc/pcpdbi.conf 設定ファイルに以下の行を挿入します。

      $database = "dbi:Pg:dbname=foreman;host=localhost";
      $username = "foreman";
      $password = "6qXfN9m5nii5iEcbz8nuiJBNsyjjdRHA"; 1
      $os_user = "foreman";

      1

      ここでの $password の値は、/etc/foreman/database.yml 設定ファイルに保存されています。

   4. SELinux を pcp_pmcd_t ドメインパーミッションに変更して、PCP の PostgreSQL データベースへのアクセスを許可します。

      # semanage permissive -a pcp_pmcd_t

   5. PostgreSQL PMDA が PostgreSQL に接続できることを確認します。

      /var/log/pcp/pmcd/postgresql.log ファイルで、接続が確立されていることを確認します。データベース接続が確立されないと、PostgreSQL PMDA はアクティブな状態ですが、メトリクスを提供することはできません。

      [Tue Aug 14 09:21:06] pmdapostgresql(25056) Info: PostgreSQL connection established

      /var/log/pcp/pmcd/postgresql.log にエラーがある場合は、pmcd サービスを再起動します。

      # systemctl restart pmcd

6. Satellite で telemetry 機能を有効にします。

   Satellite からメトリクスを収集できるようにするには、メトリクスを statsd プロトコルで pcp-mmvstatsd デーモンに送信する必要があります。メトリクスは集計され、PCP MMV API 経由で入手可能になります。

   1. Foreman Telemetry および pcp-mmvstatsd パッケージをインストールします。

      # satellite-maintain packages install foreman-telemetry pcp-mmvstatsd

   2. pcp-mmvstatsd サービスを有効にして起動します。

      # systemctl enable pcp-mmvstatsd
      # systemctl start pcp-mmvstatsd

   3. Satellite telemetry 機能を有効にします。

      以下の行を /etc/foreman/settings.yaml 設定ファイルに追加します。

      :telemetry:
        :prefix: 'fm_rails'
        :statsd:
          :enabled: true
          :host: '127.0.0.1:8125'
          :protocol: 'statsd'
        :prometheus:
          :enabled: false
        :logger:
          :enabled: false
          :level: 'INFO'

7. メトリクスをアーカイブファイルに毎日保存するようにスケジュールします。

   # cat >/etc/cron.daily/refresh_mmv <<EOF
   #!/bin/bash
   echo "log mandatory on 1 minute mmv" | /usr/bin/pmlc -P
   EOF
   # chmod +x /etc/cron.daily/refresh_mmv

8. Apache HTTP サーバーおよび PCP を再起動してデータ収集を開始します。

   # systemctl restart httpd pmcd pmlogger

手順

1. Red Hat Enterprise Linux の optional リポジトリーを有効にします。

   # subscription-manager repos --enable rhel-7-server-optional-rpms

2. PCP Web API およびアプリケーションをインストールします。

   # satellite-maintain packages install pcp-webapi pcp-webapp-grafana pcp-webapp-vector

3. PCP Web サービスを起動して、有効にします。

   # systemctl start pmwebd
   # systemctl enable pmwebd

4. PCP Web サービスへのアクセスを可能にするようにファイアウォールポートを開きます。

   # firewall-cmd --add-port=44323/tcp
   # firewall-cmd --permanent --add-port=44323/tcp