apigee-monit による自己回復

Apigee Edge for Private Cloud には、オープンソースの monit ユーティリティに基づくツールである apigee-monit が含まれています。apigee-monit は定期的に Edge サービスをポーリングします。サービスが利用できない場合、apigee-monit はそのサービスの再起動を試みます。

apigee-monit を使用するには、手動でインストールする必要があります。これは標準インストールには含まれていません。

デフォルトでは、apigee-monit は 60 秒ごとに Edge サービスのステータスを確認します。

クイック スタート

このセクションでは、apigee-monit をすばやく起動して実行する方法について説明します。

Amazon Linux を使用している場合は、まず Fedora 経由で monit をインストールします。それ以外の場合は、この手順をスキップします。

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

apigee-monit をインストールするには、次の手順を行います。

  apigee-monit をインストールする
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

これにより、apigee-monit がインストールされ、デフォルトでノード上のすべてのコンポーネントのモニタリングが開始されます。

  コンポーネントのモニタリングを停止する
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  コンポーネントのモニタリングを開始する
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  ステータス情報の概要を取得する
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  apigee-monit ログファイルを確認する
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

以降のセクションでは、これらの各トピックとその他のトピックについて詳しく説明します。

apigee-monit について

apigee-monit は、ノード上のすべてのコンポーネントを確実に稼働させるために役立ちます。そのために、次のようなさまざまなサービスを提供します。

  • 失敗したサービスを再開する
  • 概要情報を表示する
  • ロギングのモニタリング ステータス
  • 通知の送信
  • Edge 以外のサービスのモニタリング

apigee-monit が実行されていることを確認することをおすすめします。詳細については、apigee-monit のモニタリングをご覧ください。

apigee-monit のアーキテクチャ

Apigee Edge for Private Cloud のインストールと構成時に、必要に応じてクラスタ内の各ノードに apigee-monit の個別のインスタンスをインストールできます。これらの個別の apigee-monit インスタンスは互いに独立して動作します。つまり、自分のコンポーネントのステータスを他のノードに伝えることも、モニタリング ユーティリティ自体の障害を中央サービスに通知することもありません。

次の図は、5 ノードクラスタの apigee-monit アーキテクチャを示しています。

5 ノードクラスタ内の Apigee Monit のアーキテクチャ
図 1: クラスタ内の各ノードで分離された apigee-monit のインスタンスがそれぞれ実行される

コンポーネントの構成

apigee-monit はコンポーネント構成を使用して、モニタリングするコンポーネント、確認するコンポーネントの要素、障害発生時に実行するアクションを決定します。

デフォルトでは、apigee-monit は事前定義されたコンポーネント構成を使用して、ノード上のすべての Edge コンポーネントをモニタリングします。デフォルト設定は、apigee-monit コンポーネント構成ファイルで確認できます。デフォルトのコンポーネント構成は変更できません。

apigee-monit は、チェックするコンポーネントに応じて、コンポーネントのさまざまな要素をチェックします。次の表に、apigee-monit が各コンポーネントのチェック内容と、各コンポーネントのコンポーネント構成の場所を示します。1 つの構成ファイルで定義されるコンポーネントもあれば、独自の構成を持つコンポーネントもあることに注意してください。

コンポーネント 構成の場所 モニタリング対象
管理サーバー /opt/apigee/edge-management-server/monit/default.conf apigee-monit のチェック:
  • 指定したポートが開いていて、リクエストを受け入れている
  • 指定されたプロトコルはサポートされています
  • レスポンスのステータス

また、これらのコンポーネント apigee-monit について、以下のことを行います。

  • 一定のサイクル数に何回か失敗しないとアクションを実行できない
  • カスタム リクエストパスを設定する
Message Processor /opt/apigee/edge-message-processor/monit/default.conf
Postgres サーバー /opt/apigee/edge-postgres-server/monit/default.conf
Qpid サーバー /opt/apigee/edge-qpid-server/monit/default.conf
ルーター /opt/apigee/edge-router/monit/default.conf
Cassandra
Edge UI
OpenLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf apigee-monit のチェック:
  • サービスは実行中です

次の例は、edge-router コンポーネントのデフォルトのコンポーネント構成を示しています。

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

次の例は、Classic UI(edge-ui)コンポーネントのデフォルト構成を示しています。

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

これは Classic UI に適用されます。コンポーネント名が edge-management-ui の新しい Edge UI には適用されません。

Apigee Edge for Private Cloud コンポーネントのデフォルトのコンポーネント構成は変更できません。ただし、ターゲット エンドポイントや httpd サービスなどの外部サービス用に独自のコンポーネント構成を追加することは可能です。詳しくは、Apigee 以外のコンポーネントの構成をご覧ください。

デフォルトでは、apigee-monit は実行中のノード上のすべてのコンポーネントをモニタリングします。すべてのコンポーネントまたは個々のコンポーネントに対して、有効または無効にできます。詳しくは以下をご覧ください。

apigee-monit をインストールする

apigee-monit は、デフォルトではインストールされていません。Apigee Edge for Private Cloud バージョン 4.19.01 以降のアップグレードまたはインストール後に手動でインストールできます。

このセクションでは、apigee-monit のインストール方法について説明します。

apigee-monit のアンインストールの詳細については、apigee-monit をアンインストールするをご覧ください。uninstalling

apigee-monit をインストールする

このセクションでは、apigee-monit のインストール方法について説明します。

apigee-monit をインストールするには:

  1. 次のコマンドを使用して apigee-monit をインストールします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. 次のコマンドで apigee-monit を構成します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. 次のコマンドで apigee-monit を起動します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. クラスタ内の各ノードでこの手順を繰り返します。

コンポーネントのモニタリングを停止、開始する

なんらかの理由でサービスが停止すると、apigee-monit はサービスの再起動を試みます。

これにより、コンポーネントを意図的に停止する必要がある場合に問題が発生することがあります。たとえば、バックアップやアップグレードが必要になったときにコンポーネントを停止できます。バックアップまたはアップグレード中に apigee-monit によってサービスが再起動されると、メンテナンス手順が中断され、失敗する可能性があります。

以降のセクションでは、コンポーネントのモニタリングを停止するオプションについて説明します。

コンポーネントを停止してモニタリング対象外にする

コンポーネントを停止してモニタリング対象外にするには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name には次のいずれかを指定できます。
  • apigee-cassandra(Cassandra)
  • apigee-openldap(OpenLDAP)
  • apigee-postgresql(PostgreSQL データベース)
  • apigee-qpidd(Qpidd)
  • apigee-sso(Edge SSO)
  • apigee-zookeeper(ZooKeeper)
  • edge-management-server(Management Server)
  • edge-management-ui(新しい Edge UI)
  • edge-message-processor(Message Processor)
  • edge-postgres-server(Postgres Server)
  • edge-qpid-server(Qpid Server)
  • edge-router(Edge Router)
  • edge-ui(Classic UI)

stop-component では「all」は有効なオプションではありません。stop-component を使用して停止およびモニタリング対象外にできるコンポーネントは一度に 1 つだけです。

コンポーネントを再起動してモニタリングを再開するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

start-component では「all」は有効なオプションではありません。

すべてのコンポーネントを停止してモニタリング対象から外す方法については、すべてのコンポーネントを停止してモニタリング対象外にするをご覧ください。

コンポーネントをモニタリング対象外にする(ただし停止はしない)

コンポーネントを停止せずにモニタリング対象外にするには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
component_name には次のいずれかを指定できます。
  • apigee-cassandra(Cassandra)
  • apigee-openldap(OpenLDAP)
  • apigee-postgresql(PostgreSQL データベース)
  • apigee-qpidd(Qpidd)
  • apigee-sso(Edge SSO)
  • apigee-zookeeper(ZooKeeper)
  • edge-management-server(Management Server)
  • edge-management-ui(新しい Edge UI)
  • edge-message-processor(Message Processor)
  • edge-postgres-server(Postgres Server)
  • edge-qpid-server(Qpid Server)
  • edge-router(Edge Router)
  • edge-ui(Classic UI)

