Edge for Private Cloud v4.19.01
Apigee Edge for Private Cloud には、オープンソースの monit ユーティリティに基づくツールである apigee-monit
が含まれています。apigee-monit
は定期的に Edge サービスをポーリングします。サービスが利用できない場合、apigee-monit
はそのサービスの再起動を試みます。
apigee-monit
を使用するには、手動でインストールする必要があります。これは標準インストールには含まれていません。
デフォルトでは、apigee-monit
は 60 秒ごとに Edge サービスのステータスを確認します。
クイック スタート
次の表に、apigee-monit
をすぐに使い始める方法を示します。
apigee-monit をインストールする |
|
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install これにより、 |
|
コンポーネントのモニタリングを停止する | |
/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
アーキテクチャを示しています。

apigee-monit
のインスタンスがそれぞれ実行される対応プラットフォーム
apigee-monit
は、Private Cloud クラスタに対して次のプラットフォームをサポートしています。(apigee-monit
でサポートされる OS は、Private Cloud のバージョンによって異なります)。
OS | Private Cloud のバージョン | ||
---|---|---|---|
v4.50.00 | v4.51.00 | v4.52.00 | |
CentOS | 7.5、7.6、7.7、7.8 | 7.5、7.6、7.7、7.8 | 7.5、7.6、7.7、7.8 |
RedHat Enterprise Linux(RHEL) | 7.5、7.6、7.7、7.8 | 7.5、7.6、7.7、7.8、7.9、8.0 | 7.5、7.6、7.7、7.8、7.9、8.0 |
Oracle Linux | 7.5、7.6、7.7、7.8 | 7.5、7.6、7.7、7.8 | 7.5、7.6、7.7、7.8 |
* 技術的にはサポートされていませんが、Apigee Edge for Private Cloud バージョン 4.19.01 の CentOS/RHEL/Oracle バージョン 6.9 に apigee-monit をインストールして使用できます。 |
コンポーネントの構成
apigee-monit
はコンポーネント構成を使用して、モニタリングするコンポーネント、確認するコンポーネントの要素、障害発生時に実行するアクションを決定します。
デフォルトでは、apigee-monit
は事前定義されたコンポーネント構成を使用して、ノード上のすべての Edge コンポーネントをモニタリングします。デフォルト設定は、apigee-monit
コンポーネント構成ファイルで確認できます。デフォルトのコンポーネント構成は変更できません。
apigee-monit
は、チェックするコンポーネントに応じて、コンポーネントのさまざまな要素をチェックします。次の表に、apigee-monit
が各コンポーネントのチェック内容と、各コンポーネントのコンポーネント構成の場所を示します。1 つの構成ファイルで定義されるコンポーネントもあれば、独自の構成を持つコンポーネントもあることに注意してください。
コンポーネント | 構成の場所 | モニタリング対象 |
---|---|---|
管理サーバー | /opt/apigee/edge-management-server/monit/default.conf |
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
次の例は、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"
Apigee Edge for Private Cloud コンポーネントのデフォルトのコンポーネント構成は変更できません。ただし、ターゲット エンドポイントや httpd
サービスなどの外部サービス用に独自のコンポーネント構成を追加することは可能です。詳しくは、Apigee 以外のコンポーネントの構成をご覧ください。
デフォルトでは、apigee-monit
は実行中のノード上のすべてのコンポーネントをモニタリングします。すべてのコンポーネントまたは個々のコンポーネントに対して、有効または無効にできます。詳しくは以下をご覧ください。
apigee-monit をインストールする
apigee-monit
は、デフォルトではインストールされていません。Apigee Edge for Private Cloud バージョン 4.19.01 以降のアップグレードまたはインストール後に手動でインストールできます。
このセクションでは、サポートされているプラットフォームと、サポートされていない CentOS/RHEL/Oracle Linux のバージョン 6.9 に apigee-monit
をインストールする方法について説明します。
apigee-monit
のアンインストールの詳細については、apigee-monit
をアンインストールするをご覧ください。uninstalling
サポートされているプラットフォームに apigee-monit をインストールする
このセクションでは、サポートされているプラットフォームに apigee-monit
をインストールする方法について説明します。
サポートされているプラットフォームに apigee-monit
をインストールするには:
- 次のコマンドを使用して
apigee-monit
をインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
- 次のコマンドで
apigee-monit
を構成します。/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- 次のコマンドで
apigee-monit
を起動します。/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- クラスタ内の各ノードでこの手順を繰り返します。
サポートされていないプラットフォームに apigee-monit をインストールする
apigee-monit
は、CentOS/RHEL/Oracle Linux のバージョン 6.9 ではサポートされていませんが、このセクションではそのインストール方法について説明します。
CentOS/RHEL/Oracle Linux バージョン 6.9 に apigee-monit
をインストールするには:
- Extra Packages for Enterprise Linux リポジトリ(略して EPEL)をインストールします。
sudo yum install epel-release
- EPEL を無効にします。
yum-config-manager --disable epel
- EPEL を一時的に有効にして、
monit
をインストールします。yum --enablerepo=epel install monit
monit
のインストール後に EPEL リポジトリを無効にする必要があります。enablerepo
オプションは、現在のコマンドで指定されたリポジトリを有効にするだけです。 apigee-monit
をインストールします。apigee-service apigee-monit install
apigee-service apigee-monit configure
apigee-service apigee-monit start
apigee-monit
のインストール後に EPEL が無効になっていることを確認します。yum repolist all | grep epel/x86_64 !epel/x86_64 Extra Packages for Enterprise Linu disabled
この例では、EPEL リポジトリが無効になっていることを示しています。ただし、無効になっていない場合は、無効にする必要があります。
sudo yum-config-manager --disable epel
コンポーネントのモニタリングを停止、開始する
なんらかの理由でサービスが停止すると、apigee-monit
はサービスの再起動を試みます。
これにより、コンポーネントを意図的に停止する必要がある場合に問題が発生することがあります。たとえば、バックアップやアップグレードが必要になったときにコンポーネントを停止できます。バックアップまたはアップグレード中に apigee-monit
によってサービスが再起動されると、メンテナンス手順が中断され、失敗する可能性があります。
以降のセクションでは、コンポーネントのモニタリングを停止するオプションについて説明します。
コンポーネントを停止してモニタリング対象外にする
コンポーネントを停止してモニタリング対象外にするには、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_namecomponent_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_namecomponent_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
をアンインストールするには:
apigee-monit
をモニタリングするcron
ジョブを設定している場合は、apigee-monit
をアンインストールする前にそのcron
ジョブを削除します。sudo rm /etc/cron.d/apigee-monit.cron
- 次のコマンドで
apigee-monit
を停止します。/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
- 次のコマンドで
apigee-monit
をアンインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- クラスタ内の各ノードでこの手順を繰り返します。
新しくインストールされたコンポーネントをモニタリングする
apigee-monit
を実行しているノードに新しいコンポーネントをインストールする場合は、apigee-monit
の restart
コマンドを実行してモニタリングを開始できます。これにより、コンポーネント構成に新しいコンポーネントを含む新しい monit.conf ファイルが生成されます。
次の例では、apigee-monit
を再起動します。
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
apigee-monit をカスタマイズする
次のようなさまざまな apigee-monit
設定をカスタマイズできます。
デフォルトの apigee-monit 制御設定
ステータス チェックの頻度や apigee-monit
ファイルの場所など、デフォルトの apigee-monit
制御設定をカスタマイズできます。これを行うには、code with config 手法を使用してプロパティ ファイルを編集します。プロパティ ファイルは、Apigee Edge for Private Cloud をアップグレードした後も保持されます。
次の表に、カスタマイズ可能な apigee-monit
コントロールのデフォルト設定を示します。
プロパティ | 説明 |
---|---|
conf_monit_httpd_port |
httpd デーモンのポート。apigee-monit は httpd をダッシュボード アプリに使用し、レポート/サマリーを有効にします。デフォルト値は 2812 です。 |
conf_monit_httpd_allow |
httpd デーモンへのリクエストに対する制約。apigee-monit は httpd を使用してダッシュボード アプリを実行し、レポート/概要を有効にします。この値は、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
コントロール設定をカスタマイズするには:
- 次のファイルを編集します。
/opt/apigee/customer/application/monit.properties
ファイルが存在しない場合は作成し、所有者を「apigee」ユーザーに設定します。
chown apigee:apigee /opt/apigee/customer/application/monit.properties
ファイルがすでに存在する場合は、上記の表にない構成プロパティが追加で定義されることがあります。上記以外のプロパティは変更しないでください。
プロパティ値を設定するか、新しい値に置き換えます。
たとえば、ログファイルの場所を
/tmp
に変更するには、次のプロパティを追加または編集します。conf_monit_monit_logdir=/tmp/apigee-monit.log
- 変更を
monit.properties
ファイルに保存します。 - 次のコマンドで
apigee-monit
を再構成します。/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- 次のコマンドで
apigee-monit
を再読み込みします。/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
apigee-monit
を再起動できない場合は、ログファイルにエラーがないか確認してください。apigee-monit
ログファイルにアクセスするをご覧ください。 - クラスタ内のノードごとにこの手順を繰り返します。
グローバル構成の設定
apigee-monit
のグローバル構成設定を定義できます。たとえば、アラートのメール通知を追加できます。これを行うには、/opt/apigee/data/apigee-monit
ディレクトリに構成ファイルを作成してから apigee-monit
を再起動します。
apigee-monit
のグローバル設定を定義するには:
- 次の場所に新しいコンポーネント構成ファイルを作成します。
/opt/apigee/data/apigee-monit/filename.conf
ここで、filename には「monit」を除く任意の有効なファイル名を指定できます。
- 次の例のように、新しい構成ファイルのオーナーを「apigee」ユーザーに変更します。
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- 新しいファイルにグローバル設定を追加します。次の例では、メールサーバーを構成してアラートの受信者を設定しています。
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 のドキュメントをご覧ください。
- 変更をコンポーネント構成ファイルに保存します。
- 次のコマンドで
apigee-monit
を再読み込みします。/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
apigee-monit
が再起動しない場合は、ログファイルにエラーがないか確認してください。apigee-monit
ログファイルにアクセスするをご覧ください。 - クラスタ内のノードごとにこの手順を繰り返します。
Apigee 以外のコンポーネントの構成
apigee-monit
に独自の構成を追加すると、Apigee Edge for Private Cloud に含まれないサービスをチェックできます。たとえば、apigee-monit
を使用してターゲット エンドポイントにリクエストを送信し、API が実行されていることを確認できます。
Apigee 以外のコンポーネント構成を追加するには:
- 次の場所に新しいコンポーネント構成ファイルを作成します。
/opt/apigee/data/apigee-monit/filename.conf
ここで、filename には「monit」を除く任意の有効なファイル名を指定できます。
コンポーネント構成ファイルは、必要に応じていくつでも作成できます。たとえば、ノードでモニタリングする Apigee 以外のコンポーネントごとに構成ファイルを作成できます。
- 次の例のように、新しい構成ファイルのオーナーを「apigee」ユーザーに変更します。
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- カスタム構成を新しいファイルに追加します。次の例では、ローカル サーバー上のターゲット エンドポイントを確認します。
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 のドキュメントをご覧ください。
- 構成ファイルに変更を保存します。
- 次のコマンドで
apigee-monit
を再読み込みします。/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
apigee-monit
が再起動しない場合は、ログファイルにエラーがないか確認してください。apigee-monit
ログファイルにアクセスするをご覧ください。 - クラスタ内のノードごとにこの手順を繰り返します。
なお、これは 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
をモニタリングするには:
- 次の例のように、
apigee-monit.cron
ディレクトリを/etc/cron.d
ディレクトリにコピーして、cron
サポートを追加します。cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
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 ページをご覧ください。- 組織のポリシーと一致するように
cron
の設定を変更します。たとえば、実行頻度を 5 分ごとに変更するには、ジョブ定義を次のように設定します。*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
apigee-monit.cron
ファイルを保存します。- クラスタ内のノードごとにこの手順を繰り返します。
cron
が apigee-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