モニタリング ダッシュボードのインストール（ベータ版）

Edge for Private Cloud v4.18.01

システム要件

すべての Edge ノードに apigee-telegraf をインストールし、 ダッシュボードデータを収集できます。したがって、apigee-telegraf のシステム要件は次のようになります。 Edge の場合と同じで、 インストール先のノードを選択します。

apigee-grafana をインストールできます Management Server や Edge などの既存の Edge ノードの 1 つを再利用することも UI ノード。

apigee-influxdb の場合: Management Server ノードや Edge UI ノードなどの既存の Edge ノードに、既存の Edge ノードに システム要件に変更はありません。

専用のノードに apigee-influxdb をインストールする場合は、 パフォーマンス上の理由がある場合、ノードは次の要件を満たす必要があります。

  • 2 コアの CPU
  • 4 GB RAM
  • 250GB のディスク容量（モニタリングデータは 1 か月後にパージ）
  • 1,000 以上の IOPS

詳しくは、 InfluxData のドキュメント をご覧ください。

apigee-influxdb のポート要件

ポート 8086 と 8183 を apigee-influxdb データノードで開いて、 apigee-grafana を実行しているノードと apigee-telegraf。

ダッシュボードをインストールするための構成ファイル コンポーネント

apigee-telegraf をインストールする および apigee-grafana コンポーネント apigee-service ユーティリティに構成ファイルを渡します。これらのファイルを 「apigee」がアクセスできるディレクトリユーザー（/opt/apigee/customer/application など） 「apigee」が所有します。できます。

apigee-telegraf の構成パラメータ

apigee-telegraf setup に渡すテキスト ファイルで、これらのプロパティを設定します。 使用できます。たとえば、sa_telegraf.txt という名前のテキスト ファイルで設定します。

プロパティ

説明

INFLUXDB_URL

apigee-influxdb ノードの URL を指定します（ポート 8086 を含む）。例:

http://192.168.0.1:8086

apigee-grafana の構成パラメータ

apigee-grafana setup に渡すテキスト ファイルで、これらのプロパティを設定します。 使用できます。たとえば、sa_grafana.txt という名前のテキスト ファイルで設定します。

プロパティ

説明

INFLUXDB_HOST

InfluxDB ノードの IP アドレスまたは DNS 名を指定します。次に例を示します。

192.168.0.1

INFLUXDB_PORT

Grafana データソースで使用される InfluxDB API ポート。8086 を指定します。

GRAFANA_USERNAME

ダッシュボード UI にログインするための Grafana ユーザー名。

GRAFANA_PASSWORD

ダッシュボード UI にログインするための Grafana パスワード。

インストール手順

ダッシュボード コンポーネントをこの順序でインストールするには、以下の手順を行います。

  • apigee-influxdb（中央ノード）
  • apigee-telegraf（各ノード）
  • apigee-grafana（中央サーバー上）
で確認できます。

インストール 単一の Edge ノードまたはスタンドアロン ノード上の apigee-influxdb

スタンドアロン ノード、または Management Server または Edge UI を実行している Edge ノードでは、次の操作を行います。

  1. apigee-influxdb をインストールします。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
  2. apigee-influxdb データベースを構成します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
  3. apigee-influxdb を開始します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

apigee-telegraf を すべての

Edge 環境のすべてのノードで、次の操作を行います。

  1. 最初の Edge ノードで、apigee-telegraf をインストールします。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. apigee-telegraf の構成ファイルを次の名前で作成します。 sa_telegraf.txt。通常、このファイルは、環境変数、 「apigee」ユーザー（/opt/apigee/customer/application など） オーナーを「apigee」にします。できます。

    ファイルで次のプロパティを設定して、apigee-influxdb ノードの URL を指定します。 （ポート 8086 を含む）: 

    INFLUXDB_URL=http://influx_IP:8086
  3. オーナーを「apigee」に変更します。 
    > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
  4. apigee-telegraf を構成します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
    /opt/apigee/customer/application/sa_telegraf.txt
  5. apigee-telegraf を再起動します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  6. すべての Edge ノードでこのプロセスを繰り返します。

apigee-grafana を 単一のエッジノードに

Edge インストール環境の単一ノード（Edge UI ノードなど）で、次の操作を行います。

  1. 最初の Edge ノードで、apigee-grafana をインストールします。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. apigee-grafana の構成ファイルを sa_grafana.txt という名前で作成します。 通常、このファイルは「apigee」からアクセスできるディレクトリに保存します。できます。 /opt/apigee/customer/application。「apigee」が所有するように設定します。できます。

    このファイルで次のプロパティを設定します。これらのプロパティについては、上記の説明をご覧ください。

    INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin
  3. オーナーを「apigee」に変更します。 
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. apigee-grafana を構成する 次の構成ファイルを使用します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
    /opt/apigee/customer/application/sa_grafana.txt
  5. apigee-grafana を再起動します。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