コンポーネントのモニタリングを再開するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

すべてのコンポーネントのモニタリングを解除する(ただし停止はしない)

すべてのコンポーネントを停止せずにモニタリング対象外にするには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

すべてのコンポーネントのモニタリングを再開するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

すべてのコンポーネントを停止してモニタリング対象外にする

すべてのコンポーネントを停止してモニタリング対象から外すには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

すべてのコンポーネントを再起動してモニタリングを再開するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

すべてのコンポーネントのモニタリングを停止するには、apigee-monit の停止、起動、無効化で説明されているように apigee-monit を無効にします。

apigee-monit を停止、起動、無効化する

他のサービスと同様に、apigee-service コマンドを使用して apigee-monit を停止または開始できます。また、apigee-monit は、コンポーネントのモニタリングを一時的に停止できる unmonitor コマンドをサポートしています。

apigee-monit を停止する

apigee-monit を停止するには、次のコマンドを使用します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

apigee-monit を起動する

apigee-monit を起動するには、次のコマンドを使用します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

apigee-monit を無効にする

次のコマンドを使用して、ノード上のすべてのコンポーネントのモニタリングを一時停止できます。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

または、apigee-monit をアンインストールするで説明しているように、apigee-monit をノードからアンインストールすることで完全に無効にすることもできます。

apigee-monit をアンインストールする

apigee-monit をアンインストールするには:

  1. apigee-monit をモニタリングする cron ジョブを設定している場合は、apigee-monit をアンインストールする前にその cron ジョブを削除します。
    sudo rm /etc/cron.d/apigee-monit.cron
  2. 次のコマンドで apigee-monit を停止します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. 次のコマンドで apigee-monit をアンインストールします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. クラスタ内の各ノードでこの手順を繰り返します。

新しくインストールされたコンポーネントをモニタリングする

apigee-monit を実行しているノードに新しいコンポーネントをインストールする場合は、apigee-monitrestart コマンドを実行してモニタリングを開始できます。これにより、コンポーネント構成に新しいコンポーネントを含む新しい monit.conf ファイルが生成されます。

次の例では、apigee-monit を再起動します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

apigee-monit をカスタマイズする

次のようなさまざまな apigee-monit 設定をカスタマイズできます。

  1. デフォルトの apigee-monit 管理設定
  2. グローバル設定
  3. Apigee 以外のコンポーネントの構成

デフォルトの apigee-monit 制御設定

ステータス チェックの頻度や apigee-monit ファイルの場所など、デフォルトの apigee-monit 制御設定をカスタマイズできます。これを行うには、code with config 手法を使用してプロパティ ファイルを編集します。プロパティ ファイルは、Apigee Edge for Private Cloud をアップグレードした後も保持されます。

次の表に、カスタマイズ可能な apigee-monit コントロールのデフォルト設定を示します。

プロパティ 説明
conf_monit_httpd_port httpd デーモンのポート。apigee-monithttpd をダッシュボード アプリに使用し、レポート/サマリーを有効にします。デフォルト値は 2812 です。
conf_monit_httpd_allow httpd デーモンへのリクエストに対する制約。apigee-monithttpd を使用してダッシュボード アプリを実行し、レポート/概要を有効にします。この値は、localhost(httpd が実行されているホスト)を指す必要があります。

リクエストにユーザー名とパスワードを含めることを要求するには、次の構文を使用します。

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

ユーザー名とパスワードを追加する場合は、各制約の間に「\n」を挿入します。値に実際の改行や改行を挿入しないでください。

conf_monit_monit_datadir 予定の詳細が保存されるディレクトリです。
conf_monit_monit_delay_time apigee-monit が最初にメモリに読み込まれてから実行を開始するまでに待機する時間。これは apigee-monit の最初のプロセス チェックにのみ影響します。
conf_monit_monit_logdir apigee-monit ログファイルの場所。
conf_monit_monit_retry_time apigee-monit が各プロセスのチェックを試みる頻度。デフォルトは 60 秒です。
conf_monit_monit_rundir PID ファイルと状態ファイルの場所。apigee-monit がプロセスのチェックに使用します。

