第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/
   )

   Copy to Clipboard Toggle word wrap

   デフォルトでは、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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

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

      apache::purge_configs: false

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

      # ./Install

      Copy to Clipboard Toggle word wrap

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

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

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

      1

      
      $os_user = "foreman";

      Copy to Clipboard Toggle word wrap

      1

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

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

      # semanage permissive -a pcp_pmcd_t

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

      # systemctl restart pmcd

      Copy to Clipboard Toggle word wrap

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

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

   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'

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   # systemctl restart httpd pmcd pmlogger

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   # systemctl start pmwebd
   # systemctl enable pmwebd

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap