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

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

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

{
  "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 のデバッグログを有効にするには:

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

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

  1. Edge UI ノードで、/opt/apigee/customer/application/ui.properties を編集します。 このファイルが存在しない場合は作成します。
  2. このファイルに次のプロパティを追加します。
    conf_application_logger.application=DEBUG
  3. Edge UI を再起動します。
    &gt; /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 違反

?