Edge for Private Cloud v4.18.01
システム要件
ダッシュボード データを収集するには、すべての Edge ノードに apigee-telegraf
をインストールする必要があります。したがって、apigee-telegraf
のシステム要件は、これをインストールする Edge ノードのシステム要件と同じです。
apigee-grafana
は別のノードにインストールすることも、Management Server や Edge UI ノードなど既存の Edge ノードを再利用することもできます。
apigee-influxdb
は既存の Edge ノード(Management Server ノードや Edge UI ノードなど)にインストールできますが、システム要件は変更されません。
パフォーマンス上の理由から apigee-influxdb
を独自のノードにインストールする場合は、次の条件を満たす必要があります。
- 2 コア CPU
- 4 GB RAM
- 250 GB のディスク容量(1 か月後にパージされたデータのモニタリング)
- 1,000 以上の IOPS
詳細については、InfluxData ドキュメントをご覧ください。
apigee-influxdb のポート要件
apigee-grafana
と apigee-telegraf
を実行しているノードからアクセスできるように、apigee-influxdb
データノードでポート 8086 と 8183 を開く必要があります。
ダッシュボード コンポーネントをインストールするための構成ファイル
apigee-telegraf
コンポーネントと apigee-grafana
コンポーネントをインストールするには、構成ファイルを apigee-service
ユーティリティに渡します。これらのファイルは、「apigee」ユーザーがアクセスできるディレクトリ(/opt/apigee/customer/application
など)に保存し、「apigee」ユーザーが所有しているようにします。
apigee-telegraf の構成パラメータ
これらのプロパティは、apigee-telegraf setup
コマンドに渡すテキスト ファイルに設定します。たとえば、sa_telegraf.txt
という名前のテキスト ファイルで設定します。
プロパティ |
Description |
---|---|
|
apigee-influxdb ノードの URL(ポート 8086 を含む)を指定します。例: http://192.168.0.1:8086 |
apigee-grafana の構成パラメータ
これらのプロパティは、apigee-grafana setup
コマンドに渡すテキスト ファイルに設定します。たとえば、sa_grafana.txt
という名前のテキスト ファイルで設定します。
プロパティ |
Description |
---|---|
|
InfluxDB ノードの IP アドレスまたは DNS 名を指定します。次に例を示します。 192.168.0.1 |
|
Grafana データソースで使用される InfluxDB API ポート。8086 を指定します。 |
|
ダッシュボード UI にログインするための Grafana ユーザー名。 |
|
ダッシュボード UI にログインするための Grafana のパスワード。 |
インストール手順
ダッシュボード コンポーネントをインストールする手順は次のとおりです。
apigee-influxdb
(中央ノード)apigee-telegraf
(各ノード上)apigee-grafana
(中央のサーバー上)
単一 Edge ノードまたはスタンドアロン ノードに apigee-influxdb をインストールする
スタンドアロン ノード、または Management Server または Edge UI を実行している Edge ノードの場合:
apigee-influxdb
をインストールします。> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
apigee-influxdb
データベースを構成します。> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
apigee-influxdb
を起動します。> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
すべての Edge ノードに apigee-telegraf をインストールする
Edge インストール環境のすべてのノードで次の操作を行います。
- 最初の Edge ノードに、
apigee-telegraf
をインストールします。> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
apigee-telegraf
の構成ファイルをsa_telegraf.txt
という名前で作成します。通常、このファイルは「apigee」ユーザーがアクセスできるディレクトリ(/opt/apigee/customer/application
など)に保存し、「apigee」ユーザーに所有させます。ファイルで次のプロパティを設定して、apigee-influxdb ノードの URL(ポート 8086 を含む)を指定します。
INFLUXDB_URL=http://influx_IP:8086
- オーナーを「apigee」に変更します。
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
apigee-telegraf
を設定します。> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
apigee-telegraf
を再起動します。> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- すべての Edge ノードでこの手順を繰り返します。
単一の Edge ノードに apigee-grafana をインストールする
Edge インストール環境の単一ノード(Edge UI ノードなど)で次の操作を行います。
- 最初の Edge ノードに、
apigee-grafana
をインストールします。> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
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
- オーナーを「apigee」に変更します。
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- 構成ファイル(
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
)を使用してapigee-grafana
を構成します。 apigee-grafana
を再起動します。> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
ダッシュボードにアクセスするには、ブラウザで次の URL を開きます。
http://grafana_IP_or_DNS:3000
apigee-grafana
の構成ファイルで指定した認証情報を使用してログインします。上記の例では、ユーザー名とパスワードは admin / Admin です。
インストールのトラブルシューティング
ダッシュボードにデータが表示されない場合は、次の手順でインストールのトラブルシューティングを行います。
apigee-telegraf
がデータを収集できるようにするには、以下の手順を行います。apigee-service apigee-telegraf setup
を実行します。これはべき等です。エラーと依存関係の欠落を確認して解決します。apigee-telegraf
を再起動し、/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
にエラーがないかどうか確認します
apigee-influxdb
がデータを受信していることを確認するには:apigee-influxdb
データノードで TCP ポート 8086 と 8183 が開いていることを確認します。- 次の URL を使用して、ブラウザで influxdb UI を開きます。
http://influxdb_IP_or_DNS:8183
- [クエリ] フィールドに「データベースを表示」と入力します。データベース
system, application, events, _internal
が作成されていることを確認します。 - [クエリ] フィールドに「show server」と入力します。
apigee-influxdb
ノードが表示されていることを確認します。
- [クエリ] フィールドに「データベースを表示」と入力します。データベース
- ダッシュボードでデータソースを確認します。
- メインメニューで [データソース] を選択します。3 つのデータソースのアイコンが表示されるはずです。
- データソースごとにアイコンを選択します。
- データソースの詳細ページで、[Save & Test] ボタンを選択します。
- データソースが正しく構成されていれば、次の形式のメッセージが表示されます。
Success
Data source is working
ベータ版モニタリング ダッシュボードの更新
アップグレード元の Edge のバージョンに応じて、以下の 2 つの手順のいずれかを使用します。
- 4.16.09 と 4.17.0x では同じ手順を使用する
- 4.16.05 では、アップデートの一環として
apigee-collectd
をアンインストールする必要があります。
バージョン 4.16.09 または 4.17.0x からの更新
4.16.09 または 4.17.0x でベータ版の Apigee Monitoring ダッシュボードをインストールした場合は、4.18.01 のベータ版に更新できます。
ベータ版モニタリング ダッシュボードを更新するには:
- Apigee Edge 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 から 9.17.09 への更新の手順に従って、Edge を 4.18.01 に更新します。
- Management Server ノードで
apigee-influxdb
を更新します。> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
ここで、configFile は
apigee-influx
のインストールに使用した構成ファイルです。apigee-grafana
を Management Server ノードにもインストールしている場合は、この手順でapigee-grafana
も更新されます。それ以外の場合は、次の手順でapigee-granfana
を更新します。 - Management Server ノードに
apigee-grafana
をインストールしなかった場合は、インストールしたノードでapigee-grafana
を更新します。> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- ノード 1 の
apigee-telegraf
を更新します。> /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
- ノードごとにステップ 4 を繰り返します。
バージョン 4.16.05 からの更新
4.16.05 バージョンのダッシュボードでは、apigee-telegraf
ではなく apigee-collectd
が使用されていました。4.18.01 への更新の一環として、apigee-collectd
をアンインストールして apigee-telegraf
をインストールします。
ベータ版モニタリング ダッシュボードを更新するには:
- Apigee Edge 4.16.01/4.16.05 を 4.17.01 に更新すると Apigee Edge 4.16.09 を 4.17.01 に更新するの説明に従って、Edge を 4.18.01 に更新します。
- Management Server ノードで
apigee-influxdb
を更新します。> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
ここで、configFile は
apigee-influx
のインストールに使用した構成ファイルです。apigee-grafana
を Management Server ノードにもインストールしている場合は、この手順でapigee-grafana
も更新されます。それ以外の場合は、次の手順でapigee-granfana
を更新します。 - Management Server ノードに
apigee-grafana
をインストールしなかった場合は、インストールしたノードでapigee-grafana
を更新します。> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- ノード 1 に
apigee-telegraf
をインストールします。> /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
- ノードごとにステップ 4 を繰り返します。