このページは Cloud Translation API によって翻訳されました。

モニタリングのベストプラクティス

Edge for Private Cloud v. 4.17.05

アラートのモニタリング

Apigee Edge では、次の場合にアラートを syslog や外部モニタリングシステム/ツールに転送できます。エラーや、イベントの失敗によって発生した障害。これらのアラートは、システムレベルまたはアプリケーションレベルのアラート/イベント。アプリケーションレベルのアラートは、ほとんどがカスタムアラートで、自動的に作成されます。通常、ネットワーク管理者はカスタムできます。アラートの詳細については、Apigee サポートにお問い合わせください。

アラートのしきい値の設定

しきい値を設定すると、そのしきい値を超えるとアラートが生成されます。設定する内容は、構成する必要があります。しきい値は容量に応じて設定する必要があります。たとえば、Apigee 容量が 6 GB しかない場合は、エッジが低すぎる可能性があります。次の値と等しい（=）でしきい値を割り当てることができる条件を指定できます連続する 2 つのイベント間の時間間隔を指定することもできます。生成できます。時/分/秒のオプションを使用できます。

システムレベルのアラートの設定基準

次の表に基準を示します。

アラート	推奨されるしきい値	説明
メモリ不足	500 MB	メモリが不足しているため、コンポーネントを起動できません
ディスク容量が少ない（/var/log）	8 GB	ディスク容量が不足しています。
高負荷	3+	実行を待機しているプロセスが予期せず増加しました
プロセスを停止しました	該当なし、ブール値の true または false	システムの Apigee Java プロセスが停止しました

Apigee 固有およびサードパーティの確認ポート

次のポートがアクティブであることを確認する

Management Server、Router、Message Processor のポート 4526、4527、4528
Management Server、Router、Message Processor のポート 1099、1100、1101
ルーターのポート 8081 および 15999
Message Processor 上のポート 8082 および 8998

Management Server のポート 8080 次のサードパーティのポートをチェックして、アクティブである

Qpid ポート 5672
Postgres ポート 5432
Cassandra ポート 7000、7199、9042、9160
ZooKeeper ポート 2181
OpenLDAP ポート 10389

各 Apigee コンポーネントが API 呼び出しをリッスンしているポートを確認するには、次のコマンドを発行します。 Management Server（通常はポート 8080）に対して次の API 呼び出しを行います。

curl -v -u <username>:<password> http://<host>:<port>/v1/servers?pod=gateway&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=central&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=analytics&region=dc-1

これらのコマンドの出力には、以下に示すようなセクションが含まれます。「 "http.management.port"セクション指定したコンポーネントのポート番号を指定します。

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

ログの表示

ログファイルは、システムのイベントやオペレーションに関するメッセージを追跡します。メッセージが表示されますプロセスの開始時と完了時、またはエラー状態の発生時にログに記録されます。ログを表示するシステムコンポーネントに関する情報を取得できます。たとえば、CPU、メモリ、ディスク、負荷、失敗状態になる前や後になどです。これにより現在のシステムの問題の原因を診断したり、潜在的なシステムの学習します

たとえば、コンポーネントの一般的なシステムログには、次のようなエントリが含まれます。

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;    
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

/opt/apigee/conf/logback.xml ファイルを編集して、ロギングメカニズムを制御できます。サーバーを再起動する必要はありません。logback.xml ファイルには、環境変数を設定する次のプロパティが含まれています。ロギングメカニズムが logback.xml ファイルで構成変更をチェックする頻度:

<configuration scan="true" scanPeriod="30 seconds" >

デフォルトでは、ロギングメカニズムは 1 分ごとに変更をチェックします。時間単位を省略した場合 scanPeriod 属性に渡されると、デフォルトはミリ秒です。

次の表に、Apigee Edge Private Cloud コンポーネントのログファイルの場所を示します。

コンポーネント	ロケーション
管理サーバー	opt/apigee/var/log/edge-management-server
ルーター	opt/apigee/var/log/edge-router
Message Processor	opt/apigee/var/log/edge-message-processor
Qpid サーバー	opt/apigee/var/log/edge-qpid-server
Apigee Postgres サーバー	opt/apigee/var/log/edge-postgres-server
Edge UI	opt/apigee/var/log/edge-ui
ZooKeeper	opt/apigee/var/log/apigee-zookeeper
OpenLDAP	opt/apigee/var/log/apigee-openldap
Cassandra	opt/apigee/var/log/apigee-cassandra
クピッド	opt/apigee/var/log/apigee-qpidd
PostgreSQL データベース	opt/apigee/var/log/apigee-postgresql

メッセージのデバッグログの有効化プロセッサと Edge UI

Message Processor のデバッグログを有効にするには:

Message Processor ノードで、/opt/apigee/customer/application/messsage-processor.properties を編集します。このファイルが存在しない場合は作成します。
このファイルに次のプロパティを追加します。
conf_system_log.level=DEBUG
Message Processor を再起動します。
> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Edge UI のデバッグログを有効にするには:

Edge UI ノードで、/opt/apigee/customer/application/ui.properties を編集します。このファイルが存在しない場合は作成します。
このファイルに次のプロパティを追加します。
conf_application_logger.application=DEBUG
Edge UI を再起動します。
> /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

モニタリングツール

Nagios、Collectd、Graphite、Splunk、Sumologic、Monit などのモニタリングツールが企業の環境全体とビジネスプロセスをモニタリングできます。

コンポーネント		Nagios	収集済み	Splunk
システムレベルのチェック	CPU 使用率	?	?
	空きメモリ/使用メモリ	?	?
	ディスク使用量	?	?
	ネットワークの統計情報	?	?
プロセス		?
API チェック		?
JMX		?
Java			?
ログファイル				?
重大なイベント	レート制限へのヒット			?
	バックエンドサーバー（Hybris または SharePoint）にアクセスできません			?
	FaaS（STS）にアクセスできません			?
警告イベント	SMTP サーバーにアクセスできません			?
警告イベント	SLA 違反			?