ダッシュボードにアクセスするには、ブラウザで次の URL を開きます。

http://grafana_IP_or_DNS:3000

アプリケーションの構成ファイルで指定した認証情報を使用して、 apigee-grafana。上記の例では、 ユーザー名/パスワードが admin/admin です。

インストールのトラブルシューティング

ダッシュボードにデータが表示されない場合は、次の手順でトラブルシューティングを行ってください。 確認します。

  1. apigee-telegrafを確実に データを収集しています <ph type="x-smartling-placeholder">
      </ph>
    1. べき等である apigee-service apigee-telegraf setup を実行します。 依存関係の欠落などのエラーを解決し、解決します。
    2. apigee-telegraf を再起動して確認する /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log（エラーがある場合）
  2. apigee-influxdb がデータを受信していることを確認するには: <ph type="x-smartling-placeholder">
      </ph>
    1. apigee-influxdb データノードで次の TCP ポートが開いていることを確認します。 8086 と 8183。
    2. 次の URL を使用して、ブラウザで influxdb UI を開きます。 
      http://influxdb_IP_or_DNS:8183
      1. [クエリ] フィールドに「show databases」と入力します。次のデータベースが system, application, events, _internal が作成されました。
      2. [クエリ] フィールドに「show servers」と入力します。[ apigee-influxdb 個のノードが一覧表示されます。
  3. データソースをダッシュボードに確認します。 <ph type="x-smartling-placeholder">
      </ph>
    1. メインメニューで [データソース] を選択します。3 つのアイコンが 表示されます。
    2. データソースごとにアイコンを選択します。
    3. データソースの詳細ページで、[保存してテスト ] ボタンを離します。
    4. データソースが正しく構成されている場合は、
      という形式のメッセージが表示されます。 成功
      データソースが機能しています

ベータ版モニタリング ダッシュボードの更新

アップグレード元の Edge のバージョンに応じて、以下の 2 つの手順のいずれかを使用します。

  • 4.16.09 と 4.17.0x は同じプロシージャを使用します。
  • 4.16.05 では、アップデートの一環として apigee-collectd をアンインストールする必要があります。

バージョンから更新 4.16.09 または 4.17.0x

ベータ版の Apigee Monitoring ダッシュボードを 4.16.09 または 4.17.0x にインストールした場合は、 4.18.01 のベータ版に更新できます。

ベータ版のモニタリング ダッシュボードを更新するには:

  1. Apigee Edge の更新の説明に沿って Edge を 4.18.01 に更新します。 4.17.01/4.17.05 から 4.17.09 への更新、Apigee Edge 4.16.09 を 4.17.09、Apigee Edge 4.16.01/4.16.05 を 4.17.09 に更新する。
  2. apigee-influxdb の更新先 Management Server ノードで実行します。 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    ここで、configFile はインストールに使用した構成ファイルです。 apigee-influx。

    管理プロジェクトに apigee-grafana もインストールした場合は、 サーバーノードの場合、この手順では apigee-grafana も更新します。それ以外の場合は、 apigee-granfana を使用します。

  3. apigee-grafana Management Server ノード] で、このノードで apigee-grafana を インストールしました。 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. apigee-telegraf の更新先 node 1: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  5. ノードごとに手順 4 を繰り返します。

バージョン 4.16.05 からの更新

4.16.05 バージョンのダッシュボードでは、代わりに apigee-collectd が使用されていました。 apigee-telegraf。4.18.01 への更新の一環として、アンインストールします。 apigee-collectd を実行し、apigee-telegraf をインストールします。

ベータ版のモニタリング ダッシュボードを更新するには:

  1. 次の説明に従い、Edge を 4.18.01 に更新します。 Apigee Edge を更新する 4.16.01/4.16.05 ～ 4.17.01 Apigee Edge 4.16.09 を 4.17.01.
  2. apigee-influxdb の更新先 Management Server ノードで実行します。 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    ここで、configFile はインストールに使用した構成ファイルです。 apigee-influx。

    管理プロジェクトに apigee-grafana もインストールした場合は、 サーバーノードの場合、この手順では apigee-grafana も更新します。それ以外の場合は、 apigee-granfana を使用します。

  3. apigee-grafana Management Server ノード] で、このノードで apigee-grafana を インストールしました。 
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. apigee-telegraf をノード 1 にインストールします。 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
  5. ノードごとに手順 4 を繰り返します。