デフォルトの apigee-monit コントロール設定をカスタマイズするには:

  1. 次のファイルを編集します。
    /opt/apigee/customer/application/monit.properties

    ファイルが存在しない場合は作成し、所有者を「apigee」ユーザーに設定します。

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    ファイルがすでに存在する場合は、上記の表にない構成プロパティが追加で定義されることがあります。上記以外のプロパティは変更しないでください。

  2. プロパティ値を設定するか、新しい値に置き換えます。

    たとえば、ログファイルの場所を /tmp に変更するには、次のプロパティを追加または編集します。

    conf_monit_monit_logdir=/tmp/apigee-monit.log

  3. 変更を monit.properties ファイルに保存します。
  4. 次のコマンドで apigee-monit を再構成します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. 次のコマンドで apigee-monit を再読み込みします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit を再起動できない場合は、ログファイルにエラーがないか確認してください。apigee-monit ログファイルにアクセスするをご覧ください。

  6. クラスタ内のノードごとにこの手順を繰り返します。

グローバル構成の設定

apigee-monit のグローバル構成設定を定義できます。たとえば、アラートのメール通知を追加できます。これを行うには、/opt/apigee/data/apigee-monit ディレクトリに構成ファイルを作成してから apigee-monit を再起動します。

apigee-monit のグローバル設定を定義するには:

  1. 次の場所に新しいコンポーネント構成ファイルを作成します。
    /opt/apigee/data/apigee-monit/filename.conf

    ここで、filename には「monit」を除く任意の有効なファイル名を指定できます。

  2. 次の例のように、新しい構成ファイルのオーナーを「apigee」ユーザーに変更します。
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. 新しいファイルにグローバル設定を追加します。次の例では、メールサーバーを構成してアラートの受信者を設定しています。
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    グローバル構成オプションの一覧については、monit のドキュメントをご覧ください。

  4. 変更をコンポーネント構成ファイルに保存します。
  5. 次のコマンドで apigee-monit を再読み込みします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit が再起動しない場合は、ログファイルにエラーがないか確認してください。apigee-monit ログファイルにアクセスするをご覧ください。

  6. クラスタ内のノードごとにこの手順を繰り返します。

Apigee 以外のコンポーネントの構成

apigee-monit に独自の構成を追加すると、Apigee Edge for Private Cloud に含まれないサービスをチェックできます。たとえば、apigee-monit を使用してターゲット エンドポイントにリクエストを送信し、API が実行されていることを確認できます。

Apigee 以外のコンポーネント構成を追加するには:

  1. 次の場所に新しいコンポーネント構成ファイルを作成します。
    /opt/apigee/data/apigee-monit/filename.conf

    ここで、filename には「monit」を除く任意の有効なファイル名を指定できます。

    コンポーネント構成ファイルは、必要に応じていくつでも作成できます。たとえば、ノードでモニタリングする Apigee 以外のコンポーネントごとに構成ファイルを作成できます。

  2. 次の例のように、新しい構成ファイルのオーナーを「apigee」ユーザーに変更します。
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. カスタム構成を新しいファイルに追加します。次の例では、ローカル サーバー上のターゲット エンドポイントを確認します。
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    使用可能な構成設定の一覧については、monit のドキュメントをご覧ください。

  4. 構成ファイルに変更を保存します。
  5. 次のコマンドで apigee-monit を再読み込みします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit が再起動しない場合は、ログファイルにエラーがないか確認してください。apigee-monit ログファイルにアクセスするをご覧ください。

  6. クラスタ内のノードごとにこの手順を繰り返します。

なお、これは Edge 以外のコンポーネントにのみ当てはまります。Edge コンポーネントのコンポーネント構成をカスタマイズすることはできません。

apigee-monit のログファイルにアクセスする

apigee-monit は、イベント、再起動、構成の変更、アラートを含むすべてのアクティビティをログファイルに記録します。

ログファイルのデフォルトの場所は次のとおりです。

/opt/apigee/var/log/apigee-monit/apigee-monit.log

デフォルトの場所は、apigee-monit コントロール設定をカスタマイズすることで変更できます。

ログファイルのエントリの形式は次のとおりです。

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

apigee-monit ログファイル エントリの形式はカスタマイズできません。

apigee-monit で集約されたステータスを表示する

apigee-monit には、ノード上のコンポーネントに関する集約されたステータス情報を表示する次のコマンドが含まれています。

コマンド 使用状況
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

以降のセクションでは、これらの各コマンドについて詳しく説明します。

報告

report コマンドは、ノード上の現在稼働しているコンポーネント、停止しているコンポーネント、初期化中のコンポーネント、モニタリング対象外になっているコンポーネントの数を集計して表示します。次の例では、report コマンドを呼び出します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

次の例は、AIO(オールインワン)構成での report の出力を示しています。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

この例では、12 個のサービスのうち 11 個が apigee-monit によって稼働中と報告されています。現在、1 つのサービスがモニタリングされていません。

report コマンドを最初に実行したときに、Connection refused エラーが発生することがあります。その場合は、conf_monit_monit_delay_time プロパティの期間が経過してから、もう一度お試しください。

概要

summary コマンドは、各コンポーネントを一覧表示して、そのステータスを提供します。次の例では、summary コマンドを呼び出します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

次の例は、AIO(オールインワン)構成での summary の出力を示しています。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

summary コマンドを最初に実行したときに Connection refused エラーが発生した場合は、conf_monit_monit_delay_time プロパティの長さを待ってから、もう一度お試しください。

apigee-monit をモニタリングする

apigee-monit が各ノードで実行されていることを定期的に確認することをおすすめします。

apigee-monit が実行されていることを確認するには、次のコマンドを使用します。

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

apigee-monit を実行している各ノードで、このコマンドを定期的に発行することをおすすめします。これを行う方法の 1 つとして、スケジュールされたタスクをあらかじめ設定した間隔で実行する cron などのユーティリティがあります。

cron を使用して apigee-monit をモニタリングするには:

  1. 次の例のように、apigee-monit.cron ディレクトリを /etc/cron.d ディレクトリにコピーして、cron サポートを追加します。
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. apigee-monit.cron ファイルを開いて編集します。

    apigee-monit.cron ファイルでは、実行する cron ジョブと、そのジョブを実行する頻度を定義します。次の例は、デフォルト値を示しています。

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    このファイルの構文は次のとおりです。最初の 5 つのフィールドで、apigee-monit がアクションを実行する時刻を定義します。

    min hour day_of_month month day_of_week task_to_execute

    たとえば、デフォルトの実行時間は */2 * * * * で、これは 2 分ごとに apigee-monit プロセスを確認するように cron に指示します。

    cron ジョブを 1 分に 1 回を超えて実行することはできません。

    cron の使用方法の詳細については、サーバー OS のドキュメントまたは man ページをご覧ください。

  3. 組織のポリシーと一致するように cron の設定を変更します。たとえば、実行頻度を 5 分ごとに変更するには、ジョブ定義を次のように設定します。
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. apigee-monit.cron ファイルを保存します。
  5. クラスタ内のノードごとにこの手順を繰り返します。

cronapigee-monit の監視を開始しない場合は、次の点を確認してください。

  • cron ジョブ定義の後に空白行が 1 つある。
  • ファイルで定義されている cron ジョブは 1 つだけです。(コメント行はカウントされません)。

apigee-monit を停止または一時的に無効にする場合は、この cron ジョブも無効にする必要があります。そうしないと、cron によって apigee-monit が再起動されます。

cron を無効にするには、次のいずれかを行います。

  • /etc/cron.d/apigee-monit.cron ファイルを削除します。
    sudo rm /etc/cron.d/apigee-monit.cron

    後で cron を再度有効にして apigee-monit を監視する場合は、これを再度コピーする必要があります。

    または

  • /etc/cron.d/apigee-monit.cron ファイルを編集し、行の先頭に「#」を追加してジョブ定義をコメントアウトします。例:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit